Verwendung von Webhooks für das Tracking von WABA-Richtlinienverstößen
Unternehmen können Webhooks implementieren, um Echzeit-Benachrichtigungen über Änderungen an einem WhatsApp-Unternehmenskonto (WhatsApp Business Account, WABA) zu erhalten, einschließlich wenn ein Unternehmen gegen eine WhatsApp-Richtlinie verstoßen hat. In diesem Leitfaden erfährst du, wie du deine Webhooks einrichtest, damit du diese Benachrichtigungen erhältst, sodass Unternehmen ihr Verhalten umgehend anpassen können, um zusätzliche Warnungen und/oder Durchsetzungsmaßnahmen zu vermeiden.
Bevor du beginnst
Um diesen Leitfaden zu befolgen, musst du dich als Meta-Entwickler*in registrieren. Sobald du registriert bist, musst du ein Business Manager-Konto und die App Meta for Developers einrichten.
Achte beim Erstellen deiner Meta-App darauf, dass du den Typ „Business“ auswählst und deine neue App mit deinem Facebook Business Manager verknüpfst.
Nachdem du die App erstellt hast, füge WhatsApp als Produkt zu deiner Anwendung hinzu. Folge dazu diesen Anweisungen:
- Gehe zu developers.facebook.com/apps und klicke auf die App. Du wirst nach dem Klick zum App-Dashboard deiner App weitergeleitet.
- Suche im Dashboard auf der linken Seitenleiste nach Produkte und klicke auf Produkt hinzufügen. Nach dem Klick siehst du eine Liste der Produkte, die einer App hinzugefügt werden können.
- Suche WhatsApp und klicke auf Einrichten.
Stelle außerdem sicher, dass deine App die App-Review abgeschlossen und die whatsapp_business_management-Berechtigung angefordert hat.
Schritt 1: Endpunkt einrichten und Webhooks konfigurieren
Befolge unseren Leitfaden Erste Schritte mit Webhooks, um deinen Endpunkt zu erstellen und deine Webhooks zu konfigurieren.
Schritt 2: Deine App bei deinem WABA abonnieren
Du musst deine App für Webhook-Benachrichtigungen für das WhatsApp-Unternehmenskonto abonnieren. Für das Abonnement stehen dir zwei Möglichkeiten zur Verfügung:
Schritt 3: Für Konto-Updates anmelden
Nachdem du deine App für den Empfang von Webhooks im Zusammenhang mit deinem WABA angemeldet hast, kannst du festlegen, welche Arten von Updates du erhalten möchtest. Um den Status eines WABAs zu verfolgen, musst du die Option „account_update“ auswählen. Auf diese Weise wirst du benachrichtigt, wenn ein WABA gegen die WhatsApp-Richtlinien verstößt.
Um diese Option auszuwählen, gehe zu deinem App-Dashboard und suche die Option Einstellungen. Es wird ein Webhooks-Abschnitt angezeigt, der alle Informationen enthält, die du in den vorherigen Schritten angegeben hast. Klicke unter Webhook-Felder auf Verwalten. Es wird ein Dialogfenster mit allen Feldern angezeigt, die du abonnieren kannst. Klicke für „account_update“ auf „Abonnieren“.
Nun erhältst du jedes Mal, wenn dein WABA gegen eine Richtlinie verstoßen hat, eine Benachrichtigung, die folgendermaßen aussieht:
{
"object": "whatsapp_business_account",
"entry": [
{
"id": "whatsapp-business-account-id",
"time": 1604703058,
"changes": [
{
"field": "account_update",
"value": {
"phone_number": "16505551111",
"event": "ACCOUNT_VIOLATION",
"violation_info": {
"violation_type": "ALCOHOL",
}
}
}
]
}
]
}
Hier kannst du alle Richtlinienverstöße finden.
Schritt 4: WABA-Einschränkungen tracken
Du solltest Webhooks im Auge behalten, um zu überprüfen, ob dein WABA aufgrund von Richtlinienverstößen eingeschränkt wurde. Wenn eine Einschränkung auferlegt wurde, erhältst du einen Webhook, der innerhalb des Objekts „value“ das Feld restriction_info enthält. Das Feld restriction_info listet alle Einschränkungen auf, die deinem Account auferlegt wurden und wann diese Einschränkungen ablaufen.
Dein WABA kann aufgrund von Richtlinienverstößen eine oder mehrere Einschränkungen erhalten. Im folgenden Beispiel meldet der Webhook, dass ein WABA eine Einschränkung für das Hinzufügen von neuen Telefonnummern erhalten hat:
{
"field": "account_update",
"value": {
"phone_number": "PHONE_NUMBER",
"event": "ACCOUNT_RESTRICTION",
"restriction_info": [
{
"restriction_type": "RESTRICTION_ON_ADD_PHONE_NUMBER_ACTION",
"expiration": TIMESTAMP
},
]
}
}Hier siehst du einen WABA, der keine vom Unternehmen initiierte Nachrichten mehr senden darf:
{
"field": "account_update",
"value": {
"phone_number": "PHONE_NUMBER",
"event": "ACCOUNT_RESTRICTION",
"restriction_info": [
{
"restriction_type": "RESTRICTED_BIZ_INITIATED_MESSAGING",
"expiration": TIMESTAMP
},
]
}
}Zu guter Letzt, siehst du hier einen WABA, der nicht mehr auf vom Nutzer initiierte Nachrichten antworten darf:
{
"field": "account_update",
"value": {
"phone_number": "PHONE_NUMBER",
"event": "ACCOUNT_RESTRICTION",
"restriction_info": [{
"restriction_type": "RESTRICTED_CUSTOMER_INITIATED_MESSAGING",
"expiration": TIMESTAMP
}
]
}
}