Regeln für WhatsApp-Vorlagen: was jede Prüfung bedeutet und wie Sie das Problem beheben

Bevor eine WhatsApp-Vorlage zur Prüfung an Meta geht, gleicht OmniBrand sie mit den veröffentlichten Regeln von Meta ab. Dieselben Prüfungen laufen in Ihrem Browser, während Sie schreiben, und erneut auf unserem Server, wenn Sie auf Zur Prüfung einreichen klicken. So verlässt eine Vorlage, die Meta mit Sicherheit ablehnen würde, OmniBrand gar nicht erst. Jede Prüfung hat einen Code; diese Seite erklärt jeden einzelnen.

So lesen Sie eine Prüfung

• Muss behoben werden: Meta wird die Vorlage ablehnen. Im Vorlagen-Builder bleibt Zur Prüfung einreichen deaktiviert, bis das Problem behoben ist; der Bereich Prüfungen führt es unter Muss behoben werden auf, mit einer Schaltfläche Beheben, wenn OmniBrand es für Sie beheben kann. Findet der Server beim Einreichen dennoch eines, zeigt der Builder "Meta würde diese Vorlage ablehnen, daher wurde nichts gesendet. Beheben Sie diese Punkte und versuchen Sie es erneut:".
• Wahrscheinliche Ablehnung: ein häufiger Grund für eine Ablehnung oder Neukategorisierung. Sie können trotzdem einreichen.
• Tipps: nur Empfehlungen.
• Mit *OmniBrand-Richtwert* gekennzeichnete Prüfungen sind unsere eigene Faustregel, wo Meta keine Zahl veröffentlicht; sie sind nie Muss behoben werden.
• Wer einreichen kann: Mitglieder mit der Aufgabe WhatsApp-Vorlagen verwalten (standardmäßig Inhaber, Administratoren und Redakteure; siehe Rollen und Aufgaben).

Wenn Meta selbst ablehnt

Lehnt Meta dennoch ab, meldet der Builder "Meta hat die Vorlage abgelehnt:" mit dem Originalwortlaut von Meta und, wenn Meta eine uns bekannte Fehlernummer gesendet hat, die passende Regel unten: 2388299 ist VAR_EDGE, 2388293 ist VAR_DENSITY, 2388019 ist TEMPLATE_QUOTA, 2388039 ist EDIT_WHILE_PENDING, 2388040 ist BODY_MAX, 2388047 ist HEADER_NO_MARKDOWN, 2388072 ist VAR_SYNTAX, 2388073 ist FOOTER_NO_VARS und 2388024 ist NAME_TAKEN_LANG. Bei Meta ändert sich nichts: Eine neue Vorlage bleibt als Entwurf im Builder (korrigieren Sie den Text und klicken Sie erneut auf Zur Prüfung einreichen), und eine bereits eingereichte behält ihren Status (korrigieren Sie sie und klicken Sie erneut auf Änderungen speichern).

NAME_FORMAT (muss behoben werden)

Der Name darf nur englische Kleinbuchstaben, Ziffern und Unterstriche enthalten, bis zu 512 Zeichen, z. B. eid_offer_2026. Ersetzen Sie Leerzeichen durch Unterstriche und Großbuchstaben durch Kleinbuchstaben.

NAME_TAKEN_LANG (muss behoben werden)

Dieses WhatsApp Business-Konto hat bereits eine Vorlage mit diesem Namen in dieser Sprache. Wählen Sie einen anderen Namen oder fügen Sie der vorhandenen Vorlage eine andere Sprache hinzu.

NAME_RECENTLY_DELETED (wahrscheinliche Ablehnung)

Eine Vorlage mit diesem Namen wurde vor weniger als 30 Tagen gelöscht. Meta sperrt den Namen einer gelöschten genehmigten Vorlage für 30 Tage; wählen Sie also einen neuen Namen oder warten Sie.

LANGUAGE_CODE (muss behoben werden)

Der Sprachcode wird von WhatsApp nicht akzeptiert. Verwenden Sie die Codes von Meta: en, en_US, en_GB, ar, ar_EG, ar_AE usw. Portugiesisch muss pt_BR oder pt_PT sein.

LANGUAGE_SCRIPT_MISMATCH (wahrscheinliche Ablehnung, OmniBrand-Richtwert)

Der Text sieht nicht nach der gewählten Sprache aus: eine arabische Vorlage, deren Text überwiegend nicht arabisch ist, oder eine englische, die überwiegend auf Arabisch geschrieben ist. Ändern Sie die Sprache oder übersetzen Sie den Text. Meta übersetzt nie; schreiben Sie jede Sprache separat.

CATEGORY_ADVICE (wahrscheinliche Ablehnung, OmniBrand-Richtwert)

Eine Utility- oder Authentifizierungsvorlage enthält Werbewörter (Angebot, Rabatt, Sale, عرض، خصم...) oder eine Werbeschaltfläche. Meta genehmigt solche Vorlagen als Marketing, was Marketingpreise kostet und nur an Personen gehen darf, die Marketing zugestimmt haben. Entfernen Sie die Werbung oder wählen Sie Marketing.

AUTH_SHAPE (muss behoben werden)

Authentifizierungsvorlagen haben eine von Meta festgelegte Form: Der Textkörper lautet "{{1}} ist Ihr Bestätigungscode.", es gibt eine Einmalpasswort-Schaltfläche (Code kopieren, Automatisches Ausfüllen mit einem Tippen oder Zero-Tap), keine Kopfzeile, Fußzeile, Medien, Links oder Emojis, und der Code läuft nach 1 bis 90 Minuten ab. One-Tap- und Zero-Tap-Schaltflächen benötigen den Paketnamen und den Signatur-Hash Ihrer Android-App. Für Zero-Tap müssen Sie außerdem die Zero-Tap-Bedingungen von Meta akzeptieren (das Kästchen unter Schaltfläche im Builder).

BODY_REQUIRED (muss behoben werden)

Jede Vorlage braucht einen Textkörper.

BODY_MAX (muss behoben werden)

Der Textkörper ist länger, als Meta erlaubt: 1.024 Zeichen (600 bei einem zeitlich begrenzten Angebot). Kürzen Sie ihn.

HEADER_TEXT_REQUIRED (muss behoben werden)

Sie haben eine Text-Kopfzeile gewählt, sie aber leer gelassen. Geben Sie die Kopfzeile ein oder wählen Sie keine Kopfzeile.

HEADER_TEXT_MAX (muss behoben werden)

Eine Text-Kopfzeile darf höchstens 60 Zeichen lang sein.

HEADER_ONE_VAR (muss behoben werden)

Eine Text-Kopfzeile darf nur eine Variable enthalten.

HEADER_NO_MARKDOWN (muss behoben werden)

Die Kopfzeile muss reiner Text sein: keine Formatierungszeichen (* _ ~ `), keine Zeilenumbrüche und keine Emojis.

HEADER_MEDIA_SAMPLE (muss behoben werden)

Eine Bild-, Video- oder Dokument-Kopfzeile braucht eine Beispieldatei, mit der Meta die Vorlage prüft. Akzeptiert werden: JPEG- oder PNG-Bilder bis 5 MB, MP4-Videos bis 16 MB, PDF-Dokumente bis 100 MB. OmniBrand prüft die Datei selbst, nicht ihren Namen. Eine in WhatsApp Manager erstellte Vorlage braucht ein neues Beispiel, bevor sie hier bearbeitet werden kann.

HEADER_LOCATION_CATEGORY (muss behoben werden)

Eine Standort-Kopfzeile ist nur in Marketing- und Utility-Vorlagen erlaubt.

FOOTER_MAX (muss behoben werden)

Die Fußzeile darf höchstens 60 Zeichen lang sein.

FOOTER_NO_VARS (muss behoben werden)

Die Fußzeile darf keine Variablen enthalten.

VAR_SYNTAX (muss behoben werden)

Eine Variable ist falsch geschrieben. Nummerierte Variablen werden {{1}}, {{2}} geschrieben; benannte {{first_name}} (Kleinbuchstaben, Ziffern und Unterstriche). Die Klammern müssen zusammenpassen, und eine Vorlage verwendet entweder Nummern oder Namen, nie beides.

VAR_SEQUENTIAL (muss behoben werden)

Nummerierte Variablen müssen bei {{1}} beginnen und ohne Lücken 1, 2, 3 laufen, in der Reihenfolge ihres ersten Auftretens.

VAR_EDGE (muss behoben werden)

Der Text beginnt oder endet mit einer Variable (Meta-Fehler 2388299). Fügen Sie Wörter vor der ersten und nach der letzten Variable ein, z. B. "Hallo {{1}}, Ihre Bestellung ist fertig." statt "{{1}}, Ihre Bestellung ist fertig".

VAR_ADJACENT (muss behoben werden)

Zwei Variablen stehen direkt nebeneinander, nur durch Leerzeichen oder Satzzeichen getrennt. Setzen Sie Wörter dazwischen.

VAR_DENSITY (wahrscheinliche Ablehnung, OmniBrand-Richtwert)

Für die Länge des Textes gibt es viele Variablen (Meta-Fehler 2388293). Meta veröffentlicht kein genaues Verhältnis; wir warnen bei weniger als 3 Wörtern festem Text pro Variable oder wenn Variablen mehr als 30 % der Wörter ausmachen. Fügen Sie Text hinzu oder verwenden Sie weniger Variablen.

VAR_EXAMPLE (muss behoben werden)

Jede Variable braucht einen realistischen Beispielwert, den die Prüfer von Meta lesen. Ein Beispiel darf nicht leer sein, keine Zeilenumbrüche, Tabs oder 4 Leerzeichen hintereinander enthalten, keine andere Variable sein und kein Platzhalter wie "test", "x" oder "name". Verwenden Sie einen echt wirkenden Wert wie "Sara" oder "A-1042".

BUTTON_COUNTS (muss behoben werden)

Zu viele Schaltflächen: höchstens 10 insgesamt, 10 Schnellantworten, 2 Website-Schaltflächen, 1 Anruf-Schaltfläche, 1 Code-kopieren-Schaltfläche (und je eine Flow-, Katalog-, Produktlisten- und WhatsApp-Anruf-Schaltfläche). Einmalpasswort-Schaltflächen gehören nur in Authentifizierungsvorlagen.

BUTTON_TEXT (muss behoben werden)

Jede Schaltfläche braucht eine Beschriftung mit 1 bis 25 Zeichen ohne Variablen, und keine zwei Schaltflächen dürfen dieselbe Beschriftung haben.

BUTTON_GROUPING (muss behoben werden)

Schnellantwort-Schaltflächen müssen zusammenstehen und dürfen nicht zwischen Website- oder Anruf-Schaltflächen gemischt sein. Verschieben Sie sie nebeneinander.

URL_FORMAT (muss behoben werden)

Eine Website-Schaltfläche braucht einen vollständigen Link, der mit https:// beginnt, mit höchstens 2.000 Zeichen. Er darf mit einer Variable enden, geschrieben {{1}}, zum Beispiel https://example.com/order/{{1}}, und diese Variable braucht ein Beispiel (etwa eine Bestellnummer) ohne Leerzeichen. Kodieren Sie Leerzeichen und nicht-englische Zeichen (%20).

URL_SHORTENER (wahrscheinliche Ablehnung, OmniBrand-Richtwert)

Der Link verwendet einen Linkkürzer (bit.ly, tinyurl, t.co...). Prüfer lehnen diese oft ab; verwenden Sie einen Link auf Ihrer eigenen Domain.

PHONE_FORMAT (muss behoben werden)

Eine Anruf-Schaltfläche braucht die Nummer im internationalen Format mit Ländervorwahl, z. B. +966500000000, höchstens 20 Zeichen.

BUTTONS_DESKTOP (Tipp)

Bei mehr als 3 Schaltflächen zeigt WhatsApp 2 an und legt den Rest unter "Alle Optionen anzeigen" ab. Bei 4 oder mehr Schaltflächen oder bei Schnellantworten gemischt mit anderen Schaltflächen zeigt WhatsApp Desktop die Vorlage überhaupt nicht an.

CAROUSEL_SHAPE (muss behoben werden)

Ein Karussell gibt es nur für Marketing, und es hat 2 bis 10 Karten. Jede Karte hat ein Bild oder ein Video (alle vom selben Typ), höchstens 2 Schaltflächen mit denselben Typen in derselben Reihenfolge auf jeder Karte und einen Kartentext von höchstens 160 Zeichen (auf allen Karten oder auf keiner). Über den Karten gibt es keine Kopf- oder Fußzeile.

LTO_SHAPE (muss behoben werden)

Ein zeitlich begrenztes Angebot gibt es nur für Marketing: eine Angebotsüberschrift von höchstens 16 Zeichen ohne Variablen, eine Bild- oder Video-Kopfzeile, ein Textkörper von höchstens 600 Zeichen, keine Fußzeile, zuerst eine Code-kopieren-Schaltfläche (Code höchstens 15 Zeichen) und danach höchstens eine Website-Schaltfläche.

COUPON_SHAPE (muss behoben werden)

Eine Gutscheinvorlage hat genau eine Code-kopieren-Schaltfläche mit einem Beispielcode von 1 bis 20 Zeichen ohne Leerzeichen.

CATALOG_SHAPE (muss behoben werden)

Eine Katalogvorlage hat genau eine Schaltfläche "Katalog ansehen", keine anderen Schaltflächen und keine Kopfzeile (WhatsApp zeigt ein Produktbild).

MPM_SHAPE (muss behoben werden)

Eine Produktlistenvorlage braucht eine Text-Kopfzeile und genau eine Schaltfläche "Artikel ansehen". Die Abschnitte, die Sie im Builder unter Produkte auflisten, müssen zu dem passen, was WhatsApp anzeigen kann: insgesamt höchstens 10 Abschnitte und 30 Produkte, jeder Abschnitt mit einem Titel von bis zu 24 Zeichen und mindestens einer Produkt-ID.

FLOW_SHAPE (muss behoben werden)

Eine Flow-Vorlage braucht genau eine Flow-Schaltfläche, die einen Flow benennt, sowie den Bildschirm, den sie beim Navigieren öffnet.

CONTENT_SENSITIVE_ID (wahrscheinliche Ablehnung, OmniBrand-Richtwert)

Der Text scheint nach einer vollständigen Karten-, Konto-, IBAN- oder Personalausweisnummer zu fragen. Meta lehnt das ab; nach den letzten 4 Ziffern zu fragen ist in Ordnung.

CONTENT_THREAT (wahrscheinliche Ablehnung, OmniBrand-Richtwert)

Die Formulierung könnte drohend oder beschämend wirken ("letzte Warnung", "rechtliche Schritte"). Meta lehnt beleidigende oder drohende Vorlagen ab. Formulieren Sie höflich um.

CONTENT_PROHIBITED (wahrscheinliche Ablehnung, OmniBrand-Richtwert)

Der Text erwähnt etwas, das die WhatsApp Business-Richtlinie auf den Golfmärkten nicht erlaubt: Alkohol, Tabak, Glücksspiel, Dating, Kryptowährungen oder Kredite. Entfernen Sie es.

DUPLICATE (wahrscheinliche Ablehnung)

Eine andere Vorlage in diesem WhatsApp Business-Konto hat denselben Text. Meta lehnt Duplikate ab; ändern Sie den Wortlaut oder verwenden Sie die vorhandene Vorlage.

EMOJI_DENSE (wahrscheinliche Ablehnung, OmniBrand-Richtwert)

Mehr als 10 Emojis in der Nachricht oder 3 oder mehr bei mehr als einem Emoji pro 8 Wörter. Verwenden Sie weniger.

MARKETING_OPT_OUT (Tipp)

Eine Marketing-Vorlage sollte Personen eine Möglichkeit zum Abbestellen geben: Fügen Sie eine Schnellantwort "Werbung stoppen" und eine Fußzeile wie "Antworten Sie mit STOP, um sich abzumelden" hinzu.

TEMPLATE_QUOTA (muss behoben werden)

Das WhatsApp Business-Konto hat das Vorlagenlimit von Meta erreicht: 250 Vorlagen für ein nicht verifiziertes Unternehmen, 6.000 für ein verifiziertes mit genehmigtem Anzeigenamen (jede Sprache zählt). Löschen Sie Vorlagen, die Sie nicht mehr verwenden.

EDIT_LIMIT (muss behoben werden)

Nur genehmigte, abgelehnte oder pausierte Vorlagen können bearbeitet werden. Eine genehmigte Vorlage kann einmal in 24 Stunden und höchstens 10-mal in 30 Tagen bearbeitet werden; abgelehnte und pausierte haben kein Limit. Die Meldung gibt an, wie viele Stunden noch verbleiben. Nur die eigenen Einstellungen von OmniBrand zu ändern (woher der Wert einer Variable kommt, ihr Ersatzwert) gilt nicht als Bearbeitung und ist immer erlaubt.

EDIT_CATEGORY_LOCKED (muss behoben werden)

Die Kategorie einer genehmigten Vorlage kann nicht geändert werden. Erstellen Sie stattdessen eine neue Vorlage in der anderen Kategorie.

EDIT_WHILE_PENDING (muss behoben werden)

Die Vorlage ist in Prüfung (PENDING oder IN_APPEAL) und kann erst bearbeitet werden, wenn Meta entschieden hat (Meta-Fehler 2388039).

MESSAGE_TTL (muss behoben werden)

Meta akzeptiert die gewählte Nachrichtengültigkeit für diese Kategorie nicht. Erlaubt sind: Authentifizierung 30 Sekunden bis 15 Minuten oder 30 Tage; Utility 30 Sekunden bis 12 Stunden oder 30 Tage; Marketing 12 Stunden bis 30 Tage; immer ganze Sekunden. Beheben setzt das Feld auf den Standardwert von Meta zurück. Wenn Sie zu einer Kategorie wechseln, die den Zeitraum nicht akzeptiert, wird er automatisch entfernt.

MESSAGE_TTL_ADVICE (wahrscheinliche Ablehnung)

Eine Authentifizierungsnachricht könnte ankommen, nachdem ihr Code abgelaufen ist: Die Nachrichtengültigkeit (oder der Standardwert von Meta von 10 Minuten) ist länger als der unter Angeben, wann der Code abläuft (Minuten) eingestellte Ablauf des Codes. Meta empfiehlt eine Gültigkeit, die nicht länger als der Codeablauf ist; Beheben setzt die Gültigkeit auf den Codeablauf.

MESSAGE_TTL_ROUTE (Tipp)

Meta wendet die Gültigkeit einer Marketing-Vorlage auf Nachrichten an, die mit Optimierte Zustellung (Marketing Messages API) gesendet werden. Bei Marketingnachrichten, die über die reguläre Cloud API gesendet werden, wird die Zustellung weiterhin bis zu 30 Tage lang erneut versucht.

Verwandte Themen

• Eine WhatsApp-Vorlage erstellen
• WhatsApp-Broadcasts
• Rollen und Aufgaben