Dieser Leitfaden hilft Ihnen, ein bestehendes WhatsApp Cloud-Postfach auf die manuelle Einrichtung in Chatwoot umzustellen. Die Migration bewahrt Ihr bestehendes Postfach. Konversationen, Kontakte, Mitarbeiter, Routing-Regeln, Geschäftszeiten, CSAT-Einstellungen, Bot-Einstellungen und andere Postfach-Einstellungen bleiben erhalten. > **WhatsApp-Nummern mit Coexistence-Unterstützung werden derzeit geprüft. Wenn Ihre WhatsApp-Nummer auch in der WhatsApp Business App genutzt wird, kontaktieren Sie den Chatwoot-Support, bevor Sie mit dieser Migration beginnen.** Bevor Sie mit der Migration beginnen, sammeln Sie die benötigten WhatsApp Cloud API-Daten von Meta: WABA-ID, Telefonnummern-ID und ein permanentes Systembenutzer-Zugriffstoken. Nutzen Sie die folgenden Schritte, um eine Meta-App zu erstellen oder auszuwählen, die WhatsApp-Telefonnummer hinzuzufügen oder auszuwählen und das Token zu generieren. ## Ihre WhatsApp Cloud API-Daten von Meta abrufen Um die Migration abzuschließen, benötigen Sie drei Informationen von Meta: * **WhatsApp Business Konten-ID** * **Telefonnummern-ID** * **Permanenter Zugriffstoken oder Systembenutzer-Token** Sie können die WhatsApp Business Konten-ID und die Telefonnummern-ID aus Ihrer Meta-App abrufen. ### Eine Meta-App erstellen oder auswählen Gehen Sie zu [Meta for Developers](https://developers.facebook.com/apps/) und wählen Sie entweder eine bestehende App aus oder klicken Sie auf **App erstellen**. ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCUFZCNHdVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--1f606325708a807b616377c294d8f6ab773405c4/choose-or-create-app.png) \ Wenn Sie eine neue App erstellen, geben Sie einen App-Namen und eine Kontakt-E-Mail-Adresse ein und klicken Sie dann auf **Weiter**. ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCRFJDNHdVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--a289d00dec522df84ce9008ea0fdb583f32bdd77/create-app.png) ### WhatsApp-Anwendungsfall auswählen Wählen Sie auf dem Bildschirm zur Auswahl des Anwendungsfalls **Mit Kunden über WhatsApp verbinden** und klicken Sie auf **Weiter**. ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCRkZDNHdVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--a530ad1de8ee93a4cb598179012b8bd3e7fecfca/choose-whatsapp-use-case.png) ### Ein Business-Portfolio auswählen Wählen Sie das Business-Portfolio, das Ihr WhatsApp Business Konto besitzt oder besitzen wird. Wenn Sie noch kein Business-Portfolio haben, können Sie an dieser Stelle eines erstellen oder, falls Meta dies zulässt, später fortfahren und es nachträglich anlegen. ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCSUJDNHdVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--84077f3925813b62827752465f321f3f7850b7cc/choose-portfolio.png) ### Veröffentlichungsanforderungen prüfen Meta zeigt eventuell Veröffentlichungsanforderungen für die ausgewählte App und den Anwendungsfall an. Prüfen Sie die Anforderungen und klicken Sie auf **Weiter**. ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCS0pDNHdVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--8a8ee0aa597971b88d6b962b88b3590f73f8aae8/publishing-requirments.png) ### App prüfen und erstellen Überprüfen Sie die App-Daten, den ausgewählten WhatsApp-Anwendungsfall und das verbundene Business-Portfolio. Klicken Sie auf **App erstellen**, um abzuschließen. ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCTnRONHdVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--cb19f0f9ed989a0fa8a59f8aeed546ba7daa5b05/review.png) ### WhatsApp API-Konfiguration öffnen Nachdem die App erstellt oder ausgewählt wurde: 1. Klicken Sie im Seitenmenü auf **Use cases**. 2. Finden Sie **Mit Kunden über WhatsApp verbinden**. 3. Klicken Sie auf **Anpassen**. 4. Klicken Sie auf API Setup. ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCUFpENHdVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--6d166ce9f67c24dd28dc4584f38ad4cd42eba7d2/use-case.png) In der neuen Meta-App-Oberfläche gehen Sie zu **Grundlegende Einrichtung → Schritt 2. Produktionseinrichtung** und öffnen Sie **Ihre WhatsApp-Telefonnummer registrieren**. ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCR1JPNHdVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--ea20129b52437bce02873cb8b19e369f3dc1f8d9/new-ui-add-or-use-number.png) In älteren Meta-Apps öffnen Sie **WhatsApp → API setup** im linken Seitenmenü. ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCTDVENHdVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--52d9b1ad6ec3ab149aea026c3422be5b5ec92963/old-ui-api.png) ### Ihre WhatsApp-Telefonnummer hinzufügen oder auswählen Wählen Sie im Bereich **Nachrichten senden und empfangen** oder **Ihre WhatsApp-Telefonnummer registrieren** eine vorhandene Nummer im **Von**-Auswahlfeld aus oder klicken Sie auf **Telefonnummer hinzufügen**. \ Wenn Sie eine neue Nummer hinzufügen: 1. Geben Sie Ihren WhatsApp Business Anzeigenamen und die Unternehmensdetails ein. 2. Geben Sie die Telefonnummer ein. 3. Wählen Sie die Verifizierung per SMS oder Telefonanruf. 4. Geben Sie den von Meta erhaltenen OTP-Code ein, um die Nummer zu verifizieren. ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCSXhGNHdVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--06635673d9dca75d676567697983cc9c3b1dd7bc/create-business-portfolio.png) ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCRXhGNHdVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--2d87c35170f160b0d364c77df3e0813651d013fb/add-number.png) ### Die benötigten IDs kopieren Nachdem die Nummer hinzugefügt oder ausgewählt wurde, kopieren Sie folgende Werte von der API-Konfigurationsseite: * **Telefonnummern-ID** * **WhatsApp Business Konten-ID** Sie müssen diese Werte in den Chatwoot-Migrationsablauf einfügen. ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCTlZHNHdVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--99eb8165e60d568bb5987af12c8c1f0fa4bb3a99/CleanShot%202026-07-16%20at%2012.38.30@2x.png) In der älteren Meta-Oberfläche werden diese Werte direkt unter dem **Von**-Auswahlfeld in **WhatsApp → API setup** angezeigt. ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCRlJINHdVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--2d69164afa5b86f0c022c56a8e44f40fdf8281ba/CleanShot%202026-07-16%20at%2012.39.36@2x.png) > Meta ändert diese Oberfläche häufig. Wenn Ihr Bildschirm anders aussieht, suchen Sie die WhatsApp API-Konfigurationsseite und die ausgewählte Absendernummer. Die Telefonnummern-ID und die WhatsApp Business Konten-ID werden normalerweise in der Nähe der ausgewählten **Von**-Telefonnummer angezeigt. ## Ein permanentes WhatsApp Cloud API Zugriffstoken einrichten Sie benötigen außerdem ein permanentes Systembenutzer-Zugriffstoken mit WhatsApp-Berechtigungen. Dieses Token ermöglicht es Chatwoot, sich mit Ihrer WhatsApp Cloud API-Nummer zu verbinden, Nachrichten zu senden und zu empfangen und Nachrichtenvorlagen zu synchronisieren. ### Systembenutzer in den Meta Business-Einstellungen öffnen 1. Öffnen Sie die [Meta Business-Einstellungen](https://business.facebook.com/settings). 2. Wählen Sie das Business-Portfolio, das Ihr WhatsApp Business Konto besitzt. 3. Gehen Sie zu **Nutzer → Systembenutzer**. 4. Falls bereits ein Systembenutzer für Chatwoot existiert, wählen Sie diesen aus. 5. Wenn Sie noch keinen haben, klicken Sie auf **Hinzufügen**. ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCT1JJNHdVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--1c0d8becbf722cab74bf2309dfe1f9943c097f4e/CleanShot%202026-07-16%20at%2012.43.38@2x.png) ### Systembenutzer erstellen 1. Geben Sie einen Namen für den Systembenutzer ein, z.B. `Chatwoot WhatsApp`. 2. Wählen Sie **Admin** als Systembenutzer-Rolle. 3. Klicken Sie auf **Systembenutzer erstellen**. ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCSkpMNHdVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--52471a7d920c432a30fe0da42721f9af4e8491c6/CleanShot%202026-07-16%20at%2012.45.15@2x.png) ### Token generieren 1. Wählen Sie den Systembenutzer aus. 2. Klicken Sie auf **Token generieren**. ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCRTlNNHdVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--3fc13f84c0551ec2ebb5d567885d6827c8c1c9df/CleanShot%202026-07-16%20at%2012.43.38@2x%20copy.png) ### Meta-App auswählen Wählen Sie die Meta-App, die Sie zuvor für die WhatsApp Cloud API-Konfiguration erstellt oder ausgewählt haben, und klicken Sie dann auf **Weiter**. ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCSGRNNHdVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--d7d7bf129b54cfb283abaeb0b456a8b2f82b6323/CleanShot%202026-07-16%20at%2012.45.37@2x.png) ### Token-Ablauf festlegen Wählen Sie **Nie** als Token-Ablauf und klicken Sie auf **Weiter**. ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCS3RNNHdVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--4882df87fe944d64630f8cefcf2bcc3093b660b9/CleanShot%202026-07-16%20at%2012.45.48@2x.png) ### Berechtigungen zuweisen Wählen Sie die benötigten WhatsApp-Berechtigungen: * `whatsapp_business_messaging` * `whatsapp_business_management` * `whatsapp_business_manage_events` Fahren Sie dann fort, um das Token zu generieren. ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCTVpNNHdVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--6a69a730f132fcc05663f8bef110e817b6f54d35/CleanShot%202026-07-16%20at%2012.46.27@2x.png) ### Token kopieren Nachdem Meta das Token erstellt hat, klicken Sie auf **Kopieren** und speichern Sie es sicher. Sie werden dieses Token im Schritt **Zugriffstoken** des Chatwoot-Migrationsablaufs einfügen. ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCT2hNNHdVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--3dadfaa25557bb093bb7af3713c2f5264befda82/CleanShot%202026-07-16%20at%2012.47.35@2x.png) > Bewahren Sie dieses Token sicher auf. Jeder, der darauf Zugriff hat, könnte Ihre WhatsApp Cloud API-Verbindung nutzen. ## Migration starten 1. Gehen Sie zu **Einstellungen → Postfächer**. 2. Öffnen Sie das WhatsApp-Postfach, das über das Embedded Signup verbunden ist. 3. Klicken Sie auf **Manuelle Migration starten**. ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCRllnMndVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--0fed8e7f92b6a0dacb1a1ca68422eeec6a431a47/CleanShot%202026-07-13%20at%2014.28.42@2x.png) Chatwoot startet einen geführten Migrationsprozess. ## Schritt 1: Änderungen prüfen Im ersten Schritt wird erklärt, was beibehalten und was aktualisiert wird. Beibehalten: * Konversationen * Kontakte * Mitarbeiter * Routing * Geschäftszeiten * Postfach-Einstellungen Aktualisiert: * WABA-ID * Telefonnummern-ID * Zugriffstoken * Webhook-Konfiguration ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCT01nMndVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--9e1d089787f62140ca6ee62fb27f44417f083d5c/CleanShot%202026-07-13%20at%2014.30.08@2x.png) Klicken Sie auf **Weiter**. ## Schritt 2: Unternehmensdaten eingeben Geben Sie die WhatsApp Asset-Daten von Meta ein. Felder: * **WABA-ID**: Das WhatsApp Business-Konto, dem diese Telefonnummer gehört. * **Telefonnummern-ID**: Metas eindeutige ID für die mit diesem Postfach verbundene WhatsApp-Nummer. * **Angezeigte Telefonnummer**: Die kunden­seitige WhatsApp-Nummer. Diese kann während der Migration nicht geändert werden. ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCRkFrMndVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--3554a80c878cdecba4de08b8c42ed6cb1a5a98fd/CleanShot%202026-07-13%20at%2014.35.38@2x.png) Klicken Sie auf **Weiter**. ## Schritt 3: Zugriffstoken hinzufügen Fügen Sie ein permanentes Zugriffstoken oder ein Systembenutzer-Token mit WhatsApp-Berechtigungen ein. Das Token muss **whatsapp_business_messaging, whatsapp_business_management und whatsapp_business_manage_events** enthalten. ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCSTBrMndVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--365e188d56d91c2b5adf3f3030e484f0e71d9614/CleanShot%202026-07-13%20at%2014.36.18@2x.png) ## Schritt 4: Prüfen & wiederverbinden Überprüfen Sie Postfach, Telefonnummer, WABA-ID und Telefonnummern-ID, bevor Sie Änderungen übernehmen. Chatwoot prüft die Zugangsdaten bei Meta, bevor Änderungen übernommen werden. Falls die Verifizierung fehlschlägt, bleibt die aktuelle Konfiguration unberührt. ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCRThsMndVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--57a16743b6aad7c8870c8e50e96c37ef93e271a7/CleanShot%202026-07-13%20at%2014.37.18@2x.png) Klicken Sie auf **WhatsApp-Postfach wiederverbinden**, um die Migration abzuschließen. ## Nach der Migration Nach erfolgreicher Migration bleibt das Postfach in Chatwoot erhalten, aber die WhatsApp-Verbindung nutzt die manuelle WhatsApp Cloud API-Konfiguration. Sie sollten überprüfen: * Eingehende Nachrichten * Ausgehende Antworten * Versand von Vorlagen-Nachrichten * Vorlagensynchronisierung * Webhook-Zustellung ## Brauchen Sie Hilfe? Wenn Sie sich bei einem Schritt unsicher sind, kontaktieren Sie den Chatwoot-Support. Wir helfen Ihnen gern bei der Prüfung der notwendigen Meta-Daten und unterstützen Sie bei der Migration.