Vorlagen werden in Vorlagennachrichten verwendet, um Marketing-, Verwaltungs- und Authentifizierungs-Unterhaltungen mit Kund*innen zu starten. Anders als formlose Nachrichten, sind Vorlagennachrichten die einzige Art von Nachrichten, die an Kund*innen gesendet werden können, die dir noch nicht geschrieben haben oder dir in den letzten 24 Stunden nicht geschrieben haben.
Vorlagen müssen genehmigt werden, bevor sie in Vorlagennachrichten gesendet werden können. Zusätzlich können Vorlagen auf Basis von Kund*innenfeedback und Interaktionen automatisch deaktiviert werden. Nachdem eine Vorlage deaktiviert wurde, kann sie erst wieder in einer Vorlagennachricht gesendet werden, wenn ihr Qualitäts-Rating sich verbessert hat oder sie nicht mehr gegen unsere Business- oder Handelsrichtlinien verstößt.
Verwende die Business Management API, um Vorlagen zu erstellen. Weitere Informationen findest du unter Vorlagen erstellen und verwalten. Alternativ kannst du Vorlagen im WhatsApp Manager manuell erstellen.
Nachdem du deine Vorlage erstellt hast, kannst du sie zur Genehmigung einreichen. Es kann bis zu 24 Stunden dauern, bis eine Genehmigungsentscheidung getroffen wird. Sobald eine Entscheidung getroffen wurde, wird in deinem WhatsApp Manager eine Benachrichtigung angezeigt und deine Business Manager-Administrator*innen erhalten eine E-Mail von uns. Außerdem senden wir eine Webhook-Benachrichtigung, wenn du Statusänderungen von Nachrichtenvorlagen abonniert hast. Siehe Überwachung von Statusänderungen.
Wenn deine Nachrichtenvorlage genehmigt wurde, wird der Status der Vorlage in Active - Quality pending (Aktiv – Qualität ausstehend) geändert und du kannst sie an Kund*innen senden. Wenn sie abgelehnt wurde, kannst du sie bearbeiten und erneut zur Genehmigung einreichen oder Einspruch gegen die Entscheidung einlegen.
Wenn deine Vorlage Variablen verwendet, muss deine Einreichung Beispielwerte für die Variablen enthalten (Medienelemente, Text-Strings usw.). So können wir uns leichter vorstellen, wie Kund*innen deine Vorlage angezeigt wird.
Um deiner Einreichung im WhatsApp Manager ein Beispiel beizufügen, erstelle zunächst deine Vorlage, füge alle erforderlichen Variablen hinzu und klicke dann auf den Button zum Hinzufügen eines Beispiels. Im Vorschaufenster werden alle Beispielmedienelemente oder -textwerte angezeigt, die du angibst.
Wenn du Vorlagen mit unseren APIs erstellst, gib für jedes Vorlagenkomponentenobjekt in deiner Anfrage, das eine Variable verwendet, die Eigenschaft examples
an.
Einreichungen werden häufig aus den folgenden Gründen abgelehnt. Achte also darauf, diese Fehler zu vermeiden.
{{1}}
.#
, $
oder %
.{{1}}
, {{2}}
, {{4}}
und {{5}}
definiert, aber {{3}}
existiert nicht.Im Business-Support-Center wird eine Ablehnungsbenachrichtigung mit dem Ablehnungsgrund wird angezeigt. Du kannst Ablehnungen im Business-Support-Center anzeigen, indem du zu Kontoübersicht > Meine Konten ansehen (Button) > (dein Meta-Unternehmenskonto) > (dein WABA) > Abgelehnte Nachrichtenvorlagen navigierst. Informationen zur Ablehnung werden außerdem per E-Mail versendet.
Den Namen und die Sprache der vorhandenen Vorlage, die dasselbe enthält wie die abgelehnte doppelte Vorlage, findest du in der Benachrichtigung des Business-Support-Centers. Wenn du möchtest, kannst du die Vorlage bearbeiten und erneut senden.
Diese Überprüfung gilt nicht für Vorlagen, die als AUTHENTICATION
kategorisiert sind.
Du kannst eine Vorlage mit dem WhatsApp Manager oder dem Endpunkt Nachrichtenvorlage bearbeiten. Beachte: Wenn du eine Nachrichtenvorlage bearbeitest und erneut zur Genehmigung einreichst, wird ihr Status auf In Review (Überprüfung läuft) festgelegt. Sie kann erst dann an Kund*innen gesendet werden, wenn ihr Status auf Active (Aktiv) gesetzt wurde.
Sobald eine Vorlage genehmigt wurde (ihr status
wurde auf ACTIVE
gesetzt), kannst du sie an Kund*innen senden. Wie du eine Vorlage über die Cloud API sendest, erfährst du unterVorlagennachrichten senden. Informationen zum Senden von Vorlagen über die On-Premises API findest du unter Vorlagennachrichten senden.
Beachte, dass sich der status
einer Nachrichtenvorlage basierend auf Kund*innenfeedback und Interaktionen automatisch von ACTIVE
zu PAUSED
oder DISABLED
ändern kann. Daher empfehlen wir dir, Statusänderungen zu überwachen und geeignete Maßnahmen zu ergreifen, wenn eine von dir verwendete Nachrichtenvorlage pausiert oder deaktiviert wird oder werden könnte.
Vorlagen können die folgenden Statuswerte aufweisen.
Wenn du unter WhatsApp Manager > Overview (Übersicht) den Mauszeiger über das Koffer-Icon (Account tools) (Kontotools) bewegst und auf Nachrichtenvorlagen klickst, kannst du den Status einer Vorlage anzeigen. Wenn du mehrere WhatsApp Business-Konten hast, wähle oben rechts im Dropdown-Menü in der Liste der Konten das Konto aus, zu dem du den Vorlagenstatus anzeigen möchtest.
Ab dem 30. April 2024 gilt das Vorlagen-Pacing sowohl für Marketing- als auch für Verwaltungsvorlagen.
Durch das Vorlagen-Pacing haben Kund*innen Zeit, frühes Feedback zu Vorlagen abzugeben. Es identifiziert und pausiert Vorlagen, die negatives Feedback oder wenig Interaktionen erhalten haben. Das verschafft dir ausreichend Zeit, den Inhalt anzupassen, bevor sie an zu viele Kund*innen gesendet werden. Hierdurch sinkt die Wahrscheinlichkeit, dass du negatives Feedback erhältst, das sich auf dein Unternehmen auswirkt.
Das Vorlagen-Pacing gilt für Marketing- und Verwaltungsvorlagen. Neu erstellte Vorlagen, pausierte Vorlage, deren Pausierung aufgehoben wird, und Vorlagen, die möglicherweise zuvor erstellt wurden, deren Qualitäts-Rating aber nicht GREEN
ist, können dem Pacing unterzogen werden. Der Qualitätsverlauf einer Vorlage (beispielsweise Pausierung aufgrund von niedriger Qualität) ist einer der Hauptgründe für das Vorlagen-Pacing. Es kann also auch für andere Vorlagen angewendet werden.
Wenn eine Vorlage dem Pacing unterzogen wird, werden Nachrichten normal gesendet, bis ein unbestimmter Schwellenwert erreicht ist. Sobald dieser Schwellenwert erreicht wurde, werden nachfolgende Nachrichten, die diese Vorlage verwenden, zurückgehalten, um ausreichend Zeit für Kund*innenfeedback zu gewähren. Sobald wir ein Signal zu guter Qualität erhalten, werden nachfolgende Nachrichten, die diese Vorlage verwenden, an die gesamte Zielgruppe gesendet. Wenn wir ein Signal zu mangelhafter Qualität erhalten, werden nachfolgende Nachrichten, die diese Vorlage verwenden, verworfen. Dann hast du die Gelegenheit, Inhalte, Targeting usw. anzupassen.
Verwaltungsvorlagen werden nur dann dem Pacing unterzogen, wenn du eine Verwaltungsvorlage pausiert hast. Wenn eine Verwaltungsvorlage pausiert wurde, können neu erstellte Vorlagen, pausierte Vorlage, deren Pausierung aufgehoben wird, und Vorlagen, die möglicherweise zuvor erstellt wurden, deren Qualitäts-Rating aber nicht GREEN ist, für die nächsten sieben Tage dem Pacing unterzogen werden.
Die unmittelbare Antwort des Nachrichtenendpunkts gibt an, ob die Nachricht mit der neuen message_status
-Eigenschaft im message
-Objekt gesendet oder zurückgehalten wurde. Diese Antwort ist in allen Versionen der API verfügbar.
message_status
-Eigenschaft mit dem Wert accepted
für verarbeitete und dem Wert held_for_quality_assessment
für zurückgehaltene Nachrichten. Angenommene Nachrichten lösen die sent
- und delivered
-Webhooks aus, wenn sie tatsächlich gesendet werden (dies entspricht demselben Verhalten vor dem Pacing). Eine vollständige Beispielantwort findest du in der Cloud API-Dokumentation.message_status
-Eigenschaft mit dem Wert ”Message has been held because quality assessment is pending”
, wenn die Nachricht zurückgehalten wird. Gesendete Nachrichten enthalten diese Eigenschaft nicht. Eine vollständige Beispielantwort findest du in der On-Premises API-Dokumentation.Wenn das Feedback positiv ist und die Qualitätsbewertung der Vorlage auf hohe Qualität geändert wird, werden die zurückgehaltenen Nachrichten freigegeben und normal gesendet. Das message_template_quality_update
sendet ein Qualitätsupdate und der messages
-Webhook sendet die gesendeten und zugestellten Updates.
Wenn das Feedback negativ ist und sich die Qualitätsbewertung der Vorlage in schlechte Qualität ändert, geschieht Folgendes:
status
der Vorlage wird auf PAUSED
gesetzt.messages
-Webhook mit "status":"failed"
und "code":"132015"
(für Benutzer*innen der Cloud API) oder "code":"2061"
(für Benutzer*innen der On-Premises API) wird gesendet.message_template_quality_update
-Webhook mit der Qualitätsänderung wird ausgelöst.Wie du die Pausierung einer Vorlage aufhebst, die aufgrund des Pacings pausiert wurde, erfährst du unter Vorlagenpausierung.
Beachte, dass wir über interne Vorgaben verfügen, um sicherzustellen, dass wir innerhalb einer angemessenen Zeit eine Bewertung vornehmen und eine Pacing-Entscheidung treffen, um Auswirkungen auf zeitkritische Kampagnen zu vermeiden. Unser Ziel ist es, dass selbst Kampagnennachrichten mit Pacing beim höchsten Durchsatz innerhalb einer Stunde zugestellt werden (99. Perzentil).
Wenn also unsere internen Vorgabewerte erreicht werden, die Vorlage jedoch noch nicht ausreichend Feedback erhalten hat, um ihre Qualität zu gut oder schlecht zu ändern, werden die zurückgehaltenen Nachrichten zusammen mit allen entsprechenden messages
-Webhooks freigegeben.
Der Status einer Vorlage kann sich aufgrund einer Überprüfungsentscheidung, des Ergebnisses eines Einspruchs oder einer Änderung des Qualitäts-Ratings automatisch ändern. Wenn sich der Status einer Vorlage ändert, wirst du per WhatsApp Manager-Benachrichtigung, E-Mail und Webhook-Benachrichtigung informiert.
Da du Kund*innen nur Nachrichtenvorlagen mit dem Status Active (Aktiv) senden kannst, empfehlen wir dir dringend, das Feld message_template_status_update webhook
zu abonnieren, sodass du bei Statusänderungen deiner Vorlagen benachrichtigt wirst. Unter Einrichtung von Webhooks erfährst du, wie du dieses Feld abonnieren kannst. Unter Aktualisierungen von Nachrichtenvorlagen findest du Beispiele für Webhook-Payloads.
Wenn du Webhooks eingerichtet hast und feststellst, dass die Qualität einer bestimmten Nachrichtenvorlage sinkt, navigiere zu WhatsApp Manager > Nachrichtenvorlagen und bewege den Mauszeiger über die entsprechende Nachrichtenvorlage. Es sollte ein Tooltip mit Informationen zur Art des Problems angezeigt werden. Du kannst die Vorlage auf Basis dieser Informationen bearbeiten und zur erneuten Genehmigung einreichen, eine andere Vorlage verwende oder die Geschäftslogik deiner App ändern. Wenn du die Nachrichtenvorlage bearbeitest und sie erneut genehmigt wird, verbessert sich das Qualitäts-Rating allmählich, solange sie an Kund*innen gesendet wird und nicht regelmäßig negatives Feedback eingeht bzw. nicht niedrige Lesequoten aufweist.
Zu jeder Nachrichtenvorlage gibt es ein Qualitäts-Rating, das auf der Nutzung, dem Kund*innenfeedback und Interaktionen basiert. Das Rating einer Nachrichtenvorlage wird im WhatsApp Manager angezeigt, wenn diese den Status Active (Aktiv) aufweist. Sie wird im Status der Nachrichtenvorlage nach einem Bindestrich angegeben:
Genehmigte Nachrichtenvorlagen weisen zu Beginn das Rating Quality pending (Qualität offen) auf. Wenn eine Nachrichtenvorlage immer wieder negatives Feedback oder ein geringes Maß an Interaktionen erhält, führt dies früher oder später zu einer Änderung des Vorlagenstatus. Solange eine Nachrichtenvorlage den Status Active (Aktiv) aufweist, kann sie an Kund*innen gesendet – unabhängig vom Qualitäts-Rating. Sobald der Status einer Nachrichtenvorlage allerdings geändert wurde, kann sie erst wieder an Kund*innen gesendet werden, wenn sie wieder aktiv ist.
Du kannst bei Änderungen am Qualitäts-Rating einer Vorlage benachrichtigt werden, indem du das message_template_quality_update
-Feld abonnierst.
Unter Qualitätsaktualisierung der Nachrichtenvorlage findest du eine Beispiel-Payload für den Webhook.
Wenn eine Nachrichtenvorlage das niedrigste Qualitäts-Rating erreicht (Status Active - Low Quality (Aktiv – geringe Qualität)), wird sie automatisch für eine gewisse Zeit pausiert, um das Qualitäts-Rating der Telefonnummern zu schützen, die die Vorlage verwenden. Es gibt folgende Pausierungszeiträume:
Wenn eine Nachrichtenvorlage pausiert (Status Paused (Pausiert)) wird, kann sie nicht an Kund*innen gesendet werden. Daher solltest du alle automatisierten Messaging-Kampagnen stoppen, die diese Vorlage verwenden. Wenn du versuchst, eine pausierte Nachrichtenvorlage an einen*eine Kund*in zu senden, wird dir allerdings nichts berechnet und der Versuch wird nicht auf das Messaging-Limit angerechnet. Diese Versuche werden von der API ohnehin abgelehnt. Du solltest diese Kampagnen erst wieder aktivieren, wenn der Status der Vorlage wieder auf Active (Aktiv) gesetzt wurde.
Du kannst eine pausierte Vorlage bearbeiten, wenn du der Meinung bist, dass die Bearbeitung ihres Inhalts zu weniger negativem Feedback und mehr Benutzer*innen-Interaktionen führt. Beachte allerdings, dass der Status einer Vorlage, die bearbeitet und erneut zur Genehmigung eingereicht wurde, in In Review (Überprüfung läuft) geändert wird und du sie erst wieder an Kund*innen senden kannst, wenn sie erneut genehmigt wurde und der Status auf Active (Aktiv) gesetzt wurde.
Du kannst auch Änderungen an deiner Geschäftslogik vornehmen (Targeting, Auslieferungsparameter usw.), wenn du meinst, dass sie zu negativem Feedback oder wenigen Interaktionen beiträgt.
Eine Pausierung wirkt sich zunächst nicht auf die geschäftliche Telefonnummer aus, von der aus die Nachrichtenvorlage gesendet wurde, und führt auch nicht zu einer Reduzierung des Nachrichtenlimits für diese Telefonnummer. Andere Nachrichtenvorlagen mit hoher Qualität können weiterhin von der Telefonnummer aus gesendet werden. Wenn ein Unternehmen allerdings durchwegs Nachrichtenvorlagen sendet, die den Status Low quality (Geringe Qualität) erhalten, kann dies früher oder später Konsequenzen für die Telefonnummer haben.
Wenn eine Nachrichtenvorlage pausiert wurde, benachrichtigen wir dich per WhatsApp Manager-Benachrichtigung, E-Mail und Webhook, wenn du Webhooks für Nachrichtenvorlagenänderungen abonniert hast. Unter Überwachung von Statusänderungen findest du Informationen zur Einrichtung von Webhooks und unter Beispiele – Vorlage pausiert ein Beispiel für einen Webhook-Payload.
Die Pausierung einer Vorlage wird automatisch aufgehoben, wenn die oben beschriebene Pausierungsdauer abgelaufen ist. Nach der Aufhebung der Pausierung wird der Status der Vorlage auf Active (Aktiv) gesetzt und du kannst sie wieder an Kund*innen senden. Wenn du keine automatisierten Messaging-Kampagnen angehalten hast, die auf einer pausierten Vorlage basieren, sollten sie jetzt wieder funktionieren. Wir empfehlen dir allerdings, alle Kampagnen, die auf einer pausierten Vorlage beruhen, so lange anzuhalten, bis die Pausierung wieder aufgehoben wird, da deine Anfragen von unseren APIs ohnehin abgelehnt werden.
Außerdem wird das Qualitäts-Rating der Vorlage auf einen Wert zurückgesetzt, der auf dem letzten Kundenfeedback basiert, das die Vorlage erhalten hat.
Ähnlich wie bei Benachrichtigungen zur Pausierung benachrichtigen wir dich per WhatsApp Manager-Benachrichtigung, E-Mail und Webhook, sobald der Status der Vorlage auf Active (Aktiv) gesetzt wurde.
Gilt ab dem 12. September 2023 für Unternehmen in Brasilien, Kolumbien und Singapur. Gilt ab dem 12. Oktober 2023 für alle Unternehmen.
Mit der Einführung des Vorlagen-Pacings führen wir auch die Möglichkeit ein, die Pausierung pausierter Vorlagen jederzeit folgendermaßen aufzuheben:
/{whats_app_message_template_id}/unpause
. Bitte beachte, dass die Pausierung von Vorlagen, die während des Vorlagen-Pacings pausiert werden, manuell aufgehoben werden muss (per API oder WhatsApp Manager), bevor sie erneut verwendet werden können.
Wenn deine Einreichung abgelehnt wird, kannst du Einspruch einlegen. Beachte, dass Einsprüche ein Beispiel enthalten müssen. Wenn eine genehmigte Vorlage deaktiviert wurde, kannst du sie auch bearbeiten und erneut zur Genehmigung einreichen.
Führe im WhatsApp Manager folgende Schritte aus:
Der Einspruch wird geprüft und innerhalb von 24 Stunden wird eine Entscheidung getroffen.