> ## 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-Vorlagen erstellen und verwalten

> Erstellen, einreichen und pflegen Sie WhatsApp-Vorlagen für Marketing, Utility und Authentifizierung – inklusive Variablen, Buttons und Genehmigungsstatus.

<Frame>
  <img src="https://mintcdn.com/flowella/QH2KmtfTITL7teRo/images/Screenshots/flowella-whatsapp-templates.png?fit=max&auto=format&n=QH2KmtfTITL7teRo&q=85&s=9b67e4775011f71dc80bc6f2f5baa18a" alt="Flowella WhatsApp templates list" width="2772" height="1686" data-path="images/Screenshots/flowella-whatsapp-templates.png" />
</Frame>

WhatsApp-Vorlagen sind vorab genehmigte Nachrichtenformate, mit denen Sie strukturierte Nachrichten an Ihre Kontakte senden können. Sie sind unverzichtbar, um Personen außerhalb des 24-Stunden-Kundenservice-Fensters zu erreichen – für Benachrichtigungen, Updates, Erinnerungen und mehr. Vorlagen können Rich Media wie Bilder und Videos, dynamische Textvariablen sowie interaktive Buttons enthalten.

## Was Vorlagen sind und warum sie eine Meta-Freigabe benötigen

Da WhatsApp-Vorlagen außerhalb des Standard-Konversationsfensters versendet werden, prüft Meta jede Vorlage, bevor sie verwendet werden kann. Der Freigabeprozess stellt sicher, dass Nachrichten die Qualitätsstandards und Unternehmensrichtlinien von WhatsApp erfüllen. Häufige Ablehnungsgründe sind zu werbliche Sprache, irreführende Inhalte oder schlechte Grammatik – es zahlt sich daher aus, die Texte klar zu halten und auf echten Mehrwert für die Empfänger zu fokussieren.

Sobald Meta eine Vorlage genehmigt hat, können Sie sie in Flowella-Workflows, automatisierten Flows, Kampagnen und manuellen Posteingangs-Versendungen verwenden. Änderungen an der Struktur einer Vorlage erfordern eine erneute Einreichung – aber dynamische Variablen ermöglichen es Ihnen, jede Nachricht ohne zusätzliche Freigaben zu personalisieren.

<Note>
  Die Freigabe erfolgt oft nahezu sofort. Meta führt eine automatisierte Erstprüfung durch, die die meisten Vorlagen innerhalb von Minuten freigibt, alles, was zur menschlichen Prüfung weitergeleitet wird, kann jedoch **bis zu 48 Stunden** dauern. Reichen Sie rechtzeitig ein, damit eine langsamere Prüfung nie einen Produktivversand blockiert.
</Note>

<Tip>
  Suchen Sie eine schnelle Referenz zu Kategorien, Header-Formaten, Button-Typen, der `{{n}}`-Variablensyntax oder dem Einreichungs-Lebenszyklus? Siehe [Vorlagenreferenz](/app/template-reference).
</Tip>

## Eine Vorlage erstellen

<Steps>
  <Step title="Zu Vorlagen navigieren">
    Klicken Sie in der linken Seitenleiste auf **Vorlagen**.

    <Tip>
      Dies ist die zentrale Stelle für all Ihre WhatsApp-Nachrichtenvorlagen. Von hier aus können Sie jede Vorlage Ihres Kontos anzeigen, bearbeiten und den Freigabestatus verfolgen.
    </Tip>
  </Step>

  <Step title="Eine neue Vorlage starten">
    Klicken Sie auf **New Template**, um zu beginnen.

    <Tip>
      Bevor Sie starten, sollten Sie eine klare Vorstellung vom Zweck Ihrer Vorlage haben – Bestellbestätigung, Terminerinnerung, Werbenachricht und so weiter. Ein klares Ziel erleichtert es, Texte zu schreiben, die Metas Prüfung bestehen.
    </Tip>
  </Step>

  <Step title="Vorlage benennen">
    Geben Sie einen aussagekräftigen Namen ein, der den Zweck der Vorlage widerspiegelt.

    <Tip>
      Verwenden Sie nur Kleinbuchstaben, Zahlen und Unterstriche – zum Beispiel `order_confirmation` oder `appointment_reminder`. Leerzeichen und Sonderzeichen sind von Meta nicht erlaubt.
    </Tip>
  </Step>

  <Step title="Einen visuellen Header hinzufügen">
    Fügen Sie optional ein Bild oder Video als Vorlagen-Header hinzu, um Ihre Nachricht ansprechender zu gestalten.

    <Note>
      Ein Header-Medium ist optional, aber empfohlen. Bilder müssen unter 5 MB und Videos unter 10 MB groß sein. Videos sollten unter 60 Sekunden lang sein und mit einem ansprechenden Bild beginnen.
    </Note>
  </Step>

  <Step title="Nachrichten-Body schreiben">
    Geben Sie den Haupttext für Ihre Vorlage ein. Halten Sie ihn klar, prägnant und relevant für Ihre Zielgruppe.

    <Tip>
      Verwenden Sie doppelte geschweifte Klammern, um dynamische Variablen hinzuzufügen – zum Beispiel `Hi {{1}}, your order {{2}} is ready for pickup!`. Diese werden durch echte Kontaktdaten ersetzt, wenn Flowella die Nachricht sendet.
    </Tip>

    <Note>
      Vermeiden Sie zu werbliche Sprache. Metas Prüfung achtet auf Nachrichten, die dem Empfänger einen klaren Mehrwert bieten.
    </Note>
  </Step>

  <Step title="Einen Button hinzufügen">
    Klicken Sie auf **Add a button to your template**, um ein interaktives Element einzufügen.

    <Tip>
      Buttons geben Kontakten einen klaren nächsten Schritt und erhöhen die Interaktion. Sie können bis zu drei Buttons pro Vorlage hinzufügen.
    </Tip>
  </Step>

  <Step title="Button-Typ auswählen">
    Wählen Sie den Button-Typ, der zu Ihrem Anwendungsfall passt:

    * **Call-to-Action-Button** – leitet Nutzer zu einer Website oder Telefonnummer.
    * **Quick-Reply-Button** – ermöglicht Nutzern eine Antwort mit vordefiniertem Text.
    * **URL-Button** – sendet Nutzer auf eine bestimmte Webseite.

    <Note>
      Sie können Button-Typen in derselben Vorlage mischen. Kombinieren Sie zum Beispiel einen URL-Button mit der Beschriftung „View Order" mit einem Quick-Reply-Button namens „Contact Support".
    </Note>
  </Step>

  <Step title="Button-Wert festlegen">
    Geben Sie die Aktion oder das Ziel für den Button ein – zum Beispiel eine Telefonnummer für einen Anruf-Button oder eine URL für einen Link-Button.
  </Step>

  <Step title="Button-Text hinzufügen">
    Geben Sie die Beschriftung ein, die auf dem Button erscheinen soll. Machen Sie sie aktionsorientiert und klar – zum Beispiel „Mehr erfahren", „Kontaktieren Sie uns" oder „Loslegen".

    <Note>
      Der Button-Text ist auf 25 Zeichen begrenzt. Verwenden Sie kurze Handlungsverben und machen Sie deutlich, was beim Antippen des Buttons passiert.
    </Note>
  </Step>

  <Step title="Vorlage erstellen">
    Klicken Sie auf **Create Template**, um Ihre Vorlage zu speichern und einzureichen.

    <Note>
      Durch das Einreichen wird die Vorlage zur Prüfung an Meta gesendet. Das geht oft nahezu sofort, da die meisten Vorlagen Metas automatisierte Prüfung innerhalb von Minuten passieren – einige werden jedoch zur menschlichen Prüfung weitergeleitet und können bis zu 48 Stunden dauern.
    </Note>

    <Tip>
      Während der Prüfung kontrolliert Meta die Richtlinien-Konformität. Stellen Sie sicher, dass Ihre Vorlage den Empfängern einen klaren Mehrwert bietet und werbliche Sprache vermeidet, die zu einer Ablehnung führen könnte.
    </Tip>
  </Step>

  <Step title="Auf Freigabe warten">
    Eingereichte Vorlagen landen im Status **Pending**. Die meisten passieren Metas automatisierte Prüfung innerhalb von Minuten; einige werden zur menschlichen Prüfung weitergeleitet.

    <Note>
      Meta weist darauf hin, dass die Freigabe **bis zu 12 Stunden** dauern kann, und Flowella **sendet Ihnen eine E-Mail**, sobald sich der Status ändert. Sie müssen die Seite nicht ständig aktualisieren.
    </Note>
  </Step>
</Steps>

Sobald Meta die Vorlage genehmigt, können Sie sie in Flowella-Workflows, automatisierten Flows, dem Posteingang und Bulk-Sendungen verwenden.

## Editor-Verhalten

Der Vorlagen-Editor ist so konzipiert, dass keine Arbeit verloren geht.

* **Auto-Save** – jede Änderung an Name, Sprache, Kategorie, Kanal oder Komponenten wird nach einer Pause von ca. einer Sekunde gespeichert. Eine fixierte Footer-Aktionsleiste zeigt den aktuellen Speicherzustand (**Saving…**, **Saved** oder **Unsaved changes**).
* **Veröffentlichen ist an das Speichern gekoppelt** – der Button **Publish** bleibt deaktiviert, bis das letzte Auto-Save abgeschlossen ist, sodass Sie niemals einen halb gespeicherten Entwurf an Meta einreichen können.
* **Zeilenumbrüche im Body und Leerzeichen im Footer** bleiben über Tab-Wechsel und Speichervorgänge hinweg erhalten – was Sie tippen, ist das, was Meta erhält.
* **Quick-Reply-Buttons starten leer** mit einem Platzhalter. Das Speichern oder Veröffentlichen einer Vorlage mit leerem Quick-Reply-Text wird durch Inline-Validierung blockiert (`BUTTON_TEXT_REQUIRED`).
* **Das Kategorie-Dropdown** zeigt im geschlossenen Zustand nur das ausgewählte Label; beim Öffnen werden Meta-konforme Beschreibungen, ein Hinweis zur Neukategorisierung und ein Link zur [Vorlagenreferenz](/app/template-reference) angezeigt.

## Eine Vorlage testen

Um eine Vorlage vor der Verwendung mit echten Kontakten zu testen, öffnen Sie die Vorlage und wechseln Sie zum Tab **Send**.

<Steps>
  <Step title="Den Send-Tab öffnen">
    Klicken Sie unter **Vorlagen** auf die Vorlage, die Sie testen möchten, und wählen Sie den Tab **Send**.
  </Step>

  <Step title="Ihre Nummer eingeben">
    Wählen Sie unter **Test Template** die **Ländervorwahl** und geben Sie die WhatsApp-Nummer ein, auf der Sie Nachrichten empfangen können.

    <Note>
      Die Nummer muss im internationalen Format mit der Ländervorwahl angegeben werden – zum Beispiel `+44123456789`.
    </Note>
  </Step>

  <Step title="Erforderliche Variablen ausfüllen">
    Geben Sie für jede Vorlagenvariable einen Wert an. Für **Coupon code**-Vorlagen geben Sie die tatsächlichen Codes ein, die Sie versenden möchten – der Beispielwert der Vorlage ist **nur ein Platzhalter** und wird zur Sendezeit niemals verwendet.
  </Step>

  <Step title="Test senden">
    Klicken Sie auf **Send Test**.

    <Tip>
      Sie können einen Test senden, auch während die Vorlage noch auf die Freigabe von Meta wartet. So sehen Sie genau, wie die Nachricht für Kontakte aussieht, bevor Sie sie in der Produktion verwenden.
    </Tip>
  </Step>

  <Step title="Auf dem Gerät überprüfen">
    Öffnen Sie die Nachricht auf Ihrem Gerät und bestätigen Sie, dass Header-Medien, Body-Formatierung und Buttons korrekt dargestellt werden. Prüfen Sie nach Möglichkeit auf iOS und Android.
  </Step>
</Steps>

## Bulk-Versand

Der Tab **Send** ermöglicht es Ihnen auch, eine **APPROVED**-Vorlage in einem Vorgang an viele Empfänger zu senden – nützlich für Marketing-Ankündigungen, gebündelte Erinnerungen oder jeden strukturierten ausgehenden Versand, der nicht in den Posteingang passt.

### Die Empfängerliste erstellen

Der Editor für die Empfängerliste befindet sich unter **Test Template** im Send-Tab.

* **Zeilen manuell hinzufügen** – eine Zeile pro Empfänger, mit einer Telefonspalte und einer Spalte pro Vorlagenvariable.
* **Aus CSV importieren** – klicken Sie auf **Import CSV** und wählen Sie eine Datei aus. Der CSV-Datei-Import ist die einzige Möglichkeit, Empfänger in großen Mengen zu importieren; das Einfügen von Zeilen wird nicht unterstützt.
* **Beispiel-CSV herunterladen** – Flowella erzeugt eine Starterdatei mit den korrekten Spaltenüberschriften für die gewählte Vorlage (Telefon + jede Variable). Verwenden Sie sie als Grundlage für Ihre eigene Liste.
* Entfernen Sie Zeilen über die Löschaktion auf Zeilenebene.

<Tip>
  Telefonnummern müssen im vollständigen internationalen Format vorliegen (`+447700900000`). Siehe [Telefonnummern-Format](/hubspot/phone-number-format).
</Tip>

### Planung und Drosselung

* **Planung** – sofort senden oder ein zukünftiges Datum und eine Uhrzeit auswählen.
* **Drosselung** – wählen Sie, wie viele Nachrichten pro Sekunde Flowella an Meta sendet. Drosseln Sie unterhalb der **Nachrichtenlimit-Stufe** Ihrer Telefonnummer, um Spitzen zu vermeiden, die der Qualitätsbewertung schaden. Siehe [Nachrichtenlimits](/meta/messaging-limits).

### Den Auftrag beobachten

Sobald Sie auf **Start send** klicken, zeigt der Tab **Statistics** derselben Vorlage einen Live-**Fortschrittsbanner** (über einen SSE-Stream geliefert) und **Auftragsübersicht-Kacheln**: insgesamt in Warteschlange, gesendet, zugestellt, gelesen, fehlgeschlagen und **unterdrückt**.

Der Status **Suppressed** wird verwendet, wenn Flowella eine Zeile verwirft, weil dasselbe `(template, phone)`-Paar bereits innerhalb des **Dedup-Fensters** versendet wurde. Dadurch werden versehentliche Duplikate verhindert, wenn Sie eine CSV erneut importieren oder einen Zeitplan erneut ausführen.

Sie können die Seite verlassen – der Auftrag läuft serverseitig weiter und beim Abschluss wird eine Benachrichtigung ausgelöst.

### Spalte „Details" pro Versand

Jede Zeile im **Statistics → Send log** verfügt über eine Spalte **Details**, die das Ergebnis in einfacher Sprache statt eines Meta-Fehlercodes erklärt. Der Detailtext leitet den Fehlergrund aus `meta_webhook_logs` und der persistierten Zustellnutzlast ab, sodass Meta-Fehler nach dem Versand (zum Beispiel Zahlungsmethode **131042**) genauso angezeigt werden wie Auftragsfehler vor dem Versand.

| Detail                       | Bedeutung                                                                                                                                          |
| ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Delivered**                | Meta hat die Zustellung bestätigt.                                                                                                                 |
| **Invalid phone**            | Die Telefonnummer des Empfängers ist keine gültige WhatsApp-Nummer.                                                                                |
| **Opted out**                | Der Kontakt steht auf der Opt-out-Liste.                                                                                                           |
| **Contact missing**          | Die Telefonnummer ließ sich zum Sendezeitpunkt keinem Flowella-Kontakt zuordnen.                                                                   |
| **Header media URL invalid** | Die Vorlage hat einen Medien-Header, dessen Beispiel-URL nicht für Versendungen verwendet werden kann. Laden Sie das Medium im Editor erneut hoch. |
| **Payment method (131042)**  | Meta hat den Versand abgelehnt, weil die Zahlungsmethode Ihrer WABA ungültig ist oder unzureichende Mittel hat.                                    |
| **Other Meta API error**     | Ein nicht-deterministischer Meta-Fehler – erneut senden, wenn das Problem vorübergehend ist.                                                       |
| **Unknown delivery failure** | Meta hat den Versand akzeptiert, später aber gemeldet, dass keine Zustellung möglich war.                                                          |

Status-Badges sind auf die UI-Sprache Ihres Kontos lokalisiert.

## Verwandt

<CardGroup cols={2}>
  <Card title="Vorlagenreferenz" icon="file-text" href="/app/template-reference">
    Kategorien, Header, Buttons, Variablen und der Einreichungs-Lebenszyklus.
  </Card>

  <Card title="Vorlagenvariablen" icon="curly-braces" href="/app/template-variables">
    Syntax, Beispielwerte, HubSpot-Mapping und Ablehnungsfallen.
  </Card>

  <Card title="Medien-Header" icon="image" href="/app/media-in-template-headers">
    Welche Medienformate und -größen WhatsApp in Vorlagen-Headern akzeptiert.
  </Card>

  <Card title="Vorlage abgelehnt" icon="bug" href="/troubleshooting/template-rejected">
    Häufige Meta-Ablehnungsgründe und wie Sie sie beheben.
  </Card>

  <Card title="Preise & Kategorien" icon="badge-dollar-sign" href="/account/pricing-and-conversation-categories">
    Wie die Vorlagenkategorie die Preise von Meta pro Konversation bestimmt.
  </Card>

  <Card title="Workflow-Aktionen" icon="git-branch" href="/hubspot/workflow-actions">
    Senden Sie Ihre genehmigten Vorlagen aus einem HubSpot-Workflow.
  </Card>
</CardGroup>
