WhatsApp Coexistence funktioniert nicht: Kopplungsfehler, Sync-Lücken und Verbindungsabbrüche beheben

WhatsApp Coexistence funktioniert nicht: zuerst prüfen

Die meisten Coexistence-Fehler lassen sich auf sechs Voraussetzungen zurückführen, und alle zu prüfen dauert ein paar Minuten. Die ersten fünf stammen von Meta, die letzte betrifft, wie Whapis Einrichtung Metas Fenster öffnet.

„Error while pairing Cloud API“ und andere Kopplungsfehler

„Error while pairing Cloud API“ bedeutet, dass die WhatsApp Business App und die Cloud API die Verknüpfung nicht abgeschlossen haben. Meta dokumentiert diese Formulierung nicht eigens, aber seine Referenz der Anmeldefehler listet die konkreten Meldungen auf, die dieser Ablauf zeigen kann, und jede hat eine bekannte Lösung. Metas Meldungen bleiben im englischen Original, darunter steht jeweils die deutsche Erklärung:

Einen Kopplungsfehler Schritt für Schritt beheben

1. 1

   WhatsApp Business App aktualisieren

   Installieren Sie die neueste WhatsApp Business App aus dem App Store oder von Google Play. Meta verlangt für Coexistence Version 2.24.17 oder höher.
2. 2

   Alte Business-Plattform trennen

   Öffnen Sie in der WhatsApp Business App Settings > Account > Business Platform. Ist dort eine Plattform aufgeführt, wählen Sie sie, tippen Sie auf Disconnect und warten Sie, wie von Meta angewiesen, 15 Minuten.
3. 3

   Das Handy nutzen, auf dem die Nummer registriert ist

   Lassen Sie die WhatsApp Business App auf dem Haupthandy dieser Nummer geöffnet und mit stabiler Internetverbindung, bis die Verbindung abgeschlossen ist.
4. 4

   Auf einem Computer erneut aus Whapi starten

   Öffnen Sie Whapi in Ihrem Shopify-Admin auf einem Computer, erlauben Sie Popups, klicken Sie auf Connect WhatsApp und wählen Sie Connect a WhatsApp Business App.
5. 5

   Die genaue Meldung von Meta zuordnen

   Schlägt die Verbindung erneut fehl, lesen Sie die Meldung in Metas Fenster und suchen Sie sie in der Tabelle der Kopplungsfehler. Jede hat ihre eigene Lösung.
6. 6

   Die Meldung an den Whapi-Support senden

   Wenn keine der Lösungen hilft, schreiben Sie dem Whapi-Support mit einem Screenshot des Fehlers. Kann die Nummer Coexistence nicht nutzen, kann Whapi auch mit einer separaten, nur mit der API verbundenen Nummer laufen.

QR-Code oder Bestätigungscode funktioniert nicht

Die Verknüpfung schließt sich in der WhatsApp Business App ab. Ein Code, der „nichts tut“, bedeutet daher meist, dass die App-Seite nicht abgeschlossen wurde. In Metas Ablauf, nachdem Sie Ihre Nummer eingegeben haben:

1. Meta zeigt im Anmeldefenster einen Code.
2. Ihre WhatsApp Business App erhält eine Nachricht vom offiziellen Facebook-Business-Konto. Tippen Sie auf „Connect“.
3. Tippen Sie auf „Connect to the Business Platform“.
4. Wählen Sie, ob Sie Ihren Chatverlauf teilen, und bestätigen Sie.
5. Geben Sie den Code ein oder scannen Sie ihn, um abzuschließen.

Kommt die Nachricht von Facebook nicht an, prüfen Sie, ob das Handy online und die App geöffnet ist, und starten Sie die Verbindung erneut. Sie können auch in der App den Bildschirm Settings > Account > Business Platform öffnen und von dort verbinden. Zeigt Meta „You have guessed too many times“ (Sie haben zu oft geraten), warten Sie wie von Meta empfohlen etwa 12 Stunden, bevor Sie es erneut versuchen. „You have requested your code too many times“ (Sie haben Ihren Code zu oft angefordert) bedeutet ebenfalls, dass Sie warten müssen, bevor Sie einen weiteren Code anfordern.

Coexistence bricht ständig ab

Meta trennt die API-Seite von Coexistence aus bestimmten, dokumentierten Gründen und teilt der verbundenen Plattform mit, welcher zutraf. Ihre WhatsApp Business App funktioniert weiter, nur Automatisierungen stoppen, bis Sie neu verbinden.

Nach einem Handywechsel oder einer Neuinstallation listet Meta Ihre zuvor verbundenen Produkte während der Registrierung mit einem vorausgewählten Opt-in auf. Lassen Sie es angehakt, stellt Meta die Verbindung im Hintergrund wieder her, meist innerhalb weniger Minuten. In dieser Zeit können keine API-Nachrichten gesendet werden, und verknüpfte Geräte wie WhatsApp Web müssen von Hand erneut verknüpft werden. Vermeiden Sie also Neuinstallationen oder Handywechsel mitten in einem umsatzstarken Tag.

Verknüpfte Geräte, WhatsApp Web und Windows

Coexistence funktioniert mit bis zu vier verknüpften Geräten. Meta unterstützt jede Begleit-App außer WhatsApp für Windows und WhatsApp für WearOS.

• Beim Verbinden hebt Meta die Verknüpfung aller Geräte auf. Verknüpfen Sie danach die, die Sie brauchen, erneut.
• Nachrichten eines Kunden, der eine nicht unterstützte Begleit-App nutzt, erreichen die verbundene Plattform eventuell nicht, und Ihre Nachrichten zeigen auf einem nicht unterstützten Gerät einen Platzhaltertext, der den Kunden bittet, sein Haupthandy zu öffnen.
• Meta kann außerdem Fehler 131060 melden, wenn ein neuer Kunde Ihnen zum ersten Mal schreibt, oft über eine Click-to-WhatsApp-Anzeige. Laut Meta verschwindet er meist innerhalb von Sekunden; prüfen Sie die WhatsApp Business App auf diese Nachricht.

Jedes verknüpfte Gerät ist eine weitere Sitzung, die aktiv bleiben muss, verknüpfen Sie also nur die Geräte, die Sie nutzen. Wenn mehrere Personen Kunden antworten, gibt das Team Inbox von Whapi jedem Mitarbeiter Zugriff ohne zusätzliche verknüpfte Geräte.

Chatverlauf oder Kontakte wurden nicht synchronisiert

Meta lässt die verbundene Plattform Ihre Kontakte und die Einzelchats der letzten 6 Monate einmal synchronisieren, innerhalb von 24 Stunden nach dem Verbinden und nur, wenn Sie in der App zugestimmt haben, den Chatverlauf zu teilen.

• Gruppenchats werden nie synchronisiert.
• Haben Sie sich gegen das Teilen des Verlaufs entschieden, werden keine früheren Chats geteilt.
• Lassen Sie die WhatsApp Business App während der Synchronisierung geöffnet und online. Laut Meta kann es je nach Umfang des Verlaufs mehrere Minuten dauern.
• Verstreicht das 24-Stunden-Fenster oder schlägt die Synchronisierung fehl, verlangt Meta, die Verbindung zu trennen und neu zu verbinden, bevor der Verlauf synchronisiert werden kann.

Neue Nachrichten sind anders: Alles, was Sie nach dem Verbinden aus der WhatsApp Business App senden, wird auf die verbundene Plattform gespiegelt, und automatisierte Nachrichten erscheinen im Chatverlauf der App.

Funktionen, die sich in der WhatsApp Business App ändern

Das Verbinden mit der API schaltet einige Funktionen der WhatsApp Business App ab und lässt den Rest unberührt. So listet Meta die Änderungen auf:

Für Sammelnachrichten, nachdem Broadcast-Listen deaktiviert sind, senden Sie WhatsApp-Broadcasts aus Whapi als genehmigte Marketing-Vorlagen an Kunden, die zugestimmt haben.

Nachrichten aus der App und Nachrichten aus Whapi

Nachrichten, die Sie aus der WhatsApp Business App senden, bleiben kostenlos. Nachrichten über die Cloud API, etwa Whapis Bestellbestätigungen, werden zu Metas Preisen pro Nachricht berechnet, die Sie auf der Seite WhatsApp API Preise finden. Das 24-Stunden-Kundenservicefenster gilt nur für API-Nachrichten. Eine Nummer, die mit App und API genutzt wird, hat einen festen Durchsatz von 20 Nachrichten pro Sekunde.

Coexistence von Whapi aus neu verbinden

Wenn die Verbindung abbricht, verbinden Sie von Whapi aus neu und lassen Sie die WhatsApp Business App installiert, denn eine Neuinstallation trennt die API erneut. Im Whapi-Dashboard in Shopify zeigt eine verbundene Nummer einen grünen Status. Wenn nicht, klicken Sie auf Connect WhatsApp, wählen Sie Connect a WhatsApp Business App und folgen Sie den Schritten in der App.

Um Coexistence ganz zu beenden, trennen Sie in der WhatsApp Business App unter Settings > Account > Business Platform. Meta lässt eine Plattform eine Nummer, die mit App und API genutzt wird, nicht abmelden, daher erfolgt das Trennen immer in der App.