Benvenuto
Userbot mette a disposizione dei partner B2B un set di API pensate per collegare agenti AI conversazionali a CRM, ERP, portali clienti e sistemi interni — senza dover replicare la logica conversazionale nel proprio stack.
In pratica, la tua applicazione invia messaggi tramite la REST API e riceve tutte le risposte e gli aggiornamenti (messaggi bot e operatore, cambi di stato, variabili utente) tramite webhook in ingresso registrati in dashboard. Il modello è bidirezionale: tu controlli il flusso lato partner, Userbot si occupa dell’intelligenza conversazionale.
Prima integrazione end-to-end — webhook in dashboard, invio REST e ricezione risposte via message.added
Base URL, flusso REST + webhook e indice delle guide tecniche nella tab API Reference
Cosa puoi integrare
Le API coprono l’intero ciclo di vita di una conversazione: dall’avvio della chat alla chiusura, passando per l’escalation a un operatore umano e l’automazione di processi back-office.
Invia messaggi, leggi lo storico, aggiorna stato e variabili utente, archivia conversazioni — le risposte in UI arrivano via webhook
Ricevi notifiche push quando accadono eventi rilevanti: nuovi messaggi, sessioni create, cambi di stato e aggiornamenti variabili
Avvia flussi di automazione Userbot da sistemi esterni (ERP, ticketing, e-commerce) tramite webhook trigger
Bearer token, verifica HMAC sui webhook e linee guida per integrazioni enterprise production-ready
Come funziona l’integrazione
Il flusso tipico alterna chiamate REST (iniziate dal partner) e webhook (inviati da Userbot). Comprenderlo aiuta a progettare correttamente backend e UI.
- Invio messaggio — il backend partner chiama la REST API con Access Token, Secret Key (
bot_keynel path). Il messaggio dell’utente viene inoltrato all’Agente AI. - Ack REST — la risposta HTTP conferma l’accettazione e restituisce il
sessionID. Non usarla per popolare la UI chat. - Risposte via webhook — tutti i messaggi dell’agente (e, dopo escalation, dell’operatore) arrivano come eventi
message.addedsul webhook registrato in dashboard. - Verifica e conferma — il server verifica la firma HMAC di ogni webhook e risponde con status 200 entro 5 secondi.
Per un esempio concreto end-to-end, segui il Quickstart o il Tutorial: prima integrazione.
Prima di iniziare
Per integrare le API serve un account Userbot con almeno un Agente AI configurato. Se non hai ancora accesso, consulta la pagina Supporto partner.
Prima di scrivere codice, assicurati di avere questi elementi a disposizione:
- Account e Agente AI — segui la guida Setup e accesso a Userbot nell’Help Center per creare l’account e configurare il primo agente
- Access Token e Secret Key — il token si genera dalla dashboard (Autenticazione); la Secret Key si trova in Integrazioni → API Keys (parametro
bot_keynel path REST) - Webhook in dashboard — endpoint HTTPS pubblico registrato in piattaforma (Ricevere eventi webhook)
- Base URL — tutte le chiamate REST vanno inviate a
https://api.userbot.ai(HTTPS obbligatorio, payload JSON)
Dove trovare cosa
La documentazione Userbot è organizzata per pubblico e obiettivo. Se cerchi dettagli su endpoint e payload, resta qui; se devi configurare flussi o canali in piattaforma, vai all’Help Center.
Prossimi passi
Scegli il percorso in base a quanto conosci già Userbot e al tipo di integrazione che vuoi costruire.