> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/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 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 der Freigabe.
  Ablehnung oder Ablauf beendet den Zustellversuch.
</Warning>

Derselbe Assistent, der Telefonanrufe entgegennimmt, beantwortet auch WhatsApp-Sprachanrufe. Kampagnenanrufe erhalten die Lead-Informationen und Variablen, die du in der Kampagne zuordnest.

Produkteinrichtung (Zugangsdaten, Webhook, Umschalter, Vorlagen): **Settings → Channels → WhatsApp** – siehe [WhatsApp (Text + Anruf)](/de/channels/whatsapp).

Text und Anrufe nutzen dieselbe WhatsApp-Verbindung. Abonniere bei manueller Einrichtung die angezeigte Webhook-URL für **messages** und **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 bei einem Telefonanruf.
4. Nach dem Auflegen erscheint der Anruf mit Analyse und Nutzung im Verlauf.

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

## Was Workspace-Admins sehen (Produkt)

**Settings → Channels → WhatsApp**:

1. Verbinde deine Meta-Zugangsdaten (Telefonnummer-ID + permanentes System-User-Token + App Secret + Verify Token + WABA-ID) oder nutze **Connect with Meta**.
2. Weise einen Assistenten zu.
3. Kopiere die angezeigte Webhook-URL für Nachrichten, Anrufe und Vorlagenstatus.
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.

Public API: `POST /api/v1/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. **Voice calling** für diese Nummer aktiviert (Cloud API v23/v24).
4. Meta-App mit WhatsApp-Produkt + permanentem **System-User**-Zugriffstoken (oder Embedded Signup).

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

1. Erstelle oder öffne eine Meta-App → füge **WhatsApp** hinzu.
2. Notiere dir unter WhatsApp → API-Setup:
   * **Phone number ID**
   * **Access token** (in Produktion ein langlebiges System-User-Token verwenden)
3. WhatsApp → Konfiguration → Webhooks:
   * Callback-URL: Kopiere die connectorspezifische URL aus den Einstellungen
   * Verify Token: Verwende den beim Connector angezeigten Wert
   * 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

## Ausgehenden Anruf starten

Starte einen ausgehenden WhatsApp-Anruf im Absenderbereich, über `POST /api/v1/calls/whatsapp-outbound` oder mit dem MCP-Tool `start_whatsapp_outbound_call`. Geschäftlich initiierte Anrufe sind nur in unterstützten Regionen und nach der ausdrücklichen Einwilligung des Empfängers verfügbar.

## Verwandt

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