> ## Documentation Index
> Fetch the complete documentation index at: https://docs.telli.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Webhooks
> Empfange Anrufergebnisse, Transkripte und Analysen in Echtzeit in deinen eigenen Systemen
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
| Event | Wird gesendet, wenn |
| ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------ |
| [`call_ended`](/de/webhooks/events/call-ended) | Ein Anruf einen Endzustand erreicht hat und die Analyse gelaufen ist |
| [`auto_dialer_status_changed`](/de/webhooks/events/auto-dialer-status-changed) | Ein Kontakt den Auto-Dialer betritt oder verlässt |
| [`contact_status_changed`](/de/webhooks/events/contact-status-changed) | Sich der Status eines Kontakts ändert. Veraltet, wird am 1. Juli 2027 entfernt |
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](/de/integrations/zapier), [Make](/de/integrations/make) oder [n8n](/de/integrations/n8n)
## Endpoint hinzufügen
Lege in deinem eigenen Dienst oder deiner Automatisierungsplattform eine URL an, die POST-Anfragen annimmt, und kopiere sie.
Gehe in telli zu **Einstellungen > Entwickler** und klicke unter **Webhook-Konfiguration** auf **Konfigurieren**.
Klicke auf **Add Endpoint**, füge deine URL ein und klicke auf **Add**.
Aktiviere die Events, die dieser Endpoint empfangen soll. Du kannst alle aktiviert lassen — dein Handler kann anhand des Felds `event` verzweigen.
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](https://docs.svix.com/receiving/verifying-payloads/why).
Dein Signatur-Secret findest du im Webhook-Portal unter **Webhook-Konfiguration** im telli-Dashboard.
```javascript theme={null}
import { Webhook } from "svix";
// Kopiere dies aus der Webhook-Konfiguration im telli-Dashboard
const secret = "whsec_GET_THIS_FROM_THE_DASHBOARD";
// Diese Header kommen mit jeder Webhook-Nachricht
const headers = {
"svix-id": "msg_p5jXN8AQM9LWM0D4loKWxJek",
"svix-timestamp": "1614265330",
"svix-signature": "v1,g0hM9SsE+OTPJTGt/tmIKtSyZlE3uFJELVlNIOLJ1OE=",
};
// Der rohe, nicht geparste Request-Body
const body = '{"test": 2432232314}';
const wh = new Webhook(secret);
// Wirft bei einem Fehler, gibt bei Erfolg die verifizierte Payload zurück
const payload = wh.verify(body, headers);
```
Die [Verifizierungsdokumentation von Svix](https://docs.svix.com/receiving/verifying-payloads/how) 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:
| Versuch | Wartezeit nach dem vorherigen Fehlschlag |
| ------- | ---------------------------------------- |
| 1 | Sofort |
| 2 | 5 Sekunden |
| 3 | 5 Minuten |
| 4 | 30 Minuten |
| 5 | 2 Stunden |
| 6 | 5 Stunden |
| 7 | 10 Stunden |
| 8 | 10 Stunden |
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.