Vorlagenkategorisierung

Richtlinien zu Vorlagenkategorien

Für jede Kategorie werden das Ziel der Nachricht, das Geschäftsziel und Beispielvorlagen beschrieben.

Marketing-Vorlagen

Marketing-Vorlagen sind unsere flexibelste Variante. Sie ermöglichen es Unternehmen, eine Reihe von Zielen zu erreichen, von der Steigerung der Bekanntheit bis hin zur Umsatzsteigerung und mehr.

Folgende gelten auch als Marketing-Vorlagen:

• Vorlagen mit gemischten Inhalten (z. B. sowohl Verwaltung als auch Marketing wie Bestellaktualisierungen mit einer Promotion oder einem Angebot).
• Vorlagen mit unklaren Inhalten (wenn der Inhalt z. B. nur „{{1}}“ oder „Herzlichen Glückwunsch!“ lautet).

Verwaltungsvorlagen

Verwaltungsvorlagen werden normalerweise durch eine Aktion oder Anfrage einer*eines Benutzer*in ausgelöst. Sie müssen genaue Angaben über die aktive oder laufende Transaktion, das Konto, das Abonnement oder die Interaktion enthalten, auf die sie sich beziehen. So muss z. B. eine Bestellbestätigung eine Bestellnummer enthalten.

Authentifizierungsvorlagen

Mit Authentifizierungsvorlagen können Unternehmen Nutzer*innen mit einmaligen Passcodes authentifizieren (normalerweise 4–8-stellige alphanumerische Codes), potenziell in mehreren Schritten im Anmeldeprozess (z. B. Kontoverifizierung, Kontowiederherstellung, Integritätsherausforderungen).

Authentifizierungsvorlagen sind unsere am stärksten eingeschränkten Vorlagen. Damit eine Vorlage als Authentifizierung kategorisiert wird, muss ein Unternehmen:

• die voreingestellten WhatsApp-Vorlagen für Authentifizierungsnachrichten verwenden, die optionale Zusätze wie Sicherheitshinweise und Verfallswarnungen enthalten
• einen Einmalpasswort-Button konfigurieren (Code kopieren oder einmal Tippen)
• Inhaltsbeschränkungen befolgen: URLs, Medien und Emojis sind als Inhalt oder Parameter von Authentifizierungsvorlagen nicht zulässig. Für Parameter gilt eine zusätzliche Längenbeschränkung von 15 Zeichen.

So weisen wir einer Vorlage eine Kategorie zu

Hier beschreiben wir den Genehmigungsprozess für Vorlagenkategorien für alle neuen Vorlagen.

Wenn du eine Nachrichtenvorlage erstellst, wählst du auf Basis der oben beschriebenen Richtlinien für Vorlagenkategorien die Kategorie aus, die deiner Meinung nach zutrifft. Anschließend bestimmen wir die Kategorie der Vorlage auf Basis des Vorlageninhalts und der gleichen Richtlinien. Wenn wir mit der von dir angegebenen Kategorie einverstanden sind, setzen wir den Status der Vorlage auf PENDING (anschließend durchläuft sie die Vorlagenüberprüfung, um sicherzustellen, dass unsere Richtlinien eingehalten werden). Wenn wir nicht einverstanden sind, setzen wir den Status auf REJECTED.

Wir erklären unten, wie das mit der API und dem WhatsApp Manager geht.

Mit der API

Wenn du eine Vorlage erstellst, musst du die Kategorie auf MARKETING, UTILITY oder AUTHENTICATION festlegen. Wir prüfen diese Kategorie dann auf Basis unserer Kategorierichtlinien und setzen den Status deiner Vorlage entsprechend den Ergebnissen dieser Prüfung.

Wenn wir mit der von dir ausgewählten Kategorie einverstanden sind, wird der Vorlagenstatus auf PENDING gesetzt. Anschließend durchläuft die Vorlage die Vorlagenüberprüfung. Die API antwortet mit der Vorlagen-ID, dem Status und der Kategorie. Beispiel:

{
    "id": "678513060995850",
    "status": "PENDING",
    "category": "MARKETING"
}

Die Vorlage durchläuft anschließend die Vorlagenprüfung. Auf Basis dieser Prüfung wird der Status dann entweder auf APPROVED oder REJECTED gesetzt und es wird ein entsprechender Webhook zum Nachrichtenvorlagen-Statusupdate ausgelöst.

Wenn wir mit der von dir ausgewählten Kategorie nicht einverstanden sind, wird der Vorlagenstatus auf REJECTED festgelegt und die API antwortet mit der Vorlagen-ID, dem Status und der Kategorie. Beispiel:

{
    "id": "678513060995850",
    "status": "REJECTED",
    "category": "UTILITY"
}

Zusätzlich wird ein entsprechender Webhook zum Nachrichtenvorlagen-Statusupdate ausgelöst, wobei reason auf INCORRECT_CATEGORY festgelegt ist.

{
  "name": "<NAME>",
  "category": "<CATEGORY>",
  "allow_category_change": true, // Set to true to have us assign a category
  "language": "<LANGUAGE>",
  "components": [<COMPONENTS>]
}

Dies ist nur bei der Vorlagenerstellung möglich. Wir weisen eine Kategorie auf Basis des Vorlageninhalts und unserer Richtlinien zu und setzen ihren Status auf PENDING. Anschließend durchläuft die Vorlage die Vorlagenüberprüfung.

Mit dem WhatsApp Manager

Wenn du in WhatsApp Manager eine neue Vorlage erstellst, wählst du deren Kategorie aus. Wir prüfen diese Kategorie dann auf Basis unserer Kategorierichtlinien und setzen den Status deiner Vorlage entsprechend den Ergebnissen dieser Prüfung.

Wenn wir mit der von dir ausgewählten Kategorie einverstanden sind, setzen wir den Vorlagenstatus auf Pending (Offen). Anschließend durchläuft sie die Vorlagenüberprüfung. Bei bestandener Überprüfung wird der Status auf Active - Quality Pending (Aktiv – Qualität offen) gesetzt. Wird diese Überprüfung nicht bestanden, wird der Status auf Rejected (Abgelehnt) gesetzt.

Wenn wir mit der von dir ausgewählten Kategorie nicht einverstanden sind, empfehlen wir eine Kategorie, die verhindert, dass der Status der Vorlage sofort auf Rejected (Abgelehnt) gesetzt wird.

Wenn du die empfohlene Kategorie auswählst, wird der Vorlagenstatus auf Pending (Offen) gesetzt. Die Vorlage durchläuft anschließend die Vorlagenprüfung.

• Bei bestandener Überprüfung wird der Status auf Active - Quality Pending (Aktiv – Qualität offen) gesetzt.
• Wird diese Überprüfung nicht bestanden, wird der Status auf Rejected (Abgelehnt) gesetzt.

Wenn du mit der von dir ausgewählten Kategorie fortfährst (im obigen Beispiel „Utility“), wird der Vorlagenstatus auf Rejected (Abgelehnt) gesetzt.

Ändern der Kategorie einer Vorlage

Wenn du der Meinung bist, deine Vorlage sollte einer anderen Kategorie zugeordnet werden, hast du je nach Status deiner Vorlage verschiedene Optionen.

Vorlagenstatus APPROVED

Erstelle (mit der API oder WhatsApp Manager) eine neue Vorlage und wähle basierend auf den obenstehenden Richtlinien eine Kategorie aus, da die Kategorie einer genehmigten Vorlage nicht geändert werden kann.

Vorlagenstatus REJECTED

Du kannst den Inhalt oder die Kategorie deiner Vorlage mit der API oder WhatsApp Manager aktualisieren.

Mit der API

Wenn die API bei Einreichung der Vorlage sofort mit dem Vorlagenstatus REJECTED antwortet, kannst du Folgendes tun:

• Die Komponenten der Vorlage bearbeiten, sodass sie die Richtlinien dieser Kategorie erfüllt, die ausgewählte Kategorie beibehalten und die Vorlage erneut zur Genehmigung einreichen
• Nur die Kategorie der Vorlage bearbeiten und die Vorlage erneut zur Genehmigung einreichen. Sobald die Komponenten oder die Kategorieauswahl aktualisiert wurden, wird die Vorlage erneut einer Kategorieprüfung und einer Vorlagenüberprüfung unterzogen. Wir senden dir ein Webhook-Update zum Vorlagenstatus, um dich über das Ergebnis zu informieren.
• Eine neue Vorlage erstellen und basierend auf den Richtlinien für Vorlagenkategorien eine Kategorie auswählen.

Mit dem WhatsApp Manager

• Den Inhalt der Vorlage bearbeiten, sodass sie die Richtlinien dieser Kategorie erfüllt, die ausgewählte Kategorie beibehalten und die Vorlage erneut zur Genehmigung einreichen
• Nur die Kategorie der Vorlage bearbeiten und die Vorlage erneut zur Genehmigung einreichen. Um die von uns festgelegte Kategorie zu sehen, wähle die abgelehnte Vorlage aus, um sie in den Vorlageneditor zu laden. Übermittle die Vorlage. Dies führt zu der oben gezeigten Warnung „Category does not match“ (Kategorie stimmt nicht überein), wobei die aktuelle Kategorie der Vorlage und die von uns festgelegte Kategorie (bezeichnet als Empfohlen) angegeben sind. Du kannst dann das Fenster schließen, die Kategorie in die empfohlene Kategorie ändern und deine Vorlage erneut senden.
• Eine neue Vorlage erstellen und basierend auf den Richtlinien für Vorlagenkategorien eine Kategorie auswählen.

Beantragen einer Überprüfung

Wenn du der Meinung bist, dass die von uns festgelegte Kategorie nicht mit unseren Richtlinien für Vorlagenkategorien übereinstimmt, kannst du über Support für Unternehmen eine Überprüfung der Vorlage beantragen (das ist mit der API nicht möglich). So beantragst du eine Überprüfung:

Wähle im WhatsApp Manager die abgelehnte Vorlage aus, um sie im Vorlagen-Editor zu laden. Klicke im Banner Diese Vorlage wurde abgelehnt auf Go to Business Support (Zum Support für Unternehmen).

Klicke auf Abgelehnte Nachrichtenvorlagen, wähle die abgelehnte Vorlage aus und klicke auf den Button Überprüfung beantragen, um das Überprüfungsverfahren einzuleiten.

Wähle Richtige Kategorie wurde abgelehnt als Grund aus.

Nach der Übermittlung wird der Vorlagenstatus dann in Wird überprüft geändert.

Wenn die Kategorieüberprüfung nicht genehmigt wird, bleibt der Vorlagenstatus REJECTED und die Vorlage wird in WhatsApp Manager als Rejected (Abgelehnt) angezeigt. Wenn die Kategorieüberprüfung genehmigt wird, wird der Vorlagenstatus auf PENDING gesetzt und die Vorlage durchläuft die Vorlagenüberprüfung. Wenn die Vorlage die Überprüfung besteht, wird der Vorlagenstatus auf APPROVED aktualisiert und in WhatsApp Manager als Active - Quality Pending (Aktiv – Qualität offen) angezeigt.

So kommunizieren wir Änderungen der Vorlagenkategorie

Über Änderungen der Kategorie einer Vorlage wirst du auf folgende Weise informiert:

• E-Mail: Wir senden pro Vorlage eine E-Mail an die jeweilige Geschäftliche E-Mail-Adresse der*des Administrator*in.
• Webhooks: Du solltest das Feld template_category_update abonnieren, damit du einen Webhook erhältst, wenn die Kategorie einer Vorlage geändert wird. Du kannst auch den Endpunkt WhatsApp-Nachrichtenvorlage abfragen und die Felder category und previous_category anfordern.
• WhatsApp Manager: zeigt im Banner Warnungen Vorlagen an, bei denen die Kategorie geändert wurde.