Setup

WhatsApp über die Meta Cloud API verbinden

WhatsApp direkt über Meta senden und empfangen (Cloud API), mit eigener Nummer und App, als Alternative zu Twilio. BYO-Modell: die Nummer, das WhatsApp Business Account und die App gehören Ihnen.

Nachrichtenvorlagen

Nach 24 Stunden ohne Antwort der Kundin lässt WhatsApp keinen freien Text mehr zu: um das Gespräch wieder zu beginnen, braucht es eine freigegebene Vorlage. Sie erstellen und verwalten Vorlagen im CRM, auf der WhatsApp-Karte unter Einstellungen → Integrationen — der Umweg über den Business Manager von Meta entfällt.

Auf Neue Vorlage klicken und angeben, wofür sie da ist. Der technische Name wird ausgefüllt (Meta akzeptiert nur Kleinbuchstaben, Ziffern und Unterstrich).
Sprache und Kategorie wählen. Dienstprogramm für eine erwartete Nachricht wie Bestellung oder Termin; Marketing für ein Angebot. Meta prüft auch die Kategorie, und die falsche ist ein häufiger Ablehnungsgrund.
Die Nachricht schreiben. {{1}}, {{2}} für alles verwenden, was sich je Person ändert — der Reihe nach nummeriert, ohne Lücke.
Für jede Variable ein Beispiel eintragen. Meta verlangt das und lehnt die Vorlage sonst ab — niemand erhält diese Werte, sie dienen nur der Prüfung.
Zur Prüfung senden. Die Vorlage kommt als ausstehend an, und Meta gibt sie meist in wenigen Minuten frei; der Status steht in der Liste.

💡 Das CRM prüft Name, Nummerierung der Variablen und fehlende Beispiele, bevor irgendetwas an Meta geht. Das sind die drei häufigsten Ablehnungen, und Metas Meldung dazu sagt nicht, was zu ändern ist.

Mit einem Klick verbinden

Wenn oben auf der Karte die Schaltfläche „WhatsApp verbinden“ erscheint, nehmen Sie sie: das ist der kurze Weg. Ein Meta-Fenster öffnet sich, Sie wählen (oder erstellen) das WhatsApp-Business-Konto und die Nummer, fertig. Keine App anlegen, kein Token erzeugen, nichts einfügen. Das geht, weil SellioCRM ein von Meta genehmigter Tech Provider ist: die Verbindung läuft über unsere App statt über eine, die Sie selbst bauen müssten.

Nummer und Konto bleiben Ihre. Sie können bei Meta jederzeit trennen, und wir verlieren den Zugang sofort.
Wir sehen Ihr Facebook-Passwort nie, und keines unserer Geheimnisse erreicht Ihren Browser.
Die Nachrichten rechnet Meta weiterhin über Ihr eigenes Konto ab.

💡 Erscheint die Schaltfläche nicht, ist der Ein-Klick-Weg für Ihren Arbeitsbereich nicht freigeschaltet, und die manuelle Einrichtung unten ist der Weg. Beide enden am selben Punkt: gleicher Versand, gleicher Posteingang, gleiche Vorlagen.

Manuelle Einrichtung (eigene Meta-App)

Neben Twilio können Sie WhatsApp auch direkt über Meta senden und empfangen, mithilfe der offiziellen Cloud API. Es handelt sich um eine Alternative: Wenn diese Integration aktiv ist, läuft WhatsApp über Meta; SMS nutzt weiterhin Twilio. BYO-Modell (Sie bringen Ihr eigenes Konto mit): die Nummer, das WhatsApp Business Account (WABA) und die Meta-App gehören Ihnen, und die Nachrichten werden über Ihr Meta-Konto abgerechnet, ohne Kosten, Marge oder Vermittlung unsererseits.

Die Integration startet inaktiv: Es wird nichts gesendet, bis Sie die Felder ausfüllen und aktivieren. Der Access Token und das App Secret werden verschlüsselt im CRM gespeichert und niemals wieder angezeigt.

Voraussetzungen

Eine Meta-App (developers.facebook.com) mit hinzugefügtem WhatsApp-Produkt und einem WhatsApp Business Account (WABA).
Eine bei Ihrem WABA registrierte WhatsApp-Nummer und deren Phone Number ID (unter WhatsApp > API Setup).
Ein permanenter Access Token (empfohlen: ein System User im Business Manager) und das App Secret der App (unter Settings > Basic).
In Sellio: Administratorzugriff, um die Zugangsdaten zu speichern und die Integration unter Einstellungen → Integrationen zu aktivieren.

Was Sie ausfüllen müssen

Phone Number ID: die Kennung Ihrer WhatsApp-Nummer bei Meta (es handelt sich um eine ID, nicht um die Telefonnummer selbst).
WABA ID (optional): die ID Ihres WhatsApp Business Account, nützlich für Verwaltung und Vorlagen.
Graph-Version: die aufzurufende Graph-API-Version (z. B. v21.0). Leer lässt den Standardwert gelten.
Verify Token: eine von Ihnen gewählte Zeichenfolge. Sie muss im CRM und im Meta-Panel beim Abonnieren des Webhooks identisch sein.
Access Token: der permanente Token, der das Senden autorisiert (wird verschlüsselt im CRM gespeichert).
App Secret: das Secret der App, mit dem die Signatur eingehender Webhooks überprüft wird (wird verschlüsselt im CRM gespeichert).

So konfigurieren Sie es

Öffnen Sie Einstellungen → Integrationen und suchen Sie die Karte „WhatsApp (Meta Cloud API)“.
Füllen Sie die Phone Number ID, den Verify Token (wählen Sie eine Zeichenfolge), den Access Token und das App Secret aus; WABA ID und Graph-Version sind optional. Klicken Sie auf „Zugangsdaten speichern“.
Kopieren Sie die angezeigte „Webhook-URL (Meta)“. Fügen Sie diese im Meta-Panel unter WhatsApp → Configuration → Webhooks in das Feld Callback URL und denselben Verify Token in das Feld Verify Token ein.
Abonnieren Sie im Meta-Panel weiterhin das Feld „messages“, um Nachrichten und Status zu empfangen.
Kehren Sie zum CRM zurück und klicken Sie auf „Aktivieren“. Ab diesem Zeitpunkt laufen WhatsApp-Sendungen über Meta.

So senden Sie eine Nachricht

Öffnen Sie einen Kontakt oder Lead mit einer Telefonnummer (Feld Telefon oder Mobil).
Klicken Sie im Bereich „Nachrichten (SMS/WhatsApp)“ auf „SMS/WhatsApp senden“ und wählen Sie den Kanal WhatsApp.
Prüfen Sie die Nummer, schreiben Sie die Nachricht und klicken Sie auf „Senden“.
Die Nachricht wird im Verlauf des Datensatzes protokolliert. Die Antworten des Kunden treffen über den Webhook ein und erscheinen im selben Verlauf.

💡 24-Stunden-Fenster und Vorlagen: Außerhalb des 24-Stunden-Fensters seit der letzten Nachricht des Kunden akzeptiert Meta nur genehmigte VORLAGEN-Nachrichten. Innerhalb des Fensters funktioniert freier Text. Erstellen Sie Ihre Vorlagen im Meta-Panel und lassen Sie diese genehmigen.

Sicherheit: Das CRM überprüft die X-Hub-Signature-256 jedes eingehenden Webhooks anhand Ihres App Secrets (ein unsignierter Aufruf oder einer mit ungültiger Signatur wird abgelehnt). Behandeln Sie Access Token und App Secret als geheim: Sie werden verschlüsselt gespeichert und niemals wieder angezeigt.

Mehrere Nummern in derselben App

Sie können mehr als eine WhatsApp-Nummer in derselben Integration haben (z. B. eine US-Nummer als Standard und eine brasilianische Nummer für lokale Unterhaltungen). Fügen Sie sie in der Integrationskarte unter "Zusätzliche Nummern" hinzu (Phone Number ID, optionale WABA ID und eine Bezeichnung) und speichern Sie. Beim Starten einer Unterhaltung wählen Sie den Absender unter "Senden von"; Antworten aus dem Posteingang gehen automatisch über die Nummer hinaus, auf der die jeweilige Unterhaltung eingegangen ist. Die Hauptnummer bleibt der Standard.

So testen Sie es

Öffnen Sie einen Kontakt oder Lead mit Telefonnummer und senden Sie eine kurze WhatsApp-Nachricht an eine Ihrer Nummern.
Bestätigen Sie, dass die Nachricht auf dem Telefon ankam und im Verlauf des Datensatzes protokolliert wurde.
Antworten Sie vom Telefon aus und prüfen Sie, ob die Antwort im selben Verlauf erscheint (dies bestätigt den eingehenden Webhook).

Fehlerbehebung

Webhook-Verifizierung bei Meta schlägt fehl: Der Verify Token muss im CRM und im Meta-Panel identisch sein. Prüfen Sie, ob die Callback URL genau der auf der Karte angezeigten „Webhook-URL (Meta)“ entspricht.
Fehler beim Senden: Prüfen Sie die Phone Number ID und den Access Token. Ein abgelaufener Token oder einer ohne WhatsApp-Berechtigung lässt Meta das Senden verweigern.
WhatsApp sendet außerhalb des Fensters nicht: Verwenden Sie eine genehmigte Vorlage. Freier Text funktioniert nur innerhalb des 24-Stunden-Fensters.
Ich erhalte keine Antworten: Abonnieren Sie im Meta-Panel das Feld „messages“ und bestätigen Sie Callback URL + Verify Token.
Webhook abgelehnt (403): Die X-Hub-Signature-256 stimmt nicht überein. Geben Sie dasselbe App Secret erneut im CRM ein (es wird vom Server nicht zurückgegeben).
Es läuft weiterhin über Twilio: Die Meta-Integration muss „Aktiviert“ sein. Ohne Aktivierung nutzt WhatsApp weiterhin Twilio.

Dieselbe Nummer nutzen, die schon in der WhatsApp-Business-App ist

Sie können die Nummer gleichzeitig in der Handy-App und im CRM aktiv halten — Meta nennt das Koexistenz. Ihr Vertrieb antwortet weiter vom Handy, und jede gesendete Nachricht erscheint automatisch im CRM-Verlauf. Bei der Aktivierung werden bis zu sechs Monate früherer Konversationen importiert.

Sie schalten das nicht selbst im Business Manager frei: Es passiert über den Verbindungsassistenten des CRM und wird mit einem Code bestätigt, der in Ihrem WhatsApp ankommt.
Die App funktioniert weiter wie gewohnt: Neu ist nur, dass das Gespräch auch hier beim richtigen Kontakt festgehalten wird.
Der Verlaufsimport hat eine Frist: Meta gibt 24 Stunden nach der Aktivierung. Lassen Sie die App währenddessen geöffnet — der Fortschritt wird angezeigt.
Bei Handywechsel oder erneuter Registrierung bricht die Verbindung ab und muss neu hergestellt werden. Das CRM weist darauf hin.

💡 Was mit aktiver Koexistenz in der App wegfällt: Gruppen, Sprach- und Videoanrufe, Katalog und Bestellungen, Marketingnachrichten und die Schnellantworten der App. Bestehende Broadcast-Listen werden schreibgeschützt. Ist Ihnen davon etwas wichtig, nutzen Sie lieber eine eigene Nummer im CRM und lassen die App unangetastet.

Open this article inside the system →