Opt-in und Opt-out
Die Handhabung von WhatsApp-Opt-ins und -Opt-outs ist entscheidend, da WhatsApp Ihre Qualitätsbewertung der Telefonnummer überwacht und niedrige Bewertungen dazu führen können, dass Ihre Nachrichtenlimits reduziert werden.
Eine Möglichkeit, eine hohe Qualitätsbewertung aufzubauen, besteht darin, zu verhindern, dass Nutzer:innen Ihr Unternehmen blockieren oder melden. Dies kann erreicht werden, indem Sie qualitativ hochwertige Nachrichten bereitstellen (z. B. Mehrwert für Ihre Nutzer:innen), die Nachrichtenhäufigkeit kontrollieren und Kund:innen die Möglichkeit geben, den Empfang zukünftiger Kommunikation abzulehnen.
Einen kanalübergreifenden Überblick über den WhatsApp-Abo-Status finden Sie unter Abo-Status. Diese Seite beschreibt, wie Sie Opt-ins und Opt-outs einrichten und welche Unterschiede zwischen den Modifikatoren „Regex“ und „is“ bestehen.
Opt-ins können aus externen Quellen oder über Braze-Methoden wie SMS oder In-App- und In-Browser-Nachrichten stammen. Opt-outs können über in Braze festgelegte Schlüsselwörter und WhatsApp-Marketing-Buttons verarbeitet werden. Nutzen Sie die folgenden Methoden als Leitfaden für die Einrichtung von Opt-ins und Opt-outs.
Opt-in-Methoden
Opt-out-Methoden
Opt-ins für Ihren Braze-WhatsApp-Kanal einrichten
Für WhatsApp-Opt-ins müssen Sie die Anforderungen von WhatsApp einhalten. Außerdem müssen Sie Braze die folgenden Informationen bereitstellen:
- Eine
external_id, eine Telefonnummer und einen aktualisierten Abo-Status für alle Nutzer:innen. Dies kann über das SDK oder den/users/track-Endpunkt erfolgen, um die Telefonnummer und den Abo-Status zu aktualisieren.
Eine eingehende WhatsApp-Nachricht abonniert Nutzer:innen nicht automatisch für Ihre WhatsApp-Abo-Gruppe. Sie müssen den Abo-Status explizit über einen User-Update-Schritt, einen Webhook oder einen API-Aufruf aktualisieren.
Meta verlangt, dass der Opt-in-Text:
- Klar angibt, dass die Person dem Empfang von Nachrichten Ihres Unternehmens zustimmt
- Ihren Unternehmensnamen enthält (keine allgemeine Formulierung wie „Wir schreiben Ihnen“)
- Den geltenden lokalen Gesetzen entspricht

Braze hat eine Verbesserung des /users/track-Endpunkts veröffentlicht, die Aktualisierungen des Abo-Status ermöglicht. Mehr dazu erfahren Sie unter Abo-Gruppen. Wenn Sie jedoch bereits Opt-in-Protokolle mit dem /v2/subscription/status/set-Endpunkt erstellt haben, können Sie diese weiterhin dort verwenden.
Externe Opt-in-Methoden außerhalb von Braze
Ihre App oder Website (Kontoregistrierung, Checkout-Seite, Kontoeinstellungen, Kreditkartenterminal) an Braze.
Überall dort, wo Sie bereits eine Marketing-Einwilligung für E-Mail oder SMS haben, fügen Sie einen zusätzlichen Abschnitt für WhatsApp hinzu. Nachdem Nutzer:innen sich angemeldet haben, benötigen sie eine external_id, eine Telefonnummer und einen aktualisierten Abo-Status. Nutzen Sie dazu, je nach Konfiguration Ihrer Braze-Installation, entweder den /subscription/status/set-Endpunkt oder das SDK.
Extern erstellte Opt-in-Liste
Wenn Sie WhatsApp bereits zuvor verwendet haben, haben Sie möglicherweise schon eine Nutzerliste mit Opt-ins gemäß den WhatsApp-Anforderungen erstellt. Laden Sie in diesem Fall eine CSV-Datei hoch oder verwenden Sie die API mit den folgenden Informationen in Braze.
Ausgehende Nachricht im Kundensupport-WhatsApp-Kanal
Senden Sie in Ihrem Kundensupport-Kanal nach gelösten Anfragen eine automatische Nachricht, in der gefragt wird, ob die Kund:innen Marketing-Nachrichten erhalten möchten. Die Funktionalität hängt hier von den verfügbaren Features in Ihrem Kundensupport-Tool und davon ab, wo Sie Nutzerinformationen speichern.
- Stellen Sie einen Nachrichtenlink von Ihrer WhatsApp-Business-Telefonnummer bereit.
- Stellen Sie Schnellantwort-Aktionen bereit, bei denen Kund:innen mit „Ja“ antworten, um das Opt-in zu bestätigen.
- Richten Sie einen angepassten Keyword-Trigger ein.
- Für beide Ideen müssen Sie den Pfad wahrscheinlich wie folgt abschließen:
- Rufen Sie den
/users/track-Endpunkt auf, um Nutzer:innen zu aktualisieren oder zu erstellen. - Nutzen Sie den
/subscription/status/set-Endpunkt oder verwenden Sie das SDK.
- Rufen Sie den
Eingehende WhatsApp-Nachricht
Lassen Sie Kund:innen eine eingehende Nachricht an die WhatsApp-Nummer senden.
Dies kann als Canvas oder als Campaign eingerichtet werden, je nachdem, ob Nutzer:innen eine Bestätigungsnachricht auf dem neuen Kanal erhalten sollen.
- Erstellen Sie eine Campaign mit dem aktionsbasierten Zustellungstrigger einer eingehenden Nachricht.
- Erstellen Sie eine Webhook-Campaign. Ein Beispiel-Webhook finden Sie unter Abo-Gruppen.

Sie können eine URL oder einen QR-Code erstellen, um einem WhatsApp-Kanal beizutreten – direkt im WhatsApp-Manager unter Phone Number > Message Links.
Braze-gestützte Opt-in-Methoden
SMS-Nachricht
Richten Sie in Canvas eine Campaign ein, die Kund:innen fragt, ob sie WhatsApp-Nachrichten erhalten möchten, indem Sie eine der folgenden Methoden verwenden:
- Kundensegment: abonnierte Marketing-Gruppe außerhalb der USA
- Angepasster Keyword-Trigger
Erfahren Sie mehr über die Aktualisierung des Abo-Status von Nutzerprofilen unter Abo-Gruppen.
In-App- oder In-Browser-Nachricht
Erstellen Sie eine In-App-Nachricht oder ein In-Browser-Pop-up, das Kund:innen auffordert, sich für die WhatsApp-Nutzung anzumelden.
Verwenden Sie eine HTML-In-App-Nachricht mit JavaScript-„Bridge“, um eine Schnittstelle zum Braze SDK herzustellen. Stellen Sie sicher, dass Sie die WhatsApp-Abo-Gruppen-ID verwenden.
Formular zur Erfassung der Telefonnummer
Verwenden Sie das Template Formular zur Erfassung der Telefonnummer im Drag-and-Drop-Editor für In-App-Nachrichten, um Telefonnummern von Nutzer:innen zu erfassen und Ihre WhatsApp-Abo-Gruppen zu vergrößern.
Opt-outs für Ihren Braze-WhatsApp-Kanal einrichten
WhatsApp-Schalter „Angebote und Ankündigungen“
WhatsApp bietet in den App-Einstellungen einen Schalter „Angebote und Ankündigungen“, mit dem Nutzer:innen Marketing-Nachrichten abbestellen können. Dieser Schalter funktioniert unabhängig von Braze-Abo-Gruppen:
- Braze-Abo-Gruppen werden über Ihre Braze-Integration (API, Präferenzcenter oder SDK) verwaltet und steuern, welche Nutzer:innen Sie für Messaging ansprechen.
- Der native WhatsApp-Schalter wird von Meta gesteuert und auf Plattformebene durchgesetzt, außerhalb von Braze.
Diese beiden Ebenen synchronisieren sich absichtlich nicht automatisch. Wenn Nutzer:innen den Schalter „Angebote und Ankündigungen“ in WhatsApp deaktivieren, blockiert Meta die Zustellung von Marketing-Nachrichten auf Plattformebene – selbst wenn der Braze-Abo-Status der Nutzer:innen als „Subscribed“ angezeigt wird. Die Präferenz der Nutzer:innen wird zum Zeitpunkt der Zustellung berücksichtigt.

Da Braze kein Opt-out-Signal erhält, bis ein Sendeversuch unternommen wird und Meta einen Fehler zurückgibt, spiegeln die Abo-Zahlen in Braze möglicherweise nicht die Nutzer:innen wider, die sich über den WhatsApp-Schalter abgemeldet haben, bis eine Nachricht versucht wurde. Das bedeutet, dass Reichweitenschätzungen leicht überhöht sein können, bis diese Feedback-Schleife stattfindet.
Allgemeine Opt-out-Schlüsselwörter
Sie können eine Campaign oder ein Canvas einrichten, die es Nutzer:innen, die bestimmte Wörter senden, ermöglicht, sich von zukünftigen Nachrichten abzumelden. Canvases können besonders vorteilhaft sein, da Sie eine Folgenachricht einfügen können, die das erfolgreiche Opt-out bestätigt.
Schritt 1: Ein Canvas mit dem Trigger „Eingehende WhatsApp-Nachricht“ erstellen

Wenn Sie Schlüsselwort-Trigger auswählen, fügen Sie Wörter wie „Stop“ oder „Keine Nachricht“ hinzu. Wenn Sie diese Methode wählen, stellen Sie sicher, dass Ihre Kund:innen Ihre Opt-out-Wörter kennen. Fügen Sie beispielsweise nach dem ersten Opt-in eine Folgeantwort hinzu wie: „Um sich von diesen Nachrichten abzumelden, senden Sie jederzeit „Stop“.”

Schritt 2: Das Profil der Nutzer:innen aktualisieren
Aktualisieren Sie das Profil der Nutzer:innen, indem Sie eine der in Abo-Gruppen beschriebenen Methoden verwenden.
Marketing-Opt-out-Auswahl
Im WhatsApp-Nachrichten-Template-Creator können Sie die Option „Marketing-Opt-out“ einfügen. Wenn Sie diese Option verwenden, stellen Sie sicher, dass das Template in einem Canvas mit einem nachfolgenden Schritt für eine Abo-Gruppen-Änderung verwendet wird.
- Erstellen Sie ein Nachrichten-Template mit der Schnellantwort „Marketing-Opt-out“.


- Erstellen Sie ein Canvas, das dieses Nachrichten-Template verwendet.
- Folgen Sie den Schritten im vorherigen Beispiel, jedoch mit dem Trigger-Text „STOP PROMOTIONS“.
- Aktualisieren Sie den Abo-Status der Nutzer:innen, indem Sie eine der in Abo-Gruppen beschriebenen Methoden verwenden.
Opt-in- und Opt-out-Workflows einrichten
Sie können „START“- und „STOP“-Keyword-Antwort-Workflows für WhatsApp mit diesen beiden Methoden konfigurieren:
User-Update-Schritt
Der User-Update-Schritt kann die Telefonnummer der Nutzer:innen zur WhatsApp-Abo-Gruppe hinzufügen, wenn sie ein Keyword an die Telefonnummer der Abo-Gruppe senden.
Der User-Update-Schritt vermeidet Race-Conditions, da die Nutzer:innen nicht zum nächsten Schritt im Canvas weitergeleitet werden, bevor ihre Telefonnummer zur Abo-Gruppe hinzugefügt wurde. Außerdem sind weniger Schritte zur Einrichtung erforderlich als bei den anderen Methoden, weshalb Braze diese Methode generell empfiehlt.
- Erstellen Sie einen Canvas mit dem aktionsbasierten Schritt Send a WhatsApp Inbound Message. Wählen Sie Where the message body und geben Sie „START“ für Is ein.

Für „STOP“-Nachrichten kehren Sie den Nachrichtenschritt zur Bestätigung des Opt-outs und den User-Update-Schritt um. Andernfalls werden die Nutzer:innen zuerst aus der Abo-Gruppe entfernt und sind dann nicht mehr berechtigt, die Bestätigungsnachricht zu empfangen.

- Erstellen Sie im Canvas einen Set Up User Update-Schritt und wählen Sie für Action die Option Advanced JSON Editor.

- Füllen Sie das User Update object mit dem folgenden JSON-Payload aus und ersetzen Sie
XXXXXXXXXXXdurch Ihre Abo-Gruppen-ID:
1
2
3
4
5
6
7
8
9
10
11
12
{
"attributes": [
{
"subscription_groups": [
{
"subscription_group_id": "XXXXXXXXXXX",
"subscription_state": "subscribed"
}
]
}
]
}
- Fügen Sie einen nachfolgenden WhatsApp-Nachrichtenschritt hinzu.

Hinweise
Das Update kann mit unterschiedlicher Geschwindigkeit abgeschlossen werden, da Braze die Anfragen des User-Update-Schritts bündelt. Für zeitkritische Opt-in-Flows, bei denen die Bestätigung sofort nach dem Abo-Update gesendet werden muss, verwenden Sie stattdessen die Webhook-Methode anstelle eines User-Update-Schritts.
Webhook-Campaign zum Auslösen einer zweiten WhatsApp-Campaign
Eine Webhook-Campaign kann den Eintritt in eine zweite Campaign auslösen, nachdem die Telefonnummer der Nutzer:innen zur WhatsApp-Abo-Gruppe hinzugefügt wurde, wenn sie ein Keyword an die Telefonnummer der Abo-Gruppe senden.

Sie müssen diese Methode nicht für STOP-Nachrichten verwenden. Die Bestätigungsnachricht wird gesendet, bevor die Nutzer:innen aus der Abo-Gruppe entfernt werden, sodass Sie einen der beiden anderen Schritte verwenden können.
- Erstellen Sie eine Campaign oder einen Canvas mit einem aktionsbasierten Schritt Send a WhatsApp Inbound Message. Wählen Sie Where the message body und geben Sie „START“ für Is ein.

- Erstellen Sie in der Campaign oder im Canvas einen Webhook-Nachrichtenschritt und ändern Sie den Request Body auf Raw Text.

- Geben Sie die Endpunkt-URL der Kund:innen in die Webhook URL ein, gefolgt vom Endpunkt-Link
campaigns/trigger/send. Zum Beispiel:https://dashboard-02.braze.eu/campaigns/trigger/send.

- Geben Sie im Rohtext den folgenden JSON-Payload ein und ersetzen Sie
XXXXXXXXXXXdurch Ihre Abo-Gruppen-ID. Sie müssen diecampaign_idersetzen, nachdem Sie Ihre zweite Campaign erstellt haben.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
{
"campaign_id": "XXXXXXXXXXX",
"recipients": [
{
"external_user_id": "{{${user_id}}}",
"attributes": {
"subscription_groups": [
{
"subscription_group_id": "XXXXXXXXXXX",
"subscription_state": "subscribed"
}
]
}
}
]
}
- Erstellen Sie eine WhatsApp-Campaign (Ihre zweite Campaign) und setzen Sie den Trigger auf API. Stellen Sie sicher, dass Sie diese
campaign_idin den JSON-Payload Ihrer ersten Campaign kopieren.
Hinweise
- Attribut-Updates aus dem Canvas-API-Trigger-JSON-Payload werden noch nicht unterstützt, sodass Sie nur eine WhatsApp-Campaign für die WhatsApp-Antwortnachricht auslösen können (wie in Schritt 2).
- Ein WhatsApp-Template muss genehmigt sein, um es als Antwortnachricht zu senden. Dies liegt daran, dass eine Schnellantwort erfordert, dass der Trigger für eingehende Nachrichten innerhalb derselben Campaign oder desselben Canvas liegt. Wenn Sie einen User-Update-Schritt verwenden, können Sie eine Schnellantwort-Nachricht ohne Meta-Genehmigung senden.
Den Unterschied zwischen den Modifikatoren „Regex“ und „ist“ verstehen
In dieser Tabelle wird STOP als Beispiel-Trigger-Wort verwendet, um die Funktionsweise der Modifikatoren zu veranschaulichen.
| Modifikator | Trigger-Wort | Aktion |
|---|---|---|
Is |
STOP |
Erkennt jede Verwendung von „stop“ als ganzes Wort, unabhängig von der Groß-/Kleinschreibung. Dies erkennt beispielsweise „stop“, aber nicht „please stop“. |
Matches regex |
STOP |
Erkennt jede Verwendung von „STOP“ in genau dieser Schreibweise. Dies erkennt beispielsweise „STOP“ und „PLEASE STOP“, aber nicht „stop“. |
Matches regex |
(?i)STOP(?-i) |
Erkennt jede Verwendung von „STOP“ unabhängig von der Groß-/Kleinschreibung. Dies erkennt beispielsweise „stop“, „please stop“ und „never stop sending me messages“. |