API-documentatie — sem.chat | REST API voor ontwikkelaars

Aan de slag

Met de sem.chat API kunt u programmatisch gesprekken beheren, berichten verzenden en toegang krijgen analyses. Alle API-verzoeken vereisen authenticatie met behulp van een API-sleutel.

Basis-URL

https://api.sem.chat/v1

Authenticatie

Neem uw API-sleutel op in de autorisatieheader van alle verzoeken:

Authorization: Bearer your_api_key_here

Gesprekken

Geef gesprekken weer

GET /gesprekken

Haal een lijst op met alle gesprekken voor uw account.

Parameter	Type	Beschrijving
limiet	geheel getal	Aantal te retourneren resultaten (max. 100)
verschuiving	geheel getal	Aantal resultaten dat moet worden overgeslagen
-status	tekenreeks	Filter op status: actief, gesloten, in behandeling

Ontvang een gesprek

GET /gesprekken/{id}

Haal details op van een specifiek gesprek, inclusief alle berichten.

Creëer een gesprek

POST /gesprekken

Start programmatisch een nieuw gesprek.

Berichten

Bericht verzenden

POST /conversaties/{id}/berichten

Stuur een bericht naar een bestaand gesprek.

// Example request body
{
  "content": "Hello, how can I help you today?",
  "sender": "agent"
}

Webhooks

Stel webhooks in om realtime meldingen over gespreksgebeurtenissen te ontvangen.

Beschikbare evenementen

Evenement	Beschrijving
gesprek.gestart	Er is een nieuw gesprek gestart
bericht ontvangen	Er is een nieuw bericht ontvangen van een bezoeker
gesprek.gesloten	Een gesprek is gesloten
voorsprong vastgelegd	Contactgegevens zijn verzameld

Tarieflimieten

API-verzoeken zijn beperkt om eerlijk gebruik te garanderen:

Plan	Tarieflimiet
Proefperiode	100 verzoeken/uur
Pro	1.000 verzoeken/uur
Zakelijk	10.000 verzoeken/uur