Dieser Fehler erscheint, 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 verwendet wurde, müssen Sie sie trennen, bevor Sie sie mit Intercom verbinden.

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

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

Wenn keines zutrifft, wenden Sie sich mit Ihren Angaben an den Support:

Wir können eine manuelle Verbindung versuchen.

Überprüfen Sie die Browser-Konsole für weitere Details.

Wenn dies während der Migration auftrat:
Die Migration könnte bereits erfolgreich gewesen sein. 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 Browser-Konsole einen 500-Fehler erhalten, handelt es sich wahrscheinlich um einen Validierungsfehler, der von WhatsApp für die Einstellung zurückgegeben wurde, die Sie zu aktualisieren versuchen. 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, die Lösung zu beschleunigen.

Geben Sie dem Support Ihre:

Wenden Sie sich an den Intercom-Kundensupport, um Hilfe bei diesem Fehler zu erhalten.

Stellen Sie sicher, dass Ihre WhatsApp-Nummer auf der Installationsseite verbunden ist.

Überprüfen Sie, ob die Telefonnummer in Meta vollständig genehmigt ist.

Dies tritt typischerweise aufgrund eingeschränkter oder nicht erlaubter Wörter in den Feldern Titel oder Beschreibung auf.

Dies tritt häufig bei Nummern auf, die von Drittanbietern bereitgestellt werden. Versuchen Sie die Migrations-Onboarding-Schritte erneut. Wenn erfolglos, 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. Prüfen Sie die Meta-Dokumentation für weitere Details.

Außerdem, wenn Sie auf folgenden Fehler stoßen: 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 Richtlinienanforderungen von WhatsApp. Wenn Sie glauben, dass Ihr Unternehmen qualifiziert ist, wenden Sie sich an den Meta Business Suite Support. Offizielle Dokumentation finden Sie hier.

Wenn Sie eine Fehlermeldung wie „(#1) Parameterfehler“ beim Verbinden Ihrer WhatsApp-Nummer erhalten: Machen Sie einen Screenshot der Fehlermeldung. Oft erfordert die Behebung Meta-Support. Stellen Sie sicher, dass alle Einstellungen in Meta und Intercom korrekt konfiguriert sind, bevor Sie sich melden.

Beispiele:

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

Machen Sie einen Screenshot und überprüfen Sie Ihre Einstellungen. Die meisten Parameterfehler stammen von Meta und müssen über den Meta Support behoben werden.

Diese Fehlermeldung bedeutet, dass die Anzahl der variablen Parameterwerte, die Sie in Ihrer WhatsApp-Nachrichtenanfrage angegeben haben, 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 Schließen des Popups zum richtigen Zeitpunkt ist entscheidend, um diesen Fehler zu vermeiden. Dies ist das Fenster, das Sie schließen sollten 👇

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.

In solchen Fällen gehen Sie bitte zu Ihren Einstellungen in Meta, um die nächsten erforderlichen Schritte zu überprüfen.

Überprüfen Sie:

Intercom verlangt, dass Vorlagen numerische Platzhalter verwenden (z. B. {{1}}) statt beschreibender wie {{sf_full_name}}. Beispiel: Hallo {{1}}, Ihre Bestellung {{2}} wurde versandt.

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 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 Version der WhatsApp-App verwendet (erforderliche Mindestversionen sind Android/SMBA 2.21.15.15, iOS/SMBI 2.21.170.4, KaiOS 2.2130.10 und Web 2.2132.6). Weitere Gründe für eine Blockierung können sein, dass das Konto des Empfängers von Meta aufgrund ausstehender Maßnahmen oder Überschreitung der Nachrichtenfrequenzlimits markiert wurde.

Um das Problem zu beheben, 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 akzeptiert und seinen WhatsApp-Client auf die neueste Version aktualisiert.

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 zu gewährleisten. Das bedeutet in der Regel, dass der Empfänger ein Limit für Marketingvorlagen-Nachrichten innerhalb eines bestimmten Zeitraums erreicht hat.

Wenn Sie vermuten, dass dies der Grund ist, warten Sie mindestens 24 Stunden, bevor Sie die Vorlage erneut senden. Ein früheres Senden führt wahrscheinlich zum gleichen Fehler, da das Limit für unterschiedliche Zeiträume aktiv bleiben kann. Die Dauer für das Aufheben des Limits kann variieren, siehe WhatsApps Dokumentation für spezifische Reset-Zeiten.

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

Diese Nachricht konnte nicht zugestellt werden, weil WhatsApp die enthaltenen Medien nicht hochladen konnte, was typischerweise bei nicht unterstützten Formaten oder Nichteinhaltung der WhatsApp-Medienanforderungen passiert.

Überprüfen Sie die Mediendatei, die Sie senden möchten, und bestätigen Sie, dass Format und Größe von WhatsApp unterstützt werden. Sobald die Medienanforderungen erfüllt sind, sollte die Nachricht erfolgreich erneut gesendet werden können.

Diese Nachricht konnte nicht zugestellt werden, da mehr als 24 Stunden seit der letzten Antwort des Empfängers auf Ihre WhatsApp-Nummer vergangen sind. WhatsApp erlaubt nur innerhalb dieses 24-Stunden-Fensters freie Nachrichten. 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 weiter zu kommunizieren, müssen Sie eine von WhatsApp genehmigte Vorlagen-Nachricht senden. Sobald der Empfänger antwortet, öffnet sich das 24-Stunden-Fenster wieder und freie Nachrichten können erneut gesendet werden.

Diese Nachricht konnte nicht zugestellt werden, da das mit Ihrer App verbundene WhatsApp Business-Konto eingeschränkt oder deaktiviert wurde. Dies passiert typischerweise, wenn WhatsApp eine Verletzung der Plattformrichtlinien feststellt oder wenn Details in der Anfrage nicht mit der Kontokonfiguration übereinstimmen – z. B. 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 genauere Einblicke nutzen, warum das Konto gesperrt oder eingeschränkt wurde. Sobald das zugrundeliegende Problem behoben ist, sollte die Nachrichtenübermittlung wieder normal funktionieren.