WhatsApp Business Management API

Настройка Webhooks

Подпишитесь на Webhooks, чтобы получать уведомления об изменениях в настройках аккаунта WhatsApp Business и сигналах качества.

Настройка Webhooks не повлияет на номер телефона в приложении WhatsApp Business. Вы не сможете использовать этот номер в приложении WhatsApp Business, только если перенесете его на платформу WhatsApp Business.

Создание конечной точки

Чтобы получать уведомления, вам сначала необходимо создать конечную точку на своем сервере, позволяющую выполнять эту операцию.

Конечная точка должна обрабатывать два типа HTTPS-запросов: запросы подтверждения и уведомления о событиях. Так как запросы обоих типов используют протокол HTTPS, на вашем сервере должен быть настроен и установлен действующий сертификат TLS или SSL. Самозаверенные сертификаты не поддерживаются.

Подробную информацию о запросах подтверждения и уведомлениях о событиях см. в этой статье .

Подписка на Webhooks

Чтобы подписаться на Webhooks, вам необходимо получить ID приложения Meta и разрешения. Для этого перейдите на панель приложений Meta. Там вы сможете:

  1. Создать приложение Meta на панели приложений Meta
  2. Добавить продукт Webhooks в свое приложение Meta на панели приложений .

    Для каждого приложения Meta может быть одновременно настроена только одна конечная точка. Если вам нужно отправлять обновления Webhooks на разные конечные точки, создайте несколько приложений Meta.

Чтобы масштабировать обмен сообщениями от лица компании, возможно, вам понадобится:

  1. Добавить разрешение whatsapp_business_management в панель приложения.
  2. Пройти проверку приложения Meta . На это потребуется время, но во время процесса проверки вы можете продолжать тестирование.

Доступные поля подписки

Доступные поля подписки

Имя поля Описание

account_review_update

Уведомления об окончании проверки аккаунта WhatsApp Business.

account_update

Уведомления об изменениях в вашем аккаунте WhatsApp Business. Это могут быть обновление номера телефона, нарушение политики, блокировка аккаунта WhatsApp Business и др.

business_capability_update

Уведомления об изменении ограничений. Например, это может быть ограничение на количество номеров телефонов, связанных с одним аккаунтом WhatsApp Business, или на количество переписок для каждого номера телефона.

message_template_status_update

Уведомления об одобрении, отклонении или отключении шаблона сообщения.

messages

Уведомления о получении вашей компанией сообщения от клиента, об отправке вами сообщения клиенту, о доставке сообщения клиенту и о прочтении вашего сообщения клиентом.

phone_number_name_update

Уведомления об одобрении или отклонении имени, связанного с номером телефона.

phone_number_quality_update

Уведомления об обновлении статуса, связанного с качеством, для номера телефона.

security

Уведомления о следующем:

  • вы запросили отключение кода двухшаговой проверки;
  • двухшаговая проверка отключена;
  • код двухшаговой проверки обновлен.

    • Подробнее обо всех полях с полезными данными см. в справке по Webhooks для аккаунта WhatsApp Business , а о типах уведомлений messages, которые можно получать, — в справке по Webhooks для облачного API WhatsApp .

    Полезная нагрузка уведомления

    Все уведомления имеют следующий общий формат:

    [{
    "object": "whatsapp_business_account",
    "entry": [{
       "id": "{whatsapp-business-account-id}",
        "time": {unix-timestamp},
        "changes": [{
            "field": "{subscribed-field}",
            "value": {
                # Information that was update
            }
          }]
      }]
  }]

    Массив верхнего уровня содержит два основных объекта:

    ПараметрОписание

    object

    Объект, на который вы подписались.

    entry

    Этот объект содержит информацию об изменении, которое активировало вызов Webhooks.

    Доступные объекты Webhooks перечислены в статье Компоненты.

    Конечные точки тестового приложения