Vai al contenuto
Segretarioit Accedi

API e webhook: collegare il vostro gestionale

Un gestionale o un CRM si collega a Segretario.it con le API, per leggere le conversazioni e mandare messaggi, e riceve gli eventi con i webhook appena succede qualcosa.

Chat e messaggiWhatsApp
Due server collegati da un cavo con frecce nei due sensi e un lucchetto: API e webhook

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.

Lo vuoi provare con il tuo numero?

Ti mostriamo Segretario.it con i tuoi canali e lo prepariamo insieme a te: si parte da quello che serve.

Prodotti collegati

Settori collegati

Integrazioni collegati

Altro in integrazioni

Vedi anche