WhatsApp-Business-API-Fehler: was jeder Code bedeutet und wie Sie ihn beheben

WhatsApp Business API funktioniert nicht: prüfen Sie zuerst diese fünf Punkte

Wenn alle Nachrichten auf einmal stoppen, ist die Ursache fast immer eine von fünf Dingen, und Sie können alle in wenigen Minuten prüfen. Gehen Sie sie in dieser Reihenfolge durch, denn die ersten Prüfungen betreffen jede Nachricht, die letzte betrifft einzelne Kunden.

1. 1

   Metas Statusseite prüfen

   Öffnen Sie Metas Statusseite zur WhatsApp Business API. Meldet Meta ein Problem, warten Sie, bis es behoben ist, bevor Sie Einstellungen ändern. Die Codes 1, 2, 131016 und 133004 deuten darauf hin.
2. 2

   Den Status Ihrer Nummer in Whapi prüfen

   Im Whapi-Dashboard in Shopify sollte Ihre WhatsApp-Nummer einen grünen Status zeigen. Meta sendet und empfängt Nachrichten nur für Nummern mit dem Status „Connected“. Ist sie nicht verbunden, klicken Sie auf „Connect WhatsApp“ und verbinden Sie sie neu.
3. 3

   Die Zahlungsmethode bei Meta prüfen

   Öffnen Sie den WhatsApp Manager und achten Sie auf der Overview-Seite auf eine Aufforderung Add payment method. Ohne gültige Zahlungsmethode schlagen Vorlagennachrichten fehl, oft mit Fehler 131042. Folgen Sie der Anleitung zur Zahlungsmethode.
4. 4

   Den Vorlagenstatus prüfen

   Jede Whapi-Automatisierung sendet eine Vorlage, die Meta genehmigen muss. Eine Vorlage, die noch in Prüfung, abgelehnt oder pausiert ist, scheitert mit 132001, 132015 oder 132016. Siehe warum Vorlagen abgelehnt werden.
5. 5

   Die Nummer des Kunden prüfen

   Wenn nur manche Kunden keine Nachrichten bekommen, sehen Sie sich den Code der fehlgeschlagenen Nachricht an. 131026 bedeutet, dass die Nummer keine WhatsApp-Nachrichten empfangen kann, 131047, dass das 24-Stunden-Fenster geschlossen ist, 131049 und 131050 betreffen Marketing-Nachrichten.

Fehler bei Einrichtung und Verbindung

Einrichtungsfehler erscheinen in Metas Anmelde-Popup, nachdem Sie in Whapi auf Connect WhatsApp geklickt haben. Sie stammen aus Metas Embedded-Signup-Ablauf, daher ist der Wortlaut unten Metas (englisches Original mit deutscher Erklärung), und die Lösung findet auf der Meta- oder WhatsApp-Seite statt.

„Your phone number isn’t eligible to connect to the WhatsApp Business Platform“

Das ist Metas Code 3441045 (Ihre Nummer ist nicht zur Verbindung mit der WhatsApp Business Platform zugelassen), der beim Verbinden einer Nummer der WhatsApp Business App erscheint. Metas einzige genannte Lösung ist, dass für die Zulässigkeitsprüfung mehr Aktivität in der WhatsApp Business App nötig ist, und es nennt kein Minimum. Die Anleitung zur nicht zulässigen Telefonnummer beschreibt, was zu tun ist, und die verwandten Verifizierungsfehler.

„This number is registered to an existing WhatsApp account“

Meta zeigt das (diese Nummer ist bei einem bestehenden WhatsApp-Konto registriert), wenn die Nummer bereits in WhatsApp Messenger, der WhatsApp Business App oder der WhatsApp Business API genutzt wird. Liegt die Nummer in der WhatsApp Business App und möchten Sie die App weiter nutzen, wählen Sie in Whapis Einrichtung stattdessen Connect a WhatsApp Business App (das ist WhatsApp Coexistence). Um die Nummer nur über die API zu nutzen, löschen Sie zuerst das WhatsApp-Konto auf dem Handy. Laut Meta kann es bis zu 3 Minuten dauern, bis die Nummer verfügbar ist.

„The business is already sharing this WhatsApp Business account with a partner“

Das ist Code 2655093 (das Unternehmen teilt dieses WhatsApp Business-Konto bereits mit einem Partner). Ihre Nummer der WhatsApp Business App ist noch mit einem anderen Anbieter verbunden, und Meta unterstützt den Partnerwechsel in diesem Ablauf nicht. Trennen Sie den aktuellen Partner in der WhatsApp Business App unter Settings > Account > Business Platform, warten Sie 15 Minuten und verbinden Sie dann erneut. Die Anleitung zum Umzug Ihrer Nummer zu Whapi behandelt sowohl Coexistence- als auch reine API-Nummern.

Das Meta-Popup öffnet sich nicht oder schließt sich auf halbem Weg

Metas Anmeldung läuft in einem Popup-Fenster. Führen Sie Whapis Einrichtung auf einem Computer aus, erlauben Sie Popups für Ihren Shopify-Admin im Browser und laden Sie die Seite neu. Sagt Meta „Your Facebook account is too new to create a business account. Try again in an hour“ (Ihr Facebook-Konto ist zu neu, um ein Unternehmenskonto zu erstellen, versuchen Sie es in einer Stunde erneut), warten Sie oder melden Sie sich mit einem älteren, aktiven Facebook-Konto an. Sagt es „User does not have permission to create WhatsApp Business Accounts“ (der Nutzer hat keine Berechtigung, WhatsApp Business-Konten zu erstellen), brauchen Sie Admin-Zugriff auf das gewählte Unternehmensportfolio.

Anzeigename abgelehnt

Meta prüft Ihren WhatsApp-Anzeigenamen anhand seiner Richtlinien für Anzeigenamen. Sagt die Anmeldung „Your verified name violates WhatsApp guidelines. Please edit your verified name and try again“ (Ihr verifizierter Name verstößt gegen die WhatsApp-Richtlinien, bitte bearbeiten Sie ihn und versuchen Sie es erneut), lesen Sie die Richtlinien für Anzeigenamen und geben Sie einen Namen ein, der sie einhält. Einen Anzeigenamen können Sie bis zu 10 Mal in 30 Tagen im WhatsApp Manager unter Account tools > Phone numbers > Profile ändern. Fehler 131037 betrifft nur von Meta bereitgestellte 555-Geschäftsnummern ohne genehmigten Anzeigenamen.

Business Verification und Nummernlimits

Ein neues Unternehmensportfolio kann zwei Geschäftsnummern registrieren. Meta hebt diese Obergrenze auf 20 an, sobald das Unternehmen verifiziert ist oder ein Nachrichtenlimit von 2.000 erreicht. Bis zur Verifizierung begrenzt Meta außerdem, wie viele WhatsApp Business-Konten Sie erstellen können (Code 2388098). Dokumente und Schritte stehen unter Meta Business Verification für WhatsApp.

Zahlungs- und Abrechnungsfehler

Fehler 131042, „There was an error related to your payment method“ (es gab einen Fehler mit Ihrer Zahlungsmethode), bedeutet, dass Meta das Messaging-Konto, das Ihre Nachrichten sendet, nicht belasten kann. Metas eigene Ursachenliste umfasst: kein Zahlungskonto hinterlegt, eine Kreditlinie über dem Limit, ein gelöschtes oder gesperrtes WhatsApp Business-Konto und eine nie festgelegte Zeitzone oder Währung.

Seit dem 1. Oktober 2026 stoppt eine fehlende Zahlungsmethode außerdem Service-Nachrichten, sobald die 1.000 kostenlosen pro Geschäftsnummer und Monat aufgebraucht sind, und Utility-Vorlagen innerhalb eines offenen 24-Stunden-Fensters werden berechnet. Der Beitrag zur Preisänderung im Oktober 2026 erklärt die Details.

Die Anleitung zur Zahlungsmethode führt durch das Hinzufügen einer Karte im WhatsApp Manager und die Kartenfehler, die Meta zeigt, etwa „Couldn’t save payment method“ (Zahlungsmethode konnte nicht gespeichert werden). Preise pro Land stehen auf der Seite WhatsApp API Preise.

Zustellfehler bei Nachrichten

Zustellfehler betreffen jeweils einen Kunden oder eine Nachricht, sodass der Rest Ihrer Nachrichten weiter rausgeht. Behandeln Sie sie als Information über diesen Kunden und vermeiden Sie es, dieselbe Nachricht immer wieder neu zu versuchen.

131026: Nachricht nicht zustellbar

Meta nennt drei Gründe: Die Nummer ist keine WhatsApp-Nummer, der Kunde hat die neuesten WhatsApp-Nutzungsbedingungen nicht akzeptiert, oder die App des Kunden ist älter als die von Meta unterstützte Mindestversion. Scheitert eine Bestellbestätigung, rufen Sie den Kunden an oder senden Sie stattdessen eine SMS. Die Anleitung zu Fehler 131026 listet die Prüfungen auf.

131047: 24-Stunden-Fenster geschlossen

Freie Antworten sind nur innerhalb von 24 Stunden nach der letzten Nachricht des Kunden erlaubt. Danach senden Sie eine genehmigte Vorlage. Mehr zu Fehler 131047 und dem Kundenservicefenster.

131049 und 131050: Marketing-Nachrichten zurückgehalten

131049 bedeutet, dass Meta Marketing-Vorlagen an diesen Kunden begrenzt hat („to maintain healthy ecosystem engagement“, also um ein gesundes Engagement zu erhalten). Warten Sie mindestens 24 Stunden, bevor Sie erneut senden. 131050 bedeutet, dass der Kunde Marketing-Nachrichten Ihres Unternehmens abgeschaltet hat, versuchen Sie es also nicht erneut. Beide betreffen Marketing-Vorlagen. Siehe die Anleitung zu Fehler 131049.

130429 und 131056: zu schnell gesendet

130429 bedeutet, dass der Nachrichtendurchsatz der Nummer erreicht wurde; versuchen Sie es später erneut. 131056 bedeutet, dass in kurzer Zeit zu viele Nachrichten an denselben Kunden gingen; warten Sie, bevor Sie diesen Kunden erneut anschreiben, andere Kunden sind nicht betroffen.

131021: Test an die eigene Geschäftsnummer gesendet

Meta stellt keine Nachricht von einer Nummer an sich selbst zu. Wenn Sie in Whapi Send Test Message nutzen, geben Sie eine private WhatsApp-Nummer ein, die sich von der Geschäftsnummer unterscheidet.

Vorlagenfehler

Vorlagenfehler bedeuten, dass Meta die Vorlage nicht genehmigt hat, die Variablen der Nachricht nicht zu ihr passen oder Meta sie pausiert hat, weil Kunden sie blockiert oder gemeldet haben. Whapi reicht Vorlagen bei Meta ein, wenn Sie eine Automatisierung einrichten, und Meta entscheidet über Kategorie und Genehmigung.

• 132001: Die Vorlage existiert in dieser Sprache nicht oder ist nicht genehmigt. Prüfen Sie ihren Status in Whapi oder im WhatsApp Manager.
• 132000 und 132012: Die gesendeten Variablen passen nicht zu Anzahl oder Format der Vorlage. Gleichen Sie sie an oder senden Sie dem Whapi-Support den Namen der Automatisierung.
• 132005: Eine Übersetzung ist zu lang. Kürzen Sie diese Sprachversion.
• 132007: Der Inhalt verstößt gegen eine WhatsApp-Richtlinie. Siehe warum Meta Vorlagen ablehnt.
• 132015 und 132016: wegen geringer Qualität pausiert, nach wiederholten Pausen dauerhaft deaktiviert. Bearbeiten Sie eine pausierte Vorlage; ersetzen Sie eine deaktivierte durch eine mit neuem Inhalt.
• 131064: Das Konto hat wegen Verstößen gegen die Vorlagenklassifizierung ein Nachrichtenlimit erreicht. Stellen Sie sicher, dass Bestellupdates als Utility und Werbung als Marketing formuliert sind. Der Leitfaden Utility vs. Marketing erklärt den Unterschied.
• 2388019: Das Konto hat bereits das Maximum von 250 Vorlagen. Löschen Sie Vorlagen, die Sie nicht mehr nutzen.
• Vorlage als Marketing neu kategorisiert: Dafür gibt es keinen Fehlercode. Seit dem 9. April 2025 wird eine als Utility eingereichte Vorlage, die Meta als Marketing einstuft, als Marketing genehmigt, und Meta kann die Kategorie einer genehmigten Vorlage auch später ändern. Gemischter Inhalt, etwa ein Bestellupdate mit Rabattcode, zählt als Marketing. Sie können innerhalb von 60 Tagen nach der Kategorieänderung eine Prüfung beantragen.

Qualitätsbewertung, Nachrichtenlimits und Kontoeinschränkungen

Meta senkt Limits oder schränkt eine Nummer ein, wenn Kunden deren Nachrichten blockieren oder melden oder das Unternehmen gegen eine WhatsApp-Business-Richtlinie verstößt. Whapi nutzt Metas offizielle WhatsApp Business API, die die Sperren vermeidet, die inoffizielle WhatsApp-Web-Tools auslösen, aber Meta kann trotzdem jede Nummer einschränken, die gegen seine Richtlinien verstößt.

Nachrichtenlimits

Ein Nachrichtenlimit begrenzt, wie viele verschiedene Kunden Sie in einem gleitenden 24-Stunden-Zeitraum außerhalb eines Kundenservicefensters anschreiben können. Es gilt pro Unternehmensportfolio und wird von allen Nummern darin geteilt. Neue Portfolios starten bei 250. Um 2.000 zu erreichen, verifizieren Sie Ihr Unternehmen oder senden innerhalb von 30 Tagen 2.000 zugestellte Nachrichten mit hochwertigen Vorlagen außerhalb von Servicefenstern an verschiedene Kunden. Danach hebt Meta das Limit automatisch auf 10.000, 100.000 und unbegrenzt an, wenn die Qualität hoch bleibt und Sie in 7 Tagen mindestens die Hälfte Ihres aktuellen Limits nutzen. Ihr Limit sehen Sie im WhatsApp Manager unter Account tools > Messaging limits.

131048, 368 und 131031: eingeschränkter Versand oder eingeschränkte Konten

131048 bedeutet, dass der Versand von der Nummer eingeschränkt ist, weil zu viele frühere Nachrichten blockiert oder als Spam markiert wurden; prüfen Sie den Qualitätsstatus im WhatsApp Manager. Die Codes 368 und 131031 bedeuten, dass das Konto wegen eines Richtlinienverstoßes eingeschränkt oder deaktiviert wurde. Lesen Sie den Hinweis im Business Support Home und legen Sie dort Einspruch ein, wenn Sie ihn für einen Irrtum halten. Code 130497 bedeutet, dass Ihre Unternehmenskategorie Kunden in bestimmten Ländern nicht anschreiben darf.

Halten Sie Ihre Qualitätsbewertung gesund

• Schreiben Sie nur Kunden an, die bei Ihnen bestellt oder zugestimmt haben.
• Senden Sie Bestellupdates, etwa Bestellbestätigungen, als Utility-Vorlagen und halten Sie Werbung in Marketing-Vorlagen.
• Halten Sie Marketing relevant und selten und machen Sie das Abmelden einfach.

Coexistence, Calling, Flows und Benutzernamen

Diese Fehler stammen aus neueren WhatsApp-Funktionen. Die meisten Shops begegnen ihnen nur beim Verbinden einer Nummer der WhatsApp Business App oder beim Testen einer Funktion, die Meta noch ausrollt.

Coexistence: Kopplungsfehler und Broadcast-Listen

Coexistence verbindet Ihre Nummer der WhatsApp Business App mit der API, sodass Sie weiter vom Handy aus chatten können, während Whapi Automatisierungen sendet. Meta deaktiviert Broadcast-Listen in der App, sobald Sie verbinden, und bestehende Listen werden schreibgeschützt. „Error while pairing Cloud API“ und die anderen Kopplungsfehler, fehlender Chatverlauf und Verbindungsabbrüche werden unter WhatsApp Coexistence funktioniert nicht behandelt.

„Calling APIs cannot be enabled for this phone number“

Metas Fehler 138015 bedeutet, dass WhatsApp Business Calling für diese Nummer noch nicht aktiviert werden kann. Metas Lösung: Stellen Sie sicher, dass das Nachrichtenlimit der Nummer mindestens 2.000 beträgt. Nutzen Sie dafür die obigen Schritte zum Nachrichtenlimit.

WhatsApp Flows: „Blocked By Integrity“

Fehler 139000 bedeutet, dass Meta ein Integritätsproblem am Konto festgestellt hat, das das Erstellen oder Veröffentlichen eines Flows verhindert. Prüfen Sie im Business Support Home auf Einschränkungen des Unternehmens und wenden Sie sich dann an den Meta-Support, der einzigen Anlaufstelle, die Meta für diesen Code nennt.

Business-scoped User IDs (BSUID)

WhatsApp führt optionale Benutzernamen ein, daher identifiziert Meta Kunden jetzt auch mit einer Business-scoped User ID (BSUID), die für jedes Unternehmensportfolio eindeutig ist. Manche Nachrichtentypen können nicht an eine BSUID adressiert werden, und Meta gibt 131062 zurück, „Business-scoped User ID (BSUID) recipients are not supported for this message.“ (Empfänger mit BSUID werden für diese Nachricht nicht unterstützt.) Der Versand an die Telefonnummer des Kunden vermeidet das. Shopify-Bestellungen enthalten die Telefonnummer, die Bestell-Automatisierungen verwenden.

Meta-Ausfälle und abgelaufener Zugriff

Die Codes 2, 131016 und 133004 bedeuten, dass Metas Dienst überlastet oder kurz nicht verfügbar ist, die Lösung ist also zu warten und es erneut zu versuchen. Code 1 kann ein Serverfehler oder eine fehlerhafte Anfrage sein, und Metas Rat für alle vier ist, zuerst metastatus.com zu prüfen. 131000 ist ein unbekannter Fehler; versuchen Sie es einmal erneut und melden Sie ihn, wenn er sich wiederholt.

Die Codes 0 und 190 bedeuten, dass das Zugriffstoken, mit dem Whapi für Ihr Konto sendet, abgelaufen oder ungültig geworden ist. Meta nennt als Ursache auch eine Nutzereinstellung, die allen Apps den Zugriff auf ihre Daten verbietet. Die Codes 10 und 200 bis 299 bedeuten, dass eine Berechtigung entfernt wurde. Verbinden Sie WhatsApp in jedem Fall im Whapi-Dashboard neu, damit Meta neuen Zugriff ausstellt.

So bekommen Sie Hilfe bei einem WhatsApp-API-Fehler

Senden Sie zuerst den Fehlercode, denn er sagt dem Support, wo er suchen muss. Der Whapi-Support antwortet per E-Mail an info@usewhapi.com und auf WhatsApp. Geben Sie an:

• den Fehlercode und Metas Meldung oder einen Screenshot davon;
• Datum und Uhrzeit des Auftretens, mit Ihrer Zeitzone;
• die Shopify-Bestellnummer oder die Automatisierung, die fehlgeschlagen ist;
• ob jede Nachricht fehlschlägt oder nur einige Kunden.

Bei Konto-, Abrechnungs- oder Richtlinienproblemen, die nur Meta beheben kann, eröffnen Sie ein Ticket im Meta Direct Support. Bei Kartenproblemen bittet Meta Sie, das Thema „Dev: Billing, Credit & Pricing“ und die Anfrageart „Credit Card Billing“ zu wählen. Sehen Sie dieses Thema nicht, sagt Meta, dass Sie Ihren Anbieter bitten sollen, das Ticket zu eröffnen. Schreiben Sie uns also, und wir eröffnen es. Sie erreichen uns auch über die Kontaktseite.