Skip to main content
Diese Seite ist eine Referenz für die Bausteine einer WhatsApp-Vorlage – Kategorien, Header, Body, Buttons, Variablen, fortgeschrittene Vorlagentypen und den Einreichungs-Lebenszyklus. Die schrittweise Anleitung zum Erstellen und Testen einer Vorlage finden Sie unter Vorlagen. Für Medienformat-Limits siehe Medien-Header.

Kategorien

Jede Vorlage hat genau eine Kategorie, die bei der Einreichung an Meta festgelegt wird. Die Kategorie bestimmt die Preisgestaltung und welche Inhalte erlaubt sind. Wenn Meta der Meinung ist, dass Ihre Vorlage nicht zur gewählten Kategorie passt, wird sie abgelehnt oder neu kategorisiert – häufig bei Marketinginhalten, die als Utility eingereicht werden. Die Kategorie kann sich auch automatisch ändern, wenn Meta Nutzungsmuster beobachtet, was wiederum den verrechneten Preis ändert.

Header-Formate

Der Header einer Vorlage ist optional. Wenn vorhanden, kann er eine der folgenden Formen annehmen:
  • TEXT – kurze Zeichenkette, kann eine Variable enthalten.
  • IMAGE – JPEG oder PNG, max. 5 MB. Siehe Medien-Header.
  • VIDEO – MP4 oder 3GPP mit H.264/AAC, max. 16 MB.
  • DOCUMENT – PDF (am zuverlässigsten), Office-Formate oder Klartext. Max. 100 MB. Der Dateiname ist für den Empfänger sichtbar.
  • LOCATION – Breitengrad, Längengrad, Name und Adresse. Nützlich für Filialbesuche oder Lieferbestätigungen.
Medien-Header können entweder als Medien-Handle (einmal an Meta hochgeladen) oder als öffentliche HTTPS-URL pro Versand abgerufen angehängt werden. Die Vor- und Nachteile finden Sie unter Medien-Header.

Body und Variablen

Der Body ist der Haupttext der Nachricht. Variablen verwenden doppelte geschweifte Klammern mit einem 1-basierten Index:
Regeln:
  • Die Zahlen müssen fortlaufend bei {{1}} beginnen – Sie können keine Indizes überspringen.
  • Geben Sie für jede Variable einen Beispielwert an, wenn Sie einreichen. Meta nutzt die Beispiele zur Bewertung der Vorlage.
  • Halten Sie Variablen kurz und vorhersehbar. Lange eingefügte Blöcke sind ein häufiger Ablehnungsgrund.
Dieselbe {{n}}-Syntax wird in TEXT-Headern und URL-Buttons verwendet (siehe unten).

Formatierung im Body

WhatsApp unterstützt eine begrenzte Auswahl an Inline-Formatierungen im Vorlagen-Body:
  • Fett mit *Sternchen*
  • Kursiv mit _Unterstrichen_
  • Durchgestrichen mit ~Tilden~
  • Monospace mit dreifachen Backticks
Setzen Sie Formatierungen sparsam ein. Vorlagen mit starker Formatierung werden oft als spammig wirkend abgelehnt. Optionaler Klartext, der nach dem Body angezeigt wird. Keine Variablen, keine Formatierung.

Buttons

Eine Vorlage kann insgesamt bis zu 10 Buttons enthalten, gruppiert als Quick Replies oder Call-to-Action. Die von Meta erlaubten Kombinationen haben sich über die Cloud-API-Versionen verschoben; die zuverlässigsten Muster: Quick-Reply-Buttons sind nützlich, wenn Sie eine strukturierte Antwort wünschen (gut für die Analyse). URL- und Telefon-Buttons sind nützlich, um Empfänger von WhatsApp in Ihren Stack weiterzuleiten. FLOW-Buttons sind das Tor zu HubSpot-Formular-gesteuerten Flows, auf die sich Flowella spezialisiert hat.

Spezialisierte Vorlagentypen

Meta bietet mehrere spezialisierte Marketing-Vorlagentypen, die zusätzliche Funktionalität auf die Basisstruktur draufpacken. Eine Carousel-Vorlage zeigt mehrere Karten in einer horizontalen Scroll-Ansicht, jede mit eigenem Medium, Body und Buttons. Nützlich für Katalogpräsentationen, Mehrprodukt-Angebote oder Funktionsvergleiche.
  • Bis zu 10 Karten pro Vorlage.
  • Jede Karte hat einen eigenen Bild- oder Video-Header (ein Medientyp pro Vorlage – alle Bilder oder alle Videos, nicht gemischt).
  • Jede Karte kann bis zu 2 Buttons haben (Quick Reply, URL oder Telefon).
  • Der Body jeder Karte kann bis zu 3 Variablen enthalten.
Die Freigabe erfolgt pro Vorlage (nicht pro Karte), daher müssen alle Karten der gewählten Kategorie entsprechen.

Limited-Time-Offer-Vorlagen (LTO)

LTO-Vorlagen rendern einen Countdown-Timer unter dem Body. Sobald der Timer abläuft, wird das Angebot als abgelaufen angezeigt, und ein Tippen auf den CTA hat keine Wirkung.
  • Ein Aktionscode-Parameter ist erforderlich und wird dem Nutzer angezeigt.
  • Eine Ablauf-Epoche (in Sekunden) ist erforderlich.
  • Der CTA-Button ist meist ein Copy-Code oder URL.
Am besten geeignet für echte zeitlich begrenzte Angebote – LTO für Angebote zu nutzen, die nicht wirklich ablaufen, führt zu Nutzerbeschwerden und einer Neukategorisierung weg von Marketing.

Coupon-Code-Vorlagen

Wie LTO, aber ohne Countdown – einfach ein Code, den der Nutzer mit einem Tippen kopieren kann.
  • Der Code kann bis zu 20 Zeichen lang sein (kürzlich von 15 erhöht).
  • Der Copy-Code-Button kopiert den Wert, der zur Sendezeit angegeben wurde – das Feld example der Vorlage ist nur ein Platzhalter und wird nie versendet.
  • Im Vorlagen → Tab Senden und im Vorlagendialog des Posteingangs zeigen Coupon-Code-Vorlagen ein dediziertes Eingabefeld Coupon-Code-Buttons, in dem Sie die tatsächlich zu sendenden Codes eingeben (eine pro Empfängerzeile bei Bulk-Sendungen). Ältere Labels „Copy code” / „Copy coupon code buttons” wurden durch diesen einzigen, konsistenten Begriff ersetzt.

Authentifizierungs-Vorlagen

Spezialisierte Vorlagen für die OTP-Zustellung. Drei Untertypen:
  • One-Tap-Autofill – nutzt die Autofill-API von Android, um das OTP automatisch zu füllen, wenn der Nutzer auf den Button tippt. Beste UX, wo unterstützt.
  • Copy code – zeigt einen Copy-Button; der Nutzer fügt den Code in Ihre App ein. Funktioniert überall.
  • Zero-Tap – für vertrauenswürdige Absender kann das OTP ohne jeglichen Tipp übertragen werden (ein automatischer API-Callback vom WhatsApp-Client an Ihre App). Strenge Voraussetzungen.
Authentifizierungs-Vorlagen haben den günstigsten Preis pro Nachricht, aber die strengsten Inhaltsregeln: keine Marketinginhalte, kein zusätzlicher Body-Text über den Code selbst hinaus.

Standort-Vorlagen

Tragen einen Standort-Pin im Header, nützlich für Filialbesuche, Lieferbestätigungen oder Veranstaltungsorte. Der Nutzer kann den Standort mit einem Tippen in seiner Karten-App öffnen. Standort-Header als Variablen Der LOCATION-Header trägt bis zu vier Felder – Breitengrad, Längengrad, Name und Adresse – und Flowella behandelt alle vier als normale Vorlagenvariablen.
  • Die Werte, die Sie im Editor eingegeben haben (unter _flowellaEditor.headerLocationPreview), werden zur Standardvorgabe, die gesendet wird, wenn kein Override angegeben ist.
  • Die Dialoge Test Template und Posteingangsversand zeigen die vier Felder als reguläre Variableneingaben an.
  • Die HubSpot-Aktion Send WhatsApp Template leitet die vier Werte über headerLocation weiter, sodass ein Workflow den Pin pro Empfänger personalisieren kann.
Wenn Sie zum Sendezeitpunkt eines der vier Felder weglassen, fällt Flowella für dieses Feld auf den Vorschauwert des Editors zurück.

Einreichungs-Lebenszyklus

Wenn Sie eine Vorlage von Flowella einreichen, durchläuft sie diese Zustände:
1

DRAFT

In Flowella gespeichert, aber noch nicht an Meta gesendet.
2

PENDING

An Meta eingereicht und in Prüfung. Die meisten Vorlagen durchlaufen Metas automatisierte Prüfung innerhalb von Minuten, einige werden jedoch zur menschlichen Prüfung weitergeleitet. Der Editor von Flowella weist darauf hin, dass die Freigabe bis zu 12 Stunden dauern kann und sendet Ihnen eine E-Mail, sobald sich der Status ändert – Sie müssen die Seite nicht ständig aktualisieren.
3

APPROVED

Live und einsatzbereit. Sie können sie aus dem Posteingang, der API und HubSpot-Workflows senden.
4

REJECTED

Meta hat die Vorlage abgelehnt. Der Ablehnungsgrund erscheint auf der Vorlagenseite. Bearbeiten und erneut einreichen.
5

FLAGGED

Meta hat das Qualitäts-Feedback geprüft und die Vorlage markiert. In der Regel ein Vorbote von PAUSED.
6

PAUSED

Meta hat den Versand der Vorlage vorübergehend eingeschränkt, meist aufgrund von Empfänger-Feedback oder geringer Qualität. Kommt automatisch zurück, wenn sich die Qualität erholt.
7

DISABLED

Meta hat die Vorlage dauerhaft eingeschränkt. Muss als neue Vorlage erneut eingereicht werden (oft neu kategorisiert), wenn Sie den Inhalt erneut verwenden möchten.

Qualitätsbewertung

Sobald eine Vorlage genehmigt ist, baut sie ihre eigene Qualitätsbewertung auf – getrennt von der Qualitätsbewertung der Telefonnummer. Die vorlagenbezogene Bewertung verwendet dieselbe Skala Grün/Gelb/Rot und wird hauptsächlich getrieben von:
  • Blockierungsrate unter den Empfängern
  • Häufigkeit von „Melden”-Aktionen in WhatsApp
  • Anhaltend geringer Interaktion (keine Antworten, keine Linkklicks)
Gelbe und rote Vorlagenbewertungen können dazu führen, dass Meta die Vorlage pausiert, selbst wenn die Bewertung der Telefonnummer Grün ist. Beobachten Sie die Vorlagenqualität in Flowella → Vorlagen zusammen mit der Bewertung auf Nummer-Ebene.

Time-to-live (TTL)

Vorlagen können eine Time-to-Live haben, die steuert, wie lange Meta versucht, die Nachricht zuzustellen, bevor aufgegeben wird. Nützlich für zeitkritische Sendungen wie Einladungen zu Flash Sales.
  • Standard: 30 Tage für die meisten Vorlagen.
  • OTP-/Authentifizierungs-Vorlagen: deutlich kürzer (standardmäßig wenige Minuten), da Codes nach Ablauf keinen Wert mehr haben.
  • Benutzerdefinierte TTL: kann bei einigen Vorlagentypen pro Versand festgelegt werden.
Wenn eine Vorlage vor der Zustellung abläuft (Empfänger-Handy offline, Konto pausiert usw.), zählt sie für die Abrechnung als Versand, erreicht den Kunden aber nie.

Häufige Ablehnungsgründe

  • Werbeinhalte, die als Utility eingereicht werden. Erneut als Marketing einreichen.
  • Variablenbeispiele, die nicht zum Body passen – zum Beispiel Beispiele, die Links enthalten, die der Body nicht rechtfertigt.
  • Body- oder Header-Text, der nach Spam aussieht – übermäßige Großschreibung, „Hier klicken”, „Gratis!!!”, mehrere Ausrufezeichen.
  • Defekte oder nicht erreichbare Medien-Header-URLs.
  • Footer-Text, der dem Body widerspricht.
  • Generische Vorlagen, die von jedem gesendet werden könnten – Hi {{1}}, spezielles Angebot für Sie ohne Details ist für eine Marketing-Freigabe zu generisch.
  • Variablen im falschen Kontext – Verwendung einer Variable an einer Stelle, die Meta nicht erlaubt (z. B. bei einigen Button-Typen).
  • Anzeigename passt nicht zur Marke des Vorlageninhalts. Wenn der Anzeigename der WABA „Acme” lautet und die Vorlage „Beta Co” bewirbt, wird sie abgelehnt.
Bearbeiten Sie eine Kopie einer APPROVED-Vorlage anstelle des Originals, damit Sie eine funktionierende Version behalten, während Meta die Änderungen prüft. Vorlagen → Duplizieren in Flowella erledigt das für Sie.

Verwandte Anleitungen

Zuletzt geändert am 27. Juni 2026