Webhooks: Jeder Anruf landet in Ihrem System.

Nach der Anrufauswertung sendet Telofy eine signierte Nachricht an Ihre https-Adresse, in jedem Tarif und für alle oder einzelne Mitarbeiter.

Nichts wird abgetipptZusammenfassung, Anliegen und Termin kommen dort an, wo Sie sie brauchen.
Sicher erkennbarJede Nachricht ist signiert. Ihr System kann prüfen, dass sie von Telofy stammt.
Fehler gleicht Telofy ausIst Ihre Adresse kurz nicht erreichbar, versucht Telofy es bis zu fünfmal.

So richten Sie einen Webhook ein

Sie brauchen eine https-Adresse, die Nachrichten annimmt. Das kann ein Server von Ihnen sein oder ein Baustein in Zapier, Make oder n8n.

1.Empfangsadresse besorgenErzeugen Sie bei Ihrem Empfänger eine Adresse, die mit https:// beginnt. Telofy akzeptiert keine Adresse mit Zugangsdaten, keine Weiterleitung und keine internen Namen wie localhost.
2.Webhook anlegenIm Portal unter Integrationen > Webhooks die Adresse eintragen, die Ereignisse ankreuzen und bei Bedarf einen Mitarbeiter wählen. Mit „Webhook anlegen“ speichern.
3.Geheimnis sichernTelofy zeigt das Signatur-Geheimnis (whsec_…) nur einmal. Legen Sie es im Passwortmanager oder in den Einstellungen Ihres Servers ab.
4.Test-Ereignis sendenMit „Test-Ereignis senden“ schickt Telofy ein call.completed mit test: true. Höchstens einmal pro Minute und Webhook.
5.Zustellprotokoll lesenUnter dem Webhook zeigt das Portal die letzten 50 Zustellungen mit Status. So sehen Sie, ob Ihre Adresse mit 2xx geantwortet hat.

Die drei Ereignisse

EreignisWannWichtige Felder
call.completedNach jedem ausgewerteten AnrufcallId, summary, outcomeType, durationSeconds, employeeName
outcome.createdWenn ein Lead, Ticket, Termin oder eine Bestellung entstandoutcomeId, outcomeType, summary
appointment.createdZusätzlich, wenn das Anliegen ein Termin warrequestedTime, contactName, contactPhone

Jede Nachricht enthält außerdem callUrl, einen Link ins Portal. Ein Gesprächsprotokoll sendet Telofy nie mit.

Wann kommt die Nachricht?

Nach der Auswertung des Anrufs, nicht im Moment des Auflegens. Sie wird asynchron zugestellt. Planen Sie mit einigen Minuten Abstand und nicht mit „in Echtzeit“. Die Reihenfolge ist nicht garantiert.

Was Ihre Adresse leisten muss

  • Mit Status 2xx antworten, innerhalb von 10 Sekunden.
  • Nicht weiterleiten. Redirects werden nicht verfolgt.
  • Bei Wiederholungen mit denselben Daten umgehen können: Telofy sendet bei Misserfolg bis zu fünfmal, mit 1, 5, 30 und 120 Minuten Pause. Entdoppeln Sie über callId oder outcomeId.

Beispiel-Nachrichten, Signaturprüfung mit Code für Node.js und Python und alle Details stehen unter Telofy für Entwickler. Ohne eigenen Server richten Sie den Empfang mit Zapier, Make oder n8n ein.

Häufige Fragen dazu.

Wie viele Webhooks kann ich anlegen?

Bis zu fünf je Betrieb. Jeder kann auf alle Mitarbeiter oder auf einen einzelnen gelten.

Was passiert, wenn meine Adresse nicht antwortet?

Telofy versucht es bis zu fünfmal, mit 1, 5, 30 und 120 Minuten Wartezeit dazwischen. Danach gilt die Zustellung als gescheitert. Im Zustellprotokoll sehen Sie das.

Kann ich vergangene Ereignisse erneut senden?

Nein. Es gibt nur das Test-Ereignis. Vergangene Anrufe holen Sie über die Schnittstelle ab.

Hören Sie ihn, bevor Sie sich entscheiden.

Ein Klick, kein Formular, keine Anmeldung.