> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt
> Use this file to discover all available pages before exploring further.
# WhatsApp-Vorlagenreferenz: Kategorien, Header, Buttons
> Referenz zu WhatsApp-Vorlagenkategorien, Header-Formaten, Button-Typen, Variablensyntax, Coupon- und Standort-Vorlagen sowie dem Einreichungs-Lebenszyklus.
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](/app/templates). Für Medienformat-Limits siehe [Medien-Header](/app/media-in-template-headers).
## 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**.
| Kategorie | Anwendung | Hinweise |
| --------------------- | ----------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| **Marketing** | Werbeaktionen, Angebote, Eventeinladungen, Reaktivierung | Teuerste Stufe; unterliegt Opt-in-Regeln |
| **Utility** | Bestellaktualisierungen, Kontowarnungen, Erinnerungen, Folgen auf einen vom Nutzer initiierten Ablauf | Günstiger als Marketing; Inhalt muss sich auf eine bestimmte Transaktion oder Anfrage beziehen |
| **Authentifizierung** | Einmalpasswörter und Kontoverifizierungscodes | Strenges Format; keine Marketinginhalte erlaubt; günstigste Stufe |
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](/app/media-in-template-headers).
* **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](/app/media-in-template-headers).
## Body und Variablen
Der Body ist der Haupttext der Nachricht. Variablen verwenden **doppelte geschweifte Klammern mit einem 1-basierten Index**:
```text theme={null}
Hi {{1}}, your order {{2}} has shipped. Track it here: {{3}}
```
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.
## Footer
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:
| Button-Typ | Funktion | Beispiel | Variable? |
| ---------------- | ----------------------------------------------------------------- | ------------------------------- | ------------------------------ |
| **QUICK\_REPLY** | Sendet eine voreingestellte Textantwort an Ihr Unternehmen zurück | `Ja, das bin ich` | Nein |
| **URL** | Öffnet eine Webseite | `https://acme.com/orders/{{1}}` | Eine in der URL |
| **PHONE** | Ruft eine Telefonnummer an | `+44 20 7946 0000` | Nein |
| **COPY\_CODE** | Kopiert einen Code in die Zwischenablage | `SAVE20` | Eine für den Code |
| **FLOW** | Öffnet einen WhatsApp Flow | (verknüpfte Flow-ID) | Variablen über den Flow selbst |
| **CATALOG** | Öffnet Ihren WhatsApp-Katalog | (verknüpfte Katalog-ID) | Nein |
| **MPM** | Multi-Product-Message-Launcher | (Katalogprodukte) | Nein |
| **VOICE\_CALL** | Startet einen WhatsApp-Sprachanruf (wo unterstützt) | (Ihre Geschäftsnummer) | Nein |
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.
### Carousel-Vorlagen
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](/hubspot/workflow-actions#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:
In Flowella gespeichert, aber noch nicht an Meta gesendet.
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.
Live und einsatzbereit. Sie können sie aus dem Posteingang, der API und HubSpot-Workflows senden.
Meta hat die Vorlage abgelehnt. Der Ablehnungsgrund erscheint auf der Vorlagenseite. Bearbeiten und erneut einreichen.
Meta hat das Qualitäts-Feedback geprüft und die Vorlage markiert. In der Regel ein Vorbote von 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.
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](/meta/quality-score). 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
* [Vorlagen](/app/templates) – Schritt-für-Schritt-Erstellung einer Vorlage
* [Medien-Header](/app/media-in-template-headers) – Referenz zu Medienformaten
* [Vorlage abgelehnt](/troubleshooting/template-rejected) – Ablehnungen diagnostizieren
* [Qualitätsbewertung](/meta/quality-score) – wie die Qualität der Telefonnummer mit der Vorlagenqualität interagiert
* [Nachrichtenlimits](/meta/messaging-limits) – das Stufensystem, das einschränkt, wie viele Vorlagen Sie senden können