API Dokumentation —sem.chat|REST API för utvecklare

Komma igång

sem.chat API låter dig hantera konversationer programmatiskt, skicka meddelanden och få tillgång till analyser. Alla API-förfrågningar kräver autentisering med en API-nyckel.

Bas-URL

https://api.sem.chat/v1

Autentisering

Inkludera din API-nyckel i auktoriseringshuvudet för alla förfrågningar:

Authorization: Bearer your_api_key_here

Konversationer

Lista konversationer

GET /conversations

Hämta en lista över alla konversationer för ditt konto.

Parameter	Typ	Beskrivning
gräns	heltal	Antal resultat att returnera (max 100)
offset	heltal	Antal resultat att hoppa över
status	sträng	Filtrera efter status: aktiv, stängd, väntande

Få konversation

GET /conversations/{id}

Hämta information om en specifik konversation inklusive alla meddelanden.

Skapa konversation

POST /conversations

Starta en ny konversation programmatiskt.

Meddelanden

Skicka meddelande

POST /conversations/{id}/messages

Skicka ett meddelande till en befintlig konversation.

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

Webhooks

Ställ in webhooks för att ta emot aviseringar i realtid om konversationshändelser.

Tillgängliga händelser

Händelse	Beskrivning
konversation.startade	En ny konversation har inletts
meddelande.mottaget	Ett nytt meddelande mottogs från en besökare
konversation.stängd	En konversation har stängts
lead.captured	Kontaktinformation har samlats in

Prisgränser

API-förfrågningar är begränsade för att säkerställa rättvis användning:

Plan	Takstgräns
Provperiod	100 förfrågningar/timme
Pro	1 000 förfrågningar/timme
Företag	10 000 förfrågningar/timme