Gesprächsdetails abrufen

Rufen Sie den detaillierten Nachrichtenverlauf eines Gesprächs anhand der angegebenen conversation_id ab. Die Antwort enthält Details zu den Nachrichten wie message_id, Nutzeranfragen, Nachrichtentyp, Nachrichteninhalt und Erstellungszeitpunkt der Nachricht.

Anfragemethode

GET

Anfrage-URL

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

Authentifizierung

Weitere Informationen zur Authentifizierung finden Sie in der API-Übersicht.

Anfrage

Beispielanfrage

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

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

Dieser Codeblock im schwebenden Fenster

Anfrage-Header

Feld	Typ	Beschreibung
Authorization	Bearer ${API Key}	Verwenden Sie Authorization: Bearer ${API Key} zur Authentifizierung. Den API-Schlüssel erhalten Sie auf der API-Key-Seite.

Anfrageparameter

Feld	Typ	Erforderlich	Beschreibung
conversation_id	string	Ja	Gesprächskennung.
page	int	Ja	Abzurufende Seitenzahl.
page_size	int	Ja	Anzahl der Ergebnisse pro Seite, maximal 100.

Antwort

Beispielantwort

{ "total": 100, "messages": [ { "message_id": "645dd86906931c4a9e0ffb1f", "parent_message_id": "", "message_type": "ANSWER", "text": "Hallo, ich bin ein Kundenservice-Agent. Bitte stellen Sie mir Ihre Fragen.", "create_time": 1683871849906 }, { "message_id": "745dd86906931c4a9e0ffb1f", "parent_message_id": "645dd86906931c4a9e0ffb1f", "message_type": "QUESTION", "text": "Welche Funktionen bietet JPush?", "create_time": 1683871849906 }, { "message_id": "845dd86906931c4a9e0ffb1f", "parent_message_id": "745dd86906931c4a9e0ffb1f", "message_type": "ANSWER", "text": "JPush ist eine leistungsstarke Plattform...", "create_time": 1683871849906 } ] }

                      
                      {
  "total": 100,
  "messages": [
    {
      "message_id": "645dd86906931c4a9e0ffb1f",
      "parent_message_id": "",
      "message_type": "ANSWER", 
      "text": "Hallo, ich bin ein Kundenservice-Agent. Bitte stellen Sie mir Ihre Fragen.",
      "create_time": 1683871849906
    },
    {  
      "message_id": "745dd86906931c4a9e0ffb1f",
      "parent_message_id": "645dd86906931c4a9e0ffb1f",
      "message_type": "QUESTION",
      "text": "Welche Funktionen bietet JPush?",
      "create_time": 1683871849906
    },
    {
      "message_id": "845dd86906931c4a9e0ffb1f",
      "parent_message_id": "745dd86906931c4a9e0ffb1f",
      "message_type": "ANSWER",
      "text": "JPush ist eine leistungsstarke Plattform...",
      "create_time": 1683871849906
    }
  ] 
}

Dieser Codeblock im schwebenden Fenster

Erfolgreiche Antwort

Feld	Typ	Beschreibung
total	string	Gesamtanzahl der Nachrichten im Gespräch.
messages	JSON-Array	Nachrichtendetails.
message_id	string	Eindeutige Nachrichten-ID.
parent_message_id	string	ID der übergeordneten Nachricht.
message_type	string	Nachrichtentyp, ANSWER oder QUESTION.
text	string	Nachrichtentext.
create_time	long	Zeitstempel der Erstellung der Nachricht.

Fehlgeschlagene Antwort

Feld	Typ	Beschreibung
code	int	Fehlercode.
message	string	Fehlerdetails.

Fehlercodes

Code	Nachricht
40000	Ungültiger Parameter.
40005	Seitenzahl überschreitet Gesamtanzahl.
40127	Authentifizierung fehlgeschlagen.
40356	Gespräch existiert nicht.
20059	Agent gelöscht.