> ## 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. Flowella WhatsApp templates list 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. 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. Suchen Sie eine schnelle Referenz zu Kategorien, Header-Formaten, Button-Typen, der `{{n}}`-Variablensyntax oder dem Einreichungs-Lebenszyklus? Siehe [Vorlagenreferenz](/app/template-reference). ## Eine Vorlage erstellen ### Wählen Sie einen Ausgangspunkt Ein Klick auf **New Template** (oder das Aufrufen von `/{org}/templates/new`) öffnet eine Auswahl mit drei Möglichkeiten, zu starten: * **Build your own** – schreiben Sie die Nachricht selbst. Wählen Sie eine von zwei Optionen: * **Standard message** – öffnet den leeren Editor für eine Vorlage mit optionalem Header, Body, Footer und Buttons. * **Carousel** (markiert mit **NEW**) – öffnet den Karussell-Editor, um eine scrollbare Reihe von Bild- oder Videokarten zu erstellen. Siehe [Eine Karussell-Vorlage erstellen](#build-a-carousel-template). * **Meta Library** – durchsuchen Sie Metas eigenen Katalog vorgefertigter Utility-Vorlagen. Diese sind von Meta vorab geprüft und werden in der Regel schnell genehmigt. * **Flowella Templates** – ein kuratierter Katalog von Starter-Vorlagen, die die Möglichkeiten von Flowella zeigen (Flow-Buttons, Coupons, Re-Engagement und so weiter). **Carousel** bleibt deaktiviert, bis Sie eine WhatsApp-Nummer verbinden. Jede Karte benötigt ein eigenes Bild oder Video, und Flowella lädt diese Medien über Ihre verbundene Nummer zu Meta hoch. Fahren Sie mit der Maus über die deaktivierte Option, um einen Tooltip mit dieser Erklärung zu sehen. Sie können mit dem Query-Parameter `entry` direkt auf eine bestimmte Option verlinken: `?entry=meta`, `?entry=flowella`, `?entry=scratch` (Standardnachricht) oder `?entry=carousel`. Der Schritt **Erste Vorlage erstellen** im Onboarding-Einrichtungsleitfaden verwendet `?entry=meta`, um direkt in der Meta Library zu landen. Beide Galerien rendern **gemeinsame WhatsApp-Vorschaukarten**, sodass das, was Sie beim Browsen sehen, mit der Darstellung der Vorlagen im Vorlagenkatalog übereinstimmt – dieselbe Vorschau von Header, Body und Buttons. #### Meta Library-Galerie In der Meta Library-Galerie können Sie Metas Katalog von Utility-Vorlagen durchsuchen und Vorlagen übernehmen, ohne sie neu zu schreiben. * **Suche** – tippen Sie, um nach Namen zu filtern; die Ergebnisse sind entprellt und werden pro WABA etwa eine Stunde lang zwischengespeichert. * **Sprachfilter** – standardmäßig ist die Galerie auf die WhatsApp-Sprache gefiltert, die aus der **Inhaltssprache** Ihrer Organisation abgeleitet wird (festgelegt unter **Einstellungen → Organisation**). Schalten Sie **Alle Sprachen** ein, um alle Meta-Locales zu durchsuchen. * **Eine als Entwurf öffnen** – klicken Sie auf einer Karte auf **Open as draft**, um diese Vorlage als lokalen Entwurf zu instanziieren und direkt in den Editor zu springen. Es wird nichts an Meta übermittelt, bis Sie auf **Publish** klicken. * **Mehrfachauswahl hinzufügen** – setzen Sie das Häkchen auf mehreren Karten und klicken Sie dann auf **Create drafts (**{count}**)**, um alle ausgewählten Vorlagen auf einmal zu instanziieren. Bei Erfolg kehrt Flowella zur Vorlagenliste zurück. Auswahlen aus der Library werden immer als **lokale Entwürfe** in Ihrem WABA geöffnet. Sie können vor dem Veröffentlichen umbenennen, Variablen bearbeiten, Buttons hinzufügen oder Kategorien ändern – der Meta Library-Eintrag ist lediglich ein Ausgangspunkt. #### Flowella Templates-Galerie Die Flowella Templates-Galerie listet kuratierte Starter, die von Flowella gepflegt werden (Bestellstatus-Flows, Coupon-Aktionen, Terminerinnerungen und so weiter). Wählen Sie einen Starter, um den Editor mit einem bereit-zu-personalisierenden Entwurf vorzubefüllen, und veröffentlichen Sie ihn dann bei Meta, wenn Sie zufrieden sind. Hinter den Kulissen bringt Sie die Galerie über `?starter=` in den Editor. ### Editor ausfüllen Geben Sie einen aussagekräftigen Namen ein, der den Zweck der Vorlage widerspiegelt. Verwenden Sie nur Kleinbuchstaben, Zahlen und Unterstriche – zum Beispiel `order_confirmation` oder `appointment_reminder`. Leerzeichen und Sonderzeichen sind von Meta nicht erlaubt. Fügen Sie optional ein Bild oder Video als Vorlagen-Header hinzu, um Ihre Nachricht ansprechender zu gestalten. 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. Geben Sie den Haupttext für Ihre Vorlage ein. Halten Sie ihn klar, prägnant und relevant für Ihre Zielgruppe. 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. Vermeiden Sie zu werbliche Sprache. Metas Prüfung achtet auf Nachrichten, die dem Empfänger einen klaren Mehrwert bieten. Klicken Sie auf **Add a button to your template**, um ein interaktives Element einzufügen. Buttons geben Kontakten einen klaren nächsten Schritt und erhöhen die Interaktion. Sie können bis zu drei Buttons pro Vorlage hinzufügen. 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. 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". 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. 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". Der Button-Text ist auf 25 Zeichen begrenzt. Verwenden Sie kurze Handlungsverben und machen Sie deutlich, was beim Antippen des Buttons passiert. Klicken Sie auf **Create Template**, um Ihre Vorlage zu speichern und einzureichen. 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. 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. Eingereichte Vorlagen landen im Status **Pending**. Die meisten passieren Metas automatisierte Prüfung innerhalb von Minuten; einige werden zur menschlichen Prüfung weitergeleitet. 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. Sobald Meta die Vorlage genehmigt, können Sie sie in Flowella-Workflows, automatisierten Flows, dem Posteingang und Bulk-Sendungen verwenden. ### Eine Karussell-Vorlage erstellen Eine Karussell-Vorlage sendet eine Nachrichtenblase, gefolgt von einer Reihe von Karten, durch die der Empfänger seitlich scrollt. Jede Karte hat ein eigenes Bild oder Video, optionalen Text und Buttons. Verwenden Sie ein Karussell, um mehrere Produkte, Angebote oder Optionen in einer einzigen Marketing-Nachricht zu präsentieren. **Voraussetzungen:** eine verbundene WhatsApp-Nummer und eine Bild- oder Videodatei für jede Karte. Klicken Sie auf **New Template** und dann auf der Karte **Build your own** auf **Carousel**. Der Editor öffnet sich mit einem Badge **Carousel · {count} cards** neben dem Vorlagennamen. Geben Sie den Body-Text ein, der in der Nachrichtenblase über den Karten erscheint. Die Kategorie ist fest auf **Marketing** eingestellt. Karussells haben keinen Header, keinen Footer und keine Buttons auf Nachrichtenebene. Die Buttons befinden sich stattdessen auf jeder Karte. Wählen Sie unter **Card structure** den **Media type** für alle Karten: **Image** oder **Video**. Jede Karte verwendet denselben Medientyp. Aktivieren Sie **Card body**, wenn Sie Text auf jeder Karte möchten. Wenn Sie die Option aktivieren, benötigt jede Karte Body-Text mit bis zu **160 Zeichen** pro Karte. Fügen Sie unter **Card buttons** bis zu **2 Buttons** hinzu. Jeder Button ist ein **Quick reply**, **Link** oder **Phone number**. Jede Karte erhält dieselben Button-Typen in derselben Reihenfolge. Beschriftung, Link oder Telefonnummer jedes Buttons legen Sie auf der Karte selbst fest, sodass jede Karte auf ein anderes Ziel verweisen kann. Ein neues Karussell beginnt mit 2 Karten. Klicken Sie auf **Add card**, um weitere hinzuzufügen, bis zu **10 Karten**. Laden Sie auf jeder Karte das Bild oder Video hoch, schreiben Sie den Kartentext und legen Sie die Button-Beschriftungen und -Werte fest. Die Vorschau zeigt die Karten als seitlichen Streifen, so wie WhatsApp sie anzeigt. Klicken Sie auf **Publish**, um das Karussell bei Meta einzureichen. #### Karten verwalten * **Neu anordnen** – ziehen Sie eine Karte an ihrem Griff. Für die Tastatur fokussieren Sie den Ziehgriff und drücken die Pfeiltaste nach oben oder unten. Sie können auch **Move up** und **Move down** verwenden. * **Duplizieren** – klicken Sie auf **Duplicate**, um eine Karte zu kopieren. Flowella kopiert Text, Buttons und Variablenbeispiele, entfernt aber die Medien. Laden Sie auf der Kopie ein neues Bild oder Video hoch. * **Löschen** – klicken Sie auf **Delete**, um eine Karte zu entfernen. Ein Karussell benötigt mindestens 2 Karten. Wenn Sie die Anzahl der Karten einer bereits eingereichten Vorlage ändern, warnt Flowella Sie, dass die Vorlage erneut zur Prüfung an WhatsApp geht. Klicken Sie auf **Change card count**, um fortzufahren, oder auf **Cancel**, um die aktuellen Karten zu behalten. #### Kartenmedien | Medientyp | Formate | Maximale Größe | | - | - | - | | Bild | JPEG oder PNG | 5 MB | | Video | MP4 | 16 MB | Flowella prüft jede Datei vor dem Hochladen. Wenn eine Datei den falschen Typ hat oder zu groß ist, zeigt die Karte den Fehler sofort an, zum Beispiel **This image is over 5 MB. JPEG and PNG card images must be 5 MB or smaller.** Wenn ein Upload fehlschlägt, klicken Sie auf dieser Karte auf **Retry**. WhatsApp beschneidet Kartenbilder auf ein breites Format. Wenn Sie ein Bild im Hochformat hochladen, warnt Flowella, dass oben und unten etwas abgeschnitten werden kann. Verwenden Sie Bilder im Querformat oder platzieren Sie wichtige Inhalte in der Mitte. #### Regeln, die Flowella vor dem Einreichen prüft Flowella prüft das Karussell anhand der WhatsApp-Regeln und hebt die Karte hervor, die korrigiert werden muss. Hat eine Karte zum Beispiel keine Medien, hebt Flowella diese Karte hervor und zeigt **Card 3: has no image. Every card needs its own uploaded image before you can submit.** an. * Das Karussell hat 2 bis 10 Karten. * Jede Karte hat hochgeladene Medien desselben Typs. * Entweder hat jede Karte Body-Text oder keine. Der Karten-Body-Text umfasst höchstens 160 Zeichen, und jede Variable hat ein Beispiel. * Jede Karte hat dieselbe Anzahl von Buttons mit denselben Typen in derselben Reihenfolge. Die Beschriftungen können sich unterscheiden. * Ein Link-Button kann eine Variable am Ende der URL mit einem Beispielwert enthalten. Sie wählen beim Erstellen der Vorlage zwischen einer Standardnachricht und einem Karussell. Sie können ein Karussell nicht in eine Standardvorlage umwandeln und umgekehrt. Um zu wechseln, erstellen Sie eine neue Vorlage. Die vollständige Liste der Karussell-Regeln von WhatsApp finden Sie unter [Karussell-Vorlagen](/de/app/template-reference#carousel-templates). ## Zustell-Health-Pills in der Vorlagenliste Jede Zeile in der Vorlagenliste kann zusätzlich zum üblichen Status-Badge eine **Zustell-Health-Pill** anzeigen. Die Pill markiert Vorlagen, deren Zustellung WhatsApp gestoppt hat, sodass Sie sie erkennen, ohne jeden Editor öffnen zu müssen. | Pill | Wann sie erscheint | Was sie bedeutet | | - | - | - | | **Von WhatsApp pausiert** | Meta-Status ist `PAUSED`. | WhatsApp hat diese Vorlage pausiert. Journeys, Kampagnen und HubSpot-Workflow-Aktionen, die sie verwenden, senden nicht, bis Meta sie wiederherstellt. | | **Von WhatsApp deaktiviert** | Meta-Status ist `DISABLED`. | WhatsApp hat diese Vorlage deaktiviert. Aktualisieren oder ersetzen Sie sie, bevor Sie erneut senden. | | **Qualität: Rot** | Meta-Qualitätsbewertung ist `RED` und die Vorlage ist nicht bereits pausiert oder deaktiviert. | WhatsApp hat diese Vorlage mit Rot bewertet. Prüfen Sie aktuelle Versendungen und Kundenfeedback im Meta Business Manager. | Die Pills „Pausiert" und „Deaktiviert" ersetzen das normale Status-Badge; die Pill „Qualität: Rot" wird daneben angezeigt. Wenn Meta die Pause aufhebt, die Vorlage wiederherstellt oder die Qualität auf Yellow/Green zurückkehrt, verschwindet die Pill beim nächsten Sync automatisch. Übergänge zu Pause, Deaktivierung und Qualität-RED **lösen zudem Benachrichtigungen aus** (`TEMPLATE_PAUSED`, `TEMPLATE_DISABLED`, `TEMPLATE_QUALITY`), sodass Sie es auch mitbekommen, wenn Sie sich nicht auf der Vorlagenseite befinden. Aktivieren oder deaktivieren Sie diese unter [Benachrichtigungseinstellungen](/settings/notification-preferences); die vollständige Ereignisliste finden Sie unter [Benachrichtigungsereignisse](/app/notification-events). ## Meta-Statusverlauf Öffnen Sie eine beliebige Meta-basierte Vorlage und wechseln Sie zum Tab **Statistics**. Unterhalb der Versandprotokoll-Kacheln sehen Sie einen Abschnitt **Statusverlauf**, der jeden aufgezeichneten Übergang auflistet, den Meta für diese Vorlage gemeldet hat – Freigaben, Pausen, Deaktivierungen, Qualitätsänderungen und Kategorie-Neueinstufungen – jeweils mit Zeitstempel und dem geänderten Quellfeld. Verwenden Sie dies als Audit-Trail, wenn Sie einer Zustell-Health-Pill nachgehen oder in einer Support-Konversation die Frage „Wann hat sich diese Vorlage geändert?" beantworten müssen. Der Statusverlauf erscheint nur für Meta-basierte Vorlagen (nicht für lokale Entwürfe) und ist innerhalb des Statistics-Tabs verschachtelt. Frühere Versionen zeigten ihn unterhalb der Aktionsleiste des Editors – er ist jetzt bei den übrigen Zustellanalysen verortet. ## Vom System verwaltete Wiedereröffnungsvorlagen Die `flowella_reopen_*`-Vorlagen von Flowella (Service, Update, Angebot) treiben den [Antwort-Tab](/app/inbox#reply-tab-smart-reply) im Posteingang und die Ein-Klick-[Wiedereröffnen-CTA](/app/inbox#one-tap-re-engage-on-a-closed-window) an. Im Vorlagenkatalog tragen diese systemverwalteten Wiedereröffnungsvorlagen jetzt sowohl in der Karten- als auch in der Listenansicht ein **System**-Badge, damit Sie sie auf einen Blick erkennen. Sie können den Rahmentext weiterhin unter [Einstellungen → Antwortvorlagen](/settings/reply-templates) bearbeiten, aber System-Wiedereröffnungsvorlagen **können nicht gelöscht werden** – die Lösch-Aktion ist aus der Katalogzeile entfernt, und die Löschen-Schaltfläche im Vorlagen-Editor ist mit einem erklärenden Tooltip deaktiviert. Um einen Typ nicht mehr zu verwenden, deaktivieren Sie ihn stattdessen unter Antwortvorlagen. ## 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**. Klicken Sie unter **Vorlagen** auf die Vorlage, die Sie testen möchten, und wählen Sie den Tab **Send**. Wählen Sie unter **Test Template** die **Ländervorwahl** und geben Sie die WhatsApp-Nummer ein, auf der Sie Nachrichten empfangen können. Die Nummer muss im internationalen Format mit der Ländervorwahl angegeben werden – zum Beispiel `+44123456789`. 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. Klicken Sie auf **Send Test**. 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. Ö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. ### Karussell-Vorlagen senden Sie können ein genehmigtes Karussell über einen Testversand, einen Bulk-Versand, den [Posteingang](/de/app/inbox), die [Flowella API](/de/api-reference/introduction) und HubSpot senden. * **Kartenmedien** – wenn Sie für eine Karte keine Medien angeben, sendet Flowella das genehmigte Beispielbild oder -video dieser Karte. Testsendungen, Bulk-Sendungen, Posteingangs-Sendungen und HubSpot-Sendungen verwenden immer die genehmigten Beispielmedien. * **Werte pro Karte** – übergeben Sie über die API einen `carouselCards`-Eintrag pro Karte in Kartenreihenfolge. Jeder Eintrag kann die Medien der Karte (`mediaUrl` oder `mediaId`), die Variablen des Karten-Bodys (`bodyParameters`) und die Button-Werte (`buttonParameters`) festlegen. * **Gleiche Karten für alle Empfänger** – ein Bulk-Versand verwendet für jeden Empfänger dieselben Kartenmedien und Kartenwerte. Variablen im Nachrichten-Body können sich weiterhin pro Empfänger unterscheiden. ```bash theme={null} curl -X POST "https://api.flowella.io/v1/templates/send" \ -H "Authorization: Bearer flo_xxxxxxxxxxxxxxxxxxxxxxxx" \ -H "Content-Type: application/json" \ -d '{ "templateId": "clxxxxxxxxxxxxxxxxxxxxxxxx", "whatsappChannelId": "clxxxxxxxxxxxxxxxxxxxxxxxx", "recipients": [{ "phone": "+15551234567", "bodyParameters": ["Ada"] }], "carouselCards": [ { "mediaUrl": "https://cdn.example.com/card-1.jpg", "buttonParameters": [{ "index": 1, "text": "summer" }] }, { "mediaUrl": "https://cdn.example.com/card-2.jpg" } ] }' ``` In diesem Beispiel verwendet Karte 1 ein eigenes Bild und füllt die Variable am Ende des Links ihres zweiten Buttons mit `summer`. Karte 2 verwendet ein eigenes Bild. Der Button-`index` ist nullbasiert. ## 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. * **Datei importieren** – klicken Sie auf **Import file** und wählen Sie eine `.csv`- oder `.xlsx`-Datei aus. Der Datei-Import ist die einzige Möglichkeit, Empfänger in großen Mengen hinzuzufügen; das Einfügen von Zeilen wird nicht unterstützt. * **Beispieldatei herunterladen** – klicken Sie auf **Download sample file** und wählen Sie **Excel (.xlsx)** oder **CSV (.csv)**. 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. Telefonnummern müssen im vollständigen internationalen Format vorliegen (`+447700900000`). Siehe [Telefonnummern-Format](/hubspot/phone-number-format). #### Anforderungen an Importdateien * **Formate** – `.csv` und `.xlsx` werden akzeptiert. Alte `.xls`-Dateien werden abgelehnt; speichern Sie sie zuerst als `.xlsx` oder `.csv`. * **Limits** – Dateien müssen kleiner als **10 MB** sein und dürfen höchstens **50.000 Empfängerzeilen** enthalten. * **Excel-Arbeitsmappen** – Flowella liest das Arbeitsblatt mit dem Namen **Recipients**, falls vorhanden, andernfalls das erste Blatt. Als Excel-Zahlen gespeicherte Telefonnummern werden als vollständige Ziffernfolgen importiert (nie in wissenschaftlicher Notation), und Datums- oder Zahlenzellen werden so importiert, wie sie in Excel angezeigt werden. * **CSV-Anführungszeichen** – Felder in Anführungszeichen werden gemäß RFC 4180 geparst. Kommas und Zeilenumbrüche innerhalb von Anführungszeichen, doppelte Anführungszeichen (`""`) und das UTF-8-BOM aus Excels „CSV UTF-8"-Export funktionieren daher problemlos. Leere Auffüllzeilen, die Excel anhängt, werden automatisch entfernt. ### 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 Empfängerdatei 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 Kategorien, Header, Buttons, Variablen und der Einreichungs-Lebenszyklus. Syntax, Beispielwerte, HubSpot-Mapping und Ablehnungsfallen. Welche Medienformate und -größen WhatsApp in Vorlagen-Headern akzeptiert. Häufige Meta-Ablehnungsgründe und wie Sie sie beheben. Wie die Vorlagenkategorie die Preise von Meta pro Nachricht bestimmt. Senden Sie Ihre genehmigten Vorlagen aus einem HubSpot-Workflow. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.