Zeichenlimits für WhatsApp-Vorlagen
Metas Dokumentation zu den Vorlagenkomponenten setzt feste Grenzen für jeden Teil einer Vorlage. Wer sie überschreitet, scheitert schon an der API, bevor ein Prüfer die Vorlage sieht. Deshalb lohnt es sich, sie beim Schreiben zu prüfen.
Gezählt wird, was Sie sehen: Ein Emoji oder ein arabischer Buchstabe zählt als ein Zeichen. Zeilenumbrüche zählen mit, ebenso Formatierungszeichen wie die Sternchen in *fett*.
Quelle: Meta, Template components, https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/components (geprüft im Oktober 2026).
- Vorlagenname: bis 512 Zeichen, nur Kleinbuchstaben, Ziffern und Unterstriche.
- Textkopfzeile: bis 60 Zeichen und höchstens 1 Variable. Medienkopfzeilen können Bild, Video oder Dokument sein; Standort-Kopfzeilen sind nur für Service und Marketing erlaubt.
- Nachrichtentext: bis 1.024 Zeichen, Pflichtfeld, mit beliebig vielen Variablen.
- Fußzeile: bis 60 Zeichen, ohne Variablen.
- Schaltflächen: insgesamt bis 10, davon höchstens 10 Schnellantworten, 2 URL-Schaltflächen, 1 Telefon- und 1 Code-Schaltfläche. Beschriftung bis 25 Zeichen, URL bis 2.000, Telefonnummer bis 20, Code bis 20.
Variablenregeln, die zur Ablehnung führen
Die meisten abgelehnten Vorlagen scheitern an den Platzhaltern, nicht am Wortlaut. Metas Leitfaden zur Vorlagenprüfung nennt die Probleme: Variablen, die nicht fortlaufend sind, Sonderzeichen wie #, $ oder % enthalten, unpassende geschweifte Klammern haben oder ganz am Anfang oder Ende der Nachricht stehen.
Meta lehnt außerdem Vorlagen mit zu vielen Variablen im Verhältnis zur Länge ab. Ein genaues Verhältnis veröffentlicht Meta nicht; das Tool warnt daher unter drei festen Wörtern pro Variable. Prüfer lehnen auch zwei direkt benachbarte Variablen wie {{1}} {{2}} häufig ab: Fassen Sie sie zusammen oder setzen Sie Wörter dazwischen.
Jede Variable braucht bei der Einreichung einen realistischen Beispielwert. Die Prüfer lesen ihn, um die Nachricht zu verstehen; „test“ oder „xxx“ führen leicht zur Ablehnung.
Quelle: Meta, Template review, https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-review.
Vorlage abgelehnt? Metas Grund entschlüsseln
Wechseln Sie zum Tab „Abgelehnt? Metas Grund einfügen“ und fügen Sie den Grund aus dem WhatsApp Manager, der Business Support Home, der Ablehnungs-E-Mail oder dem Webhook message_template_status_update ein. Das Tool erkennt Metas Codes wie INVALID_FORMAT, INCORRECT_CATEGORY, TAG_CONTENT_MISMATCH, PROMOTIONAL, SCAM und ABUSIVE_CONTENT sowie die Formulierungen der häufigen Ursachen aus Metas Leitfaden zur Vorlagenprüfung und zeigt die wahrscheinliche Ursache und die Lösung.
Eine abgelehnte Vorlage kann bearbeitet und erneut eingereicht werden, oder Sie legen im WhatsApp Manager mit Beispielwerten Einspruch ein; laut Meta wird darüber innerhalb von 24 Stunden entschieden. Der Grund NONE bedeutet, dass die Vorlage pausiert und nicht abgelehnt wurde.
Service, Marketing oder Authentifizierung
Die Kategorie entscheidet über Freigabe und Preis. Service-Vorlagen (Utility) folgen auf eine Aktion oder Anfrage des Kunden, etwa Bestellung, Buchung, Kontoänderung oder Warnung, und dürfen nichts bewerben. Authentifizierungsvorlagen übermitteln Einmalcodes mit festem Meta-Text. Alles andere, auch Warenkorb-Erinnerungen, Angebote und Reaktivierung, ist Marketing.
Laut Metas Kategorisierungsrichtlinien ist eine Vorlage, die Service- und Werbeinhalte mischt, Marketing. Rabattcodes, Angebote, Upselling, Warenkorb-Erinnerungen und App-Download-Aufrufe machen eine Vorlage zu Marketing. Meta prüft genehmigte Vorlagen regelmäßig erneut und stuft werbliche Service-Vorlagen meist mit einem Tag Vorlauf als Marketing ein.
Das Tool durchsucht Ihren Text auf Deutsch, Englisch, Arabisch, Französisch, Spanisch und Portugiesisch nach werblichen Begriffen und warnt Sie, bevor Meta die Vorlage umstuft. Da nur Authentifizierungsvorlagen Einmalcodes senden dürfen, markiert es auch OTP-Formulierungen in anderen Kategorien.
Quelle: Meta, Template categorization, https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-categorization.
Schaltflächen: Gruppierung, dynamische URLs, Darstellung
Schnellantworten und Aktionsschaltflächen müssen gruppiert sein: alle Schnellantworten vor den anderen Schaltflächen oder alle danach. Eine Schnellantwort zwischen zwei Links lehnt die API ab.
Eine URL-Schaltfläche erlaubt eine Variable am Ende der URL, etwa https://shop.example.com/orders/{{1}}. Kodieren Sie den gesendeten Wert (ein Leerzeichen wird zu %20) und verzichten Sie auf Linkkürzer: Sie verbergen das Ziel und wirken wie Spam.
Bei mehr als drei Schaltflächen zeigt WhatsApp zwei an, der Rest liegt hinter „Alle Optionen ansehen“. Vorlagen mit vier oder mehr Schaltflächen oder mit Schnellantworten neben anderen Schaltflächen sind in WhatsApp Desktop nicht sichtbar. Setzen Sie die wichtigste Aktion an den Anfang.
Von der Vorschau zum Versand in großem Umfang
Das exportierte JSON folgt dem Request-Body von POST /<WABA_ID>/message_templates der WhatsApp Business Management API, einschließlich Beispielwerten. Für Medienkopfzeilen laden Sie eine Beispieldatei über die Resumable Upload API hoch und ersetzen das Platzhalter-Handle.
Nach der Freigabe senden Sie die Vorlage per Name und Sprache mit den echten Werten. OmniChannels.ai verwaltet Vorlagen über mehrere WhatsApp-Business-Konten, verfolgt Prüfstatus und Qualität und versendet freigegebene Vorlagen über eine REST-API, Kampagnen oder den gemeinsamen Posteingang, mit SMS-Fallback, wenn WhatsApp nicht verfügbar ist.
