Syntax
WhatsApp-Vorlagen verwenden positionelle Variablen: doppelte geschweifte Klammern mit einer Zahl.- Um eine Variable hinzuzufügen, klicken Sie im Texteditor auf + Variable oder neben Header text auf Variable. Flowella fügt automatisch die nächste Nummer ein.
- Die Nummern beginnen bei
{{1}}und müssen fortlaufend sein. Sie können nicht von{{1}}zu{{3}}springen. - Variablen sind Text. Zahlen, Datumsangaben und Beträge werden als Text gesendet. Formatieren Sie sie daher, bevor sie die Vorlage erreichen.
Meta unterstützt auch benannte Variablen wie
{{first_name}}. Flowella kann Vorlagen mit benannten Variablen senden, die im WhatsApp Manager erstellt wurden, der Editor von Flowella erstellt jedoch nur positionelle Variablen.Wo Variablen vorkommen können
Beispielwerte
Wenn Sie eine Vorlage veröffentlichen, benötigt Meta für jede Variable ein Beispiel. Meta verwendet die Beispiele, um:- Zu prüfen, ob der Inhalt zur gewählten Kategorie passt (Marketing, Utility oder Authentication).
- Qualität und Spam-Risiko zu beurteilen.
- Den Prüfern eine Vorschau zu zeigen.
- Verwenden Sie realistische Werte.
Johnist in Ordnung,xxxführt oft zur Ablehnung. - Halten Sie Beispiele kurz. Ein ganzer Absatz in einer einzigen Variable ist ein klassisches Ablehnungssignal.
- Passen Sie den Typ an. Wenn
{{2}}ein Datum ist, verwenden Sie ein Datum. Wenn es eine Bestellnummer ist, verwenden Sie etwas, das wie eine Bestellnummer aussieht.
Fallback-Werte
Jede Variable im Editor hat ein Feld Fallback value:- Textvariablen: im Bereich Body variables des Texteditors.
- Variable im Text-Header: unter Header variables in der Karte Variables.
- Variable in der URL-Schaltfläche: unter der Adresse der Schaltfläche.
- Er erscheint in der Vorschau.
- Er geht beim Veröffentlichen als Beispiel der Variable an Meta.
- Flowella sendet ihn, wenn der Wert eines Kontakts fehlt oder leer ist, sobald die Fallback-Werte bestätigt sind.
there in Hi there. Fallback-Werte dürfen keine Zeilenumbrüche enthalten.
Wenn Sie eine in Flowella erstellte Vorlage veröffentlichen, werden ihre Fallback-Werte automatisch bestätigt.
Vorlagen mit nicht geprüften Fallbacks
Manche Vorlagen zeigen in der Vorlagenliste ein Badge Fallbacks not reviewed. Ihre Fallback-Werte hat noch niemand bestätigt, zum Beispiel weil die Vorlage im WhatsApp Manager erstellt wurde. Flowella füllt ihre Fallback-Werte vorab aus den Beispielen der Vorlage. Bis Sie sie bestätigen:- Zeigt der Editor ein Banner: Review fallback values. These are used when a contact’s data is empty. Until you confirm them, sends with missing data will fail.
- Schlägt jeder Versand mit einem leeren Wert fehl, statt den Fallback zu verwenden.
1
Die Vorlage öffnen
Öffnen Sie die Vorlage auf der Seite Templates im Editor.
2
Jeden Fallback-Wert prüfen
Lesen Sie jeden Fallback value und ändern Sie alle, die sich nicht für jeden Kontakt gut lesen würden.
3
Bestätigen
Klicken Sie im Banner auf Confirm fallback values. Wenn Sie einen Wert geändert haben, klicken Sie stattdessen auf Save Template. In beiden Fällen geht nichts an Meta, und die Vorlage wird nicht erneut geprüft.
Was beim Senden passiert
Das gilt für HubSpot-Workflows, Massenversand, die API, Testversand und Sendungen aus dem Posteingang. Flowella sendet nie eine leere Variable an Meta.
Wenn ein Versand wegen einer leeren Variable fehlschlägt, nennt die Fehlermeldung die Variable und verlinkt auf die Vorlage. Zum Beispiel:
Variable {{2}} is empty and has no fallback value. In einem HubSpot-Workflow schlägt die Aktion für diesen Kontakt fehl, und der Workflow-Verlauf zeigt die Meldung. Wenn die Variable keinen Fallback-Wert hat, lautet die Ausgabe Error code der Aktion VARIABLE_EMPTY_NO_FALLBACK.
Variablen aus HubSpot zuordnen
In einem HubSpot-Workflow hat die Aktion Send WhatsApp Template fünf Felder für Variablen: Template Variable 1 bis Template Variable 5. Siehe Workflow-Aktionen.1
Die Vorlage auswählen
Wählen Sie die Vorlage in Template Name. Die Liste zeigt jede Vorlage einmal, nach Namen.
2
Die Variablen der Reihe nach zuordnen
Flowella füllt zuerst eine Variable im Text-Header, dann die Textvariablen der Reihe nach. Ein Beispiel: Eine Vorlage hat
{{1}} im Header sowie {{1}} und {{2}} im Text. Ordnen Sie Template Variable 1 dem Header-Wert und Template Variable 2 und 3 den Textwerten zu. Bild-, Video- und Dokument-Header belegen kein Feld.3
Leere Werte einplanen
Wenn eine zugeordnete Eigenschaft für einen Kontakt leer ist, sendet Flowella den bestätigten Fallback-Wert. Wenn die Vorlage für diese Variable keinen bestätigten Fallback hat, schlägt die Aktion für diesen Kontakt fehl. Wenn Sie weniger Felder zuordnen, als die Vorlage Variablen hat, behandelt Flowella die fehlenden als leer.
4
Vor dem Livegang testen
Nehmen Sie zuerst einen Testkontakt auf und prüfen Sie die Nachricht auf Ihrem Smartphone. Aktivieren Sie den Workflow dann für alle.
Eine Vorlage kann mehr als fünf Variablen haben, die Aktion kann aber nur fünf zuordnen. Für jede Variable nach der fünften sendet Flowella den bestätigten Fallback-Wert, oder der Versand schlägt fehl, wenn es keinen gibt.
Datumsangaben aus HubSpot
HubSpot sendet Datums- und Datum-Uhrzeit-Eigenschaften als Zeitstempel. Flowella wandelt ihn indd.MM.yyyy HH:mm in UTC um, zum Beispiel 27.06.2026 14:30. Eine reine Datumseigenschaft zeigt die Uhrzeit 00:00.
Um ein Datum in der Ortszeit des Kontakts oder in einem anderen Format anzuzeigen, speichern Sie das formatierte Datum in einer HubSpot-Texteigenschaft und ordnen Sie stattdessen diese Eigenschaft zu. Flowella sendet Texteigenschaften genau so, wie sie sind.
Sprache
Die Liste Template Name zeigt jeden Vorlagennamen einmal. Wenn eine Vorlage in mehr als einer Sprache freigegeben ist, wählt Flowella eine Version in dieser Reihenfolge:- Die mit der Workflow-Aktion übergebene Sprache, falls vorhanden.
- Eine Version mit dem Sprachcode
en. Versionen inen_USoderen_GBzählen hier nicht. - Die zuletzt aktualisierte freigegebene Version.
Standort-Header
Eine Vorlage mit Standort-Header benötigt bei jedem Versand einen Breiten- und Längengrad. Ortsname und Adresse sind optional. Ordnen Sie den Standort in einem HubSpot-Workflow den Template Variable-Feldern zu, die auf Ihre Textvariablen folgen: zuerst den Breitengrad, dann den Längengrad, dann den Ortsnamen. Bei zwei Textvariablen ordnen Sie zum Beispiel den Breitengrad Template Variable 3 und den Längengrad Template Variable 4 zu.Tipps zur Formatierung von Variablen
Namenfirstname in eine Eigenschaft „First name (formatted)” zu kopieren.
Datumsangaben
WhatsApp formatiert keine Datumsangaben. Ordnen Sie eine Texteigenschaft zu, die das Datum so enthält, wie es gelesen werden soll, zum Beispiel 24 May 2026. Siehe Datumsangaben aus HubSpot.
Währung
Formatieren Sie Beträge, bevor sie die Vorlage erreichen. Setzen Sie das Währungssymbol in den Vorlagentext (Total: £{{1}}), sodass die Variable nur die Zahl enthält.
URLs im Text
Sie können eine vollständige URL in eine Textvariable setzen, die Linkvorschau wird dann aber nicht angezeigt, und die URL zählt zum Zeichenlimit des Texts. Verwenden Sie stattdessen eine URL-Schaltfläche mit einer Variable am Ende:
Sendungen aus HubSpot-Workflows füllen nur Text-, Header- und Standortvariablen. Sie können einer URL-Schaltfläche keinen kontaktspezifischen Wert geben. Setzen Sie für Links, die sich in einem HubSpot-Workflow je Kontakt ändern, die vollständige URL daher stattdessen in eine Textvariable.
Häufige Ablehnungsgründe im Zusammenhang mit Variablen
- Übersprungene Nummern (
{{1}}, dann{{3}}). Nummerieren Sie Variablen der Reihe nach. - Eine Variable ganz am Anfang oder Ende des Texts ohne umgebenden Text. Fügen Sie davor oder danach ein Wort hinzu.
- Zwei Variablen direkt nebeneinander (
{{1}}{{2}}). Trennen Sie sie mindestens durch ein Leerzeichen oder ein Satzzeichen. - Beispiele, die wie Platzhalter aussehen, etwa
test,xxxoder123, besonders in Marketing-Vorlagen. - Variablen in der Fußzeile. Fußzeilen können keine Variablen haben.
- Mehr als eine Variable in einer URL-Schaltfläche. Nur eine ist erlaubt, und sie muss am Ende der URL stehen.
Fortgeschrittene Muster
Einen Wert in mehreren Komponenten wiederverwenden
Header- und Textvariablen werden getrennt nummeriert,{{1}} im Header und {{1}} im Text sind also verschiedene Variablen. Wenn ein Kundenname in beiden vorkommt, ordnen Sie beiden Feldern dieselbe HubSpot-Eigenschaft zu: Template Variable 1 für den Header und Template Variable 2 für den Text.
Bedingte Inhalte
WhatsApp-Vorlagen unterstützen keine Wenn-dann-Logik. Um verschiedenen Kontaktgruppen unterschiedliche Inhalte zu senden, erstellen Sie separate Vorlagen und verzweigen Sie Ihren HubSpot-Workflow, zum Beispiel „VIP welcome” und „Standard welcome”.Mehrsprachige Vorlagen
Jede Sprachversion einer Vorlage wird separat eingereicht, freigegeben und gespeichert. Halten Sie die Variablen in jeder Sprache an denselben Positionen. Welche Version ein HubSpot-Workflow sendet, erfahren Sie unter Sprache.Fehlerbehebung
Sendungen schlagen mit Variable {{n}} is empty and has no fallback value fehl
Sendungen schlagen mit Variable {{n}} is empty and has no fallback value fehl
Der Wert des Kontakts war leer, und die Vorlage hat für diese Variable keinen Fallback-Wert. In HubSpot lautet der Error code der Aktion
VARIABLE_EMPTY_NO_FALLBACK. Stellen Sie sicher, dass die Eigenschaft für jeden Kontakt gefüllt ist, oder fügen Sie der Vorlage einen Fallback-Wert hinzu und bestätigen Sie ihn.Sendungen schlagen mit Variable {{n}} is empty and its fallback has not been reviewed fehl
Sendungen schlagen mit Variable {{n}} is empty and its fallback has not been reviewed fehl
Die Vorlage hat einen Fallback-Wert, aber niemand hat ihn bestätigt. Öffnen Sie die Vorlage und klicken Sie auf Confirm fallback values. Siehe Vorlagen mit nicht geprüften Fallbacks.
Ein Kontakt hat den Fallback-Wert statt seiner eigenen Daten erhalten
Ein Kontakt hat den Fallback-Wert statt seiner eigenen Daten erhalten
Die zugeordnete Eigenschaft war für diesen Kontakt leer, oder die Vorlage hat mehr als fünf Variablen. Prüfen Sie den Kontaktdatensatz und die Variablenzuordnung in der Workflow-Aktion.
Kann eine Nachricht mit einem wörtlichen {{1}} ankommen?
Kann eine Nachricht mit einem wörtlichen {{1}} ankommen?
Nein. Flowella sendet nie eine leere oder nicht gefüllte Variable. Ein leerer Wert wird durch den bestätigten Fallback-Wert ersetzt, oder der Versand schlägt fehl.
Nachricht beim Senden wegen eines Richtlinienverstoßes abgelehnt
Nachricht beim Senden wegen eines Richtlinienverstoßes abgelehnt
Eine Variable enthält eine URL oder Inhalte, die nicht zur Kategorie der Vorlage passen. Sie können einer Utility-Vorlage über ihre Variablen keine Marketinginhalte hinzufügen. Wie Sie den von WhatsApp gemeldeten Fehlercode nachschlagen, erfahren Sie unter WhatsApp-Fehlercodes in Flowella.