Documentazione API — sem.chat | API REST per sviluppatori

Per iniziare

L'API sem.chat ti consente di gestire in modo programmatico le conversazioni, inviare messaggi e accedere analitica. Tutte le richieste API richiedono l'autenticazione tramite una chiave API.

URL di base

https://api.sem.chat/v1

Autenticazione

Includi la tua chiave API nell'intestazione Autorizzazione di tutte le richieste:

Authorization: Bearer your_api_key_here

Conversazioni

Elenca conversazioni

GET /conversazioni

Recupera un elenco di tutte le conversazioni per il tuo account.

Parametro	Digita	Descrizione
limite	intero	Numero di risultati da restituire (max 100)
scostamento	intero	Numero di risultati da saltare Stato
	stringa	Filtra per stato: attivo, chiuso, in sospeso

Ricevi conversazione

GET /conversazioni/{id}

Recupera i dettagli di una conversazione specifica inclusi tutti i messaggi.

Crea conversazione

POST /conversazioni

Avvia una nuova conversazione in modo programmatico.

Messaggi

Invia messaggio

POST /conversazioni/{id}/messaggi

Invia un messaggio a una conversazione esistente.

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

Webhook

Configura webhook per ricevere notifiche in tempo reale sugli eventi di conversazione.

Eventi disponibili

Evento	Descrizione
conversazione.avviata	È stata avviata una nuova conversazione
messaggio.ricevuto	È stato ricevuto un nuovo messaggio da un visitatore
conversazione.chiusa	Una conversazione è stata chiusa
lead.catturato	Le informazioni di contatto sono state raccolte

Limiti di velocità

Le richieste API sono limitate per garantire un utilizzo corretto:

Piano	Limite di velocità
Prova	100 richieste/ora
Professionista	1.000 richieste/ora
Affari	10.000 richieste/ora