WhatsApp-Vorlagenvariablen: {{1}} vs. benannte Parameter

{
  "type": "BODY",
  "text": "Hi {{1}}! Your order {{2}} ships on {{3}}.",
  "example": { "body_text": [["Layla", "OM-4821", "12 November"]] }
}

{
  "type": "BODY",
  "text": "Hi {{first_name}}! Your order {{order_number}} ships on {{ship_date}}.",
  "example": {
    "body_text_named_params": [
      { "param_name": "first_name", "example": "Layla" },
      { "param_name": "order_number", "example": "OM-4821" },
      { "param_name": "ship_date", "example": "12 November" }
    ]
  }
}

Wie sende ich die Parameter im API-Aufruf?

Sie senden den Vorlagennamen, die Sprache und ein components-Array mit den Werten. So sieht das für eine positionsbasierte Vorlage aus:

{
  "messaging_product": "whatsapp",
  "to": "971500000000",
  "type": "template",
  "template": {
    "name": "order_shipped",
    "language": { "code": "en" },
    "components": [
      { "type": "body", "parameters": [
        { "type": "text", "text": "Layla" },
        { "type": "text", "text": "OM-4821" },
        { "type": "text", "text": "12 November" }
      ] }
    ]
  }
}

Bei einer benannten Vorlage trägt jeder Eintrag zusätzlich parameter_name, das zum Platzhalter passen muss:

{ "type": "text", "parameter_name": "order_number", "text": "OM-4821" }

Wie funktionieren Medienparameter in der Kopfzeile?

Eine Medienkopfzeile hat keine Textvariable. Beim Erstellen enthält die Kopfzeile ein Beispiel-Asset-Handle aus Metas Upload-Ablauf, und das Beispiel wird zusammen mit der Vorlage geprüft. Beim Senden übergeben Sie das Asset, etwa ein Bild per Media-ID:

{ "type": "header", "parameters": [ { "type": "image", "image": { "id": "1558081531584829" } } ] }

Die ID oben ist das Beispiel aus Metas Dokumentation, kein echtes Asset.

Wie sieht das über die OmniChannels.ai-API aus?

Unser Endpunkt sendbulk nimmt die Vorlage laut WhatsApp-API-Dokumentation als Formularfelder entgegen:

Praxisbeispiel: eine Vorlage für den Versand einer Bestellung

„Souq Rafiq“ (fiktiv), ein Händler in den VAE, möchte ein Versandupdate mit Produktbild und Tracking-Schaltfläche senden.

1. Vorlage schreiben, sodass sie weder mit einer Variablen beginnt noch endet: „Hi {{1}}, your order {{2}} has shipped and should arrive on {{3}}. Tap the button to follow it.“
2. Kopfzeile als Bild, Fußzeile als einfachen Text und eine URL-Schaltfläche https://shop.example/track/{{1}} mit einem Beispiel wie OM-4821 ergänzen.
3. Einreichen mit realistischen Beispielen für jede Variable und dann den Freigabestatus abwarten.
4. Senden mit den drei Werten für den Nachrichtentext, dem Tracking-Suffix und, falls Sie es überschreiben, dem Kopfzeilenbild.

curl -X POST https://api.broadnet.me/whatsapp/message/sendbulk \
  -H "Authorization: Bearer $BROADNET_TOKEN" \
  -F batchId=0 \
  -F campaignName=order-shipped \
  -F destinationNo=971500000000 \
  -F messageType=TEMPLATE \
  -F templateName=order_shipped \
  -F templateLanguage=en \
  -F bodyTemplateVariables=Layla \
  -F buttonsTemplateVariable=OM-4821

Dieses Snippet zeigt die Feldnamen für einen einzelnen Wert. Für mehrere Variablen im Nachrichtentext pro Empfänger nutzen Sie einen personalisierten Upload, statt den Befehl zu wiederholen. Klären Sie die Kodierung für Ihre erste Kampagne mit unserem Team.

Wie personalisiere ich eine Vorlage aus einer CSV-Datei?

Verwenden Sie eine Zeile pro Empfänger und eine Spalte pro Variable und laden Sie die Datei in einem personalisierten Versand hoch.

1. Tragen Sie die Nummer des Empfängers im internationalen Format in die erste Spalte ein. Siehe E.164-Rufnummernformat.
2. Fügen Sie pro Variable eine Spalte hinzu und klären Sie das Spaltenlayout vor Ihrer ersten Kampagne mit unserem Team.
3. Bereinigen Sie zuerst die Daten: Leerzeichen entfernen, Groß- und Kleinschreibung korrigieren, ein Datumsformat verwenden und leere Werte entfernen, denn eine leere Variable führt zu einer fehlerhaften Nachricht oder einem fehlgeschlagenen Versand.
4. Prüfen Sie mehrere Zeilen in der Vorschau und senden Sie zuerst an Ihre eigene Nummer.

Die Schritte zur Datenbereinigung stehen in Massen-SMS aus Excel oder CSV senden; sie gelten ebenso für WhatsApp.

Wie wähle ich zwischen positionsbasiert und benannt?

Entscheiden Sie danach, wie viele Personen die Vorlage anfassen und wie viele Variablen sie hat.

1. Ein oder zwei Variablen, ein Verantwortlicher: positionsbasiert genügt und ist der Standard.
2. Drei oder mehr Variablen oder mehrere Teams, die Vorlagen bearbeiten: benannt verwenden, damit jeder Platzhalter für sich spricht.
3. Gleicher Wortlaut in mehreren Sprachen: dieselben Namen oder Nummern in allen Versionen beibehalten, damit eine Senderoutine jede Sprache füllen kann.
4. Dokumentieren Sie stets, welche Quellspalte welche Variable speist, damit eine spätere Änderung der Vorlage die Daten nicht verschiebt.

Lesen Sie die fertige Nachricht vor dem Einreichen mit den Beispielwerten laut vor. Klingt sie unnatürlich, werden Prüfer und Kunden das ebenso empfinden.

Was sind die häufigsten Fehler?

• Mit einer Variablen beginnen oder enden, was Meta als Ablehnungsgrund nennt.
• Nummern überspringen oder dieselbe Nummer in einer positionsbasierten Vorlage in falscher Reihenfolge wiederverwenden.
• Platzhalter-Beispiele wie „test“, die den Prüfern nichts sagen.
• Sonderzeichen wie #, $ oder % in Variablen.
• Falsche Reihenfolge beim Senden in einer positionsbasierten Vorlage, die die richtigen Daten an die falsche Stelle setzt.
• Nicht passendes parameter_name in einer benannten Vorlage.
• Eine Variable nutzen, um den eigentlichen Zweck der Nachricht zu verschleiern. Eine Vorlage, deren Kategorie nicht zum Inhalt passt, kann abgelehnt oder umkategorisiert werden; siehe den Kategorien-Leitfaden.
• Grenzen: Dieser Leitfaden gibt wieder, was Metas Dokumentation zum Zeitpunkt der Erstellung sagt. Prüfentscheidungen liegen bei Meta und Regeln ändern sich, prüfen Sie daher die verlinkten Seiten.

So unterstützt Sie OmniChannels.ai

BroadNet ist ein offizieller Meta Business Solution Provider. In OmniChannels.ai erstellen Sie WhatsApp-Vorlagen mit Variablen, Medien und Schaltflächen, sehen eine Vorschau und verfolgen den Freigabestatus. Anschließend senden Sie sie mit personalisierten Werten über die API oder aus einem Excel- oder CSV-Upload in einer Kampagne. Duplikatfilterung und Zustellberichte sind enthalten. Siehe die WhatsApp-Business-API-Seite und die Kampagnenplattform.