> For the complete documentation index, see [llms.txt](https://one-loop.gitbook.io/help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://one-loop.gitbook.io/help/plattform/one-loop-plattform/kommunikation/sms-und-whatsapp/whatsapp-zustellfehler-gezielt-prufen.md). # WhatsApp-Zustellfehler gezielt prüfen ## Was die Fehlermeldungen bedeuten Eine WhatsApp-Nachricht kann als gesendet erscheinen, ohne das Gerät der empfangenden Person zu erreichen. Prüfe zuerst den einzelnen Kontakt und die Nachricht. Versende nicht sofort dieselbe Vorlage wiederholt, denn das kann weitere Zustellprobleme auslösen. ## Zwei Hinweise richtig unterscheiden **Meta hat nicht zugestellt** bedeutet, dass eine Marketingvorlage für diesen Empfänger vorübergehend begrenzt wurde. Wiederhole die Vorlage nicht sofort. Warte ab, prüfe die bisherige Reaktion des Kontakts und versende nur bei einem neuen, erwarteten Anlass erneut. **Nachricht nicht zustellbar** weist häufiger auf die Rufnummer, eine fehlende WhatsApp-Nutzung, eine nicht aktuelle App oder nicht bestätigte Nutzungsbedingungen hin. Prüfe zuerst diese Voraussetzungen beim einzelnen Kontakt. Die genaue Fehlermeldung hilft dir, den richtigen Weg zu wählen; sie ist kein Grund, mehrere Vorlagen nacheinander zu testen. ## Häufige Ursachen bei nicht zugestellten Nachrichten Eine Zustellung kann aus Gründen scheitern, die du nicht direkt im Standort ändern kannst: * Die Person war länger als 30 Tage nicht bei WhatsApp aktiv. Nachrichten werden für nicht aktive Empfänger nur begrenzt vorgehalten. * Die Person hat eure Rufnummer blockiert. Aus Datenschutzgründen erhältst du darüber keine direkte Bestätigung. * Die Rufnummer ist falsch, nicht bei WhatsApp registriert oder die Person verwendet eine veraltete App-Version. * Die aktuellen Nutzungsbedingungen wurden noch nicht bestätigt. * Die Person befindet sich in einem Gebiet, in dem WhatsApp Business nicht verfügbar ist. Dazu zählen derzeit unter anderem Kuba, Iran, Nordkorea, Syrien sowie die Regionen Krim, Donezk und Luhansk. Diese Einschränkungen können sich ändern. * Eine Vorlage ist für den Kontakt vorübergehend begrenzt. Bei mehreren verwendeten Geräten kann ein Status widersprüchlich wirken: Wird die Nachricht an mindestens ein Gerät zugestellt, gilt sie als zugestellt, auch wenn ein anderes Gerät einen Fehler meldet. ## Wenn eine Nachricht nicht zugestellt wird Gehe in dieser Reihenfolge vor: 1. Öffne den Kontakt und prüfe die Rufnummer auf Vollständigkeit und Richtigkeit. 2. Prüfe, ob die Person WhatsApp mit dieser Rufnummer verwendet. 3. Kontrolliere, ob eine passende Einwilligung für den Kontakt vorliegt. 4. Prüfe, ob die Nachricht für den Anlass relevant und erwartet ist. 5. Warte vor einem erneuten Versuch deutlich länger und dokumentiere den Fehler. 6. Nutze bei Bedarf einen anderen erlaubten Kommunikationsweg, um die Person um eine Prüfung ihrer WhatsApp-App, der Rufnummer und der aktuellen Nutzungsbedingungen zu bitten. Wenn die Ursache unklar bleibt, kann eine erwartete eingehende Nachricht der Person eine normale Antwort im laufenden Gespräch ermöglichen. Bitte Kontakte niemals nur zur Umgehung einer Zustellbegrenzung um eine Nachricht. Fehlt eine technische Angabe in einer Vorlage oder werden Platzhalter nicht korrekt gefüllt, kann eine Nachricht bereits vor der Zustellung abgewiesen werden. Solche technischen Prüfungen gehören an die zuständige Person für die Einrichtung; ändere nicht auf Verdacht mehrere Vorlagen gleichzeitig. ## Qualität nachhaltig verbessern Hohe Zustellqualität entsteht durch erwartete, hilfreiche und zurückhaltende Nachrichten: * Sende nur an Kontakte mit nachvollziehbarer Einwilligung. * Beziehe dich auf einen aktuellen Anlass. * Sprich den Kontakt persönlich und klar an. * Vermeide viele ähnliche Nachrichten in kurzer Zeit. * Biete eine klare Möglichkeit, keine weiteren Nachrichten zu erhalten. * Prüfe regelmäßig Zustellstatus, Antworten und auffällige Vorlagen. Wenn sich Zustellprobleme häufen, prüfe zuerst die zuletzt verwendeten Vorlagen und die Zielgruppe. Ändere dann nur einen klaren Punkt und beobachte die Ergebnisse. ## Ergebnis prüfen 1. Dokumentiere den konkreten Fehler am Testkontakt. 2. Prüfe Rufnummer, Einwilligung und Nachrichtentext. 3. Führe keinen sofortigen Wiederholungsversand durch. 4. Teste erst später mit einem Kontakt, der eine passende Einwilligung gegeben hat. 5. Kontrolliere, ob die Nachricht zugestellt wurde und ob es eine Antwort gibt. ## Praxisbeispiel Ein Unternehmen verschickt nach einer aktuellen Terminbuchung eine kurze, erwartete Nachricht. Bei einem Kontakt erscheint ein Zustellfehler. Das Team prüft die Rufnummer, verzichtet auf einen unmittelbaren Wiederholungsversand und bittet den Kontakt per E-Mail, die WhatsApp-App und die hinterlegte Rufnummer zu prüfen. Die nächste Nachricht wird erst nach dieser Klärung versendet. ## Typische Fehler * **Sofort mehrfach erneut senden:** Das löst die Ursache nicht und kann die Zustellung weiter beeinträchtigen. * **Nachrichten ohne Einwilligung versenden:** Das erhöht das Risiko von Beschwerden und Zustellproblemen. * **Fehler nur als Technikproblem sehen:** Häufig sind Rufnummer, Einwilligung oder Relevanz der Nachricht entscheidend. ## Wenn der Fehlercode 131049 erscheint Der Fehlercode **131049** weist darauf hin, dass für eine Person derzeit kein weiterer Versand einer WhatsApp-Marketingvorlage möglich ist. Die Begrenzung wird pro Empfänger dynamisch bewertet. Einfluss haben unter anderem die jüngste Reaktion auf vergleichbare Nachrichten und die aktuelle Auslastung des Nachrichteneingangs der Person. Der Fehler betrifft nur Marketingvorlagen, die eine neue Marketing-Unterhaltung eröffnen würden. Läuft bereits eine solche Unterhaltung, kann eine weitere Vorlage möglich sein. Antwortet die Person, beginnt ein Zeitfenster für die laufende Unterhaltung; darin gelten andere Regeln für die weitere Kommunikation. ### So reagierst du richtig 1. Öffne den fehlgeschlagenen Versand und prüfe, ob tatsächlich der Code **131049** angezeigt wird. 2. Markiere den Kontakt für diese Vorlage als vorerst nicht erreichbar. 3. Wiederhole den Versand nicht sofort. 4. Warte mindestens einen Tag, bevor du einen erneuten Versuch planst. 5. Prüfe vor einem späteren Versuch, ob der Kontakt inzwischen reagiert oder ein neuer, erwarteter Anlass besteht. 6. Nutze bei Bedarf einen anderen zulässigen Kontaktweg, statt dieselbe Vorlage mehrfach erneut zu senden. Mehrere Wiederholungsversuche in kurzer Zeit können den Zeitraum ohne Zustellung verlängern. Der Fehler bei einem Kontakt bedeutet nicht, dass andere Kontakte von derselben Vorlage betroffen sind. ### Kampagnen vorbeugend planen * Richte Vorlagen nur an Kontakte, für die Inhalt und Zeitpunkt nachvollziehbar sind. * Bevorzuge Empfänger, die zuletzt aktiv reagiert haben. * Prüfe Zustellung, Antworten und Abmeldungen regelmäßig. * Trenne servicebezogene Nachrichten klar von werblichen Nachrichten. * Plane keinen automatischen Sofort-Wiederholungsversand nach diesem Fehler. ## Hinweis zur Nachrichtenqualität Ein weiterer Hinweis kann erscheinen, wenn eine werbliche Vorlage nach der Qualitätsbewertung für einen Kontakt vorübergehend nicht verwendet werden darf. Wiederhole den Versand dann nicht sofort. Warte ab und prüfe, ob später ein konkreter, erwarteter Anlass vorliegt. Eine servicebezogene Vorlage darfst du nur verwenden, wenn die Nachricht tatsächlich einen laufenden Servicefall betrifft. Dass diese Vorlagenart anders behandelt werden kann, ist kein Grund, eine Begrenzung mit einem unpassenden Nachrichtentyp zu umgehen. Regionale Vorgaben und die Bewertung durch Meta können sich ändern. Wenn eine Zustellbegrenzung in deinem Zielgebiet unerwartet erscheint, prüfe zusätzlich den aktuellen Hinweis direkt im WhatsApp Manager. ## Praxisbeispiel Ein Terminangebot wird als WhatsApp-Vorlage an eine kleine, passende Kontaktgruppe gesendet. Bei einem Kontakt erscheint der Fehlercode **131049**. Das Team versendet nicht erneut, dokumentiert den Status und wartet ab. Nach einer späteren Reaktion des Kontakts wird nur dann eine passende weitere Nachricht gesendet, wenn sie für den Gesprächsverlauf sinnvoll ist. ## Fehler „Ungültiger Parameter“ bei einer Testnachricht Erscheint dieser Fehler, prüfe zuerst Absender- und Empfänger-Rufnummer. Sind beide identisch, kann die Nachricht nicht versendet werden. Teste mit einer anderen WhatsApp-Rufnummer als Empfänger. 1. Öffne die fehlgeschlagene Nachricht. 2. Vergleiche Absender- und Empfänger-Rufnummer einschließlich Ländervorwahl. 3. Wähle für den Test eine andere, bei WhatsApp erreichbare Nummer. 4. Wiederhole den Test erst mit dieser getrennten Rufnummer. ## Rufnummer bleibt bei der Verbindung auf „Ausstehend“ Eine Rufnummer kann bei der Verbindung ausstehend bleiben, wenn sie gleichzeitig noch in einer persönlichen App, einer Business-App oder einer anderen Nachrichtenplattform aktiv registriert ist. Eine Nummer lässt sich im üblichen Verbindungsweg nicht gleichzeitig an mehreren Stellen aktiv nutzen. 1. Prüfe alle Geräte und Plattformen, auf denen die Rufnummer noch angemeldet sein könnte. 2. Melde die Nummer dort vollständig ab oder trenne die bestehende Verbindung. 3. Warte, bis die Trennung übernommen wurde. 4. Starte erst danach einen neuen Verbindungsversuch. Wiederhole die Verbindung nicht fortlaufend. Zu viele Versuche innerhalb kurzer Zeit können weitere technische Begrenzungen auslösen. Die Dauer bis zum Wechsel von „Ausstehend“ zu aktiv ist nicht verbindlich vorgegeben. ## Der Bestätigungscode kommt nicht an Kommt der Bestätigungscode nicht an, prüfe zunächst die Rufnummer und ob sie noch in einer WhatsApp-App registriert ist. Verwende nach Möglichkeit eine bisher nicht registrierte Rufnummer für die Verbindung. Musst du dieselbe Rufnummer verwenden, kann es erforderlich sein, den bestehenden WhatsApp-Account in der App selbst zu löschen. Das entfernt die dortigen Chatverläufe und Daten dauerhaft. Sichere wichtige Informationen vorher und führe diesen Schritt nur aus, wenn die Folgen klar sind. Danach kann die Rufnummer nach einer kurzen Wartezeit erneut verbunden und der Code angefordert werden. Bleibt der Code aus, obwohl die Nummer nicht mehr registriert ist, dokumentiere Rufnummer mit Ländervorwahl, Zeitpunkt und genaue Fehlermeldung. Gib diese Informationen zusammen mit einem Screenshot an die zuständige Unterstützung weiter. ### Prüfliste vor einem neuen Versuch * Absender und Testempfänger sind zwei unterschiedliche Rufnummern. * Die einzurichtende Rufnummer ist nicht auf einem anderen Gerät oder in einer anderen WhatsApp-Umgebung aktiv. * Rufnummer und Ländervorwahl sind richtig eingetragen. * Vorherige Versuche werden nicht in kurzer Folge wiederholt. * Ein sicherer Kommunikationsweg für Rückfragen bleibt verfügbar. ## Fehler: Ein Platzhalter im Nachrichtentext enthält eine URL Erscheint bei einer WhatsApp-Vorlage ein Hinweis, dass ein Parameter im Nachrichtentext eine URL enthält, wurde in einen Textplatzhalter beim Versand eine vollständige Webadresse eingesetzt. Solche Links dürfen nicht über einen Platzhalter im Nachrichtentext eingefügt werden. Das gilt auch für viele verkürzte Links. Wähle stattdessen eine der beiden passenden Lösungen: * **Gleicher Link für alle:** Schreibe die vollständige Adresse direkt in den zur Freigabe eingereichten Nachrichtentext. Sie ist dann fester Bestandteil der Vorlage. * **Individuelle Zieladresse:** Verwende in der Vorlage eine Website-Schaltfläche. Hinterlege den gleichbleibenden Anfang der Adresse in der Schaltfläche und ergänze beim Versand nur den dafür vorgesehenen variablen Endteil. Prüfe vor einem neuen Versand, ob der Link im richtigen Element liegt und ob der Platzhalter wirklich nur den vorgesehenen Wert enthält. Sende anschließend eine Testnachricht an eine andere Rufnummer als die Absendernummer. ## Wenn die Zustellung zum Schutz des Empfängers begrenzt wird Manchmal wird eine Nachricht nicht zugestellt, obwohl Rufnummer und Vorlage korrekt sind. Der Versand kann dann zum Schutz des Nachrichteneingangs der empfangenden Person begrenzt sein. Ausschlaggebend können geringe frühere Interaktion, häufige ähnliche Werbenachrichten, Blockierungen oder Meldungen durch Empfänger sein. Die Begrenzung betrifft den einzelnen Kontakt und kann sich später ändern. Sie ist keine Aufforderung, dieselbe Nachricht mehrfach neu zu senden. ### So reagierst du 1. Sichere Fehlertext, Zeitpunkt, Kontakt und verwendete Vorlage. 2. Stoppe unmittelbare Wiederholungsversuche für diesen Kontakt. 3. Prüfe, ob eine nachvollziehbare Einwilligung und ein aktueller Anlass vorliegen. 4. Überlege, ob die Nachricht persönlich genug, nützlich und erwartbar ist. 5. Warte ab und nutze bei dringender Klärung einen anderen zulässigen Kontaktweg. 6. Prüfe die Vorlage später nur bei einem passenden Anlass erneut; versende nicht viele ähnliche Vorlagen nacheinander. ### Für künftige Kampagnen vorbeugen Sende zielgerichtet statt möglichst häufig. Teile Kontakte nach Anlass und tatsächlichem Interesse auf, passe die Ansprache an und beobachte Antworten, Zustellstatus, Abmeldungen und auffällige Vorlagen. Eine Nachricht nach einer gerade erfolgten Buchung ist zum Beispiel eher erwartbar als eine allgemeine Wiederholung ohne Bezug. > **Praxisbeispiel:** Nach einer Terminbuchung erhält ein Kontakt eine kurze Erinnerung. Bei einer früheren Werbevorlage hatte derselbe Kontakt einen Zustellfehler. Das Team wiederholt nicht die alte Vorlage, sondern wartet auf einen passenden neuen Anlass und beschränkt künftige Kampagnen auf Kontakte mit klarer Reaktion und Einwilligung. **Grenze:** Die genaue interne Bewertung beim Nachrichtendienst ist im Standort nicht einsehbar und lässt sich nicht manuell aufheben. Konzentriere dich deshalb auf Einwilligung, Relevanz, sinnvolle Versandhäufigkeit und eine saubere Dokumentation der Fehler. ## Hinweis: Versand in ein bestimmtes Land ist eingeschränkt Erscheint der Hinweis **„Business account is restricted from messaging users in this country“**, liegt die Einschränkung nach dem zugrunde liegenden Kanal-Hinweis nicht an deiner Vorlage, Verbindung oder sonstigen Standort-Einstellung. Sie betrifft einen länderübergreifenden Versandweg. Der Hinweis betrifft aktuell die Kommunikation mit Empfängern in Brasilien und Indonesien: * Unternehmen außerhalb dieser Länder können diese Empfänger über diesen Kanal nicht anschreiben. * Unternehmen in Brasilien oder Indonesien können nur Empfänger im eigenen Land anschreiben. * Eingehende Nachrichten sind davon nicht betroffen. Auch Kommunikation innerhalb desselben Landes bleibt möglich. Eine Einstellung im Standort kann diese Vorgabe nicht aufheben. Prüfe deshalb das Zielland, halte die genaue Fehlermeldung fest und nutze für berechtigte wichtige Anliegen einen anderen zulässigen Kommunikationsweg. Da sich Kanalvorgaben ändern können, ist die konkrete Fehlermeldung bei einer späteren Prüfung entscheidend. > **Praxisbeispiel:** Ein Team in Deutschland möchte einen Kontakt in Indonesien über WhatsApp informieren und sieht den Länderhinweis. Es wiederholt die Nachricht nicht, dokumentiert die Meldung und wählt nach Einwilligung des Kontakts einen anderen erlaubten Kanal. ## Weitere Zustellfehler systematisch behandeln Zusätzliche Fehlerhinweise helfen dir einzugrenzen, ob der Grund beim einzelnen Kontakt, bei einer Nachrichtenvorlage, bei einer Datei oder vorübergehend beim Nachrichtendienst liegt. Halte immer den genauen Hinweis, den Zeitpunkt, den Kontakt und die verwendete Vorlage fest. Wiederhole einen fehlgeschlagenen Versand nicht unmittelbar mehrfach. ### Nachricht nicht zustellbar – Fehler 131026 Dieser Hinweis bedeutet: Die Nachricht wurde zur Übermittlung übergeben, hat den Empfänger aber nicht erreicht. Ein genauer einzelner Grund wird nicht immer angezeigt. Prüfe zuerst die internationale Rufnummer, ob der Kontakt WhatsApp mit dieser Nummer verwendet und ob eine Blockierung oder eine nicht bestätigte Nutzungsbedingung beim Empfänger denkbar ist. In einzelnen Ländern können außerdem besondere Vorgaben für Vorlagen gelten. Wenn nur ein Kontakt betroffen ist, kläre die Erreichbarkeit über einen anderen zulässigen Weg. Wenn viele Kontakte betroffen sind, dokumentiere Muster, Zeitpunkt und die genutzte Vorlage für die zuständige Unterstützung. ### Allgemeiner Vorlagenfehler – Fehler 135000 Der Fehler kann erscheinen, obwohl die Vorlage grundsätzlich sichtbar ist. Prüfe deshalb jeden Wert, den die Vorlage beim Versand erhält: 1. Öffne den fehlgeschlagenen Versand und notiere die verwendete Vorlage. 2. Kontrolliere, ob jeder Platzhalter einen passenden, nicht leeren Wert bekommt. 3. Prüfe, ob Anzahl und Reihenfolge der Werte zur Vorlage passen. 4. Wiederhole den Test mit einem kurzen, klaren Text und einem dafür geeigneten Testkontakt. 5. Besteht der Fehler weiter, gib Vorlage, Zeitpunkt und Fehlerhinweis an die verantwortliche Person weiter. Sie kann die Vorlage fachlich prüfen und bei Bedarf neu anlegen. Ändere nicht mehrere Vorlagen gleichzeitig. So lässt sich anschließend nachvollziehen, was den Fehler tatsächlich behoben hat. ### Datei konnte nicht übertragen werden – Fehler 131053 Dieser Hinweis betrifft eine angehängte Datei. Die Nachricht wird dann nicht zugestellt. Prüfe die tatsächliche Datei, nicht nur ihre Dateiendung. | Dateityp | Geeignete Formate | Maximale Dateigröße | | -------- | ------------------------------------------------ | ------------------- | | Bild | JPG oder PNG | 5 MB | | Video | MP4 oder 3GPP | 16 MB | | Audio | AAC, MP4, MPEG, AMR oder OGG | 16 MB | | Dokument | PDF oder gängige Office-Datei | 100 MB | | Sticker | WebP, 512 × 512 Pixel, transparenter Hintergrund | 100 KB | Ein GIF ist kein geeignetes Bildformat für diesen Versandweg. Auch ein gewöhnliches WebP-Bild kann abgelehnt werden; speichere es als JPG oder PNG. Ein Video sollte mit H.264-Bild und AAC-Ton exportiert sein. Liegt die Datei unter einer Webadresse, muss sie ohne Anmeldung direkt erreichbar sein. Exportiere die Datei bei einem Fehler neu, prüfe Format und Größe und teste anschließend genau diese Datei mit einem passenden Testkontakt. Nur die Endung umzubenennen löst das Problem nicht. ### Vorübergehender allgemeiner Fehler – Fehler 131000 Dieser Hinweis nennt keinen konkreten Grund und kann vorübergehend auftreten. Warte zunächst, statt denselben Versand in kurzer Folge zu wiederholen. Prüfe danach die Verbindung des Kanals, die aktuelle Vorlage, die Rufnummer und ob die Nachricht in den aktuellen Gesprächskontext passt. Tritt der Fehler wiederholt bei einer Person auf, nutze einen anderen zulässigen Kontaktweg zur Klärung. Tritt er bei vielen Personen auf, dokumentiere den Zeitraum und die betroffenen Vorlagen für die Unterstützung. > **Praxisbeispiel:** Bei einer Erinnerung mit PDF erscheint der Hinweis zur Dateiübertragung. Das Team kontrolliert die PDF-Größe, exportiert die Datei erneut und testet die neue Datei mit einem einwilligenden Testkontakt. Erst nach erfolgreicher Zustellung wird die Erinnerung wieder verwendet. **Grenze:** Nicht jeder Hinweis nennt die interne Ursache des Nachrichtendienstes. Der Standort kann eine externe Sperre, eine Blockierung durch einen Empfänger oder eine vorübergehende Störung nicht selbst aufheben. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://one-loop.gitbook.io/help/plattform/one-loop-plattform/kommunikation/sms-und-whatsapp/whatsapp-zustellfehler-gezielt-prufen.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.