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 21, 2026

Bevor Sie etwas ändern: Löschen Sie Ihr WhatsApp-Konto nicht, entfernen Sie Ihr WhatsApp Business-Konto nicht und trennen Sie keinen Anbieter als generelle Lösung. 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 auftrat.

Verbindung herstellen

Ermitteln Sie zuerst, wie Ihre Nummer derzeit verwendet wird: eine neue Nummer, eine Nummer in der WhatsApp Business-App (benutzen Sie Koexistenz, um die App zu behalten) oder eine Nummer bei einem anderen API-Anbieter (diese folgen einem anderen Ablauf). Siehe So wählen Sie, wie WhatsApp verbunden wird.

Was Sie sehen Meta-Code Bedeutung und Vorgehen
Nummer nicht berechtigt, benötigt mehr Aktivität in der WhatsApp Business-App 3441045 Eine Berechtigungsprüfung für Koexistenz. Nutzen Sie die App wie gewohnt mit echten Kund:innen und versuchen Sie es später erneut. Meta gibt kein Minimum an. Generieren Sie keine Fake-Aktivität und erstellen Sie das Konto nicht erneut.
Nummer nicht registriert mit der WhatsApp Business-App 2655095, 2655048 Prüfen Sie die Nummer und die Ländervorwahl sowie, dass sie in der Business-App ist (nicht persönliches WhatsApp). Für eine neue API-Nummer verwenden Sie den neuen Nummern-Ablauf.
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 einem Partner zugeordnet ist. Das bestätigt nicht, dass der andere Anbieter noch aktiv ist. Ein Wechsel des Partners ist in diesem Ablauf nicht möglich. Wenn die Nummer von einem anderen Anbieter stammt, siehe Fehler 2655093 nach dem Wechsel von einem anderen Anbieter unten. Kontaktieren Sie den Support, bevor Sie etwas trennen.
Bereits beim Produkt registriert oder trennen Sie Ihre Unternehmensplattform 3441049, 2655094 Eine bestehende Plattform-Verbindung muss zuerst behandelt werden. Um die aktuelle Partner-Verbindung zu sehen: WhatsApp Business App › Einstellungen › Konto › Business Platform oder Meta Business Einstellungen › Konten › WhatsApp-Konten › Partner. Wenn Sie absichtlich trennen, schreibt Meta eine Wartezeit von 15 Minuten vor, bevor Sie es erneut versuchen.
Diese Nummer ist bereits einem bestehenden WhatsApp-Konto zugeordnet Die Nummer ist aktiv in der WhatsApp Business-App. Um die App weiterhin zu nutzen, verbinden Sie per Koexistenz (Quick Setup mit Meta verbinden). Verwenden Sie nicht den Weg für neue Nummern, da dies die Nummer aus der App entfernt.
Diese Telefonnummer existiert bereits in Ihrer Liste der Telefonnummern Kehren Sie zurück und wählen Sie die vorhandene Nummer im richtigen WhatsApp Business-Konto, anstatt sie erneut hinzuzufügen.
Nummer ist nicht mit dem gewählten Unternehmen verknüpft 3441041 Wählen Sie das Unternehmens-Portfolio, das die Nummer besitzt.
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 Seiten-Admin) oder verwenden Sie eine andere Nummer.
Konto nutzt Marketing-Nachrichten 3441047 Wählen Sie ein anderes WhatsApp Business-Konto. Wiederholen 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 Widerspruch ein. Erstellen Sie keine neuen Konten, um dies zu umgehen.
Verifizierung wurde mit einem anderen Partner begonnen 2494143 Setzen Sie mit diesem Partner fort oder beantragen Sie direkt eine Meta-Unternehmensverifizierung.
Funktion in Ihrer Region nicht verfügbar 3441042 Prüfen Sie die Ländervorwahl. Wenn korrekt, ist dieser Ablauf für die Nummer noch nicht verfügbar.
Code konnte nicht gesendet oder verifiziert werden 2388091, 2388093 Überprüfen Sie die Nummer und nutzen Sie eine Methode, die sie empfangen kann (Festnetznummern benötigen einen Anruf). IVR-Nummern werden nicht unterstützt.

Weitere Verbindungsprobleme

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

  • Facebook-Konto zu neu: Warten Sie ein paar Stunden oder verwenden Sie ein etabliertes Konto mit Unternehmenskontakten.

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

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

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

  • "Zu viele Versuche geraten": Warten Sie ca. 12 Stunden. "Code zu oft angefordert": Folgen Sie der von Meta angezeigten Wartezeit.

  • Fehler 2655093 nach Wechsel von einem anderen Anbieter: Die Kreditlinie des bisherigen Anbieters ist möglicherweise noch Ihrem WhatsApp Business-Konto zugeordnet. Das Entfernen des Anbieterzugriffs in Ihren Business-Einstellungen löst dies nicht immer. Zum Prüfen öffnen Sie die Details zur Kreditlinie des Kontos im WhatsApp Manager: Zugewiesen von zeigt den Anbieter, der sie hält. Bitten Sie diesen Anbieter, die Kreditlinie freizugeben, und versuchen Sie dann Quick Setup erneut. Wenn der Fehler weiter auftritt, kontaktieren Sie den Support mit Ihrer WhatsApp Business Account ID und den Fehlerdetails.

    • Registrieren Sie die Nummer nicht erneut in einer anderen WhatsApp-App, um diesen Fehler zu beheben. Eine Neu-Registrierung unterbricht den Nachrichtenfluss, Nachrichten nach dem Backup können verloren gehen und der Chatverlauf auf dem Telefon wird nicht in Chatwoot importiert.

  • Koexistenz mit QR-Code verbinden: Statt eines Verifizierungscodes zur Eingabe in der App zeigt der Ablauf evtl. QR-Code scannen an. Nutzen Sie den Scanner und den vom Ablauf vorgegebenen Code und lassen Sie das Meta-Fenster offen, bis alles abgeschlossen ist. Schlägt das Scannen fehl, prüfen Sie Kamera-Berechtigungen und benutzen Sie den aktuellen Code. Wenn der Ablauf nach einem SMS- oder Anruf-Code fragt, stoppen Sie: Das ist der neue Nummernweg, der die Nummer aus der App entfernt.

  • Koexistenz-Aufforderung oder QR-Code funktioniert nicht: Nutzen Sie die neueste Business-App, lassen Sie das Handy online, lassen Sie das Anmeldefenster offen und prüfen Sie die Kameraberechtigung für QR-Codes. Wechseln Sie nicht auf den manuellen Registrierungsweg, um einen fehlgeschlagenen Koexistenz-Schritt zu umgehen.

  • Meta-Fenster öffnet sich nicht oder bleibt hängen: Pop-ups erlauben, blockierende Erweiterungen deaktivieren, Meta-Sicherheitsprüfung abschließen und nach einem temporären Fehler einige Minuten warten.

  • Meta ist fertig, 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.

  • Alte Chats fehlen nach Koexistenz: Das ist zu erwarten. Chatwoot importiert keine Chats von vor der Verbindung, selbst wenn Sie in Meta das Teilen des Chatverlaufs gewählt haben. Ab Verbindung erscheinen neue Kunden-Nachrichten und Ihre Antworten aus der WhatsApp Business-App in Chatwoot. Stellen Sie keine erneute Verbindung her, um alte Chats zu übertragen.

Nachrichten empfangen und senden

Symptom Wahrscheinliche Ursache Was tun
Nachrichten treffen nicht mehr ein, aber die Nummer ist verbunden und Qualität ist grün Etwas an der Verbindung benötigt Aufmerksamkeit: Registrierung, Berechtigungen oder der Webhook. Häufig nach Änderung des Anzeigenamens oder Profils. Nach jeder Korrektur senden Sie eine Testnachricht an Ihre Nummer und antworten von Chatwoot, um beide Richtungen zu prüfen. Kontaktieren Sie zuerst den Support, damit wir Registrierung, Berechtigungen und Webhook für Ihren Posteingang prüfen können. Wenn die Nummer neu registriert werden muss, erledigen Sie das selbst in Meta und folgen Metas Prozess. Löschen Sie die Nummer nicht und erstellen Sie keinen neuen Posteingang. Koexistenz-Nummern benötigen einen eigenen Wiederherstellungsweg, wenden Sie sich vor Änderungen an den Support.
Nach Einrichtung kommen keine Nachrichten an Ein möglicher Grund: Der Webhook ist nicht registriert oder verweist woandershin Öffnen Sie Konto-Integrität. Wenn Webhook-Konfiguration Webhook nicht konfiguriert oder Webhook-URL stimmt nicht überein zeigt, klicken Sie auf Webhook registrieren. Testen Sie: Senden Sie eine Nachricht an Ihre Nummer von einem anderen Handy, prüfen Sie, dass sie in Chatwoot ankommt, und antworten Sie von Chatwoot aus. Bleiben Nachrichten trotz korrekt konfiguriertem Webhook aus, kontaktieren Sie den Support. Für Twilio prüfen Sie die Callback-URL unter WhatsApp via Twilio verbinden.
Sie können nur mit einer Vorlage antworten Über 24 Stunden seit letzter Kunden-Nachricht Senden Sie eine Vorlage. Siehe Vorlagen und 24-Stunden-Fenster
Nachricht schlägt mit Fehler 131026 fehl (Nachricht unzustellbar) WhatsApp konnte die Nachricht nicht zustellen. Mögliche Gründe: Nummer ist nicht bei WhatsApp, Empfänger hat WhatsApps neueste Bedingungen nicht akzeptiert oder seine App ist veraltet. Bitten Sie den Empfänger über einen anderen Kanal, Nummer und Vorwahl zu prüfen, zu kontrollieren, dass er Sie nicht blockiert hat, seine App zu aktualisieren und Bedingungen zu akzeptieren und Ihnen zuerst eine WhatsApp-Nachricht zu senden. Trennen Sie den Posteingang nicht und registrieren Sie die Nummer für diesen Fehler nicht erneut.
Nachricht schlägt mit Fehler 131049 fehl Meta hat diese Marketing-Vorlage nicht zugestellt, um das Engagement gesund zu halten. WhatsApp limitiert, wie viele Marketing-Nachrichten eine Person von allen Unternehmen erhält. Senden Sie die Vorlage nicht erneut oder klicken Sie nicht direkt auf Wiederholen. Warten Sie mindestens 24 Stunden, bevor Sie dieser Person wieder eine Marketing-Vorlage schicken. Antwortet der Kunde, zählen Marketing-Nachrichten im 24-Stunden-Fenster nicht zum Limit.
WhatsApp-Verbindung muss aktualisiert werden / Ihr Posteingang ist getrennt Die Quick Setup-Verbindung ist abgelaufen Klicken Sie im Banner auf Hier erneut verbinden. Siehe WhatsApp-Nummer verwalten
WhatsApp-Zugangstoken benötigt Aufmerksamkeit Das Token aus dem manuellen Setup ist abgelaufen oder wurde widerrufen Ersetzen Sie es im Tab Konfiguration des Posteingangs

Vorlagen

Symptom Wahrscheinliche Ursache Was tun
Eine Vorlage fehlt in Chatwoot Noch nicht genehmigt, nicht synchronisiert oder von einem Typ, den Chatwoot nicht unterstützt Prüfen Sie den Status im WhatsApp Manager (bei Twilio-Posteingängen in der Twilio-Konsole) und klicken Sie auf Vorlagen synchronisieren. Unterstütze Typen unter Vorlagen und das 24-Stunden-Fenster.
Nachrichten funktionieren, aber Vorlagen werden nie synchronisiert (Quick Setup) Die Verbindung hat die Berechtigung zum Lesen Ihres WhatsApp Business-Kontos verloren Fügen Sie ein Business Management Token hinzu
Business Management Token: Business management token muss die Berechtigung whatsapp_business_management gewähren whatsapp_business_management wurde nicht ausgewählt Erstellen Sie ein neues Token mit dieser Berechtigung
Business Management Token: kein Zugriff, oder Token ungültig Der Systembenutzer hat das WhatsApp-Konto nicht oder das Token ist abgelaufen oder gehört zu einer anderen App Prüfen Sie die zugewiesenen Assets und die App des Systembenutzers, dann ein neues Token generieren
Token akzeptiert, Vorlagen fehlen weiterhin Das Token hat Zugriff auf ein anderes WhatsApp Business-Konto Prüfen Sie, dass der Systembenutzer exakt das vom Posteingang genutzte Konto hat und die Vorlagen dort existieren
Eine Vorlage lässt sich nicht senden, oder Medien werden nicht angezeigt Leere Variablen, privater oder fehlerhafter Medien-Link oder Datei überschreitet Metas Limits Füllen Sie jede Variable aus, verwenden Sie einen öffentlichen Link und prüfen Sie das Format und die Größenbegrenzungen in Vorlagen und das 24-Stunden-Fenster
Ein URL-Button öffnet die falsche Seite oder das Senden der Vorlage schlägt fehl Die Variable des Buttons ist leer oder falsch Bei einem URL-Button mit Variable geben Sie beim Senden den Wert unter Button-Parameter ein. WhatsApp hängt ihn am Ende der im Template gesetzten Basis-URL an. Geben Sie also nur den variablen Teil ein, nicht den vollständigen Link. Prüfen Sie bei Fehlern die exakte Fehlermeldung an der gescheiterten Nachricht und beheben Sie das Benannte.

Kontakte und Telefonnummern

Nummern sehen in WhatsApp und Chatwoot unterschiedlich aus (Brasilien, Mexiko, Argentinien). Diese Länder haben ihre Mobilnummern-Formate geändert und WhatsApp nutzt möglicherweise noch das alte:

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

  • Argentinien: Eine 9 nach dem Ländercode kann vorhanden sein oder fehlen (+54 9 11 ... vs +54 11 ...).

  • Mexiko: WhatsApp kann eine 1 nach dem Ländercode einfügen (+52 1 ... vs +52 ...).

Das kommt von WhatsApp und es gibt keine Einstellung dafür. In Brasilien und Mexiko gleicht Chatwoot beide Formate demselben Kontakt zu, sodass die Nummer nur unterschiedlich aussieht. In Argentinien ordnet Chatwoot eine Nachricht des Formats +54 9 einem ohne 9 gespeicherten Kontakt zu, aber nicht umgekehrt. Ein mit 9 gespeicherter Kontakt bekommt einen Doppelten. Am häufigsten tritt dies auf, wenn Sie eine Unterhaltung im aktuellen Format beginnen und WhatsApp von der alten registrierten Nummer antwortet. Sie können trotzdem normal mit diesen Kund:innen weiter schreiben.

Ein Kontakt hat keine Telefonnummer. Das ist möglich. WhatsApp ermöglicht, dass manche Personen Unternehmen per Username anschreiben, ohne ihre Nummer preiszugeben. Chatwoot identifiziert den Kontakt dann per Business-Scoped User ID (BSUID) und zeigt den Username an, falls WhatsApp einen liefert. Sie können trotzdem Nachrichten empfangen und antworten. Siehe WhatsApp-Benutzernamen und BSUID in Chatwoot.

Support kontaktieren

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

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

  • Dem Schritt, der fehlschlug, und ob der Fehler in Meta oder Chatwoot erschien

  • Ihrem Posteingang-Link, der Geschäftsnummer mit Ländervorwahl und Zeitpunkt sowie Zeitzone des Versuchs

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

  • Bei Koexistenz: App-Version, Nutzungsdauer und ob sie auf dem Handy noch funktioniert

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

Teilen Sie niemals Ihr Passwort, Zugriffstoken, Ihren Verifizierungscode oder Ihre Zwei-Faktor-PIN. Schwärzen Sie diese Angaben auf Screenshots. Chatwoot kann Metas Entscheidungen zu Einschränkungen oder Überprüfungen nicht außer Kraft setzen.