WhatsApp (Text + Voice)

WhatsApp ist ein Workspace-Kanal unter Settings → Channels → WhatsApp – für Text-Chat, plattformseitige Sprachanrufe und Nachrichtenvorlagen. Bevorzugtes Onboarding (nur Plattform-Domain, z. B. app.famulor.io): WhatsApp Embedded Signup (Connect with Meta). Auf Whitelabel-Custom-Domains nutzen Workspaces ausschließlich das manuelle Einfügen von Zugangsdaten. Marketplace-Nummern (Settings → Numbers) sind PSTN/SIP für Telefon-Voice. Dieselbe E.164-Nummer wird erst dann WhatsApp-fähig, wenn Meta sie verifiziert hat (OTP). Deine SIP-Trunk-Einstellungen sind unabhängig von der WhatsApp Cloud API. Die SMS-Helfer der Plattform sind ausschließlich für SMS/MMS – nicht für WhatsApp.

​

Voraussetzungen

Dein Plan enthält WhatsApp Text und/oder WhatsApp Voice.

​

Antwort- und Gesprächseinstellungen

Cloud-API- und Coexistence-Absender bieten KI-Auto-Antworten, Nachrichtenreaktionen ignorieren und Gespräche ungelesen lassen. Reaktionen werden standardmäßig ignoriert. Schalte dies aus, um neue Emoji-Reaktionen als Kundennachrichten zu speichern und bei aktivierter KI beantworten zu lassen. Das Entfernen einer Reaktion löst keine Antwort aus. Ungelesene Gespräche unterdrücken auch die Tippanzeige. Unter Edit → General → Timing stellst du Antwortverzögerung und Inaktivitätszeit ein, unter Edit → Advanced → Conversation ended eine optionale Webhook-URL. Die Inaktivität zählt ab der letzten Kundennachricht. Der Webhook enthält Transkript und extrahierte Variablen. Erneutes Auslösen erlauben sendet diesen Absender-Webhook erneut, wenn derselbe Kunde ein beendetes Gespräch fortsetzt und wieder inaktiv wird. Workspace-Webhooks und Automatisierungen behalten ihre eigenen Ereignisabonnements.

​

Produkt-UI

1. Add number öffnet die Wahl: Wähle WhatsApp Cloud (nur Cloud API — die Nummer verlässt in der Regel die WhatsApp Business App) oder Koexistenz mit der WhatsApp Business App (App und WhatsApp Web bleiben auf der Nummer; der Assistent antwortet parallel; eine Antwort aus der App pausiert die KI) und dann Continue. Setup guide neben der Liste führt durch die Schritte.
2. Connect with Meta (Embedded Signup) – Assistent auswählen, optionale Marketplace-Nummer (nur Cloud), OTP-Helfer für Marketplace-SMS
3. Oder Zugangsdaten manuell auf dem Cloud-Pfad einfügen (Token, App Secret, Verify Token, Phone Number ID, WABA-ID). Koexistenz erfordert Connect with Meta.
4. Toggles: Text chat, Inbound calls und Outbound calls (Anrufe nur auf dem Cloud-Pfad — bei Koexistenz bleiben Anrufe in der WhatsApp Business App)
5. Edit bei einem Sender: Oben stehen Status, Quality, Limit und Calls. General enthält die Chat- und Outbound-Voice-Assistenten, AI Auto-Responses, Inbound calls, Outbound calls, Ignore message reactions, Keep conversations unread und das Timing. Profile enthält das Business-Profil (About, Description, Business Address, Business Category, Logo, Banner, Websites und Kontakt-E-Mails/-Telefonnummern); bei Cloud-Sendern überträgt Publish to WhatsApp es zu Meta – das Logo wird dein WhatsApp-Profilbild. Advanced enthält die Webhooks für Gesprächsende und Lesebestätigungen, die Cloud-API-Zugangsdaten und die Konto-IDs. Refresh from Meta, Enable / fix calling und Re-subscribe webhooks liegen im ⋯-Menü. Ungespeicherte Änderungen zeigen eine Leiste mit Save und Discard.
6. Wähle Templates neben einem Sender, um dessen eigene Template-Seite zu öffnen. Sync with Meta folgt jeder Ergebnisseite, importiert im WhatsApp Manager erstellte Vorlagen und aktualisiert den Genehmigungsstatus. Mit Add template erstellst du einen eigenen Entwurf mit Text-, Bild-, Video-, PDF-Dokument- oder Standort-Header, optionaler Fußzeile, Schnellantworten sowie Website-, Telefon- und Code-kopieren-Buttons oder durchsuchst die offizielle Vorlagenbibliothek nach Sprache. Dieselbe Live-WhatsApp-Vorschau erscheint auch beim Einrichten einer Kampagne. Medien-Header benötigen eine JPEG-/PNG-, MP4- oder PDF-Prüfdatei mit maximal 3 MB. Vorlagen, die beim Versand Medien, Standorte, dynamische URLs oder Kopiercodes benötigen, bleiben sichtbar, sind aber noch nicht für Tests oder Kampagnen verfügbar. Variablen müssen fortlaufend nummeriert sein ({{1}}, {{2}}, {{3}}) und einer Systemvariable, einem Lead-Attribut, einer Assistentenvariable oder einem eigenen Schlüssel zugeordnet werden. URL- und Telefonnummer-Buttons müssen konfiguriert sein, bevor eine Vorlage aus der Bibliothek hinzugefügt wird.
7. Einen Test-WhatsApp-Anruf über das ⋯-Menü des Senders durchführen (Test call)

Profile bei Cloud API und Coexistence: Cloud-Verbindungen veröffentlichen Profildaten und Profilbild über Publish to WhatsApp. Bei Coexistence bearbeitest du das öffentliche Profil in der WhatsApp Business App und übernimmst es anschließend mit Refresh from Meta. Save speichert nur einen lokalen Entwurf und das Branding. Das gilt auch für den Profil-Sync über API und MCP. Die Antwortverzögerung beginnt nach der letzten eingehenden Nachricht; danach kommen die Zeit für die KI-Verarbeitung und die Zustellung hinzu. Kopiere für die manuelle Einrichtung die nach dem Verbinden angezeigte Webhook-URL (verifizierte Custom Domains werden automatisch gehandhabt) und abonniere messages, calls und message template status updates. Koexistenz-Sender erhalten über denselben Webhook zusätzlich Business-App-Echos, Kontaktabgleich und den letzten Chatverlauf. Aktiviere für Voice zusätzlich Calling auf der Telefonnummer unter Edit → ⋯ → Enable / fix calling. Bestehende Cloud-Sender lassen sich nicht direkt umwandeln — trenne die Verbindung in Meta und verbinde erneut mit Koexistenz. Eine Antwort aus der Business App pausiert den Assistenten für diese Unterhaltung, bis du sie in History fortsetzt; importierter Chatverlauf erscheint dort als abgeschlossene Unterhaltungen, und das Trennen der Nummer von der Business App (Settings → Account → Business Platform → Disconnect) zeigt den Sender bis zur erneuten Verbindung als ERROR an.

​

Das 24-Stunden-Fenster und Vorlagen

Meta erlaubt Freitext-Antworten nur innerhalb eines 24-hour service window, das sich jedes Mal öffnet, wenn dir ein Kunde schreibt:

• Innerhalb des Fensters – dein Assistent kann jede Nachricht senden, keine Vorlage nötig.
• Außerhalb des Fensters – du musst eine genehmigte Vorlage senden. Das gilt für den Start einer neuen Konversation, die Reaktivierung eines Kunden nach 24 Stunden Inaktivität sowie jede von dir initiierte Benachrichtigungs- oder Marketing-Nachricht.

Meta sortiert Vorlagen in drei Kategorien, jede mit einer eigenen Genehmigungshürde: Add template erstellt Utility- und Marketing-Vorlagen, und die offizielle Bibliothek, die es durchsucht, ist Utility. Authentication- Vorlagen werden im WhatsApp Manager erstellt und von Sync with Meta wie jede andere Vorlage übernommen. Eine call-permission request ist keine eigene Kategorie – sie ist eine übergeordnete CALL_PERMISSION_REQUEST-Komponente, die einer Utility- oder Marketing-Vorlage hinzugefügt wird, um einen Kunden um die Erlaubnis zu bitten, ihn über WhatsApp Voice anzurufen. Meta liefert den maßgeblichen Prüfstatus asynchron zurück.

​

Nachrichtenqualität und Sendelimits

Meta steuert über zwei getrennte Größen, wie viel ein Sender senden darf. Quality rating – High, Medium oder Low, je nachdem, wie Menschen auf deine Nachrichten reagieren: Blockierungen, Spam-Meldungen und ob sie antworten. Sie sinkt nach einer Serie von Blockierungen oder Meldungen und erholt sich, wenn du relevante, angeforderte Inhalte sendest. Messaging limit – wie viele Kunden du innerhalb von 24 gleitenden Stunden neu kontaktieren darfst. Ein neuer Sender startet auf der niedrigsten Stufe (typischerweise 250 Kunden), und Meta hebt sie Schritt für Schritt an – 1.000, dann 10.000, dann 100.000, dann unbegrenzt –, sobald du mehr bei gesunder Quality Rating sendest. Eine dauerhaft niedrige (Low) Bewertung kann die Stufe einfrieren oder wieder herabsetzen. Antworten innerhalb eines offenen 24-Stunden-Fensters zählen nicht auf das Limit. Beide Werte kommen direkt von Meta und werden pro Sender in der Liste und oben unter Edit als Quality und Limit angezeigt – baue dir also erst eine Historie qualitativ guter Konversationen auf, bevor du das Volumen hochskalierst.

​

Kampagnen

Wähle WhatsApp im Kampagnen-Wizard, um pro Lead einmal die genehmigte Text-Vorlage eines aktiven Senders zu senden. Gespeicherte Vorlagen-Bindings sind vorausgefüllt und lassen sich pro Kampagne überschreiben. Mappings können kanonische Kontaktfelder, schreibgeschützte Kanal-/Systemvariablen, Lead-Attribute, Assistentenvariablen oder einen eigenen Lead-Schlüssel nutzen. WhatsApp Call (Beta) erfordert Beta Features, WhatsApp-Voice-Zugang, einen outbound-fähigen Sender sowie eine für diesen Sender ausgewählte, genehmigte Call-Permission-Vorlage. Von Unternehmen initiierte Anrufe hängen zudem von der Verfügbarkeit bei Meta, der Region und der ausdrücklichen Erlaubnis des Kunden ab. Berechtigungsanfragen und ihr sichtbarer Status Awaiting permission werden automatisch verwaltet. Eine erteilte Erlaubnis setzt den Lead nur fort, solange seine Kampagne läuft. Voice-Kampagnen können eine genehmigte WhatsApp-Vorlage, SMS oder E-Mail als ihr einziges Follow-up nach den Wiederholungsversuchen nutzen. Erfolgreiche Anrufe, gesperrte Kontakte und manuell pausierte Kampagnen erzeugen dieses Follow-up nie. Vorlagen-Versand nutzt dieselben Messaging-Credits wie WhatsApp innerhalb einer Session.

​

Read-Receipts-Webhook

Unter Edit → Advanced kannst du einen HTTPS-Endpunkt konfigurieren, der Zustell- und Lesestatus-Callbacks empfängt. Jeder Callback wird mit HMAC-SHA256 über den exakten rohen Request-Body signiert. Die Signatur wird als X-Signature-256: sha256=<hex digest> gesendet. Ein Signing Secret wird erzeugt, sobald du die Webhook-URL zum ersten Mal speicherst. Bestehende Secrets lassen sich nicht erneut abrufen. Nutze Rotate signing secret in den Sender-Einstellungen, POST /api/v1/whatsapp/connectors/{id}/profile mit action=rotate_read_receipts_webhook_secret, oder das MCP-Tool rotate_whatsapp_read_receipts_webhook_secret. Das neue signing_secret wird genau einmal angezeigt oder zurückgegeben, und das vorherige Secret funktioniert sofort nicht mehr. Sichere den neuen Wert, bevor du die Antwort verlässt, und aktualisiere deinen Empfänger, bevor du eine Testanfrage sendest.

​

Verlauf

Jede WhatsApp-Konversation landet neben deinen anderen Kanälen in Verlauf:

• Textkonversationen erscheinen als Kanal WhatsApp.
• Voice-Anrufe erscheinen als Kanal WhatsApp voice.

Abgeschlossene Textkonversationen bleiben manuell beantwortbar, solange Metas 24-Stunden-Servicefenster offen ist. Nach einer manuellen Antwort fragt History, ob die Konversation abgeschlossen bleiben oder mit KI-Auto-Antworten wieder geöffnet werden soll. Das Wiederöffnen startet einen neuen Inaktivitäts-Timer, ohne Metas 24-Stunden-Fenster zu verlängern. Bei Koexistenz-Sendern erscheint der Chatverlauf, den die WhatsApp Business App nach dem Verbinden teilt, in History als eigene abgeschlossene Konversationen mit einem kleinen Imported-Badge neben der Kanalbezeichnung. Importierte Konversationen sind ein reiner Lesezugriff auf das, was vor oder außerhalb von Famulor passiert ist — sie haben kein aktives Servicefenster und können weder für eine manuelle Antwort noch für KI-Auto-Antworten wieder geöffnet werden. Sendet ein Kunde ein Foto, beschreibt dein Assistent automatisch, was darauf zu sehen ist, und kann als Teil der Konversation darauf eingehen. Eingehende Sprachnachrichten werden automatisch transkribiert und wie eine getippte Nachricht behandelt. Sowohl das Medium als auch die resultierende Beschreibung oder das Transkript sind in der Konversation sichtbar.

​

Abrechnung

• Text: wird pro Nachricht abgerechnet, zum Messaging (sent)- / Messaging (received)-Tarif deines Workspace – demselben Tarif, den auch andere Messaging-Kanäle nutzen. Aktuelle Tarife findest du auf der Usage-Seite.
• Voice: bestehende Reservierung/Abrechnung von Sprachminuten-Credits (wie bei Telefon-/SIP-Anrufen)
• Meta-Konversationspreise: Zahlungsmethode des Kunden im WhatsApp Manager (Tech Provider)

​

Fehlerbehebung

Das Status-Pill eines Senders zeigt PENDING, CONNECTED oder ERROR.

​

Public API

• Messaging Connectors: GET/POST /api/v1/messaging-connectors mit platform=whatsapp
• Vorlagen: GET/POST /api/v1/whatsapp/templates; nutze source=library, language, limit und den zurückgegebenen paging.after-Cursor, um die offizielle Bibliothek zu durchsuchen. parameter_bindings ordnet Positionen wie 1 oder header.1 Variablenschlüsseln zu. Übergib library_template_name plus library_button_values, wenn eine Vorlage URL- oder Telefonnummer-Buttons hat. action=update bearbeitet Entwürfe lokal; Komponenten- oder Kategorieänderungen an einer bearbeitbaren Anbieter-Vorlage werden an Meta gesendet, reine Mapping-Änderungen bleiben lokal. Review-Dateien für Medien-Header lädst du über POST /api/v1/whatsapp/templates/media oder das MCP-Tool upload_whatsapp_template_review_sample hoch. API- und MCP-Clients können dieselbe Call-Permission-Vorlage erstellen, indem sie eine BODY- und CALL_PERMISSION_REQUEST-Komponente übergeben.
• Outbound Voice: POST /api/v1/calls/whatsapp-outbound
• History-KI-Fortsetzung: POST /api/v1/history/actions mit action=resume_ai, kind=messaging und der Conversation-ID
• Calling-Verwaltung: GET /api/v1/whatsapp/calling liest die Anruf-Bereitschaft (Meta-Anrufeinstellungen, Webhook-Abonnement, Quality Rating) für die Business-Nummer eines Connectors; POST /api/v1/whatsapp/calling führt enable_calling, resubscribe oder ensure_voice aus.
• Sender-Assets: POST/DELETE /api/v1/whatsapp/connectors/{id}/assets lädt ein Business-Profil-Logo/-Banner hoch oder entfernt es (URL oder Base64).
• Sender-Profil und Read Receipts: GET/PATCH/POST /api/v1/whatsapp/connectors/{id}/profile verwaltet das Sender-Profil, testet den signierten Callback und rotiert dessen Signing Secret.
• Messenger Connect lässt sich auch vollständig über die API steuern: POST /api/v1/messenger/facebook-login/pages listet die Facebook-Pages auf, die ein User Access Token verwalten kann, vor POST /api/v1/messenger/facebook-login.
• MCP: WhatsApp-Template-Tools + start_whatsapp_outbound_call + get_whatsapp_calling_status + manage_whatsapp_calling + rotate_whatsapp_read_receipts_webhook_secret + upload_whatsapp_sender_asset / delete_whatsapp_sender_asset + list_messenger_facebook_pages

Die OTP capture-Session für Marketplace-Nummern (der Telefonnummer-Verifizierungsschritt, der eine gekaufte Nummer WhatsApp-fähig macht) bleibt ausschließlich im Dashboard – es handelt sich um einen interaktiven Telefonie-Ablauf ohne REST-/MCP-Äquivalent. Siehe auch Embedded Signup setup, Messaging-Kanäle, WhatsApp Voice.