# WhatsApp-Marketing-Templates Ein Marketing-Template enthält werbliche Inhalte wie ein Angebot, eine Produktankündigung oder einen Gutschein. Bereiten Sie vor dem Versand genehmigte Inhalte, die Einwilligung der Empfänger und einen klaren Umgang mit Antworten und Opt-outs vor. ## Bevor Sie senden Der verwaltete Katalog von Bird enthält kein einziges Marketing-Template. Ein Marketing-Versand verwendet daher immer ein Template, das Ihr Workspace erstellt hat, auf einem eigenen WhatsApp Business Account: 1. Verbinden Sie einen eigenen WhatsApp Business Account und eine eigene Nummer. Siehe [Telefonnummer einrichten](/docs/guides/whatsapp/phone-number-setup). 2. Erstellen Sie ein Template mit der Kategorie `marketing` und reichen Sie es zur Prüfung ein. Siehe [Template-Richtlinien](/docs/knowledge-base/whatsapp/template-guidelines) für die Freigabekriterien. 3. Senden Sie von einer Nummer auf demselben WhatsApp Business Account wie das Template. `from` ist bei einem Marketing-Versand erforderlich, und ein Absender auf einem anderen Account wird `422` [`E15023`](/docs/api/errors/E15023) `WhatsAppSenderWABAMismatch` abgelehnt, bevor etwas berechnet wird. ## Ein Marketing-Template senden `POST /v1/whatsapp/messages` mit gesetztem `from` und einem `template`-Objekt, das Ihren eigenen Slug benennt: **TypeScript** ```typescript const msg = await bird.whatsapp.send({ to: "+16505551234", from: "+13125550101", template: { slug: "summer_sale", language: "en", components: [ { type: "header", parameters: [{ type: "image", url: "https://cdn.example.com/banners/summer.png" }], }, { type: "body", parameters: [{ type: "text", name: "first_name", text: "Pablo" }] }, { type: "button", parameters: [{ type: "text", text: "SUMMER25" }] }, ], }, }); console.log(msg.id, msg.status); ``` Examples: [TypeScript](/de-de/dokumentation/guides/whatsapp/templates/marketing.ts.md) · [Python](/de-de/dokumentation/guides/whatsapp/templates/marketing.py.md) · [Go](/de-de/dokumentation/guides/whatsapp/templates/marketing.go.md) · [PHP](/de-de/dokumentation/guides/whatsapp/templates/marketing.php.md) · [CLI](/de-de/dokumentation/guides/whatsapp/templates/marketing.cli.md) · [MCP](/de-de/dokumentation/guides/whatsapp/templates/marketing.mcp.md) · [cURL](/de-de/dokumentation/guides/whatsapp/templates/marketing.curl.md) - **Body-Parameter sind benannt**, genau wie bei Utility. Jeder Parameter trägt einen `name`, und die Reihenfolge im Array hat keine Bedeutung. - **Der Code eines Gutschein-Buttons ist ein gewöhnlicher `text`-Parameter**, wie der auf dem Button oben. Es gibt keinen separaten Parametertyp für Gutscheincodes. - **Ein `gif`-Header erwartet einen `gif`-Parameter**, nicht `video` oder `image`. Marketing ist die einzige Kategorie, die einen animierten GIF-Header akzeptiert. - **Carousel-Werte gehören auf `cards`, nicht auf `parameters`**, und ein Versand muss exakt die Anzahl an Karten liefern, mit der das Template genehmigt wurde. Bird leitet jeden Marketing-Versand automatisch an Metas Marketing Messages API weiter; Sie müssen sich nicht anmelden, und es gibt keinen Schalter pro Versand. Der Onboarding-Status des Business-Accounts bei diesem API steuert Metas Optimierungen, nicht die Zustellung selbst, mit einer Ausnahme: Ein `gif`-Header erfordert einen Account mit abgeschlossenem Onboarding, sonst schlägt der Versand bei WhatsApp fehl. Siehe [Marketing-Templates](/docs/knowledge-base/whatsapp/marketing-templates) für den Account-Status, was Onboarding freischaltet und wo Marketing länderspezifisch eingeschränkt ist. ## Opt-outs Wenn Bird ein gültiges Marketing-Stopp-Ereignis von Meta empfängt, speichert es eine Empfängerpräferenz für diesen Business Account. Diese Präferenz ist getrennt von einer allgemeinen Nachrichtensperre. Prüfen Sie beide Einträge vor dem Versand. Ein Zustellfehler kann vor dem zugehörigen Präferenzereignis eintreffen; bewahren Sie die Entscheidung des Empfängers und untersuchen Sie den Verlauf, anstatt den Versand erneut zu versuchen. Siehe [Opt-outs](/docs/guides/whatsapp/opt-outs) zum Erfassen und Auslesen dieser Einträge. ## Kosten Verwenden Sie den veröffentlichten Marketing-Tarif für das Zielland und die Währung. Bird berechnet die eigene Versandgebühr vor der Übermittlung; ein abrechenbares Zustell- oder Leseergebnis kann Metas Gebühr hinzufügen. Siehe [Kosten und Abrechnung](/docs/guides/whatsapp/sending-whatsapp#cost-and-billing) und [WhatsApp-Preise](/products/whatsapp/pricing). ## Worauf Sie achten sollten - **Meta kategorisiert in Marketing um, nie heraus, und das ist eine Preisänderung.** Ein Template, das Meta inhaltlich als werblich einstuft, wird zu `marketing`, egal welche Kategorie Sie eingereicht haben, und der Versand erfolgt weiterhin zum neuen, höheren Preis. Es gibt kein Opt-out und keine Möglichkeit, die Kategorie zurückzusetzen; die Lösung ist ein neues Template. - **`131049` ist eine Zustellpause, keine von Ihnen konfigurierte Begrenzung der Anfragerate, und erneutes Senden verschlimmert es.** Meta meldet `131049` sowohl bei seiner generellen US-Pause als auch bei einem benutzerbezogenen Marketing-Limit, und Metas eigene Empfehlung ist, etwa einen Tag mit dem erneuten Senden zu warten. Früheres erneutes Senden kann den Account für diesen Empfänger länger unerreichbar machen und verfälscht Ihre eigene Zustellrate. Bird meldet den Fehler als `rate_limited`. - **`131050` bedeutet, dass der Empfänger "Offers and announcements" deaktiviert hat, und der Versand darf nie wiederholt werden.** Meta nimmt den Versand an und verweigert dann die Zustellung. Die richtige Reaktion ist der Messaging-Preferences-Pfad, kein erneuter Versand: Sperren Sie den Empfänger selbst, oder warten Sie, bis er die Zustellung wieder aktiviert, worüber Bird über denselben Präferenzmechanismus informiert wird, der die Sperre gemeldet hat. Siehe [Opt-outs](/docs/guides/whatsapp/opt-outs). - **`132015` und `132016` bedeuten Template-Pausierung, kein Empfängerproblem.** `132015` ist eine Pause wegen niedriger Qualität; `132016` ist eine dauerhafte Deaktivierung nach wiederholten Pausen, und die einzige Lösung ist ein neues Template mit anderem Inhalt. Prüfen Sie den Status der jeweiligen Sprache statt den des Templates, da eine pausierte Sprache den Versand sofort stoppt. - **Ein Absender auf dem falschen WhatsApp Business Account wird vor jeder Berechnung abgelehnt.** `from` muss auf demselben Account wie das Template liegen, sonst schlägt der Versand fehl `422` [`E15023`](/docs/api/errors/E15023) `WhatsAppSenderWABAMismatch`. ## Nächste Schritte - [WhatsApp-Templates](/docs/guides/whatsapp/templates): Katalog durchsuchen und der gemeinsame Vertrag für den Template-Versand - [Marketing-Templates](/docs/knowledge-base/whatsapp/marketing-templates): die Marketing Messages API, Onboarding-Status und wo Marketing eingeschränkt ist - [Opt-outs](/docs/guides/whatsapp/opt-outs): Sperren und Präferenzen erfassen und auslesen - [Utility-Templates](/docs/guides/whatsapp/templates/utility): Bestellupdates, Terminbenachrichtigungen und Kontohinweise ## Related resources - [Connecting WhatsApp to Bird: from buying a number to a live channel](/learn/whatsapp/connecting-whatsapp-to-bird) (video) - [What is the 24-hour customer service window on WhatsApp?](/explained/whatsapp/what-is-the-24-hour-customer-service-window) (answer) - [WhatsApp message builder](/tools/whatsapp-message-builder) (tool) - [WhatsApp](/products/whatsapp) (product) [Get an implementation brief](/learn/workspace?topic=whatsapp)