Ein Bestellupdate benötigt festen Wortlaut und bestellspezifische Details. Ein Template hält den genehmigten Wortlaut getrennt von Werten wie der Bestellnummer.
Wann brauche ich ein Template?
Verwenden Sie ein genehmigtes Template, wenn Sie außerhalb des 24-Stunden-Servicefensters des Kunden senden.
Innerhalb eines offenen Fensters können Sie mit frei formuliertem Inhalt antworten. Das Senden eines Templates öffnet dieses Fenster nicht von selbst erneut; die Antwort des Kunden tut das.
Eine Genehmigung ersetzt nicht die Einwilligung des Kunden. Beachten Sie Metas Messaging-Richtlinie für die Nachricht, die Sie senden möchten.
Was enthält ein Template in Bird?
Ein Template identifiziert wiederverwendbaren Inhalt, während seine Versionen den Wortlaut für jede Sprache enthalten.
Verwenden Sie den slug beim Senden. Der Anzeigename beschriftet das Template, ist aber nicht der Bezeichner, der beim Senden aufgelöst wird.
Wählen Sie beim Erstellen des Templates authentication, marketing oder utility. Bird fixiert die deklarierte Kategorie und den Slug nach der Erstellung.
Der Inhalt einer Sprache umfasst einen erforderlichen body-Block. Er kann auch einen header, footer, buttons oder carousel enthalten, abhängig von den Inhaltsregeln des Templates.
Um den genehmigten Inhalt einzusehen, lesen Sie live_version_id aus dem Template. Rufen Sie dann die Sprache dieser Version über den Sprachbefehl ab.
Ein Template ohne Live-Version kann nicht senden. Sein Entwurf kann noch Inhalte enthalten, die die Überprüfung nicht bestanden haben.
Welche Sprache und Kategorie verwendet ein Versand?
Prüfen Sie available_languages für sendefähige Sprachen. Prüfen Sie den eigenen category der Sprache für Metas Preisklassifizierung.
Der status des Templates fasst seine Sprachen zusammen. Ein active-Template hat mindestens eine sendefähige Sprache. Eine andere Sprache kann abgelehnt, pausiert oder deaktiviert sein.
Meta kann die Genehmigung oder Verfügbarkeit einer Sprache nach dem Launch entziehen. Prüfen Sie den Sprachstatus beim Senden, anstatt eine permanente Liste aus dem Deployment zu verwenden.
Meta kann eine Sprache auch umklassifizieren, ohne die von Ihnen deklarierte Kategorie zu ändern. Verwenden Sie die Klassifizierung dieser Sprache zusammen mit den veröffentlichten WhatsApp-Tarifen zur Kostenschätzung.
Verwenden Sie Beispiele, um die Kategorie vor dem Einreichen einer Sprache zu prüfen:
| Beispielinhalt | Lektion zur beabsichtigten Kategorie |
|---|---|
Your order {{reference}} has shipped. | Ein spezifisches Transaktionsupdate entspricht dem Utility-Muster |
Your code is {{code}}. | Eine Authentifizierungsnachricht verwendet die authentication-Kategorie und deren Erstellungsregeln |
Get 20% off your next order. | Ein Werbeangebot gehört in den Marketing-Pfad |
Halten Sie die Beispiele illustrativ. Meta überprüft die eingereichte Sprache und kann sie anders klassifizieren als die von Ihnen gewählte Kategorie.
Setzen Sie on_missing_language, um festzulegen, was passiert, wenn die angeforderte Sprache keinen verfügbaren Inhalt hat. Bird setzt neue WhatsApp-Templates standardmäßig auf fail. Jede Sprache wird separat genehmigt und bepreist, sodass ein stiller Ersatz unerwarteten Inhalt zu einem unbeabsichtigten Tarif senden könnte.
Diese Richtlinie erlaubt dennoch ein breiteres Tag: pt kann eine Anfrage für pt-BR bedienen. Sie ersetzt nicht die Geschwistervariante pt-PT.
Wählen Sie fallback nur, wenn das Ersetzen durch die konfigurierte Standardsprache für Ihre Empfänger akzeptabel ist. Bird-verwaltete Templates behalten ihre feste Richtlinie für fehlende Sprachen.
Wie ändere ich eingereichten Inhalt?
Erstellen Sie einen neuen Entwurf. Schreiben Sie die korrigierte Sprache. Reichen Sie diese Version zur Überprüfung ein.
Bird hält eingereichte Versionen unveränderlich, sodass das Bearbeiten der Templatebeschriftung den genehmigten Nachrichteninhalt nicht ändert.
| Feld | Was es Ihnen sagt |
|---|---|
draft_version_id | Ein nicht eingereichter Entwurf existiert |
pending_version_id | Eine eingereichte Version hat noch ungeklärte Sprachen |
live_version_id | Diese Version liefert den für Sendungen verwendeten Inhalt |
Die Genehmigung einer Sprache kann ihre gesamte Version live schalten. Andere Sprachen in dieser Version können noch ausstehen oder abgelehnt sein.
Prüfen Sie die Sprache der eingereichten Version, um eine Überprüfung zu verfolgen. Das Template kann noch eine frühere Live-Version anzeigen, während ein Ersatz auf Genehmigung wartet.
Wie sende ich ein Template?
Benennen Sie das Template. Liefern Sie die Variablen, die die Sprache erfordert, die Sie senden möchten.
Finden Sie die verfügbaren Templates mit:
bird whatsapp templates listVerwenden Sie bird whatsapp templates get, um das ausgewählte Template einzusehen. Rufen Sie seinen Sprachinhalt ab, bevor Sie die components des Versands zusammenstellen, die die Werte für die Variablen dieses Templates enthalten.
Im Dashboard liefert die Templatedetailansicht ein cURL-Beispiel mit den Beispielwerten dieses Templates. Ersetzen Sie Empfänger, Anmeldedaten und Variablen durch Ihre gewünschten Werte, bevor Sie senden.
Ein erstelltes Template benötigt einen Absender auf demselben WhatsApp Business Account. Folgen Sie der Sendeprozedur. Verfolgen Sie den zurückgegebenen Nachrichtenbezeichner über Zustellereignisse.
Eine 202-Antwort akzeptiert die Anfrage zur Verarbeitung. Bestätigen Sie die Zustellung anhand des späteren Ergebnisses, bevor Sie die Nachricht als empfangen betrachten.
Kurz gesagt
Prüfen Sie die Sprache vor dem Senden.
Ein aktives Template kann nicht verfügbare Sprachen enthalten. Verwenden Sie
available_languages, um zu prüfen, ob die Sprache des Empfängers gesendet werden kann.Lesen Sie die Kategorie der Sprache.
Meta kann eine Sprache anders klassifizieren als Ihre deklarierte Kategorie. Die Preisgestaltung folgt Metas Klassifizierung.
Bearbeiten Sie über einen neuen Entwurf.
Bird friert eingereichte Versionen ein. Erstellen Sie einen neuen Entwurf, um Inhalte zu ändern. Reichen Sie die korrigierte Sprache zur Überprüfung ein.
Senden Sie den genehmigten Inhalt mit seinen Variablen.
Benennen Sie das Template und liefern Sie die Werte, die seine Sprache erwartet. Eine akzeptierte Anfrage bestätigt keine Zustellung.