Die Webhooks von Sayelo, dem KI-Sprachagenten, senden jeden bearbeiteten Anruf an Ihr CRM, Ihr Ticketsystem oder Ihre Einsatzplanung: Zusammenfassung, Analyse und Kontaktdaten, ohne erneutes Abtippen. Sie sind in den 4 Tarifen enthalten, ab 39 € zzgl. MwSt./Monat, in 2 Minuten eingerichtet, und jede Übertragung ist mit HMAC-SHA256 signiert.
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"
}
} Einrichtung
In der App: Fügen Sie unter „Konto“ → „Webhooks“ einen Webhook hinzu. Fügen Sie die URL Ihrer Software ein und wählen Sie die Ereignisse. Das Signatur-Secret wird automatisch erzeugt.
Die Schaltfläche „Test senden“ prüft die Verbindung sofort. Ein Protokoll zeigt die letzten 20 Zustellungen: Status, HTTP-Code, Datum.
Jeder bearbeitete Anruf kommt in Ihrem Tool an. Sie möchten einen Agenten pausieren? Unter „Konto“ → „Webhooks“ stoppt sein Schalter die Übertragung seiner Anrufe, ohne die anderen zu berühren.
Anwendungsfälle
Ein Kunde meldet ein Problem telefonisch? Das Ereignis message.taken erstellt das Ticket in Ihrem Tool, mit Zusammenfassung und Kontaktdaten.
Jedes Gespräch landet im Kundendatensatz: Zusammenfassung, Kernpunkte, Aufgaben. Die Vertriebshistorie entsteht von selbst.
Die „Rufen Sie mich zurück“ werden zu Aufgaben in Ihrem Nachverfolgungstool, statt in einem E-Mail-Postfach liegen zu bleiben.
Referenz
Zwei Ereignisse decken den Lebenszyklus eines Anrufs ab. Sie wählen für jeden Webhook, welche Sie empfangen.
| Ereignis | Gesendet, wenn … |
|---|---|
call.completed | Ein Anruf wurde vom Agenten bearbeitet – mit Dauer, Ergebnis, Zusammenfassung und Analyse. |
message.taken | Der Agent hat eine Nachricht oder einen Rückrufwunsch aufgenommen. Ideal, um Tickets zu erstellen. |
Jede Zustellung ist ein POST JSON mit den Anrufdaten (Dauer, Nummer, Ergebnis, Agent), dem Kontaktdatensatz aus dem Adressbuch (Name, Vorname, Firma), der Zusammenfassung des Gesprächs, der strukturierten Analyse (Kernpunkte, Aufgaben, Stimmung) und einem direkten Link zum Anrufdatensatz in der App, wo Transkription und Aufzeichnung zu finden sind.
Das obige Schema ist ein veranschaulichendes Beispiel – am einfachsten sehen Sie das genaue Format, das an Ihre Software gesendet wird, mit der Schaltfläche „Test senden“.
| Header | Funktion |
|---|---|
X-Sayelo-Event | Der Ereignistyp: call.completed oder message.taken. |
X-Sayelo-Delivery | Die eindeutige Kennung der Zustellung. Sie bleibt bei einer erneuten Zustellung gleich: Ignorieren Sie bereits verarbeitete Kennungen, um Duplikate zu vermeiden. |
X-Sayelo-Signature | Die HMAC-SHA256-Signatur des Request-Bodys, berechnet mit Ihrem Secret (sha256=…). |
Sicherheit
Jede Anfrage ist mit HMAC-SHA256 signiert, mit dem Secret, das beim Anlegen des Webhooks erzeugt wurde. Wenn Sie die Signatur auf Empfängerseite neu berechnen, haben Sie die Gewissheit, dass die Übertragung von Sayelo stammt und der Body nicht verändert wurde.
Audio und Transkription laufen nie über den Webhook: Der Payload enthält einen Link zum Anrufdatensatz in der App, wo sie weiterhin abrufbar sind.
// 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)
);
} Zuverlässigkeit
Schlägt eine Zustellung fehl, sendet Sayelo die Anfrage automatisch nach 2 Minuten, 10 Minuten, 30 Minuten und dann nach 2 Stunden erneut – insgesamt fünf Versuche. Der Header X-Sayelo-Delivery bleibt von Versuch zu Versuch gleich: Ihr Empfänger kann eine bereits verarbeitete Zustellung ignorieren, Duplikate sind ausgeschlossen. Das Protokoll der letzten 20 Zustellungen in der App zeigt Status und HTTP-Code jedes Versuchs.
Die ausgehenden Webhooks sind in allen kostenpflichtigen Tarifen enthalten.
Zwei Minuten Einrichtung, ein sofortiger Test, und jeder bearbeitete Anruf landet in Ihrer Branchensoftware.
14 Tage kostenlos testen →
Eine kleine Unterstützung für Sayelo?
Mit Ihrer Zustimmung messen Cookies die Reichweite der Website und die Wirksamkeit unserer Anzeigen (Google, Meta), damit wir Sayelo den Unternehmen zeigen können, denen es helfen kann. Jederzeit änderbar.