Syntax
WhatsApp-Vorlagen verwenden Positionsvariablen mit doppelten geschweiften Klammern und einem 1-basierten Index:- 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:- zu entscheiden, ob der Inhalt der Vorlage in die gewählte Kategorie (Marketing, Utility, Authentifizierung) passt.
- Qualität und Spam-Risiko abzuschätzen.
- Zeigen Sie den Prüfern eine Vorschau an.
- 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:Wählen Sie die Vorlage
Flowella zeigt jede genehmigte Vorlage für Ihren Kanal an. Die Variablen werden automatisch aus dem Vorlagentext, der Kopfzeile und den Schaltflächen erkannt.
Ordnen Sie jede Variable einem HubSpot-Wert zu
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.Legen Sie einen Fallback für leere Werte fest
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.Tipps zur Formatierung von Variablen
Namenfirstname 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:
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 derhs_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.