Verwenden Sie die manuelle Einrichtung, wenn Ihre Nummer bereits auf der WhatsApp Business Platform (API) ist, Sie als technischer Anbieter Ihre eigene Nummer einbinden, Sie selbst gehostet sind oder die Schnell-Einrichtung nicht verfügbar ist. Sie verbinden Chatwoot mit Ihrer eigenen Meta-App.
Plan & Zugriff
-
Jeder Tarif, der WhatsApp enthält (Startups und höher sowie die kostenlose Testversion) auf Chatwoot Cloud und selbst gehostet. Siehe Preise & Tarife.
-
Nur Administratoren.
-
Koexistenz (die WhatsApp Business-App behalten) wird bei der manuellen Einrichtung nicht unterstützt. Wenn Ihre Nummer in der WhatsApp Business-App aktiv ist, registrieren Sie sie nicht über diesen Ablauf. Verwenden Sie die Schnell-Einrichtung (Seite 3) oder kontaktieren Sie den Support.
Bevor Sie beginnen
Sie benötigen drei Dinge von Meta. Die geführte Einrichtung in Chatwoot begleitet Sie durch jeden Schritt und verlinkt auf den richtigen Meta-Bildschirm:
-
Eine Meta-App mit dem WhatsApp-Anwendungsfall
-
Die Phone Number ID und WhatsApp Business Account ID Ihrer Nummer
-
Einen permanenten Zugriffstoken von einem Meta-Systembenutzer
Verbinden Sie Ihre Nummer
-
Gehen Sie zu Einstellungen › Postfächer › Postfach hinzufügen › WhatsApp und wählen Sie WhatsApp Cloud. Auf dem Schnell-Einrichtung-Bildschirm klicken Sie unten auf manuelle Einrichtung. (Wenn die Schnell-Einrichtung nicht verfügbar ist, gelangen Sie direkt zur manuellen Einrichtung.)
-
Erstellen oder wählen Sie eine Meta-App aus. Erstellen Sie in Meta Developers eine App (oder wählen Sie die, die Sie bereits für diese Nummer verwenden), wählen Sie die Verbindung zu Kunden über WhatsApp und wählen Sie das Geschäftsportfolio, dem die Nummer gehört. Klicken Sie auf Meine Meta-App ist bereit.
-
Fügen Sie Ihre Telefonnummer hinzu und erhalten Sie deren IDs. Öffnen Sie in Ihrer Meta-App den WhatsApp-Anwendungsfall und wählen Sie API-Einrichtung. Öffnen Sie unter Nachrichten senden und empfangen den Von-Selektor und wählen Sie Ihre Nummer, oder klicken Sie auf Telefonnummer hinzufügen, vervollständigen Sie das Geschäftsprofil und verifizieren Sie mit dem von Meta gesendeten Code. Kopieren Sie die Phone Number ID und WhatsApp Business Account ID, geben Sie sie in Chatwoot ein und klicken Sie auf Weiter.
-
Generieren Sie einen permanenten Zugriffstoken. Gehen Sie in den Meta Business-Einstellungen zu Benutzer › Systembenutzer, erstellen Sie einen Admin-Systembenutzer (oder wählen Sie einen), ordnen Sie diesem Ihre Meta-App und das WhatsApp Business-Konto mit voller Kontrolle zu und klicken Sie dann auf Token generieren. Stellen Sie das Ablaufdatum auf Nie, wählen Sie whatsapp_business_management und whatsapp_business_messaging aus und kopieren Sie den Token. Meta zeigt ihn nur einmal an. Tragen Sie ihn anschließend in Chatwoot als Permanent access token ein und klicken Sie auf Details überprüfen.
-
Überprüfen Sie den Geschäftsnahmen, die Nummer und die IDs, ändern Sie ggf. den Postfachnamen und klicken Sie auf Postfach erstellen.
-
Chatwoot prüft Nummerzugriff, Vorlagenzugriff, Webhook-Callback und Webhook-Abonnement und richtet den Webhook automatisch in Meta ein. Wenn alle vier als Verifiziert angezeigt werden, klicken Sie auf Weiter, um Agenten hinzuzufügen.
Testen Sie es: Senden Sie eine WhatsApp-Nachricht von einem anderen Handy an Ihre Geschäftsnummer. Sie sollte in Chatwoot erscheinen. Antworten Sie und prüfen Sie, ob sie ankommt.
Halten Sie Ihren Token geheim. Jeder, der ihn hat, kann Ihre WhatsApp-Verbindung nutzen. Wenn Sie ihn bei Meta ersetzen oder widerrufen, aktualisieren Sie ihn im Tab Konfiguration des Postfachs.
Falls ein Verifizierungsschritt fehlschlägt
| Nachricht | Was tun |
|---|---|
| Dieses Zugriffstoken ist ungültig oder abgelaufen | Generieren Sie ein neues permanentes Token (Ablauf Nie) und versuchen Sie es erneut |
| Vorlagenzugriff nicht verifiziert | Dem Token fehlt whatsapp_business_management. Nachrichten funktionieren, aber Vorlagen werden nicht synchronisiert. Generieren Sie einen Token mit beiden Berechtigungen. |
| Webhook-Callback oder Webhook-Abonnement nicht verifiziert | Klicken Sie auf Webhook-Einrichtung wiederholen. Falls es weiterhin fehlschlägt, prüfen Sie, ob der Systembenutzer volle Kontrolle über das WhatsApp Business-Konto hat. |
| Geben Sie die Phone Number ID und WhatsApp Business Account ID ein | Kopieren Sie beide aus der API-Einrichtung in Ihrer Meta-App. Es handelt sich um unterschiedliche Nummern. |
Alles Weitere finden Sie unter WhatsApp Fehler beheben.
Wie geht es weiter
-
Vorlagen, die in Ihrem WhatsApp Business-Konto genehmigt wurden, werden automatisch synchronisiert. Siehe Vorlagen und das 24-Stunden-Fenster.
-
Anrufe funktionieren auch mit manueller Einrichtung, sobald Ihre Nummer bei Metas Calling API registriert ist. Siehe WhatsApp-Anrufe.
Mehrere Nummern verbinden
Ja, das ist möglich. Erstellen Sie für jede Nummer ein separates Chatwoot-Postfach. Die geführte Einrichtung konfiguriert das Webhook-Routing für jede einzelne, Sie müssen nichts manuell zuweisen.