Integrations- & Einrichtungfehler
Diese Nummer ist bei einem bestehenden WhatsApp-Konto registriert
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 Learn more link, 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.
Hinweis: Das Trennen eines WhatsApp-Kontos löscht den Chatverlauf, sofern dieser nicht gesichert wurde.
Wenn keines zutrifft, wenden Sie sich mit Ihren Angaben an den Support:
WhatsApp Account ID
Telefonnummer
Wir können eine manuelle Verbindung versuchen.
Code konnte nicht gesendet werden
Ü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 Flow „Ich integriere WhatsApp zum ersten Mal“ und wählen Sie die neu erstellten Konten aus.
Tipp: Dieser Fehler lässt sich oft beheben, indem man einfach den Erst-Setup-Pfad wählt.
Wenn das Problem weiterhin besteht, wenden Sie sich an den Support.
500-Fehler in der Konsole während der Anmeldung
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 zu aktualisierende Profileinstellung zurückgegeben wurde. Details zu Einschränkungen wie der maximalen Anzahl von Zeichen finden Sie hier.
Telefonnummer kann nicht migriert werden
Vollständiger Fehler: „Telefonnummer kann nicht migriert werden. Das WhatsApp-Konto, bei dem diese Nummer registriert ist, ist nicht korrekt eingerichtet“.
Überprüfen Sie:
Die Telefonnummer ist bei Meta vollständig verifiziert.
Sie ist nicht mehr mit der WhatsApp Business App verbunden.
Wenn beide Prüfungen fehlschlagen: Das Senden eines Screenshots der verifizierten Nummer im Business Manager an den Support beschleunigt die Lösung.
Geben Sie dem Support Ihre:
Verifizierter Screenshot
Telefonnummer
WABA ID
WhatsApp Business Account-Zugriff nicht geteilt
Wenden Sie sich für Hilfe bei diesem Fehler an den Fin-Kundensupport.
Zertifikat kann nicht erstellt werden. Bitte stellen Sie sicher, dass die Zwei-Faktor-Authentifizierung deaktiviert ist
Stellen Sie sicher, dass Ihre WhatsApp-Nummer auf der Installationsseite verbunden ist.
Hinweis: Die Zwei-Faktor-Authentifizierung muss in WhatsApp für die Zertifikatserstellung deaktiviert sein.
Bitte stellen Sie sicher, dass Sie den Zugriff auf Ihr WhatsApp Business-Konto vollständig autorisieren.
Überprüfen Sie, ob die Telefonnummer bei Meta vollständig genehmigt ist.
Tipp: Verzögerungen zwischen der Genehmigung durch Meta und der Synchronisierung mit Intercom können dies manchmal vorübergehend verursachen. Warten Sie ein paar Minuten und versuchen Sie es erneut.
Bitte versuchen Sie es später erneut oder wenden Sie sich an den Support, um das Problem zu beheben.
Dies tritt typischerweise aufgrund von eingeschränkten oder nicht erlaubten Wörtern in den Feldern Titel oder Beschreibung auf.
Hinweis: Meta setzt die Namensregeln strikt durch. Vermeiden Sie politische, medizinische oder sensible Begriffe. Dieser Facebook-Entwickler-Beitrag könnte einen Blick wert sein.
WABA eingegeben (ID xxxx) verwendet bereits eine Zahlungsmethode.
Dies tritt häufig bei Nummern auf, die von Drittanbietern bereitgestellt werden. Versuchen Sie die Migrations-Onboarding-Schritte erneut. Wenn erfolglos, kontaktieren Sie Fin Support.
Wir können das ausgewählte Meta-Geschäftskonto nicht verifizieren…
Dieser Fehler muss vom Meta Support behoben werden und kann nicht innerhalb von Intercom gelöst werden.
Nicht unterstützte GET-Anfrage.
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.
Tipp: WhatsApp-Konto-IDs unterscheiden sich von Business Manager-IDs – überprüfen Sie genau, welche Sie eingeben. Sie finden sie hier.
Fehlercode (#100) Ungültiger Parameter.
Dies wird normalerweise von Meta aufgrund eines Fehlers bei der Telefonmigration markiert. 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 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 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.
OAuthException-Fehler.
Beispiele:
Typ: OAuthException.
Code: 1.
Error_subcode: 23881.
„Zertifikat kann nicht erstellt werden“.
„Ihr Unternehmen erfüllt nicht die WhatsApp-Richtlinien“.
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.
„(#1) Parameterfehler“ beim Verbinden Ihrer Nummer.
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.
„Nachricht nicht gesendet aufgrund falscher Anzahl von Parametern. Stellen Sie sicher, dass alle Template-Parameter ausgefüllt sind, und versuchen Sie es erneut.“
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.
Fehler beim Verbinden des WhatsApp-Kontos: Code: 1, error_subcode: 99, Nachricht: Ein unbekannter Fehler ist aufgetreten [HTTP 500].
Folgen Sie diesen Schritten:
Gehen Sie zu den Einstellungen der WhatsApp-App.
Wählen Sie „Ich migriere von einem bestehenden WhatsApp…“
Wählen Sie Erstellen Sie ein neues WhatsApp Business-Konto.
Schließen Sie das Popup nach der Erstellung des WhatsApp Business-Kontos, aber vor dem Hinzufügen der Telefonnummer.
Sie werden in Intercom aufgefordert, die ID des neuen WhatsApp Business-Kontos einzugeben, das Sie erstellt haben – Sie finden diese in Ihrem WhatsApp Business-Konto.
Sie können dann den Anweisungen in unserem Hilfsartikel folgen, um den Migrationsprozess abzuschließen.
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 👇
Ausstehende Aktion bei Meta erforderlich.
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 Meta-Seite nicht vollständig abgeschlossen/verifiziert ist.
In solchen Fällen gehen Sie bitte zu Ihren Einstellungen bei Meta, um die nächsten erforderlichen Schritte zu prüfen.
Probleme mit WhatsApp-Nachrichtenvorlagen.
Vorlagen erscheinen nicht in Intercom.
Überprüfen Sie:
Die Vorlage enthält nur einfachen Text oder Schnellantwort-Schaltflächen.
Keine Medien oder nicht unterstützte Variablen.
Die Vorlage ist in Meta vollständig genehmigt.
Die Sprache entspricht den Intercom-Einstellungen.
Intercom wurde aktualisiert.
Hinweis: Das WhatsApp 1:1-Konversationsfenster muss aktiviert sein, damit Vorlagen in 1:1-Gesprächen angezeigt werden.
Tipp: Die Genehmigung durch Meta kann Minuten bis Stunden dauern, Synchronisierungsprobleme lösen sich oft mit der Zeit.
Variablenformatierung in WhatsApp-Nachrichtenvorlagen
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.
Verhinderung der Umklassifizierung von Vorlagen als „Marketing“
Marketing-Vorlagen werden in Intercom nicht unterstützt. Nur von Meta genehmigte transaktionale Vorlagen sind verfügbar; Marketing-Vorlagen erscheinen nicht in der Vorlagenauswahl und sind in Intercom nicht nutzbar.
Um sicherzustellen, dass Vorlagen nicht als Marketing eingestuft werden:
Vermeiden Sie werbliche Sprache.
Vermeiden Sie übermäßige Personalisierung.
Fügen Sie keine Medien ein, es sei denn, es ist erforderlich.
Geben Sie den Support- oder transaktionalen Zweck bei der Einreichung klar an. Machen Sie ihn explizit und nicht werblich.
Nützliche Ressourcen:
Probleme beim Senden von WhatsApp-Nachrichten
Empfänger kann diese Nachricht nicht empfangen / Nachricht ist unzustellbar
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 (mindestens erforderliche Versionen sind Android/SMBA 2.21.15.15, iOS/SMBI 2.21.170.4, KaiOS 2.2130.10 und Web 2.2132.6). Weitere Faktoren, die die Zustellung blockieren können, sind ein vom Meta markiertes Konto des Empfängers aufgrund ausstehender Maßnahmen oder Überschreitung der Nachrichtenfrequenzlimits.
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 konnte aufgrund von WhatsApps Nachrichtenfrequenzlimits nicht zugestellt werden
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 die Anzahl der Marketing-Vorlagennachrichten erreicht hat, die er innerhalb eines bestimmten Zeitraums erhalten kann.
Wenn Sie vermuten, dass dies die Ursache ist, ist es am besten, mindestens 24 Stunden zu warten, bevor Sie versuchen, die Vorlagennachricht erneut zu senden. Ein früheres erneutes Senden führt wahrscheinlich zum gleichen Fehler, da das Limit für unterschiedliche Zeiträume aktiv bleiben kann. Die Dauer der Aufhebung des Frequenzlimits kann variieren, daher sollten Sie die WhatsApp-Dokumentation für spezifische Reset-Zeiträume konsultieren.
Tipp: Für weitere Details zur Funktionsweise dieser Limits und deren Rücksetzung siehe die Dokumentation zu WhatsApps Marketing-Vorlagennachrichtenlimits pro Nutzer.
Diese Nachricht konnte nicht zugestellt werden, weil die Telefonnummer des Empfängers Teil eines WhatsApp-Experiments ist
Diese Nachricht wurde nicht im Rahmen eines Experiments gesendet. Für weitere Details zu Experimenten siehe WhatsApps Dokumentation zum Marketing-Nachrichten-Experiment.
Medientyp wird von WhatsApp nicht unterstützt
Diese Nachricht konnte nicht zugestellt werden, weil WhatsApp die enthaltenen Medien nicht hochladen konnte. Dies passiert typischerweise, wenn die Datei ein nicht unterstütztes Format verwendet oder nicht den WhatsApp-Medienanforderungen entspricht.
Um dies zu beheben, ü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, sollten Sie die Nachricht erfolgreich erneut senden können.
Diese Nachricht kann nicht gesendet werden
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 stattdessen eine von WhatsApp genehmigte Vorlagennachricht senden. Sobald der Empfänger antwortet, öffnet sich das 24-Stunden-Fenster wieder und freie Nachrichten können erneut gesendet werden.
WhatsApp Business Account wurde gesperrt
Diese Nachricht konnte nicht zugestellt werden, da der mit Ihrer App verbundene WhatsApp Business Account eingeschränkt oder deaktiviert wurde. Dies passiert typischerweise, wenn WhatsApp eine Verletzung ihrer Plattformrichtlinien feststellt oder wenn Details in der Anfrage nicht mit der Kontokonfiguration übereinstimmen – 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 den 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.