Chatwoot
de
Sprache
en English pt_BR Portuguese (Brazil) es Spanish de German fr French ar Arabic

Fehlerbehebung bei WhatsApp

Öffnen in
Als Markdown anzeigen In ChatGPT öffnen In Claude öffnen
Sojan

Sojan

Zuletzt aktualisiert am Oct 16, 2026

Bevor Sie irgendetwas ändern: Löschen Sie Ihr WhatsApp-Konto nicht, entfernen Sie Ihr WhatsApp Business-Konto nicht und trennen Sie keinen Anbieter als generelle Maßnahme. Die richtige Wiederherstellung hängt davon ab, wie Ihre Nummer heute eingerichtet ist. Notieren Sie die vollständige Fehlermeldung, jeden Code und den Bildschirm, auf dem sie erschien.

Verbinden

Wissen Sie zuerst, wie Ihre Nummer heute verwendet wird: eine neue Nummer, eine Nummer in der WhatsApp Business-App (verwenden Sie Koexistenz, um die App zu behalten), oder eine Nummer bei einem anderen API-Anbieter (diese nutzen unterschiedliche Wege). Siehe Wählen Sie, wie Sie WhatsApp verbinden.

Was Sie sehen Meta-Code Was es bedeutet und was zu tun ist
Nummer nicht berechtigt, benötigt mehr Aktivität in der WhatsApp Business-App 3441045 Eine Koexistenz-Berechtigungsprüfung. Nutzen Sie die App weiterhin wie gewohnt mit echten Kunden und versuchen Sie es später erneut. Meta veröffentlicht kein Minimum. Erzeugen Sie keine künstliche Aktivität und legen Sie das Konto nicht neu an.
Nummer nicht mit der WhatsApp Business-App registriert 2655095, 2655048 Überprüfen Sie die Nummer und die Ländervorwahl, und dass sie in der Business App ist (nicht im privaten WhatsApp). Für eine ausschließlich API-basierte neue Nummer nutzen Sie den neuen Nummernweg.
App aktualisieren 4563015 Installieren Sie die neueste WhatsApp Business-App und versuchen Sie es erneut.
Unternehmen teilt dieses Konto bereits mit einem Partner 2655093 Meta meldet, dass dieses WhatsApp Business-Konto bereits mit einem Partner verbunden ist. Das bestätigt nicht, dass der andere Anbieter noch aktiv ist. Ein Wechsel von Partnern ist in diesem Ablauf nicht möglich. Kontaktieren Sie den Support, bevor Sie etwas trennen.
Bereits mit dem Produkt registriert oder Geschäftsplattform trennen 3441049, 2655094 Eine bestehende Plattformverbindung muss zuerst behandelt werden. Wenn Sie absichtlich trennen, verlangt Meta 15 Minuten Wartezeit bis zum erneuten Versuch.
Nummer nicht mit dem gewählten Unternehmen verbunden 3441041 Wählen Sie das Unternehmensportfolio aus, dem diese Nummer gehört.
Nummer mit einer Facebook-Seite verknüpft 2655082 Prüfen Sie Meta Business Suite › Einstellungen › Konten › Seiten. Entfernen Sie die Seitenverknüpfung (nach Rücksprache mit dem Seitenadministrator) oder verwenden Sie eine andere Nummer.
Konto verwendet Marketingnachrichten 3441047 Wählen Sie ein anderes WhatsApp Business-Konto. Ein erneuter Versuch behebt es nicht.
Unternehmen oder Konto eingeschränkt 2655089, 3441040, 2388107 Öffnen Sie Meta Business Support Home, prüfen Sie die Einschränkung und legen Sie ggf. Widerspruch ein. Erstellen Sie keine neuen Konten, um die Einschränkung zu umgehen.
Verifizierung bei einem anderen Partner gestartet 2494143 Fahren Sie mit diesem Partner fort, oder beantragen Sie die Meta Business-Verifizierung direkt.
Funktion in Ihrer Region nicht verfügbar 3441042 Prüfen Sie die Ländervorwahl. Ist sie korrekt, ist dieser Ablauf für diese Nummer noch nicht verfügbar.
Code konnte nicht gesendet oder überprüft werden 2388091, 2388093 Überprüfen Sie die Nummer und nutzen Sie eine empfangsfähige Methode (Festnetz benötigt Sprachoption). IVR-Nummern werden nicht unterstützt.

Weitere Verbindungsprobleme

  • Konto oder Portfolio fehlt: Melden Sie sich mit dem Facebook-Konto an, das Administrator des richtigen Portfolios ist. „Benutzer hat keine Berechtigung“ bedeutet, ein bestehender Administrator muss Zugriff gewähren.

  • Facebook-Konto zu neu: Warten Sie einige Stunden oder nutzen Sie ein etabliertes Konto mit Geschäftszugang.

  • Unternehmensverifizierung läuft: Prüfen Sie Meta Business Suite › Security Center.

  • Anzeigename abgelehnt: Siehe Anzeigename unter Verwalten Sie Ihre WhatsApp-Nummer.

  • Telefonnummern-Limit erreicht: Wählen Sie die vorhandene Nummer, wenn sie bereits aufgelistet ist, oder bitten Sie Meta um ein höheres Limit. Löschen Sie keine funktionierende Nummer.

  • „Zu oft geraten“: Warten Sie etwa 12 Stunden. „Code zu oft angefordert“: Befolgen Sie die von Meta angezeigte Wartezeit.

  • Koexistenz-Aufforderung oder QR-Code funktioniert nicht: Verwenden Sie die neueste Business-App, halten Sie das Telefon online, lassen Sie das Anmelde-Fenster offen und überprüfen Sie die Kamerazugriffserlaubnis für QR-Codes.

  • Meta-Fenster öffnet sich nicht oder stoppt: Pop-ups erlauben, blockierende Erweiterungen deaktivieren, Meta-Sicherheitsprüfung abschließen und nach einem kurzfristigen Fehler einige Minuten warten.

  • Meta abgeschlossen, aber kein Posteingang in Chatwoot: Aktualisieren Sie und prüfen Sie Einstellungen › Posteingänge, bevor Sie es erneut versuchen. Erstellen Sie keine doppelten Posteingänge.

  • Koexistenz-Chatverlauf unvollständig: Halten Sie die App online geöffnet. Meta synchronisiert den Verlauf nur innerhalb von 24 Stunden nach der Verbindung. Kontaktieren Sie umgehend den Support statt sich erneut zu verbinden.

Nachrichten empfangen und senden

Symptom Wahrscheinliche Ursache Was zu tun ist
Nachrichten kommen nicht mehr an, aber die Nummer zeigt Verbunden und Qualität ist Grün Etwas in der Verbindung benötigt Aufmerksamkeit: Registrierung, Berechtigungen oder der Webhook. Das folgt häufig auf Änderungen am Anzeigenamen oder Profil. Nach jeder Behebung eine Testnachricht an Ihre Nummer senden und von Chatwoot aus antworten, um beide Richtungen zu bestätigen. Kontaktieren Sie zuerst den Support, damit wir die Registrierung, Berechtigungen und den Webhook Ihres bestehenden Posteingangs prüfen können. Falls die Nummer erneut registriert werden muss, machen Sie das selbst bei Meta nach Metas Registrierungsvorgang. Löschen Sie die Nummer nicht und erstellen Sie keinen neuen Posteingang. Koexistenz-Nummern benötigen einen anderen Wiederherstellungspfad, daher vor Änderungen Support kontaktieren.
Nach Einrichtung kommen keine Nachrichten an Eine mögliche Ursache: Der Webhook ist nicht registriert oder verweist woanders hin Öffnen Sie Account Health. Wenn Webhook-Konfiguration als Webhook nicht konfiguriert oder Webhook-URL stimmt nicht überein angezeigt wird, klicken Sie auf Webhook registrieren. Dann testen: Senden Sie eine Nachricht an Ihre Nummer von einem anderen Telefon, prüfen Sie die Ankunft in Chatwoot und antworten Sie von Chatwoot aus. Wenn der Webhook als konfiguriert angezeigt wird, aber trotzdem keine Nachrichten ankommen, kontaktieren Sie den Support. Für Twilio: Callback-URL in Twilio prüfen (Seite 5).
Sie können nur mit einer Vorlagennachricht antworten Mehr als 24 Stunden seit der letzten Nachricht des Kunden Senden Sie eine Vorlage. Siehe Vorlagen und das 24-Stunden-Fenster
Eine Nachricht schlägt fehl mit Fehler 131049 Meta hat diese Marketingvorlage zur Wahrung der Engagement-Qualität nicht zugestellt. WhatsApp limitiert, wie viele Marketingnachrichten eine Person von allen Unternehmen erhält. Nicht sofort erneut senden oder auf Erneut versuchen klicken. Mindestens 24 Stunden warten, bevor Sie dieser Person eine weitere Marketingvorlage senden. Utility-Vorlagen sind nicht betroffen. Antwortet der Kunde, zählen Marketingnachrichten innerhalb des 24-Stunden-Fensters nicht zum Limit.
WhatsApp-Verbindung muss aktualisiert werden / WhatsApp neu verbinden Die Quick-Setup-Verbindung ist abgelaufen Klicken Sie auf WhatsApp neu verbinden. Siehe Verwalten Sie Ihre WhatsApp-Nummer
WhatsApp-Zugriffstoken benötigt Aufmerksamkeit Das manuell eingerichtete Token ist abgelaufen oder wurde widerrufen Ersetzen Sie es im Reiter Konfiguration des Posteingangs

Vorlagen

Symptom Wahrscheinliche Ursache Was zu tun ist
Eine Vorlage fehlt in Chatwoot Noch nicht genehmigt, nicht synchronisiert oder ein von Chatwoot nicht unterstützter Typ Status im WhatsApp Manager prüfen und Vorlagen synchronisieren klicken. Unterstützte Typen auf Seite 7 prüfen.
Nachrichten funktionieren, aber Vorlagen werden nie synchronisiert (Quick-Setup) Die Verbindung hat die Berechtigung verloren, auf Ihr WhatsApp Business-Konto zuzugreifen Fügen Sie ein Business Management Token hinzu (Seite 7)
Business Management Token: Business management token must grant the whatsapp_business_management permission whatsapp_business_management wurde nicht ausgewählt Neues Token mit dieser Berechtigung generieren
Business Management Token: keine Berechtigung oder Token ungültig Der Systembenutzer hat das WhatsApp-Konto nicht, das Token ist abgelaufen oder gehört zu einer anderen App Zugewiesene Assets und App des Systembenutzers prüfen, dann neues Token generieren
Token akzeptiert, Vorlagen fehlen trotzdem Das Token kann auf ein anderes WhatsApp Business-Konto zugreifen Prüfen Sie, ob der Systembenutzer genau das Konto des Posteingangs hat und dort die Vorlagen existieren
Vorlage schlägt beim Senden fehl oder Medien werden nicht angezeigt Leere Variablen, privater oder kaputter Medienlink, oder Datei überschreitet Metas Limits Alle Variablen füllen, öffentlichen Link verwenden, Format und Größe prüfen (Seite 7)
Dynamischer URL-Button funktioniert nicht Bekanntes Problem bei bestimmten dynamischen URL-Buttons Statische URL in der Vorlage verwenden

Kontakte und Telefonnummern

Nummern sehen in WhatsApp und Chatwoot unterschiedlich aus (Brasilien, Mexiko, Argentinien). Diese Länder haben ihr Mobilnummernformat geändert, und WhatsApp kann immer noch das alte verwenden:

  • Brasilien: Eine 9 wurde nach der Vorwahl hinzugefügt (+55 11 9 8765-4321 vs +55 11 8765-4321).

  • Argentinien: Eine 9 nach der Ländervorwahl kann vorhanden sein oder nicht (+54 9 11 ... vs +54 11 ...).

  • Mexiko: WhatsApp kann eine 1 nach der Ländervorwahl hinzufügen (+52 1 ... vs +52 ...).

Chatwoot gleicht beide Formate automatisch demselben Kontakt zu, sodass Sie keine Duplikate bekommen sollten. Die Nummer kann an den beiden Orten einfach unterschiedlich dargestellt werden.

Support kontaktieren

Wenn Sie weiterhin nicht weiterkommen, kontaktieren Sie den Chatwoot-Support mit:

  • Der vollständigen Fehlermeldung und dem Fehlercode sowie einem Screenshot

  • Dem Schritt, der fehlgeschlagen ist, und ob der Fehler in Meta oder in Chatwoot auftrat

  • Ihrem Posteingangslink, der geschäftlichen Telefonnummer mit Ländervorwahl sowie Zeitpunkt und Zeitzone des Versuchs

  • Wie die Nummer verwendet wird: neu, WhatsApp Business-App oder anderer Anbieter

  • Für Koexistenz: App-Version, wie lange sie bereits genutzt wird und ob sie auf dem Telefon noch funktioniert

  • Ihrer Unternehmensportfolio-ID, WhatsApp Business Account ID und Phone Number ID, beschriftet

Teilen Sie niemals Ihr Passwort, Zugriffstoken, Ihren Bestätigungscode oder Ihren Zwei-Faktor-PIN. Verbergen Sie diese in Screenshots. Chatwoot kann Metas Entscheidungen zu Einschränkungen oder Überprüfungen nicht außer Kraft setzen.