API Documentație —sem.chat|REST API pentru dezvoltatori

Noțiuni de bază

sem.chat API vă permite să gestionați programatic conversațiile, să trimiteți mesaje și să accesați analize. Toate cererile API necesită autentificare folosind o cheie API.

Adresa URL de bază

https://api.sem.chat/v1

Autentificare

Includeți cheia API în antetul de autorizare al tuturor solicitărilor:

Authorization: Bearer your_api_key_here

Conversații

Lista conversații

GET /conversations

Preluați o listă cu toate conversațiile pentru contul dvs.

Parametru	Tip	Descriere
limită	întreg	Numărul de rezultate de returnat (maximum 100)
offset	întreg	Numărul de rezultate de ignorat
starea	şir	Filtrați după stare: activ, închis, în așteptare

Obțineți conversație

GET /conversations/{id}

Preluați detaliile unei anumite conversații, inclusiv toate mesajele.

Creați o conversație

POST /conversations

Începeți o conversație nouă în mod programatic.

Mesaje

Trimite mesaj

POST /conversations/{id}/messages

Trimiteți un mesaj unei conversații existente.

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

Webhook-uri

Configurați webhook-uri pentru a primi notificări în timp real despre evenimentele de conversație.

Evenimente disponibile

Eveniment	Descriere
conversația.începută	O nouă conversație a fost inițiată
mesaj.primit	A fost primit un mesaj nou de la un vizitator
conversatie.inchis	O conversație a fost închisă
plumb.capturat	Au fost colectate informații de contact

Limite de rate

Solicitările API sunt limitate pentru a asigura o utilizare corectă:

Plan	Limită de rată
Proces	100 cereri/oră
Pro	1.000 de cereri/oră
Afaceri	10.000 de cereri/oră