I webhook di Sayelo, agente vocale IA, inviano ogni chiamata gestita al suo CRM, al suo strumento di ticketing o alla sua pianificazione: riepilogo, analisi e scheda contatto, senza reinserimenti. Sono inclusi nei 4 piani, da 39 €/mese IVA esclusa, si configurano in 2 minuti e ogni invio è firmato HMAC-SHA256.
POST https://votre-logiciel.fr/webhooks/sayelo
X-Sayelo-Event: call.completed
X-Sayelo-Delivery: dlv_9f2c47e1a8b3
X-Sayelo-Signature: sha256=1e0e6a…
{
"event": "call.completed",
"call": {
"duration_seconds": 154,
"from": "+33 6 12 34 56 78",
"outcome": "Rendez-vous pris",
"agent": "Accueil — Cabinet Vernet"
},
"contact": {
"first_name": "Marie",
"last_name": "Lefèvre",
"company": "Lefèvre Immobilier"
},
"summary": "Marie Lefèvre souhaitait déplacer son
rendez-vous de jeudi. Créneau de vendredi
10 h 30 proposé, confirmé et enregistré.",
"analysis": {
"key_points": ["Report de rendez-vous"],
"actions": ["Confirmer la salle 2 vendredi"],
"sentiment": "positif"
}
} Configurazione
Nell'app: «Account» → «Webhook», aggiunga un webhook. Incolli l'URL del suo software e scelga gli eventi. Il segreto di firma viene generato automaticamente.
Il pulsante «Invia un test» verifica subito la connessione. Un registro mostra gli ultimi 20 invii: stato, codice HTTP, data.
Ogni chiamata gestita arriva nel suo strumento. Deve sospendere un agente? In «Account» → «Webhook», il suo interruttore interrompe la trasmissione delle sue chiamate senza toccare le altre.
Casi d'uso
Un cliente segnala un problema al telefono? L'evento message.taken crea il ticket nel suo strumento, con il riepilogo e i recapiti.
Ogni conversazione si aggiunge alla scheda cliente: riepilogo, punti chiave, azioni da fare. Lo storico commerciale si costruisce da solo.
I «mi richiami» diventano attività nel suo strumento di monitoraggio, invece di restare in una casella di posta.
Riferimento
Due eventi coprono il ciclo di vita di una chiamata. Lei sceglie quali ricevere, webhook per webhook.
| Evento | Emesso quando… |
|---|---|
call.completed | Una chiamata è stata gestita dall'agente, con la sua durata, il suo esito, il riepilogo e l'analisi. |
message.taken | L'agente ha preso un messaggio o una richiesta di richiamata. Ideale per creare ticket. |
Ogni invio è un POST JSON che contiene le informazioni della chiamata (durata, numero, esito, agente), la scheda contatto della rubrica (cognome, nome, azienda), il riepilogo della conversazione, l'analisi strutturata (punti chiave, azioni da fare, sentiment) e un link diretto alla scheda della chiamata nell'app, dove si trovano la trascrizione e la registrazione.
Lo schema qui sopra è un esempio illustrativo: il modo più semplice per vedere il formato esatto inviato al suo software è il pulsante «Invia un test».
| Intestazione | Ruolo |
|---|---|
X-Sayelo-Event | Il tipo di evento: call.completed o message.taken. |
X-Sayelo-Delivery | L'identificativo univoco dell'invio. Resta identico in caso di nuovo invio: ignori gli identificativi già elaborati per evitare i doppioni. |
X-Sayelo-Signature | La firma HMAC-SHA256 del corpo della richiesta, calcolata con il suo segreto (sha256=…). |
Sicurezza
Ogni richiesta è firmata HMAC-SHA256 con il segreto generato alla creazione del webhook. Ricalcolando la firma lato ricevente, ha la garanzia che l'invio provenga da Sayelo e che il corpo non sia stato alterato.
L'audio e la trascrizione non transitano mai attraverso il webhook: il payload contiene un link alla scheda della chiamata nell'app, dove restano consultabili.
// Node.js — vérifier la signature
const crypto = require("crypto");
function vientDeSayelo(corpsBrut, signature, secret) {
const attendu = "sha256=" + crypto
.createHmac("sha256", secret)
.update(corpsBrut, "utf8")
.digest("hex");
return crypto.timingSafeEqual(
Buffer.from(attendu),
Buffer.from(signature)
);
} Affidabilità
In caso di invio non riuscito, Sayelo ripete automaticamente la richiesta dopo 2 minuti, 10 minuti, 30 minuti e poi 2 ore: cinque tentativi in tutto. L'intestazione X-Sayelo-Delivery resta identica da un tentativo all'altro: il suo ricevente può ignorare un invio già elaborato, nessun doppione possibile. Il registro degli ultimi 20 invii, nell'app, mostra lo stato e il codice HTTP di ogni tentativo.
I webhook in uscita sono inclusi in tutti i piani a pagamento.
Due minuti di configurazione, un test immediato, e ogni chiamata gestita arriva nel suo software di settore.
Provi gratis per 14 giorni →
Un piccolo aiuto per Sayelo?
Con il suo consenso, alcuni cookie misurano l'audience del sito e l'efficacia dei nostri annunci (Google, Meta), per mostrare Sayelo alle aziende che può aiutare. Modificabile in qualsiasi momento.