Che cos'è un webhook
Un webhook è una chiamata che un sistema fa a un altro quando succede qualcosa: invece di chiedere ogni minuto «ci sono novità?», il vostro gestionale riceve subito un messaggio con i dati. Le API sono il contrario: è il vostro sistema a chiedere o a fare qualcosa.
Le API
Con le API il vostro gestionale o CRM può:
- creare e aggiornare i canali di un'azienda e le persone che ci lavorano;
- leggere le conversazioni e mandare messaggi, anche su WhatsApp;
- cambiare lo stato di una conversazione (aperta, risolta).
I webhook
Il vostro sistema riceve un evento quando:
- arriva o parte un messaggio (
messaggio.creato); - una conversazione si apre o si risolve (
conversazione.stato); - un operatore chiede di aprire un ticket (
ticket.richiesto); - arriva un messaggio WhatsApp (
whatsapp.entrata); - l'agente AI ha raccolto una richiesta (
lead.creato).
Sicurezza
Ogni chiamata, nei due sensi, è firmata con HMAC-SHA256 su ora, metodo, percorso e corpo, e vale pochi minuti: chi non ha il segreto non può né chiamare le API né fingere un evento. Le consegne non riuscite si riprovano da sole.
Come si attiva
L'accesso lo attiviamo noi per il vostro sistema, con un codice e un segreto. Il collegamento con gestire.it è già pronto e usa le stesse API.
Domande frequenti
Che cos'è un webhook?
Una chiamata che Segretario.it fa al vostro sistema quando succede qualcosa, invece di aspettare che sia lui a chiedere.
Come si ottiene l'accesso?
Lo attiviamo noi: il vostro sistema riceve un codice e un segreto per firmare le chiamate.
Se il mio sistema è giù?
Le consegne non riuscite si riprovano da sole più volte.

WhatsApp Business API
Casella unica dei messaggi
Sviluppatori software
gestire.it
richieste.it
Google Tag Manager
Caselle email
WhatsApp per il team
Campagne di messaggi
Falegnami
Giardinieri