> ## 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

> Referenz für die Webhook-Events, die telli bei Änderungen an Anrufen und Kontaktstatus sendet.

Webhooks senden Echtzeit-Event-Daten von telli an deine Systeme. Gehe zu **Einstellungen > Entwickler**, klicke unter **Webhook-Konfiguration** auf **Konfigurieren** und füge anschließend einen Endpunkt hinzu. Wähle dann die Events aus, die der Endpunkt empfangen soll.

Informationen zur Einrichtung von Endpunkten, zur Signaturprüfung und zu erneuten Zustellversuchen findest du unter [Anrufdaten empfangen](/de/receive-call-data).

## Events

### Anruf beendet

Das Event `call_ended` wird gesendet, wenn ein Anruf endet. Es enthält den Anrufstatus, das Transkript, die Analyse, das Ergebnis, erfasste Daten und den zugehörigen Kontakt.

```json theme={null}
{
  "event": "call_ended",
  "call": {
    "ended_reason": "contact-ended-call",
    "call_id": "b4a05730-2abc-4eb0-8066-2e4d23b53ba9",
    "loop_id": "ba99c99d-19b9-4a0d-8df6-3e213088989a",
    "attempt": 1,
    "from_number": "+17755719467",
    "direction": "outbound",
    "to_number": "+14155552671",
    "external_contact_id": "123456789",
    "contact_id": "6bd1e7e0-6d00-4c0b-ad5b-daa72457a27d",
    "contact_details": {
      "company": "Art Studio Inc"
    },
    "contact_properties": [],
    "agent_id": "d8931604-92ad-45cf-9071-d9cd2afbad0c",
    "triggered_at": 1731956924302,
    "triggered_at_iso": "2024-11-18T15:08:44.302Z",
    "started_at": 1731956932264,
    "started_at_iso": "2024-11-18T15:08:52.264Z",
    "ended_at": 1731957002078,
    "ended_at_iso": "2024-11-18T15:10:02.078Z",
    "call_length_min": 2,
    "call_length_sec": 69,
    "call_status": "COMPLETED",
    "transcript": "Agent: Hello...",
    "transcriptObject": [
      {
        "content": "Hello...",
        "role": "agent"
      }
    ],
    "call_analysis": {
      "summary": {
        "value": true,
        "details": "The customer is interested in buying an ice cream machine."
      }
    },
    "call_outcome": null,
    "collected_data": {
      "email": {
        "status": "confirmed",
        "value": "charlie@example.com"
      }
    },
    "booked_slot_for": null,
    "recording_url": "https://example.com/recording.wav",
    "sip_status_code": 200,
    "sip_status": "OK"
  },
  "contact": {
    "contact_id": "6bd1e7e0-6d00-4c0b-ad5b-daa72457a27d",
    "external_contact_id": "123456789",
    "external_url": null,
    "created_at": "2024-11-18T15:00:00.000Z",
    "gender": null,
    "first_name": "Charlie",
    "last_name": "Doe",
    "phone_number": "+14155552671",
    "in_call_since": null,
    "reached_at": "2024-11-18T15:08:52.264Z",
    "contact_details": {
      "company": "Art Studio Inc"
    },
    "call_attempts": 1,
    "next_call_at": null,
    "email": "charlie@example.com",
    "timezone": "America/Los_Angeles",
    "salutation": "Ms.",
    "status": "reached",
    "properties": []
  }
}
```

Unter [Anrufdaten empfangen](/de/receive-call-data#call-ended-event) findest du weitere Informationen zu Anrufstatus, Analyse, Ergebnissen und erfassten Daten.

### Auto-Dialer-Status geändert

Das Event `auto_dialer_status_changed` wird gesendet, wenn ein Kontakt den Auto-Dialer betritt oder verlässt.

Das Feld `auto_dialer_status` hat einen der folgenden Werte:

* `in_dialer`: Der Kontakt ist in den Auto-Dialer eingetreten
* `not_in_dialer`: Der Kontakt hat den Auto-Dialer verlassen

Wenn ein Kontakt den Auto-Dialer verlässt, beschreibt `auto_dialer_exit_reason` den Grund. Das Feld ist `null`, wenn kein Austrittsgrund zutrifft.

```json theme={null}
{
  "event": "auto_dialer_status_changed",
  "contact": {
    "contact_id": "6bd1e7e0-6d00-4c0b-ad5b-daa72457a27d",
    "external_contact_id": "123456789",
    "auto_dialer_status": "not_in_dialer",
    "auto_dialer_status_updated_at": "2026-07-14T10:30:00.000Z",
    "auto_dialer_exit_reason": "manually-removed-from-dialer",
    "first_name": "Charlie",
    "last_name": "Doe",
    "phone_number": "+14155552671",
    "email": "charlie@example.com",
    "contact_details": {
      "company": "Art Studio Inc"
    },
    "properties": []
  }
}
```

### Kontaktstatus geändert

<Warning>Dieser Webhook ist veraltet und wird am 1. Juli 2027 entfernt.</Warning>

Das Event `contact_status_changed` wird gesendet, wenn sich der Status eines Kontakts ändert. Es enthält den neuen Status, den Änderungszeitpunkt und die zugehörigen Kontaktdaten.

Der Kontaktstatus kann `new`, `pending`, `closed` oder `reached` sein.

```json theme={null}
{
  "event": "contact_status_changed",
  "contact": {
    "contact_id": "6bd1e7e0-6d00-4c0b-ad5b-daa72457a27d",
    "external_contact_id": "123456789",
    "status": "reached",
    "status_updated_at": "2024-11-18T15:10:02.078Z",
    "reached_at": "2024-11-18T15:08:52.264Z",
    "first_name": "Charlie",
    "last_name": "Doe",
    "phone_number": "+14155552671",
    "email": "charlie@example.com",
    "contact_details": {
      "company": "Art Studio Inc"
    },
    "properties": []
  }
}
```

Unter [Anrufdaten empfangen](/de/receive-call-data#contact-status-changed-event) findest du weitere Informationen zu Kontaktstatus.
