Verwenden Sie die manuelle Einrichtung, wenn Ihre Nummer bereits auf der WhatsApp Business Platform (API) ist, Sie als technischer Anbieter Ihre eigene Nummer einrichten, Sie selbst gehostet sind und die Schnellinstallation nicht konfiguriert ist oder die Schnellinstallation nicht verfügbar ist. Sie verbinden Chatwoot mit Ihrer eigenen Meta-App.
Tarif & Zugriff
-
Jeder Tarif, der WhatsApp enthält (Startups und höher, sowie die kostenlose Testversion) auf Chatwoot Cloud und Selbst-Hosting. Siehe Preise & Tarife.
-
Nur Administratoren.
-
Die Koexistenz (die WhatsApp Business-App weiterhin verwenden) wird bei manueller Einrichtung nicht unterstützt. Wenn Ihre Nummer in der WhatsApp Business-App aktiv ist, registrieren Sie sie nicht über diesen Ablauf. Verwenden Sie Schnellinstallation mit Meta oder wenden Sie sich an den Support.
Bevor Sie beginnen
Sie benötigen drei Dinge von Meta. Der geführte Ablauf in Chatwoot führt Sie Schritt für Schritt durch jede Anforderung und verlinkt auf den richtigen Meta-Bereich:
-
Eine Meta-App mit dem WhatsApp-Anwendungsfall
-
Die Telefonnummern-ID Ihrer Nummer und die WhatsApp Business Account ID
-
Ein permanentes Zugriffstoken eines Meta-Systembenutzers
Verbinden Sie Ihre Nummer
-
Gehen Sie zu Einstellungen › Postfächer › Postfach hinzufügen › WhatsApp und wählen Sie WhatsApp Cloud. Klicken Sie auf dem Schnellinstallationsbildschirm ganz unten auf manueller Einrichtungsablauf. (Wenn Schnellinstallation nicht verfügbar ist, gelangen Sie direkt zur manuellen Einrichtung.)
-
Erstellen oder wählen Sie eine Meta-App aus. Erstellen Sie im Meta Developers Portal eine App (oder wählen Sie diejenige, die Sie bereits für diese Nummer verwenden), wählen Sie die Verbindung mit Kunden über WhatsApp und legen Sie das Geschäftsportfolio fest, das die Nummer besitzt. Klicken Sie auf Meine Meta-App ist bereit.
-
Fügen Sie Ihre Telefonnummer hinzu und holen Sie sich deren IDs. Öffnen Sie in Ihrer Meta-App den WhatsApp Anwendungsfall und wählen Sie API-Einrichtung (Anwendungsfälle › Mit Kunden über WhatsApp verbinden › Anpassen › API-Einrichtung). Bei neueren Apps gehen Sie zu Basis-Einrichtung › Produktiv-Einrichtung und öffnen Sie stattdessen Ihre WhatsApp-Telefonnummer registrieren. In Nachrichten senden und empfangen (oder Ihre WhatsApp-Telefonnummer registrieren) öffnen Sie den Von-Auswähler und wählen Sie Ihre Nummer, oder wählen Sie Telefonnummer hinzufügen, füllen Sie das Unternehmensprofil aus und verifizieren Sie sich mit dem Code, den Meta per SMS oder Telefonanruf sendet. Meta ändert diesen Bildschirm häufig. Die Telefonnummern-ID und die WhatsApp Business Account ID werden in der Regel in der Nähe der ausgewählten Von-Nummer angezeigt. Kopieren Sie beide, geben Sie sie in Chatwoot ein und klicken Sie auf Weiter.
-
Generieren Sie ein permanentes Zugriffstoken. Wählen Sie in den Meta Business-Einstellungen das Geschäftsportfolio aus, dem Ihr WhatsApp Business Account gehört, und gehen Sie zu Benutzer › Systembenutzer. Erstellen Sie einen Systembenutzer mit Adminrechten (oder wählen Sie einen bestehenden), weisen Sie ihm Ihre Meta-App und Ihren WhatsApp Business Account mit voller Kontrolle zu und klicken Sie dann auf Token generieren. Wählen Sie die erstellte Meta-App aus, stellen Sie das Ablaufdatum auf Nie, wählen Sie whatsapp_business_management und whatsapp_business_messaging aus, und kopieren Sie das Token. Meta zeigt es nur ein einziges Mal an. Fügen Sie es in Chatwoot als Permanentes Zugriffstoken ein und klicken Sie auf Details überprüfen.
-
Überprüfen Sie den Unternehmensnamen, die Nummer und die IDs, ändern Sie den Postfachnamen falls gewünscht, und klicken Sie auf Postfach erstellen.
-
Chatwoot prüft Zugriff auf Nummer, Vorlagenzugriff, Webhook-Callback und Webhook-Abonnement und richtet automatisch den Webhook in Meta für Sie ein. Sobald alle vier Punkte als Verifiziert angezeigt werden, klicken Sie auf Weiter, um Agenten hinzuzufügen.
Testen Sie es: Senden Sie eine WhatsApp-Nachricht von einem anderen Telefon an Ihre Geschäftsnummer. Sie sollte in Chatwoot erscheinen. Antworten Sie und prüfen Sie, ob sie ankommt.
Halten Sie Ihr Token geheim. Jeder mit Zugang kann Ihre WhatsApp-Verbindung nutzen. Wenn Sie es in Meta ersetzen oder widerrufen, aktualisieren Sie es im Reiter 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. Erstellen Sie ein Token mit beiden Berechtigungen. |
| Webhook-Callback oder Webhook-Abonnement nicht verifiziert | Klicken Sie auf Webhook-Einrichtung wiederholen. Falls es trotzdem fehlschlägt, prüfen Sie, ob der Systembenutzer volle Kontrolle über den WhatsApp Business Account hat. Wenn die Wiederholung weiterhin fehlschlägt, richten Sie den Webhook manuell ein: Kopieren Sie die Webhook-URL und das Webhook-Verifizierungstoken, die auf dem Abschlussbildschirm angezeigt werden (das Token steht auch im Tab Konfiguration des Postfachs). Gehen Sie in Ihrer Meta-App zu WhatsApp › Konfiguration, fügen Sie beides ein, klicken Sie auf Überprüfen und speichern und abonnieren Sie das Feld messages. |
| Geben Sie die Telefonnummern-ID und WhatsApp Business Account ID ein | Kopieren Sie beide aus API-Einrichtung in Ihrer Meta-App. Es sind unterschiedliche Nummern. |
Für alles Weitere siehe WhatsApp-Fehlerbehebung.
Was passiert als Nächstes
-
Vorlagen in Ihrem WhatsApp Business Account werden automatisch synchronisiert. Siehe Vorlagen und das 24-Stunden-Fenster.
-
Anrufe funktionieren auch mit manueller Einrichtung, sobald Ihre Nummer bei Metas Calling API angemeldet ist. Siehe WhatsApp-Anrufe.
Mehr als eine Nummer verbinden
Ja, das geht. Erstellen Sie jeweils ein separates Chatwoot-Postfach für jede Nummer. Der geführte Ablauf konfiguriert das Webhook-Routing für jede Nummer, sodass Sie nichts manuell verkabeln müssen.