WhatsApp-Marketing-Vorlagen

Eine Marketing-Vorlage enthält Werbeinhalte, etwa ein Angebot, eine Produktankündigung oder einen Gutschein. Bereiten Sie vor dem Senden genehmigte Inhalte, die Einwilligung der Empfänger und einen klaren Umgang mit Antworten und Opt-outs vor.

WhatsApp Studio sendet jeweils an einen Empfänger. Ein Broadcast sendet eine Marketing-Vorlage aus dem Dashboard an eine ganze Zielgruppe. Informationen zur Planung einer Kampagne finden Sie unter WhatsApp Studio und Marketingkampagnen.

Vor dem Senden

Der verwaltete Katalog von Bird enthält keine Marketing-Vorlagen. Für einen Marketing-Versand verwenden Sie daher immer eine Vorlage, die Ihr Workspace erstellt hat, auf einem eigenen WhatsApp Business Account:

Verbinden Sie ein WhatsApp Business Account und eine eigene Nummer. Siehe Einrichtung der Telefonnummer.
Erstellen Sie eine Marketing-Vorlage und reichen Sie sie zur Prüfung ein. Was die Prüfung besteht, erfahren Sie in den Richtlinien für Vorlagen.
Senden Sie von einer Nummer auf demselben WhatsApp Business Account wie die Vorlage. from ist bei einem Marketing-Versand erforderlich. Ein Absender auf einem anderen Account wird abgelehnt 422 E15023 WhatsAppSenderWABAMismatch, bevor Kosten entstehen.

Eine Marketing-Vorlage senden

POST /v1/whatsapp/messages mit gesetztem from und einem template-Objekt, das Ihren eigenen Slug angibt:

const msg = await bird.whatsapp.send({
  to: "+16505551234",
  from: "+13125550101",
  template: {
    slug: "summer_sale",
    language: "en",
    parameters: {
      header_url: "https://cdn.example.com/banners/summer.png",
      first_name: "Pablo",
      code: "SUMMER25",
    },
  },
});
console.log(msg.id, msg.status);

msg = client.whatsapp.send(
    to="+16505551234",
    from_="+13125550101",
    template="summer_sale",
    language="en",
    parameters={
        "header_url": "https://cdn.example.com/banners/summer.png",
        "first_name": "Pablo",
        "code": "SUMMER25",
    },
)
print(msg.id, msg.status)

package main

import (
	"context"
	"fmt"
	"log"
	"os"

	bird "github.com/messagebird/bird-sdk-go"
	"github.com/messagebird/bird-sdk-go/option"
)

func main() {
	client, err := bird.NewClient(option.WithAPIKey(os.Getenv("BIRD_API_KEY")))
	if err != nil {
		log.Fatal(err)
	}
	msg, err := client.Whatsapp.Send(context.Background(), bird.WhatsappSendParams{
		To:         "+16505551234",
		From:       "+13125550101",
		Template:   "summer_sale",
		Language:   "en",
		Parameters: map[string]any{
			"header_url": "https://cdn.example.com/banners/summer.png",
			"first_name": "Pablo",
			"code":       "SUMMER25",
		},
	})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(msg.Id, *msg.Status)
}

$message = $bird->whatsapp->send(
    to: '+16505551234',
    from: '+13125550101',
    template: 'summer_sale',
    language: 'en',
    parameters: [
        'header_url' => 'https://cdn.example.com/banners/summer.png',
        'first_name' => 'Pablo',
        'code' => 'SUMMER25',
    ],
);
echo $message->getId(), ' ', $message->getStatus();

bird whatsapp send \
  --from +13125550101 \
  --language en \
  --parameters '{"code":"SUMMER25","first_name":"Pablo","header_url":"https://cdn.example.com/banners/summer.png"}' \
  --template summer_sale \
  --to +16505551234

curl -X POST "https://us1.platform.bird.com/v1/whatsapp/messages" \
  -H "Authorization: Bearer $BIRD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "to": "+16505551234",
      "from": "+13125550101",
      "template": {
        "slug": "summer_sale",
        "language": "en",
        "parameters": {
          "header_url": "https://cdn.example.com/banners/summer.png",
          "first_name": "Pablo",
          "code": "SUMMER25"
        }
      }
    }'

Body-Variablen sind benannt, genau wie bei Utility-Vorlagen, daher ist first_name ein eigener Schlüssel.
Der Code eines Coupon-Buttons gehört in code, wie im Beispiel oben. Einen separaten Coupon-Schlüssel gibt es nicht.
Ein Medien-Header verwendet header_url, egal ob Bild, Video oder gif. Lassen Sie ihn weg, wird das genehmigte Beispiel der Vorlage gesendet. Eine aus Meta importierte Vorlage hat kein Beispiel und benötigt daher header_url. Nur die Kategorie Marketing akzeptiert einen animierten GIF-Header.
Medien und nummeriertes URL-Suffix einer Karussellkarte verwenden nummerierte Schlüssel: header_url_1 und button_url_1 für die erste Karte, header_url_2 für die zweite und so weiter. Benennen Sie die Variablen innerhalb der Karten. Ein Name, der in zwei Karten vorkommt, ist ein einziger Schlüssel, daher erhalten beide Karten denselben Wert. Ein Karussell, dessen Karten jeweils ein {{1}} nummerieren, verwendet nur components mit den Werten in cards. Ein solcher Versand muss genau so viele Karten liefern, wie die Vorlage bei der Genehmigung hatte.

Bird leitet jeden Marketing-Versand automatisch über Metas Marketing Messages API. Sie müssen sich nicht anmelden, und es gibt keinen Schalter pro Versand. Der Onboarding-Status des Business-Kontos für diese API steuert Metas Optimierungen, nicht die Zustellung selbst. Ausnahmen sind gif-Header und Vorlagen mit Höchstpreis, die ein abgeschlossenes Onboarding voraussetzen. Unter Marketing-Vorlagen finden Sie den Kontostatus, was das Onboarding freischaltet und in welchen Ländern Marketing eingeschränkt ist.

Opt-outs

Wenn Bird ein gültiges Marketing-Stopp-Ereignis von Meta erhält, speichert es eine Empfängerpräferenz für dieses Business-Konto. Diese Präferenz ist getrennt von einer Unterdrückung aller Nachrichten. Prüfen Sie vor dem Senden beide Einträge. Ein Zustellfehler kann vor dem zugehörigen Präferenzereignis eintreffen. Respektieren Sie dann die Entscheidung des Empfängers und untersuchen Sie diesen Verlauf, statt es erneut zu versuchen. Unter Präferenzen erfahren Sie, wie Sie diese Einträge speichern und lesen.

Kosten

Verwenden Sie den veröffentlichten Marketingtarif für Zielland und Währung, oder legen Sie einen Höchstpreis fest, damit Meta eine variable Zustellgebühr bis zu Ihrer Obergrenze berechnet. Bird berechnet seine ausgehende Gebühr vor der Übermittlung. Ein abrechenbares Zustell- oder Leseergebnis kann Metas Gebühr hinzufügen. Siehe Kosten und Abrechnung und WhatsApp-Preise.

Worauf Sie achten sollten

Metas Kategorie bestimmt den Preis. Meta kann Werbeinhalte nach der Genehmigung als Marketing neu einstufen. Prüfen Sie vor dem Senden die aktuelle Kategorie jeder Sprache. Ein Versand mit Höchstpreis erfordert die Kategorie Marketing. Wenn Sie mit der Einstufung nicht einverstanden sind, lesen Sie Metas Verfahren zur Kategorieprüfung.
131049 ist eine Zustellpause, keine von Ihnen konfigurierte Begrenzung der Anfragerate, und ein erneuter Versuch verschlimmert sie. Meta meldet 131049 sowohl für die generelle US-Pause als auch für eine Marketing-Obergrenze pro Nutzer und empfiehlt selbst, vor einem erneuten Senden etwa einen Tag zu warten. Wer früher erneut sendet, kann das Konto für diesen Empfänger länger unerreichbar machen und verfälscht die eigene Zustellrate. Bird meldet den Fehler als rate_limited.
131050 bedeutet, dass der Empfänger "Offers and announcements" deaktiviert hat, und Sie dürfen diesen Versand niemals erneut versuchen. Meta nimmt den Versand an und stellt ihn dann nicht zu. Reagieren Sie über die Nachrichtenpräferenzen, nicht mit einem erneuten Versand: Unterdrücken Sie den Empfänger selbst, oder warten Sie, bis er die Zustellung wieder aktiviert. Davon erfährt Bird über denselben Präferenzmechanismus, der auch den Stopp gemeldet hat. Siehe Preferences.
132015 und 132016 bedeuten, dass die Vorlage pausiert ist, nicht, dass ein Problem beim Empfänger vorliegt. 132015 ist eine Pause wegen geringer Qualität. 132016 ist die dauerhafte Deaktivierung nach wiederholten Pausen, und die einzige Abhilfe ist eine neue Vorlage mit anderem Inhalt. Prüfen Sie den Status der jeweiligen Sprache statt den der Vorlage, denn eine pausierte Sprache stoppt den Versand sofort.
Ein Absender im falschen WhatsApp Business Account wird abgelehnt, bevor Kosten entstehen. from muss zum selben Account gehören wie die Vorlage, sonst schlägt der Versand fehl 422 E15023 WhatsAppSenderWABAMismatch.

Nächste Schritte

WhatsApp-Vorlagen: den Katalog durchsuchen und der gemeinsame Vertrag für den Versand per Vorlage
Marketingvorlagen: die Marketing Messages API, der Onboarding-Status und wo Marketing eingeschränkt ist
Präferenzen: Angaben von Empfängern erfassen und auslesen
Utility-Vorlagen: Bestellaktualisierungen, Terminerinnerungen und Kontobenachrichtigungen

Weiter mit der Dokumentation, Anleitungen und Beispielen zu diesem Thema.

Übung ausprobieren und ein Implementierungs-Briefing erhalten