Report e integrazioni
I webhook avvisano i tuoi sistemi quando succede qualcosa al telefono: una chiamata in coda, una risposta, un esito, un operatore in pausa. Le API ti permettono di caricare lead, gestire la rubrica e far partire chiamate dai tuoi programmi.
{ "id": "evt_7Hq2kLm9Xa", "type": "queue.call_answered", "createdAt": "2026-10-05T09:41:12.000Z", "data": { "call": { "from": "+393331234567", "waitSeconds": 42 }, "contact": { "name": "Mario Bianchi" }, "queue": { "id": 100000346, "name": "Assistenza clienti" }, "operator": { "extension": "202", "name": "Laura Verdi" } }}
Un webhook è una richiesta che il centralino invia a un tuo indirizzo nel momento in cui succede qualcosa. Con i webhook di Robottino il tuo CRM, il gestionale o uno strumento di automazione sa subito che è arrivata una chiamata, che un operatore ha risposto, che il cliente ha lasciato un voto o ha chiesto di essere richiamato. Non serve controllare a mano.
Scegli tu gli eventi, tra 27 divisi in sette gruppi: chiamate, code, operatori, risponditore IVR, feedback, callback e chat interna. Puoi limitarli ad alcune code, operatori, numerazioni o menu IVR, e decidere se inviare l'evento completo o solo i campi che servono al tuo sistema, con i nomi che vuoi.
Ogni invio è firmato, così il tuo sistema verifica che arrivi davvero dal centralino. Se il tuo indirizzo non risponde, l'invio viene ritentato più volte; nella scheda Consegne vedi richiesta e risposta di ogni tentativo e puoi reinviare un evento con un clic.
Nell'altra direzione ci sono le API pubbliche: con una chiave API i tuoi programmi leggono e creano lead e liste, cercano e aggiornano i contatti della rubrica, avviano o mettono in pausa le campagne, leggono lo storico chiamate e fanno partire una chiamata click-to-call dal telefono di un operatore.
Con l'evento «Squilla una chiamata all'operatore» il CRM riceve numero del chiamante, coda e interno dell'operatore, e può aprire la scheda giusta prima che l'operatore risponda. Con i campi personalizzati dell'operatore invii anche il suo ID nel CRM.
Quando l'operatore salva o cambia l'esito di una chiamata, l'evento arriva al gestionale con nome dell'esito, nota e data di richiamo. Se ti interessano solo le vendite, scegli l'evento di conversione: parte solo per gli esiti segnati come conversione.
L'evento «chiamata persa» o «abbandonata in coda» può far partire un messaggio in Slack, un ticket o un'attività di richiamata nel tuo strumento di automazione, con numero, coda e tempo di attesa.
Il modulo del tuo sito chiama le API e aggiunge il contatto a una lista: la campagna di chiamate lo lavora subito. Con le API puoi anche leggere lo stato del lead, aggiornarlo o eliminarlo.
Il tuo gestionale chiama le API con l'operatore e il numero: squilla prima il telefono dell'operatore, poi parte la chiamata verso il cliente sulla sua linea in uscita. Nello storico chiamate trovi poi com'è andata.
Gli eventi di login, logout, pausa e ritorno disponibile, con la durata della pausa, alimentano il foglio presenze o il sistema paghe senza esportazioni manuali.
In Webhook premi Nuovo webhook, dai un nome e scrivi l'URL https del tuo sistema. Scegli il metodo (POST, PUT, PATCH o GET) e, se serve, aggiungi header come una chiave di autorizzazione.
Nella scheda Eventi spunti quando inviare, cercando per nome o per gruppo. Con «Solo per…» limiti gli eventi a certe code, operatori, numerazioni o menu IVR.
Nella scheda Contenuto scegli Evento completo, con tutti i dati già pronti, oppure Campi personalizzati: scrivi i nomi dei campi e i valori con le variabili come {{call.from}}. L'anteprima mostra il risultato con dati di esempio.
Con Prova invii subito una richiesta di esempio, anche se non hai ancora salvato, e vedi la risposta del tuo sistema, gli header e il comando cURL equivalente.
Nella scheda Consegne trovi ogni invio degli ultimi 30 giorni con esito, tempo e tentativi. Clicchi una riga per vedere richiesta e risposta, e con Reinvia rimetti in coda un evento.
Sono richieste HTTPS che il centralino invia al tuo sistema quando succede un evento, come una chiamata in coda, una risposta o un esito. Il tuo CRM le riceve in tempo reale, senza dover chiedere i dati di continuo.
27 eventi in sette gruppi: chiamate (in arrivo, chiusa, persa, limite raggiunto), code (entrata, risposta, abbandono, tempo scaduto, coda piena), operatori (login, logout, pausa, squillo, risposta, chiamate in uscita, trasferimento, esito, conversione), IVR, feedback, callback e chat interna.
Ogni richiesta ha l'header Robottino-Signature con un timestamp e una firma HMAC-SHA256 del testo «timestamp.body», calcolata con il segreto di firma del webhook. Il tuo sistema ricalcola la firma e la confronta.
L'invio viene ritentato dopo 1 minuto, 5 minuti, 30 minuti, 2 ore e 6 ore. Se per più di 3 giorni non riesce nessun invio, il webhook va in pausa e ricevi un'email. Dal registro delle consegne puoi reinviare gli eventi.
Sì. Con una chiave API gestisci campagne, liste, lead, rubrica e operatori, leggi lo storico chiamate e avvii chiamate click-to-call. La documentazione OpenAPI permette di provarle dal browser.
Sì, con un webhook verso l'indirizzo che ti dà lo strumento di automazione (per esempio il trigger «Catch Hook» di Zapier). Scegli gli eventi e, se vuoi, i campi personalizzati.
Registrati gratis e prova questa funzione con i tuoi numeri, oppure scrivici su WhatsApp e te la mostriamo noi.
