WhatsApp user_preferences-Webhook: Wenn ein Kunde Marketingnachrichten abbestellt oder wieder aktiviert
Der user_preferences-Webhook teilt einem Unternehmen mit, dass ein WhatsApp-Nutzer seine Marketingnachrichten über die Einstellung Angebote und Ankündigungen beendet oder wieder aufgenommen hat. Jedes Ereignis enthält die Kategorie marketing_messages, den Wert stop oder resume, einen Detailsatz, die wa_id und BSUID des Nutzers sowie einen Unix-Zeitstempel. Interessiert und Nicht interessiert in derselben Einstellung lösen ihn nicht aus.
easyCoexistence verbindet Ihre Nummer der WhatsApp-Business-App über Coexistence mit der Cloud API von Meta, sodass Ihre KI und Automatisierungen auf der Nummer funktionieren, die Sie in der App behalten.
Werte, die eine Präferenz annehmen kann: stop und resume, beide in der Kategorie marketing_messages.
Der Fehlercode im Status failed für ein Marketing-Template, das an einen Nutzer gesendet wurde, der Ihre Marketingnachrichten abbestellt hat.
Wohin Meta user_preferences sendet: Es ist ein Feld, das ein WhatsApp Business Account oder eine Nummer nicht überschreiben kann.
Die Berechtigung, die eine App für andere Webhooks als messages und calls benötigt, einschließlich user_preferences.
Was löst den user_preferences-Webhook aus?
Ein Kunde öffnet Angebote und Ankündigungen in WhatsApp und entscheidet sich, Marketingnachrichten von Ihrem Unternehmen abzubestellen oder später wieder zu aktivieren. Nur diese beiden Aktionen lösen ihn aus. Dieselbe Einstellung erlaubt es Kunden auch, Interessiert oder Nicht interessiert zu markieren, und dieses Feedback sendet keinen Webhook. Allerdings kann Nicht interessiert das Marketing-Limit pro Nutzer zwischen Ihnen und diesem Kunden senken und öffnet einen zweiten Bildschirm, der anbietet, Marketingnachrichten ganz zu beenden. Nur wenn der Kunde dann auf beenden tippt, wird user_preferences ausgelöst.
Was enthält die Payload?
Ein Array user_preferences neben einem Array contacts, unter dem Feldnamen user_preferences. Der Zeitstempel ist hier eine Ganzzahl, während Status-Webhooks ihn als String senden. wa_id entfällt, wenn der Kunde einen Benutzernamen verwendet und seine Telefonnummer nicht geteilt werden kann, user_id, wenn unternehmensbezogene Nutzer-IDs für Ihr Unternehmen nicht aktiviert sind, und parent_user_id, sofern Parent-BSUIDs nicht eingeschaltet sind. Beispiel von Meta für eine Wiederaufnahme:
{
"object": "whatsapp_business_account",
"entry": [
{
"id": "102290129340398",
"changes": [
{
"value": {
"messaging_product": "whatsapp",
"metadata": {
"display_phone_number": "15550783881",
"phone_number_id": "106540352242922"
},
"contacts": [
{
"wa_id": "16505551234",
"user_id": "US.13491208655302741918",
"parent_user_id": "US.ENT.506847293015824"
}
],
"user_preferences": [
{
"wa_id": "16505551234",
"user_id": "US.13491208655302741918",
"parent_user_id": "US.ENT.506847293015824",
"detail": "User requested to resume marketing messages",
"category": "marketing_messages",
"value": "resume",
"timestamp": 1731705721
}
]
},
"field": "user_preferences"
}
]
}
]
}Was sollte Ihr System bei einem Stopp tun?
Speichern Sie ihn beim Kunden und schließen Sie ihn von jedem Marketingversand aus, bis eine Wiederaufnahme eintrifft. Das Feld detail lautet entweder „User requested to stop marketing messages“ oder „User requested to resume marketing messages“. Maßgeblich für den Code ist aber value.
- Speichern Sie die Präferenz über die BSUID und über die Telefonnummer, da bei einem Ereignis jeweils eines davon fehlen kann.
- Schließen Sie den Kunden von Marketing-Template-Versänden aus; Meta würde sie ohnehin mit 131050 ablehnen.
- Wenden Sie sie nur pro Kunde an: Meta wendet eine Präferenz nie auf der Ebene der übergeordneten BSUID an.
- Bei einer Wiederaufnahme heben Sie den Ausschluss auf und behalten Ihren eigenen Opt-in-Nachweis, wie es Metas Opt-in-Richtlinie verlangt.
Was passiert, wenn user_preferences Ihren Server nie erreicht?
Meta setzt den Stopp trotzdem durch, daher kostet ein fehlender Webhook Sie einen fehlgeschlagenen Versand, keinen Richtlinienverstoß. Wenn Sie eine Marketing-Template an jemanden senden, der beendet hat, nimmt die API die Anfrage an, sendet die Nachricht nicht und löst einen Status-Webhook mit status failed, dem Fehlercode 131050 und dem Titel „Unable to deliver the message. This recipient has chosen to stop receiving marketing messages on WhatsApp from your business“ aus. Behandeln Sie diesen Fehler genau wie ein Stopp-Ereignis: Speichern Sie ihn und unterdrücken Sie weitere Marketingversände an diesen Kunden.
Wie funktioniert das bei einer Nummer, die über easyCoexistence verbunden ist?
user_preferences gehört nicht zu den Feldern, für die Meta ein Ziel-Override erlaubt. Daher liefert Meta es nur an den Standard-Callback der App, die das Konto abonniert hat. Bei einer über easyCoexistence verbundenen Nummer ist das die App von easyCoexistence, und diese abonniert user_preferences derzeit nicht. Das Ereignis erreicht deshalb weder ein direktes Ziel noch eine Forward-URL. Der Fehlerstatus 131050 hingegen erreicht Sie, da er über das Feld messages läuft.
Wenn Ihre KI Marketing-Templates mit send_template versendet, pflegen Sie die Stopp-Liste in Ihrem eigenen System und prüfen Sie sie zuerst: easyCoexistence führt keine solche Liste.
Häufige Fehler
- Nicht interessiert als Stopp behandeln. Es sendet keinen Webhook und stoppt die Zustellung nicht, kann aber das Marketing-Limit pro Nutzer für diesen Kunden senken.
- Präferenzen allein über wa_id speichern. Sie fehlt bei Kunden mit Benutzernamen, deren Nummer nicht geteilt werden kann; speichern Sie deshalb auch die BSUID.
- Einen Stopp auf alle unter einer übergeordneten BSUID anwenden. Meta wendet Präferenzen pro Nutzer an, nie auf übergeordneter Ebene.
- Nach 131050 erneut senden, statt den Fehler als Stopp zu erfassen. Jeder Versuch schlägt auf dieselbe Weise fehl.
Marketing-Templates, die darüber versendet werden, laufen über Ihren eigenen WhatsApp Business Account, und die Fehlerstatus, die einen Stopp melden, erreichen Ihren Server direkt oder als signierte Weiterleitungen. Von US$ 9 bis US$ 0.75 pro Nummer und Monat, sinkend, je mehr Nummern Sie hinzufügen, die ersten 3 Tage kostenlos.
Häufig gestellte Fragen
Blockiert ein Stopp auch Antworten auf die eigenen Nachrichten des Kunden?
Die Dokumentation von Meta beschreibt den Stopp als Marketingnachrichten betreffend, und der zurückgegebene Fehler nennt Marketingnachrichten. Antworten an einen Kunden, der Ihnen geschrieben hat, sind Service-Nachrichten, eine andere Kategorie.
Löst es user_preferences aus, wenn der Kunde Ihr Unternehmen blockiert?
Nein. Der Webhook wird nur bei Stopp und Wiederaufnahme in der Einstellung Angebote und Ankündigungen ausgelöst. Blockieren ist eine eigene Aktion und wird in diesem Feld nicht gemeldet.
Zählt eine Wiederaufnahme als Opt-in?
Sie bedeutet, dass der Kunde sich dafür entschieden hat, Ihre Marketingnachrichten wieder zu erhalten. Ihre eigenen Opt-in-Pflichten nach der Richtlinie von Meta gelten weiterhin, also bewahren Sie den Nachweis auf, wie und wann dieser Kunde zugestimmt hat, von Ihnen zu hören.
Welches Webhook-Feld abonniere ich?
user_preferences, im App Dashboard unter WhatsApp > Configuration, bei der App, die den WhatsApp Business Account abonniert. Es ist ein eigenes Feld, getrennt von messages, und benötigt whatsapp_business_management.
Weiterlesen
Bereit für den Start?
Richten Sie WhatsApp Coexistence in wenigen Minuten statt Monaten ein. Die App funktioniert weiterhin auf dem Telefon.
Kostenlose Testphase startenVerifiziert am