Integra il tuo Assistente AI
in qualsiasi software
via API REST.
CRM, app mobile, strumento interno, portale clienti — se può fare una richiesta HTTP, può parlare con il tuo assistente. Il canale API è il modo più flessibile per incorporare AnyDialog nel tuo stack software esistente.
Cosa puó fare il tuo assistente via API
Il canale API è il più flessibile — sblocca ogni funzionalità AnyDialog da qualsiasi linguaggio o piattaforma.
Autenticazione basata su token
Ogni chiave API ha un prefisso (cs_live_*) e viene archiviata con hash. Passala nell'header X-API-Key. Più chiavi per assistente — ruota senza tempi di inattività.
Gestione delle sessioni
Passa un session_id per mantenere il contesto della conversazione tra più richieste. Le sessioni persistono tra le chiamate API — l'assistente ricorda cosa è stato detto.
Cronologia della conversazione
GET /v1/chat/{session}/history restituisce il log completo dei messaggi per qualsiasi sessione. Utile per visualizzare la cronologia della chat nella tua interfaccia.
Rate limiting
I limiti di velocità per chiave impediscono abusi. I limiti sono configurabili per piano. L'header X-RateLimit-Remaining ti dice quante richieste hai rimasto.
Monitoraggio dell'uso
Ogni chiamata API registra l'uso dei token, la latenza e la sessione a cui appartiene. Visualizza le analitiche per chiave nella tua dashboard AnyDialog.
Agnostico del linguaggio
L'API è REST+JSON semplice. Chiamala da Python, Node.js, PHP, Ruby, Go, Swift, Kotlin — qualsiasi linguaggio che può fare una richiesta HTTP.
Configurazione in 5 minuti
Nessuna configurazione di webhook necessaria. Genera una chiave e inizia a chiamare l'API.
Genera una chiave API
1 minNelle impostazioni del tuo assistente, vai a Integrazioni, sezione API. Fai click su Genera chiave API. Copia la chiave immediatamente — viene mostrata solo una volta. Salvala in modo sicuro.
Invia la tua prima richiesta
2 minUsa la chiave API nell'header X-API-Key o come token Bearer. POST a /api/v1/chat con il tuo messaggio. L'assistente risponde con la risposta AI.
Gestisci le sessioni
1 minCrea sessioni con POST /api/v1/chat/session. Recupera la cronologia con GET /api/v1/chat/{session}/history. Ogni sessione mantiene il contesto della conversazione.
Tre endpoint, controllo completo
L'API è intenzionalmente minimalista. Tre endpoint coprono ogni caso di uso.
/v1/chat
Invia un messaggio e ricevi una risposta. Supporta session_id per conversazioni multi-turno.
/v1/chat/{session}/history
Recupera la cronologia completa della conversazione per una sessione — tutti i messaggi, timestamp e conteggi dei token.
/v1/chat/session
Crea una nuova sessione esplicitamente e ottieni un session_id. Opzionale — puoi anche far creare le sessioni implicitamente al primo messaggio.
Da sapere
Note oneste per gli sviluppatori che si integrano via API.
-
I rate limit si applicano per chiave API. Ogni chiave ha un limite di velocità configurabile (richieste al minuto). Se lo superi, ricevi una risposta 429. Monitora X-RateLimit-Remaining negli header di risposta.
-
Nessun supporto WebSocket — solo REST. L'API è HTTP/REST. Non c'è attualmente un endpoint WebSocket o streaming. Le risposte vengono restituite come un singolo oggetto JSON, non trasmesso token per token.
-
Scadenza della sessione dopo inattività. Le sessioni che non ricevono messaggi per 24 ore sono considerate terminate. Un nuovo messaggio con lo stesso session_id inizierà da capo. Archivia la cronologia della conversazione lato client se hai bisogno di una persistenza più lunga.
-
L'assistente deve essere pubblicato. Un assistente in modalità bozza non risponderà alle richieste API. Assicurati di pubblicare il tuo assistente dall'area di lavoro prima di andare live con la tua integrazione.
Funziona con
Il canale API sblocca ogni funzionalità AnyDialog — è il percorso di integrazione più completo.
Risposte accurate
Ogni risposta basata sulla tua knowledge base — nessuna allucinazione.
Cattura di lead
Cattura i lead a livello di programmazione — i dati fluiscono direttamente nel tuo CRM.
Azioni intelligenti
Attiva flussi di lavoro e integrazioni dalle conversazioni guidate da API.
Strategia di conversazione
I flussi di strategia si applicano alle conversazioni API esattamente come negli altri canali.
Il tuo assistente. All'interno di qualsiasi software.
Tre endpoint. Cinque minuti.
Ottieni gratuitamente la tua chiave API e inizia a costruire. Nessuna carta di credito richiesta.