WhatsApp-Anrufe

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). 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-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)
• Nachrichtenkanäle
• Telefonnummern