> ## Documentation Index
> Fetch the complete documentation index at: https://docs.phonelabs.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Inbound webhook

# Inbound Webhook

Ein Inbound Webhook lädt Informationen, bevor der Assistent mit dem Anrufer spricht. Das ist hilfreich, wenn der Assistent abhängig vom Anrufer unterschiedlich reagieren soll.

## Typische Fälle

* Anrufer als Bestandskunde erkennen
* zuständige Filiale bestimmen
* offene Anfrage erkennen
* VIP-Hinweis setzen
* Kundentyp an den Assistenten übergeben

## Wann du keinen Inbound Webhook brauchst

Wenn der Assistent alle Anrufer gleich behandeln kann, brauchst du keinen Inbound Webhook. Starte dann lieber ohne externe Abhängigkeit.

## Ablauf planen

Beschreibe zuerst, welche Information vor dem Gespräch wirklich benötigt wird.

Beispiel:

```text theme={null}
Wenn die Telefonnummer bekannt ist, soll der Assistent den Kundennamen und die zuständige Filiale kennen. Er darf aber keine internen Daten nennen.
```

## Einrichtung

1. Öffne den Assistenten.
2. Öffne `Webhooks`.
3. Aktiviere den Pre-Call- oder Inbound-Kontext.
4. Trage die Zieladresse ein.
5. Konfiguriere Authentifizierung, falls nötig.
6. Lege fest, welche Daten erwartet werden.
7. Teste mit einer bekannten Telefonnummer.
8. Führe einen echten Testanruf durch.

## Gute Antwortdaten

Sende nur Gesprächskontext.

Geeignet:

* Name
* Kundentyp
* zuständige Filiale
* offene Vorgangsnummer
* Hinweis, ob Rückruf bevorzugt ist

Nicht geeignet:

* Zahlungsdaten
* vertrauliche Notizen
* lange Historien
* komplette Datensätze
* Zugangsdaten

## Prompt-Regel ergänzen

Der Assistent muss wissen, wie er mit dem Kontext umgehen soll.

```text theme={null}
Wenn Kundendaten aus dem Inbound Webhook vorhanden sind, nutze sie zur Einordnung. Gib keine internen Informationen preis. Wenn keine Daten vorhanden sind, führe das Gespräch normal.
```

## Fehlerfall

Der Assistent sollte auch ohne Inbound-Daten funktionieren. Plane immer einen Fallback.

Gute Fallback-Regel:

```text theme={null}
Wenn keine Kundendaten verfügbar sind, frage normal nach Name und Anliegen.
```

## Testcheck

* bekannter Anrufer wird erkannt
* unbekannter Anrufer funktioniert trotzdem
* der Assistent nennt keine internen Daten
* Fehler im externen System blockiert den Anruf nicht unnötig
