Перейти к основному содержимому

Справочник по веб-хуку phone_number_quality_update | Документация для разработчиков

ссылка на веб-перехватчик phone_number_quality_update

Обновлено: 14 ноября 2025 г
В этом справочнике описаны события-триггеры и содержимое полезной нагрузки для phone_number_quality_update .
Он обновление_качества_телефонного_номера Веб-хук уведомляет вас об изменениях в рабочем телефонном номере число'число'с уровень пропускной способности.

Триггеры

    Рабочий телефон число'число'уровень пропускной способности изменяется.

    Синтаксис

    {
    "вход": [
          {
            "идентификатор": "<Идентификатор бизнес-аккаунта WhatsApp>",
            "время": <WEBHOOK_TRIGGER_TIMESTAMP>,
            "изменения": [
              {
                "ценить": {
                  "display_phone_number": "<НОМЕР ТЕЛЕФОНА ДЛЯ ОТОБРАЖЕНИЯ НА ТЕЛЕФОНЕ>",
                  "событие": "<СОБЫТИЕ>",
                  "old_limit": "<OLD_LIMIT>", <!-- only included for messaging limit changes -->
                  "current_limit": "<CURRENT_LIMIT>",
                  "max_daily_conversations_per_businesс": "<MAX_DAILY_MESSAGES_LIMIT>"
                },
                "field": "phone_number_quality_update"
              }
            ]
          }
        ],
        "object": "whatsapp_business_account"
      }

    Параметры

    Заполнитель Описание Пример значения
    <BUSINESS_DISPLAY_PHONE_NUMBER>
    Нить
    Номер телефона компании, отображаемый на экране.
    15550783881
    <CURRENT_LIMIT>
    Нить
    Это поле будет удалено в феврале 2026 года. Вместо него используйте значение max_daily_conversations_per_business .
    Указывает текущий лимит сообщений или пропускной способности уровень
    Возможные значения:
    TIER_50 - Указывает на ограничение на количество сообщений — 50.
    TIER_250 - Указывает на ограничение на количество сообщений — 250.
    TIER_2K - Указывает на ограничение на количество сообщений — 2000.
    TIER_10K - Указывает на ограничение на количество сообщений — 10 000.
    TIER_100K - Указывает на лимит сообщений в 100 000.
    TIER_NOT_SET - Указывает на то, что рабочий номер телефона еще не использовался для отправки сообщения.
    TIER_UNLIMITED - Указывает на то, что номер телефона компании имеет более высокую пропускную способность.
    TIER_UNLIMITED
    <EVENT>
    Нить
    Возможные значения:
    Ввод в должность - Указывает на то, что номер телефона компании все еще находится в процессе регистрации.
    УЛУЧШЕНИЕ ПРОПУСКНОЙ СПОСОБНОСТИ - Указывает на рабочий телефон число'число'Уровень пропускной способности увеличился до более высокого уровня.
    УЛУЧШЕНИЕ ПРОПУСКНОЙ СПОСОБНОСТИ
    <MAX_DAILY_MESSAGES_LIMIT>
    Нить
    Указывает на изменение в бизнесе владельца портфель'портфель'с лимит сообщений или пропускная способность изменять.
    Возможные значения:
    TIER_50 - Указывает на ограничение на количество сообщений — 50.
    TIER_250 - Указывает на ограничение на количество сообщений — 250.
    TIER_2K - Указывает на ограничение на количество сообщений — 2000.
    TIER_10K - Указывает на ограничение на количество сообщений — 10 000.
    TIER_100K - Указывает на лимит сообщений в 100 000.
    TIER_NOT_SET - Указывает на то, что рабочий номер телефона еще не использовался для отправки сообщения.
    TIER_UNLIMITED - Указывает на то, что номер телефона компании имеет более высокую пропускную способность.
    TIER_2K
    <OLD_LIMIT>
    Нить
    Этот параметр будет удален в феврале 2026 года. Вместо него используйте параметр max_daily_conversations_per_business .
    Указывает на старый лимит сообщений.
    Возможные значения:
    TIER_50 - Указывает на ограничение на количество сообщений — 50.
    TIER_250 - Указывает на ограничение на количество сообщений — 250.
    TIER_2K - Указывает на ограничение на количество сообщений — 2000.
    TIER_10K - Указывает на ограничение на количество сообщений — 10 000.
    TIER_100K - Указывает на лимит сообщений в 100 000.
    TIER_NOT_SET - Указывает на то, что рабочий номер телефона еще не использовался для отправки сообщения.
    TIER_UNLIMITED
    <WEBHOOK_TRIGGER_TIMESTAMP>
    Целое число
    Временная метка Unix, указывающая на момент срабатывания веб-перехватчика.
    1739321024
    <WHATSAPP_BUSINESS_ACCOUNT_ID>
    Нить
    Идентификатор бизнес-аккаунта WhatsApp.
    102290129340398

    Пример

    {
    "вход": [
        {
    "идентификатор""102290129340398",
    "время"1748454394,
    "изменения": [
            {
    "ценить": {
    "display_phone_number""15550783881",
    "событие""УЛУЧШЕНИЕ ПРОПУСКНОЙ СПОСОБНОСТИ",
    "current_limit""TIER_UNLIMITED"
              },
    "поле""Обновление качества телефонных номеров"
            }
          ]
        }
      ],
    "объект""whatsapp_business_account"
    }