Skip to main content
POST
Start een nieuwe conversatie
Dit endpoint begint een nieuwe conversatie met een specifieke chatbot. Je ontvangt een conversation_id terug die je kunt gebruiken om berichten te versturen.

Authorizations

Authorization
string
header
required

Gebruik je API sleutel als Bearer token. Voorbeeld: Authorization: Bearer <jouw-api-sleutel>

Body

application/json
chatbot_id
string<uuid>
required

Unieke identifier van de chatbot

Example:

"b88e1147-d2ce-407e-8646-5a7c08ecaebc"

contact_id
string<uuid>

Optionele UUID voor het contact. Als deze niet wordt opgegeven, wordt automatisch een nieuwe ID gegenereerd. Een bestaand contact moet tot dezelfde organisatie als de chatbot behoren.

Example:

"c428c263-a1d3-4072-bf64-525cefbfb0b1"

external_id
string

Optionele identifier uit je eigen systeem, opgeslagen bij de conversatie

Example:

"order-12345"

user_name
string

Optionele naam van het contact

Example:

"Jan Jansen"

user_email
string

Optioneel e-mailadres van het contact

user_phone
string

Optioneel telefoonnummer van het contact

Example:

"+31612345678"

Response

Conversatie succesvol aangemaakt

conversation_id
string<uuid>
required

Unieke identifier van de aangemaakte conversatie

Example:

"5fc020e6-d603-4069-890e-a231c8e9003c"

contact_id
string<uuid>
required

Unieke identifier van het contact

Example:

"c428c263-a1d3-4072-bf64-525cefbfb0b1"