Nachrichtenvorlagen

Eine Nachrichtenvorlage ist erforderlich, um eine Marketing-, Verwaltungs- oder Authentifizierungs-Unterhaltung zu starten. Diese Unterhaltungen können Kund*innenbetreuungs-Nachrichten, Erinnerungen an Termine, Zahlungs- oder Versand-Updates, Warnungen und vieles mehr sein.

Anforderungen

• Eine Nachrichtenvorlage muss genehmigt werden, bevor sie für Unterhaltungen verwendet wird. Mehr erfahren.
• Um ein Marketing-, Verwaltungs- oder Authentifizierungs-Unterhaltungen mit Kund*innen zu starten, muss der*die Kund*in die Zustimmung erteilt haben, Nachrichten von deinem Unternehmen zu erhalten. Mehr erfahren.

Unterstützte Vorlagenkategorien

Siehe Kategorien.

Übersetzungen

Beim Senden einer Nachrichtenvorlage musst du die Sprache mit dem Feld language angeben. Dein Unternehmen ist für alle Übersetzungen verantwortlich, die du verwenden möchtest.

Unterstützte Sprachen

Sprachpakete

Nachrichtenvorlagen werden in Form von Sprachpaketen gespeichert. Ein Sprachpaket ist ein Bundle aus Nachrichtenvorlagen für eine bestimmte Sprache bzw. Ländereinstellung. Wenn ein Unternehmen mindestens eine Übersetzung für eine Sprache oder Ländereinstellung unterstützt, wird ein Paket für die jeweilige Sprache oder Ländereinstellung erstellt.

Ein Namespace mit Nachrichtenvorlagen stellt das Bundle der Sprachpakete für ein bestimmtes Unternehmen dar.

Optionen für die Sprachrichtlinie

Beim Senden einer Nachrichtenvorlage, für die das Feld language: policy auf den Standardwert deterministic festgelegt ist, übermittelt WhatsApp die Nachrichtenvorlage in der gewünschten Sprach- und Ländereinstellung. Das Gerät fordert dann beim Server ein Sprachpaket für die jeweilige Sprache an.

Wenn diese Nachricht an das Gerät übermittelt wird, werden auf dem Gerät die folgenden Aktionen ausgeführt:

• Richtlinien-/Codeprüfung: Ist auf dem Gerät angesichts von "policy": "deterministic" und "code": "en" ein zwischengespeichertes en -Paket vorhanden?

  • Wenn ja: Gehe zu Elementprüfung.
  • Wenn nein: Ist das en-Paket auf dem Server zu finden?

    • Falls ja, lokalen Cache aktualisieren und zu Elementprüfung gehen.
    • Falls nein, Fehler protokollieren. Der Server gibt über einen Webhook einen structure_unavailable-Fehler zurück und auf dem Gerät werden keine Nachrichten gerendert.

• Elementprüfung: Ist das "element": "hello_world"-Element vorhanden?

  • Falls ja, Parameter entpacken und die Nachricht auf dem Gerät rendern.
  • Wenn nein:

    • Falls das Sprachpaket aus dem lokalen Cache stammt, das neueste en-Paket vom Server herunterladen und die Elementprüfung wiederholen.
    • Falls das Sprachpaket kürzlich vom Server heruntergeladen wurde, Fehler protokollieren. Der Server gibt über einen Webhook einen structure_unavailable-Fehler zurück und auf dem Gerät werden keine Nachrichten gerendert.

Die Sprach- bzw. Ländereinstellungen des Geräts werden vollständig ignoriert.

Wenn ein angefordertes Element nicht vorhanden ist, kann dies bei Verwendung der deterministic-Richtlinie ein Problem verursachen. Stelle daher Folgendes sicher:

• Der Namespace ist korrekt.
• Der Elementname ist korrekt.
• Die Übersetzung zur Sprache/Ländereinstellung für das jeweilige Element ist verfügbar.
• Die Anzahl der gesendeten Parameter stimmt mit der Angabe in der Nachrichtenvorlage überein.

Lokalisierung

Nachrichtenvorlagen können ohne weitere Konfiguration lokalisiert werden, indem die Nachricht entsprechend der Ländereinstellungen für das Gerät lokalisiert wird.

Lokalisierbare Parameter

Vorlagen enthalten Parameter, die dynamisch in die Nachricht integriert werden. Beim Beispiel in diesem Dokument sieht die Nachrichtenvorlage wie folgt aus:

"You made a purchase for {{1}} using a credit card ending in {{2}}."

"namespace": "cdb2df51_9816_c754_c5a4_64cdabdcad3e" mit "element_name": "purchase_with_credit_card": In diesem Fall ersetzt der Wert an erster Stelle die {{1}}-Variable in der Nachrichtenvorlage und der Wert an zweiter Stelle die {{2}}-Variable.

Einige dieser Parameter (z. B. date_time oder currency) können lokalisiert werden, um sicherzustellen, dass sie der Sprache und Ländereinstellung des Kunden entsprechend angezeigt werden. Wenn das Gerät einen Parameter nicht lokalisieren kann, wird er auf den fallback_value-Standardwert zurückgesetzt.

Wenn zusätzlich zum fallback_value Währung und Datum angegeben werden sollen, müssen die Objekte currency und date_time verwendet werden. Auf diese Weise kann der Client die Daten bestmöglich lokalisieren und muss nur dann auf den fallback_value-Standardwert zurücksetzen, wenn die Daten nicht lokalisiert werden können.

In der folgenden Tabelle sind die localizable_params-Optionen aufgeführt:

Parameter

Das Objekt currency

Der WhatsApp Business API-Client versucht, die Währung anhand der angegebenen Lokalisierung zu formatieren.

Beispiel

{
    "type": "currency",
    "currency" : {
        "fallback_value": "$230.99",
        "code": "USD",
        "amount_1000": 230990
    }
}  

Das Objekt date_time

Der WhatsApp Business API-Client versucht, Datum/Uhrzeit anhand der angegebenen Lokalisierung zu formatieren. Es werden unter anderem die folgenden Datums- und Uhrzeitformate unterstützt:

• Komponentenzeit - Der Zeitpunkt wird aus Komponenten zusammengesetzt (Wochentag, Monat, Stunde usw.). Der angegebene Zeitpunkt ist immer gleich, unabhängig von der Zeitzone, in der sich der Client befindet.
• Unix-Zeit - Der angezeigte Zeitpunkt hängt von der Zeitzone ab, in der sich der Client befindet.

DateTime

DateTimeComponent

Beispiel

{
    "type": "date_time",
    "date_time" : {
        "fallback_value": "October 25, 2020",
        "day_of_week": "Saturday",
        "day_of_month": 25,
        "year": 2020,
        "month": 10,
        "hour": 12,
        "minute": 0
    }
}

DateTimeUnixEpoch

Nächste Schritte

Dieses Dokument enthält Referenzinformationen zu Nachrichtenvorlagen. Einen Leitfaden zum Erstellen und Verwenden einer Vorlage findest du unter Senden von Nachrichtenvorlagen. Alle Parameter, die in einer Nachrichtenvorlage verwendet werden können, findest du unter Nachrichten, Nachrichtenvorlage.

https://developers.facebook.com/docs/whatsapp/message-templates/creation#step-1--create-template-using-the-whatsapp-manager