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

# WhatsApp-Anrufe

> Wie WhatsApp-Anrufe auf der Plattform funktionieren – Einrichtung und Produkt-UX

<Warning>
  Ausgehende WhatsApp-Anrufe sind ein Workspace-gegatetes Beta-Feature, nur in
  unterstützten Regionen verfügbar und benötigen die ausdrückliche Zustimmung
  des Empfängers. Multi-Channel-Kampagnen fordern diese automatisch an, zeigen
  den Lead als **Awaiting permission** und wählen erst nach einem signierten
  Grant-Webhook. Ablehnung oder Ablauf beendet die Delivery.
</Warning>

Kampagnen-Calls übertragen `campaign_id`, `lead_id`, Lead-Felder, gemappte
Variablen und die Kampagnen-Zeitzone im Agent-Dispatch. WhatsApp-Medien starten
niemals einen SIP-Dial.

WhatsApp-**Sprachanrufe** laufen über den WhatsApp-Voice-Connector der Plattform. Derselbe Sprachagent, der Telefonanrufe entgegennimmt, beantwortet auch WhatsApp-Anrufe.

Produkteinrichtung (Zugangsdaten, Webhook, Umschalter, Vorlagen): **Einstellungen → Kanäle → WhatsApp** – siehe [WhatsApp (Text + Anruf)](/channels/whatsapp).

Text-Chat nutzt denselben Connector über den Cloud-API-Pfad (Feld `messages` im Webhook). Bei Anrufen wird dieselbe Webhook-URL verwendet, aber mit dem Feld `calls`.

## Was Endnutzer sehen

1. Der Kunde tippt auf **Anrufen** bei deiner WhatsApp-Business-Nummer (oder nimmt einen ausgehenden Anruf entgegen).
2. Normale WhatsApp-Anruf-Oberfläche (Klingeln → verbunden).
3. Dein Assistent spricht wie am Telefon (STT/LLM/TTS in der Anrufsitzung).
4. Nach dem Auflegen: derselbe Verlauf-/Analyse-/Credits-Pfad wie bei anderen Anrufen.

Es gibt keinen eigenen In-App-WhatsApp-Dialer für den Kunden – er bleibt einfach in WhatsApp.

## Was Workspace-Admins sehen (Produkt)

**Einstellungen → Kanäle → WhatsApp**:

1. Verbinde deine Meta-Zugangsdaten (Telefonnummer-ID + permanentes System-User-Token + App Secret + Verify Token + WABA-ID) oder nutze **Mit Meta verbinden**.
2. Weise einen Assistenten zu.
3. Kopiere die Webhook-URL für Meta (`messages` + `calls` + Template-Status).
4. Aktiviere die Umschalter für eingehende/ausgehende Anrufe (ausgehend ist regionsabhängig + erfordert eine Meta-Nutzerberechtigung).
5. Optional: Starte einen Test-WhatsApp-Anruf direkt im selben Panel.

Webhook-Route: `https://app.famulor.io/api/webhooks/messaging/whatsapp/{connectorId}`.

Ausgehende API: `POST /api/calls/whatsapp-outbound`.

## Apps/Konten, die du brauchst

1. [Meta Developer](https://developers.facebook.com/)-Konto.
2. WhatsApp Business Account (WABA) mit einer geschäftlichen Telefonnummer.
3. **Sprachanrufe** für diese Nummer aktiviert (Cloud API v23/v24).
4. Meta-App mit WhatsApp-Produkt + permanentem **System-User**-Zugriffstoken (oder Embedded Signup).
5. Plattform-Sprachinfrastruktur mit aktiviertem WhatsApp-Calling (vom Betreiber konfiguriert).

## Meta-Setup (Schritt für Schritt)

1. Erstelle oder öffne eine Meta-App → füge **WhatsApp** hinzu.
2. Notiere dir unter WhatsApp → API-Setup:
   * **Telefonnummer-ID**
   * **Zugriffstoken** (in Produktion ein langlebiges System-User-Token verwenden)
3. WhatsApp → Konfiguration → Webhooks:
   * Callback-URL: `https://app.famulor.io/api/webhooks/messaging/whatsapp/{connectorId}` (oder der Plattform-WhatsApp-Webhook)
   * Verify Token: das Connector-Verify-Token (oder das Plattform-Verify-Token für den App-weiten Callback)
   * Abonniere mindestens **`calls`** (und **`messages`** für Text)
   * Nutze durchgängig API-Version **v23.0** oder **v24.0**
4. Anrufberechtigungen aktivieren:
   * Eingehend: Konfiguriere die verfügbaren Anrufzeiten (nutzerinitiierte Anrufe)
   * Ausgehend: nur in unterstützten Regionen + mit expliziter Nutzerberechtigung

## Anrufablauf (Produkt)

### Eingehend

1. Der Nutzer ruft deine WhatsApp-Business-Nummer an.
2. Meta sendet einen **Call-Connect**-Webhook mit SDP-Offer + Call-ID.
3. Die Plattform nimmt den Anruf an, startet den Sprachagenten und leitet das Audio in die Anrufsitzung.
4. Der Assistent läuft wie bei einem normalen Telefonanruf.

### Ausgehend

1. Der Workspace (UI/API/MCP) startet einen ausgehenden WhatsApp-Anruf an die Nummer des Nutzers.
2. Meta ruft den Nutzer an und sendet einen **Call-Connect**-Webhook mit SDP-Answer.
3. Die Plattform verbindet die Medien sofort (eine Verzögerung kann zu Stille oder Abbrüchen führen).
4. Beim Auflegen: Meta sendet **Call-Terminate** → die Plattform trennt die Sitzung.

## Verwandt

* [WhatsApp (Text + Anruf)](/channels/whatsapp)
* [Nachrichtenkanäle](/channels/messaging)
* [Telefonnummern](/telephony/phone-numbers)