Obtenir les détails des messages de la conversation

Récupérez tous les détails des messages d'une conversation en utilisant le paramètre conversation_id. La réponse inclut message_id, les requêtes utilisateur, les types de messages, le contenu des messages, les horodatages des messages, et plus encore.

Méthode de requête

GET

Endpoint

https://api-${endpoint}.gptbots.ai/v2/messages

Authentification

Consultez la Présentation de l'API pour les instructions d'authentification.

Requête

Exemple de requête

curl -X GET 'https://api-${endpoint}.gptbots.ai/v2/messages?conversation_id=xxxxxx&page=1&page_size=100' \ -H 'Authorization: Bearer ${API Key}'

                      
                      curl -X GET 'https://api-${endpoint}.gptbots.ai/v2/messages?conversation_id=xxxxxx&page=1&page_size=100' \
-H 'Authorization: Bearer ${API Key}'

Ce bloc de code dans la fenêtre flottante

En-têtes de la requête

Champ	Type	Description
Authorization	Bearer ${API Key}	Utilisez Authorization: Bearer ${API Key} pour l'authentification. Obtenez votre clé API depuis la page de clé API.

Paramètres de la requête

Champ	Type	Obligatoire	Description
conversation_id	string	Oui	Identifiant de la conversation.
page	int	Oui	Numéro de la page à demander.
page_size	int	Oui	Nombre d'éléments par page, jusqu'à 100.

Réponse

Exemple de réponse

{ "total": 2, "conversation_content": [ { "message_id": "645dd86906931c4a9e0ffb1f", "parent_message_id": "545dd86906931c4a9e0ffb1f", "create_time": 1683871849906, "feedback": "POSITIVE", "role": "user", "content": [ { "branch_content": [ { "type": "text", "text": "J'ai téléchargé 2 fichiers image, veuillez effectuer l'OCR et retourner 2 enregistrements json." }, { "type": "image", "image": [ { "url": "https://gptbots.ai/example.png", "format": "jpeg", "name": "TAXI1", "size": 1024 }, { "url": "https://gptbots.ai/example.png", "format": "png", "name": "TAXI2", "size": 1024 } ] }, { "type": "audio", "audio": [ { "url": "https://gptbots.ai/example.mp3", "format": "mp3", "name": "exemple1 audio", "size": 1024 } ] }, { "type": "document", "document": [ { "url": "https://gptbots.ai/example.pdf", "format": "pdf", "name": "exemple pdf", "size": 1024 } ] } ] } ] }, { "message_id": "745dd86906931c4a9e0ffb1f", "parent_message_id": "645dd86906931c4a9e0ffb1f", "create_time": 1683871849906, "feedback": "POSITIVE", "role": "assistant", "content": [ { "from_component_branch": "1", "branch_content": [ { "type": "text", "text": "Bonjour, puis-je vous aider ?" }, { "type": "audio", "audio": [ { "url": "http://gptbots.ai/example.mp3", "transcript": "Contenu texte transcrit de l'audio" } ] } ] }, { "from_component_branch": "2", "branch_content": [ { "type": "document", "document": [ { "url": "https://gptbots.ai/example.pdf", "format": "pdf", "name": "exemple pdf" } ] }, { "type": "image", "image": [ { "url": "https://gptbots.ai/example.png", "format": "png", "name": "TAXI2" } ] } ] } ] } ] }

                      
                      {
  "total": 2,
  "conversation_content": [
    {
      "message_id": "645dd86906931c4a9e0ffb1f",
      "parent_message_id": "545dd86906931c4a9e0ffb1f",
      "create_time": 1683871849906,
      "feedback": "POSITIVE",
      "role": "user",
      "content": [
        {
          "branch_content": [
            {
              "type": "text",
              "text": "J'ai téléchargé 2 fichiers image, veuillez effectuer l'OCR et retourner 2 enregistrements json."
            },
            {
              "type": "image",
              "image": [
                {
                  "url": "https://gptbots.ai/example.png",
                  "format": "jpeg",
                  "name": "TAXI1",
                  "size": 1024
                },
                {
                  "url": "https://gptbots.ai/example.png",
                  "format": "png",
                  "name": "TAXI2",
                  "size": 1024
                }
              ]
            },
            {
              "type": "audio",
              "audio": [
                {
                  "url": "https://gptbots.ai/example.mp3",
                  "format": "mp3",
                  "name": "exemple1 audio",
                  "size": 1024
                }
              ]
            },
            {
              "type": "document",
              "document": [
                {
                  "url": "https://gptbots.ai/example.pdf",
                  "format": "pdf",
                  "name": "exemple pdf",
                  "size": 1024
                }
              ]
            }
          ]
        }
      ]
    },
    {
      "message_id": "745dd86906931c4a9e0ffb1f",
      "parent_message_id": "645dd86906931c4a9e0ffb1f",
      "create_time": 1683871849906,
      "feedback": "POSITIVE",
      "role": "assistant",
      "content": [
        {
          "from_component_branch": "1",
          "branch_content": [
            {
              "type": "text",
              "text": "Bonjour, puis-je vous aider ?"
            },
            {
              "type": "audio",
              "audio": [
                {
                  "url": "http://gptbots.ai/example.mp3",
                  "transcript": "Contenu texte transcrit de l'audio"
                }
              ]
            }
          ]
        },
        {
          "from_component_branch": "2",
          "branch_content": [
            {
              "type": "document",
              "document": [
                {
                  "url": "https://gptbots.ai/example.pdf",
                  "format": "pdf",
                  "name": "exemple pdf"
                }
              ]
            },
            {
              "type": "image",
              "image": [
                {
                  "url": "https://gptbots.ai/example.png",
                  "format": "png",
                  "name": "TAXI2"
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}

Ce bloc de code dans la fenêtre flottante

Réponse réussie

Champ	Type	Description
total	string	Nombre total de messages dans la conversation.
conversation_content	JSON Array	Détails des messages.
message_id	string	Identifiant unique du message.
parent_message_id	string	Identifiant unique du message parent.
create_time	long	Horodatage de création du message.
feedback	string	Retour utilisateur sur le message, valeurs : `POSITIVE`, `NEGATIVE`. Aucun retour si vide.
role	string	Rôle du message : `user` ou `assistant`.
content	JSON Array	Contenu du message.
from_component_branch	string	ID de la branche composant source du message. Vide pour les messages utilisateur et Agents classiques.
branch_content	JSON Array	Contenu de la branche du message.
type	string	Type de contenu du message : `text`, `image`, `audio`, `document`, `video`, `file`.
text	string	Contenu du message texte.
image	JSON Array	Contenu du message image.
audio	JSON Array	Contenu du message audio.
document	JSON Array	Contenu du message document.
video	JSON Array	Contenu du message vidéo.
file	JSON Array	Contenu du message fichier.

Réponse d'erreur

Champ	Type	Description
code	int	Code d'erreur.
message	string	Détails de l'erreur.

Codes d'erreur

Code	Message
40000	Paramètres invalides
40005	Le paramètre de pagination dépasse le nombre réel
40127	Échec de l'authentification du développeur
40356	La conversation n'existe pas
20059	L'Agent a été supprimé