Использование Webhooks для отслеживания нарушений политики аккаунтом WhatsApp Business
Компании могут интегрировать Webhooks для получения уведомлений в реальном времени о различных изменениях в аккаунте WhatsApp Business (WABA), в том числе о нарушениях политики WhatsApp. В этом руководстве вкратце рассматривается настройка Webhooks для получения таких уведомлений, позволяющих компании быстро внести необходимые корректировки, прежде чем она получит дополнительные предупреждения и/или в отношении нее будут приняты меры.
Прежде чем начать
Чтобы следовать инструкциям из этого руководства, вам нужно зарегистрироваться в качестве разработчика Meta. После регистрации необходимо настроить аккаунт Meta Business Manager и приложение Meta for Developers.
При создании приложения Meta выберите тип "Для бизнеса" и свяжите свое новое приложение с Meta Business Manager.
После создания приложения добавьте WhatsApp в качестве продукта в свое приложение. Для этого выполните следующие действия:
- Перейдите по адресу developers.facebook.com/apps и нажмите на приложение. Вы будете перенаправлены на Панель приложений.
- На Панели приложений найдите раздел Продукты на левой боковой панели и нажмите Добавить продукт. Вы увидите список продуктов, которые можно добавить в приложение.
- Найдите WhatsApp и нажмите Настроить.
Вы также можете уточнить, прошло ли ваше приложение проверку и запросило ли оно разрешение whatsapp_business_management.
Шаг 1. Создайте конечную точку и настройте Webhooks
Для создания конечной точки и настройки Webhooks воспользуйтесь руководством по началу работы с Webhooks.
Шаг 2. Свяжите свое приложение с аккаунтом WhatApp Business
Вам потребуется подписать свое приложение на уведомления Webhooks для аккаунта WhatsApp Business. Настроить эту подписку можно двумя разными способами:
Шаг 3. Зарегистрируйтесь для получения уведомлений об изменениях в аккаунте
Теперь, когда ваше приложение зарегистрировано для получения обратных вызовов Webhooks, связанных с аккаунтом WhatsApp Business, можно уточнить, какие виды обновлений вы хотите получать. Для отслеживания статуса аккаунта WhatsApp Business нужно выбрать параметр account_update. В результате вы будете получать уведомления о нарушении вашим аккаунтом WhatsApp Business политик WhatsApp.
Чтобы выбрать этот параметр, перейдите на Панель приложений и найдите раздел Настройки. Вы увидите раздел Webhooks со всей информацией, которую вы предоставили на предыдущих этапах. В разделе Поля Webhook нажмите Настроить. Появится диалоговое окно со всеми полями, на изменения в которых можно подписаться. Нажмите "Подписаться" для параметра account_update.
Теперь каждый раз при нарушении политики вашим аккаунтом WhatsApp Business вы будете получать примерно такое уведомление:
{
"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",
}
}
}
]
}
]
}
Перечень всех нарушений политики можно найти здесь.
Шаг 4. Отслеживание ограничений аккаунта WhatsApp Business
Не забывайте следить за обратными вызовами Webhooks, чтобы оперативно узнавать об ограничениях, наложенных на ваш аккаунт WhatsApp Business из-за нарушений политики. При появлении подобного ограничения вы получите вызов Webhooks с полем restriction_info в объекте значения value. В поле restriction_info перечислены все ограничения, наложенные на ваш аккаунт, и срок их действия.
На аккаунт WhatsApp Business может быть наложено одно или несколько ограничений в связи с нарушениями политики. В следующем примере обратный вызов Webhooks сообщает о том, что в аккаунт WhatsApp Business запрещено добавлять новые номера телефона:
{
"field": "account_update",
"value": {
"phone_number": "PHONE_NUMBER",
"event": "ACCOUNT_RESTRICTION",
"restriction_info": [
{
"restriction_type": "RESTRICTION_ON_ADD_PHONE_NUMBER_ACTION",
"expiration": TIMESTAMP
},
]
}
}Здесь видно, что аккаунт WhatsApp Business больше не может отправлять сообщения, инициированные компанией:
{
"field": "account_update",
"value": {
"phone_number": "PHONE_NUMBER",
"event": "ACCOUNT_RESTRICTION",
"restriction_info": [
{
"restriction_type": "RESTRICTED_BIZ_INITIATED_MESSAGING",
"expiration": TIMESTAMP
},
]
}
}Наконец, здесь показано, что аккаунт WhatsApp Business больше не может отвечать на сообщения, инициированные пользователем:
{
"field": "account_update",
"value": {
"phone_number": "PHONE_NUMBER",
"event": "ACCOUNT_RESTRICTION",
"restriction_info": [{
"restriction_type": "RESTRICTED_CUSTOMER_INITIATED_MESSAGING",
"expiration": TIMESTAMP
}
]
}
}