Zum Hauptinhalt springen
POST
Create Chat
Erstelle einen neuen Chat für einen deiner Chatbots. Die zurückgegebene chatId brauchst du, um Nachrichten zu senden und die Konversation zu lesen.

Authentifizierung

Diese Anfrage benötigt deinen API-Key im x-api-key-Header.

Request

chatbotId
string
erforderlich
ID des Chatbots, zu dem der Chat gehört.
userId
string
Optionale ID, die den Endnutzer identifiziert. Nutze sie, um einen Chat mit einem bekannten Nutzer in deinem System zu verknüpfen.

Response

id
string
erforderlich
ID des erstellten Chats. Verwende sie als chatId in späteren Anfragen.
chatbotId
string
erforderlich
ID des Chatbots, zu dem der Chat gehört.
userId
string
erforderlich
ID des verknüpften Endnutzers.
organizationId
string
erforderlich
ID der Organisation, der der Chat gehört.
createdAt
string
erforderlich
ISO-8601-Zeitstempel, wann der Chat erstellt wurde.

Beispiele

Erfolgreiche Response

Fehler-Response

Autorisierungen

Authorization
string
header
erforderlich

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
chatbotId
string
erforderlich
userId
string

Antwort

201 - application/json
id
string
erforderlich
chatbotId
string
erforderlich
userId
string
erforderlich
organizationId
string
erforderlich
createdAt
string
erforderlich