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.

3
URL hinzufügen
Klicke auf Add Endpoint, füge deine URL ein und klicke auf Add.

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.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.Node.js-Beispiel
Node.js-Beispiel
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.

