Skip to main content
Webhooks senden Daten von telli in Echtzeit an deine Systeme. Sobald während eines Anrufs etwas passiert, schickt telli eine POST-Anfrage an den Endpoint, den du konfiguriert hast. So aktualisierst du CRM-Einträge, qualifizierst Leads und stößt Follow-ups an, ohne die API abfragen zu müssen. Ein Endpoint kann alle Event-Typen empfangen. Für die meisten Integrationen genügt deshalb eine einzige URL.

Events

Jede Event-Seite dokumentiert die vollständige Payload Feld für Feld.

Voraussetzungen

  • Ein telli-Konto mit API-Zugriff
  • Eine Endpoint-URL, die POST-Anfragen annimmt, entweder von deinem eigenen Dienst oder von einer Automatisierungsplattform wie Zapier, Make oder n8n

Endpoint hinzufügen

1

Endpoint anlegen

Lege in deinem eigenen Dienst oder deiner Automatisierungsplattform eine URL an, die POST-Anfragen annimmt, und kopiere sie.
2

Webhook-Portal öffnen

Gehe in telli zu Einstellungen > Entwickler und klicke unter Webhook-Konfiguration auf Konfigurieren.Das Webhook-Konfigurationsfenster in den telli-Entwicklereinstellungen
3

URL hinzufügen

Klicke auf Add Endpoint, füge deine URL ein und klicke auf Add.Das Formular für einen neuen Endpoint mit URL-Feld und Event-Auswahl
4

Events auswählen

Aktiviere die Events, die dieser Endpoint empfangen soll. Du kannst alle aktiviert lassen — dein Handler kann anhand des Felds event verzweigen.
5

Testen

Starte einen Testanruf aus deinem telli-Konto. Prüfe anschließend im Webhook-Portal, ob die Nachricht zugestellt wurde und dein System wie erwartet reagiert hat.

Nachrichten bestätigen

Gib innerhalb von 15 Sekunden einen 2xx-Statuscode (200–299) zurück, damit eine Nachricht als verarbeitet gilt. Alles andere — ein Fehlerstatus, ein Timeout, eine abgebrochene Verbindung — zählt als Fehlschlag, und die Nachricht wird erneut zugestellt. Wenn deine Verarbeitung länger als 15 Sekunden dauert, bestätige die Nachricht zuerst und erledige die Arbeit anschließend asynchron.
Deaktiviere den CSRF-Schutz für deinen Endpoint, sonst werden Webhook-POST-Anfragen abgewiesen, bevor dein Handler überhaupt läuft.

Signaturen verifizieren

Jede Nachricht ist signiert, damit du prüfen kannst, dass sie von telli stammt und nicht von jemandem, der an deine URL sendet. Die Verifizierung ist optional, wird in der Produktion aber empfohlen. Svix erklärt, warum du Webhooks verifizieren solltest. Dein Signatur-Secret findest du im Webhook-Portal unter Webhook-Konfiguration im telli-Dashboard.
Die Verifizierungsdokumentation von Svix enthält entsprechende Beispiele für Python, Go, Java, PHP und weitere Sprachen.

Erneute Zustellversuche

Fehlgeschlagene Zustellungen werden automatisch mit exponentiellem Backoff wiederholt. Jede Wartezeit beginnt, nachdem der vorherige Versuch fehlgeschlagen ist: Eine Nachricht, die dreimal fehlschlägt und dann ankommt, wird rund 35 Minuten und 5 Sekunden nach dem ersten Versuch zugestellt. Wenn ein Endpoint entfernt oder deaktiviert wird, werden auch seine ausstehenden Zustellversuche eingestellt. Du kannst jede Nachricht außerdem jederzeit manuell über das Webhook-Portal erneut senden oder mit Recover alle fehlgeschlagenen Nachrichten ab einem bestimmten Datum wiederholen.