> ## 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. # Vorlagenvariablen und dynamische Inhalte > Variablen in Headern, Text, Buttons und URLs von WhatsApp-Vorlagen verwenden – Syntaxregeln, Beispielwerte, HubSpot-Personalisierungstoken und Ablehnungsfallen. Mit Variablen können Sie mit einer einzigen genehmigten Vorlage personalisierte Nachrichten an Tausende von Kontakten senden, ohne sie erneut an Meta zu übermitteln. Auf dieser Seite erfahren Sie, wie Variablen in Flowella funktionieren, wo sie erscheinen können und wie Sie sie mit HubSpot-Daten verknüpfen. Einen umfassenden Überblick über die Struktur von Vorlagen finden Sie unter [Vorlagenreferenz](/de/app/template-reference). Eine schrittweise Anleitung zur Erstellung von Vorlagen finden Sie unter [Vorlagen](/de/app/templates). ## Syntax WhatsApp-Vorlagen verwenden **Positionsvariablen** mit doppelten geschweiften Klammern und einem 1-basierten Index: ```text theme={null} Hi {{1}}, your booking on {{2}} is confirmed. Reference: {{3}}. ``` Regeln: * Indizes beginnen bei `{{1}}` und müssen **sequenziell** sein - Sie können nicht von `{{1}}` zu `{{3}}` springen. * Derselbe Index kann innerhalb einer einzelnen Komponente (Body, Header oder URL) wiederverwendet werden, aber Flowella sendet an jedes Vorkommen denselben Wert. * Leerzeichen innerhalb der geschweiften Klammern sind nicht erlaubt: `{{ 1 }}` ist ungültig. * Variablen sind **nur** Text. Zahlen, Datumsangaben und Währungen werden als Strings gesendet - formatieren Sie sie vor dem Senden in HubSpot. Meta führt **benannte Variablen** (`{{first_name}}`) für neue Vorlagen ein. Flowella unterstützt beide, aber Positionsindizes bleiben das zuverlässigste Format für alle Vorlagentypen und Cloud API-Versionen. ## Wo Variablen erscheinen können | Komponente | Erlaubte Variablen | Anmerkungen | | --------------------------------------------------------- | ---------------------------------- | -------------------------------------------------------------------------- | | **Kopfzeile (TEXT)** | 1 | Nur kurze Werte - keine Zeilenumbrüche. | | **Kopfzeile (Medien)** | 1 (das Medien-Handle oder die URL) | Variable ist das Medium selbst, nicht der Text. | | **Header (LOCATION)** | 4 (lat, long, name, address) | Alle vier sind erforderlich, wenn der Header variabel ist. | | **Body** | Bis zu \~10 in der Praxis | Jede Variable wird auf das Zeichenlimit für den Body von Meta angerechnet. | | **Footer** | Keine | Die Fußzeile ist nur statischer Text. | | **URL-Schaltfläche** | 1 | Wird an das Ende einer statischen Basis-URL angehängt. | | **COPY\_CODE-Schaltfläche** | 1 | Der vollständige Codewert. | | **Schaltflächen Schnellantwort, Telefon, Fluss, Katalog** | Keine | Statische Konfiguration. | | **Karussellkarten** | Bis zu 3 pro Kartenkörper | Die Variablen jeder Karte werden unabhängig voneinander nummeriert. | ## Beispielwerte Wenn Sie eine Vorlage an Meta übermitteln, benötigt jede Variable einen **Musterwert**. Meta verwendet die Musterwerte, um: 1. zu entscheiden, ob der Inhalt der Vorlage in die gewählte Kategorie (Marketing, Utility, Authentifizierung) passt. 2. Qualität und Spam-Risiko abzuschätzen. 3. Zeigen Sie den Prüfern eine Vorschau an. Die Probenwerte werden beim Senden nicht verwendet - sie dienen nur der Überprüfung. Aber sie sind wichtig: * Verwenden Sie **realistische** Werte. `{{1}} = "John"` ist in Ordnung; `{{1}} = "xxx"` führt oft zur Ablehnung. * Halten Sie die Muster **kurz**. Das Einfügen eines Absatzes in eine einzige Variable ist ein klassisches Ablehnungssignal. * Achten Sie darauf, dass die Probe **typgerecht** ist. Wenn `{{2}}` ein Datum ist, verwenden Sie ein Datum. Wenn es sich um eine Bestellnummer handelt, verwenden Sie etwas, das wie eine Bestellnummer aussieht. ## Variablen mit HubSpot-Daten verbinden In einem HubSpot-Workflow, der die Aktion **WhatsApp-Vorlage senden** von Flowella verwendet: Flowella zeigt jede genehmigte Vorlage für Ihren Kanal an. Die Variablen werden automatisch aus dem Vorlagentext, der Kopfzeile und den Schaltflächen erkannt. Wählen Sie für jedes `{{n}}` eine HubSpot Kontakt-, Unternehmens-, Geschäfts- oder Ticketeigenschaft - oder geben Sie einen statischen Wert ein. Sie können Personalisierungs-Token und wörtlichen Text in der gleichen Zuordnung mischen. Wenn ein Kontakt keinen Wert für die zugeordnete Eigenschaft hat, schlägt die Nachricht fehl, es sei denn, Sie geben einen Fallback an. Übliche Ausweichmöglichkeiten: `"there"` für den Vornamen, `"your account"` für den Kontonamen. Senden Sie den Workflow zunächst an einen einzelnen Testkontakt. Meta lehnt Sendungen ab, bei denen eine Variable leer ist, nur Leerzeichen enthält oder einen Zeilenumbruch enthält. Leere Variablen werden beim Senden abgelehnt, nicht bei der Genehmigung der Vorlage. Ein Workflow, der für Tausende von Kontakten ausgeführt wird, kann stillschweigend abgebrochen werden, wenn eine wichtige Eigenschaft fehlt. Setzen Sie immer Fallbacks. ## Tipps zur Formatierung von Variablen **Namen** ```text theme={null} Hi {{1}}, ``` Schreiben Sie die Eigenschaft im vorgelagerten HubSpot groß, oder verwenden Sie einen HubSpot-Workflowschritt, um `firstname` in eine Eigenschaft "Vorname (formatiert)" zu kopieren. **Daten** WhatsApp-Vorlagen formatieren keine Datumsangaben. Wenn Ihre HubSpot-Eigenschaft `2026-05-24T00:00:00Z` lautet, wird dies in der Nachricht angezeigt. Verwenden Sie eine berechnete HubSpot-Eigenschaft oder eine Workflow-Aktion, um das Datum als `24 May 2026` zu formatieren, bevor Sie es zuordnen. **Währung** Dasselbe wie bei Datumsangaben - Formatierung im Vorfeld. Fügen Sie das Währungssymbol in den statischen Text ein (`Total: £{{1}}`), damit die Variable nur die Zahl ist. **URLs im Textkörper** Sie können die vollständige URL in eine Body-Variable einfügen, aber die Linkvorschau wird nicht angezeigt und die URL wird auf die Zeichenbegrenzung im Body angerechnet. Verwenden Sie stattdessen eine **URL-Schaltfläche** mit einem variablen Suffix: ```text theme={null} Base URL: https://acme.com/orders/ Variable: {{1}} At send time: https://acme.com/orders/AB-1234 ``` ## Häufige Ablehnungsgründe im Zusammenhang mit Variablen * **Übersprungene Indizes** (`{{1}}` dann `{{3}}`). Nummerieren Sie immer neu. * **Variable ganz am Anfang oder Ende** des Textes ohne umgebenden Text (`{{1}}` allein). Fügen Sie ein Wort davor oder danach ein. * **Zwei Variablen nebeneinander** (`{{1}}{{2}}`). Trennen Sie sie mit mindestens einem Leerzeichen oder einer Interpunktion. * **Musterwerte, die wie Platzhalter aussehen** - `"test"`, `"xxx"`, `"123"` - insbesondere in Marketingvorlagen. * **Variablen in der Fußzeile** - nicht erlaubt. * **Mehr als eine Variable in einer URL-Schaltfläche** - nur eine ist erlaubt, und sie muss sich am **Ende** der URL befinden. ## Erweiterte Muster ### Wiederverwendung eines Wertes in verschiedenen Komponenten Wenn ein Kundenname sowohl im Header als auch im Body vorkommt, definieren Sie ihn einmal in Ihrem Workflow und ordnen sowohl `{{1}}` (Header) als auch `{{1}}` (Body) der gleichen HubSpot-Eigenschaft zu. Flowella sendet jeder Komponente eine eigene Parameterliste, so dass die Indizes unabhängig sind - Sie ordnen den Wert zweimal zu, aber Sie speichern ihn nur einmal in HubSpot. ### Bedingter Inhalt WhatsApp-Vorlagen unterstützen keine if/else-Logik innerhalb der Vorlage. Um unterschiedliche Inhalte an verschiedene Kontaktsegmente zu senden, erstellen Sie **getrennte Vorlagen** und verzweigen Sie in Ihrem HubSpot-Workflow - zum Beispiel "VIP-Begrüßung" und "Standard-Begrüßung". ### Mehrsprachige Vorlagen Der Name und die Struktur einer Vorlage sind für alle Sprachen gleich, aber jede Sprache wird separat **vorgelegt, genehmigt und gespeichert**. Die Variablen müssen sich in jeder Sprachversion an der gleichen Stelle befinden. Flowella wählt die richtige Sprache anhand der `hs_language`-Eigenschaft des Kontakts (oder eines von Ihnen konfigurierten Fallbacks) aus. ## Fehlersuche * **Vorlage genehmigt, aber Meldungen schlagen fehl mit "parameter mismatch "** - Meta und Flowella sind sich nicht einig, wie viele Variablen die Vorlage hat. Holen Sie die Vorlage erneut in Flowella (Vorlagen → Aktualisieren), damit die Anzahl der Variablen synchronisiert wird. * **Die Variable wird in der zugestellten Nachricht wörtlich als `{{1}}` angezeigt** - der Workflow hat diesem Index keinen Wert zugeordnet. Überprüfen Sie die Parameterliste der Workflow-Aktion. * **Nachricht beim Senden mit "Richtlinienverletzung "** zurückgewiesen - eine Variable enthält eine URL oder einen Inhalt, der nicht zur Kategorie der Vorlage passt. Inhalte im Marketing-Stil können nicht über Variablen in eine Utility-Vorlage eingefügt werden. Den gesamten Lebenszyklus des Einreichens, Bearbeitens und Anhaltens von Vorlagen finden Sie unter [Vorlagen](/de/app/templates) und [Vorlagenreferenz](/de/app/template-reference). Ablehnungsspezifische Hilfe finden Sie unter [Vorlage abgelehnt](/de/troubleshooting/template-rejected).