Berichten sturen via de API

Met de Chat API stuur je vanuit je eigen code een bericht naar je bot en lees je het antwoord uit, hetzelfde brein als de widget, maar zonder de interface. Handig voor een eigen chat-UI, een mobiele app of een backend die gewoon een antwoord nodig heeft.

Een request maken

POST naar /api/v1/chat met je API key als Bearer-token. De body heeft de bot_id en het message van de bezoeker nodig. Geef een session_id mee om een gesprek voort te zetten; laat je die weg, dan krijg je een nieuwe terug.

curl https://ovellan.com/api/v1/chat \
  -H "Authorization: Bearer awk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"bot_id":"YOUR_BOT_ID","message":"What are your opening hours?"}'

De response lezen

Je krijgt de response-tekst terug, de sources die zijn gebruikt (elk een titel en URL) en een session_id. Geef die session_id mee in je volgende call en de bot onthoudt het gesprek. Antwoorden komen als één JSON-body, niet gestreamd, en productkaarten en knoppen krijg je alleen via de widget, niet via dit endpoint.

Abonnement en limieten

• Beschikbaar op de Business- en Enterprise-abonnementen; andere abonnementen krijgen een 403.
• 30 requests per minuut en 1.000 per dag per key. Daarboven krijg je een 429 met een retry-after-header.
• Eén bericht mag maximaal 2.000 tekens zijn.