Dieser Fehler tritt auf, wenn die Telefonnummer zuvor mit einem anderen WhatsApp Business API-Anbieter oder mit der WhatsApp Mobile-/Business-App verwendet wurde. Wenn die Nummer in der Standard-WhatsApp-App genutzt wurde, müssen Sie sie trennen, bevor Sie sie mit Intercom verbinden.

Wenn sie mit einem anderen API-Anbieter verwendet wurde:
Folgen Sie dem Onboarding-Prozess für die Migrierung einer bestehenden WhatsApp-Telefonnummer und verlassen Sie das eingebettete Onboarding nach Schritt 2.

Wenn sie mit einer mobilen WhatsApp-App verwendet wurde:
Folgen Sie den Schritten unter dem Link „Mehr erfahren“ im Fehler, um die Nummer von diesem WhatsApp-Konto zu trennen. Danach sollten Sie den Onboarding-Prozess erfolgreich erneut starten können.

Wenn keines der beiden zutrifft, wenden Sie sich mit folgenden Angaben an den Support:

Wir können eine manuelle Verbindung versuchen.

Öffnen Sie die Entwicklertools Ihres Browsers (drücken Sie F12 oder klicken Sie mit der rechten Maustaste auf die Seite und wählen Sie Untersuchen), und wechseln Sie dann zum Tab Konsole, um die vollständige Fehlermeldung zu sehen.

Wenn dies während der Migration auftrat:
Die Migration ist möglicherweise bereits erfolgreich abgeschlossen. Versuchen Sie den Ablauf „Ich integriere WhatsApp zum ersten Mal“ und wählen Sie die neu erstellten Konten aus.

Wenn Sie Ihre Geschäftskontoeinstellungen nicht speichern können und in der Browserkonsole einen 500-Fehler erhalten, handelt es sich wahrscheinlich um einen Validierungsfehler, der von WhatsApp für die von Ihnen zu aktualisierenden Profileinstellungen zurückgegeben wurde. Details zu Einschränkungen wie der maximalen Anzahl von Zeichen finden Sie hier.

Vollständiger Fehler: „Telefonnummer kann nicht migriert werden. Das WhatsApp-Konto, bei dem diese Nummer registriert ist, ist nicht korrekt eingerichtet.“

Überprüfen Sie:

Wenn beide Prüfungen fehlschlagen: Ein Screenshot der verifizierten Nummer im Business Manager hilft dem Support, das Problem schneller zu lösen.

Geben Sie dem Support Ihre:

Dies passiert, wenn Ihr WhatsApp Business Account (WABA) während der eingebetteten Anmeldung bei Meta nicht mit Intercom geteilt wurde, sodass Intercom keinen Zugriff hat. Führen Sie den Verbindungsprozess erneut aus und stellen Sie sicher, dass Sie Intercom den Zugriff auf den WABA gewähren, wenn Sie dazu aufgefordert werden. Wenn der Fehler weiterhin besteht, wenden Sie sich mit Ihrer WABA-ID an den Intercom-Support.

Stellen Sie sicher, dass Ihre WhatsApp-Nummer auf der Installationsseite verbunden ist. Wenn nicht, schließen Sie zuerst den WhatsApp-Einrichtungsprozess ab. Sobald die Verbindung besteht, deaktivieren Sie die Zwei-Faktor-Authentifizierung in WhatsApp (siehe Hinweis unten) und versuchen Sie erneut, das Zertifikat zu erstellen.

Überprüfen Sie, ob die Telefonnummer im Meta Business Manager vollständig genehmigt ist. Falls noch Überprüfungen oder Genehmigungen ausstehen, schließen Sie diese ab, bevor Sie es erneut in Intercom versuchen.

Dies tritt typischerweise aufgrund von eingeschränkten oder nicht erlaubten Wörtern in den Feldern Titel oder Beschreibung auf.

Dies passiert oft bei Nummern, die von Drittanbietern bereitgestellt werden. Versuchen Sie die Migrations-Onboarding-Schritte erneut. Wenn es nicht klappt, kontaktieren Sie den Intercom-Support.

Dieser Fehler muss vom Meta Support behoben werden und kann nicht innerhalb von Intercom gelöst werden.

Vollständiger Fehler: „Nicht unterstützte GET-Anfrage. Objekt mit der ID XXXXXXXXXXXX existiert nicht, kann aufgrund fehlender Berechtigungen nicht geladen werden oder unterstützt diese Operation nicht.“

Wenn Sie versuchen, eine Nummer zu verbinden, stellen Sie sicher, dass der angezeigte Code eine WhatsApp-Konto-ID ist.

Dies wird normalerweise von Meta aufgrund eines Fehlers bei der Telefonmigration gemeldet. Weitere Details finden Sie in den Meta-Dokumenten.

Außerdem, wenn Sie folgenden Fehler erhalten: Typ: OAuthException Code: 1 Error_subcode: 23881 Nachricht: Ungültiger Parameter Error_user_title: Zertifikat kann nicht erstellt werden Error_user_msg: Ihr Unternehmen erfüllt nicht die WhatsApp-Richtlinien. Wenn Sie glauben, dass Ihr Unternehmen qualifiziert ist, wenden Sie sich an den Meta Business Suite Support. Offizielle Dokumentation finden Sie hier.

Wenn Sie beim Verbinden Ihrer Nummer einen (#1) Parameterfehler erhalten, lesen Sie den untenstehenden Abschnitt.

Beispiele:

Diese Fehler deuten darauf hin, dass Ihr Unternehmen möglicherweise nicht den WhatsApp-Richtlinien entspricht. Wenn Sie glauben, dass Ihr Unternehmen qualifiziert ist, wenden Sie sich an den Meta Business Suite Support. Offizielle Dokumentation finden Sie hier.

Zur Fehlerbehebung:

Diese Fehlermeldung bedeutet, dass die Anzahl der variablen Parameterwerte in Ihrer WhatsApp-Nachrichtenanfrage nicht mit der Anzahl der in Ihrer WhatsApp-Vorlage definierten variablen Parameter übereinstimmt. Sie müssen Ihre Vorlage bearbeiten und Werte für alle Variablen hinzufügen.

Folgen Sie diesen Schritten:

Hinweis: Das Popup zum Erstellen des WhatsApp Business-Kontos zum richtigen Zeitpunkt zu schließen, ist entscheidend, um diesen Fehler zu vermeiden. Schließen Sie das unten angezeigte Popup nach der Kontoerstellung, aber bevor Sie Ihre Telefonnummer hinzufügen:

Wenn Sie den Fehler sehen:

„Ihr Geschäftskonto hat eine ausstehende Aktion, die Sie vor dem Senden abschließen müssen“

Das bedeutet, dass Meta (WhatsApp Business Manager) das Senden von Nachrichten blockiert, weil Ihr WhatsApp Business-Konto (WABA) oder die Telefonnummern-Einrichtung auf der Meta-Seite nicht vollständig abgeschlossen/verifiziert ist.

Gehen Sie zu Ihrem Meta Business Manager-Konto, navigieren Sie zu WhatsApp Accounts und prüfen Sie, ob auf Ihrem WhatsApp Business Account (WABA) oder Ihrer Telefonnummer ausstehende Aktionen markiert sind. Schließen Sie alle ausstehenden Verifizierungsschritte ab und versuchen Sie dann erneut, Ihre Nachricht zu senden.

Bevor Sie den Support kontaktieren, überprüfen Sie Folgendes — Vorlagen, die in Intercom nicht erscheinen, bestehen normalerweise eine dieser Prüfungen nicht:

WhatsApp verlangt, dass Vorlagen numerische Platzhalter verwenden (z. B. {{1}}) statt beschreibender wie {{sf_full_name}}. Beispiel: Hallo {{1}}, Ihre Bestellung {{2}} wurde versandt. Intercom ordnet diese positionsabhängig Ihren Attributen zu.

Wenn Ihre Vorlagen mit Variablen wie {{sf_full_name}} fehlschlagen, bearbeiten Sie Ihre Vorlage in Meta, um beschreibende Platzhalter durch numerische zu ersetzen und diese in Intercom zuzuordnen. Dies gewährleistet die Kompatibilität zwischen WhatsApp und Intercom, indem Variablen direkt den Intercom-Attributen zugeordnet werden.

Um sicherzustellen, dass Vorlagen nicht als Marketing eingestuft werden:

WhatsApp konnte diese Nachricht nicht zustellen, da das WhatsApp-Konto des Empfängers derzeit keine Nachrichten empfangen kann. Dies kann passieren, wenn die Telefonnummer nicht bei WhatsApp registriert ist, der Empfänger die neuesten Nutzungsbedingungen oder Datenschutzrichtlinien von WhatsApp nicht akzeptiert hat oder eine veraltete WhatsApp-Version verwendet (Mindestversionsanforderungen sind in der untenstehenden Tabelle aufgeführt). Weitere Faktoren, die die Zustellung blockieren können, sind ein vom Meta markiertes Konto des Empfängers aufgrund ausstehender Aktionen oder Überschreitung der Nachrichtenfrequenzlimits. Intercom ordnet dies als Fehlercode 131026 zu, angezeigt als „Nachricht unzustellbar“ oder „Empfänger unfähig.“

Um das Problem zu lösen, bitten Sie den Empfänger über einen anderen Kommunikationskanal (z. B. SMS, E-Mail oder Telefon), zu bestätigen, dass er eine Nachricht an Ihre WhatsApp Business-Nummer senden kann, ausstehende Nutzungsbedingungen über Einstellungen > Hilfe oder Einstellungen > Anwendungsinformationen zu akzeptieren und seinen WhatsApp-Client auf die neueste Version zu aktualisieren.

Sobald diese Schritte abgeschlossen sind, sollte WhatsApp Ihre Nachrichten erfolgreich zustellen können.

Diese Nachricht wurde nicht zugestellt, weil WhatsApp sie blockiert hat, um ein gesundes Ökosystem-Engagement aufrechtzuerhalten, was normalerweise bedeutet, dass der Empfänger ein Limit erreicht hat, wie viele Marketingvorlagen-Nachrichten er innerhalb eines bestimmten Zeitraums erhalten kann. Intercom identifiziert dies als Fehlercode 131049 (Ökosystem-Engagement). Für Fehlerbehebungsschritte und Rücksetzzeiten siehe den WhatsApp-Fehlerbehebungsleitfaden.

Wenn Sie vermuten, dass dies die Ursache ist, sollten Sie mindestens 24 Stunden warten, bevor Sie versuchen, die Vorlagen-Nachricht erneut zu senden. Ein früheres Senden führt wahrscheinlich zum gleichen Fehler, da das Limit für unterschiedliche Zeiträume aktiv bleiben kann. Die Dauer der Aufhebung der Frequenzbegrenzung kann variieren, daher sollten Sie die Dokumentation von WhatsApp für spezifische Rücksetzzeiten konsultieren.

Diese Nachricht wurde nicht im Rahmen eines Experiments gesendet. Für weitere Details zu Experimenten siehe die Dokumentation zum Marketing Message Experiment von WhatsApp.

Diese Nachricht konnte nicht zugestellt werden, da WhatsApp die enthaltenen Medien nicht hochladen konnte, was typischerweise auftritt, wenn die Datei ein nicht unterstütztes Format verwendet oder nicht den Medienanforderungen von WhatsApp entspricht.

Um dies zu beheben, überprüfen Sie die Mediendatei, die Sie senden möchten, und bestätigen Sie, dass ihr Format und ihre Größe von WhatsApp unterstützt werden. Sobald die Medien den Anforderungen von WhatsApp entsprechen, sollten Sie die Nachricht erfolgreich erneut senden können.

Diese Nachricht konnte nicht zugestellt werden, da mehr als 24 Stunden vergangen sind, seit der Empfänger zuletzt auf Ihre WhatsApp-Nummer geantwortet hat, und WhatsApp nur innerhalb dieses aktiven 24-Stunden-Konversationsfensters Freiformnachrichten erlaubt. Dieser Fehler kann auch auftreten, wenn sich die Telefonnummer des Empfängers während der Konversation geändert hat, was die Sitzung effektiv zurücksetzt.

Um die Nachrichtenübermittlung fortzusetzen, müssen Sie stattdessen eine von WhatsApp genehmigte Vorlagen-Nachricht senden. Sobald der Empfänger antwortet, öffnet sich das 24-Stunden-Fenster erneut und reguläre Freiformnachrichten können wieder gesendet werden.

Diese Nachricht konnte nicht zugestellt werden, da das mit Ihrer App verbundene WhatsApp Business-Konto eingeschränkt oder deaktiviert wurde. Dies geschieht typischerweise, wenn WhatsApp eine Verletzung ihrer Plattformrichtlinien feststellt oder wenn Details in der Anfrage nicht mit der Kontokonfiguration verifiziert werden können – zum Beispiel eine falsche Zwei-Faktor-Authentifizierungs-PIN.

Um dies zu beheben, überprüfen Sie die Richtlinien zur Durchsetzung von WhatsApp, um die Art des Verstoßes und die erforderlichen Schritte zur Wiederherstellung des Kontos zu verstehen. Sie können auch die WhatsApp Health Status API für spezifischere Einblicke nutzen, warum das Konto gesperrt oder eingeschränkt wurde. Sobald das zugrunde liegende Problem behoben ist, sollte die Nachrichtenübermittlung wieder normal funktionieren.