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

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

Обновлено: 14 ноября 2025 г

В этом справочнике описаны события-триггеры и содержимое полезной нагрузки для phone_number_quality_update .

Он обновление_качества_телефонного_номера Веб-хук уведомляет вас об изменениях в рабочем телефонном номере ~~число'~~число'с throughput level.

Триггеры

A business phone ~~число'~~число's throughput level changes.

Синтаксис

{

"вход": [
      {
        "идентификатор": "<Идентификатор бизнес-аккаунта WhatsApp>",
        "время": <WEBHOOK_TRIGGER_TIMESTAMP>,
        "изменения": [
          {
            "ценить": {
              "display_phone_number": "<НОМЕР ТЕЛЕФОНА ДЛЯ ОТОБРАЖЕНИЯ НА ТЕЛЕФОНЕ>",
              "event": "<EVENT>",
              "old_limit": "<OLD_LIMIT>", <!-- only included for messaging limit changes -->
              "current_limit": "<CURRENT_LIMIT>",
              "max_daily_conversations_per_business": "<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 —- Indicates a messaging limit of 50.

TIER_250 —- Indicates a messaging limit of 250.

TIER_2K —- Indicates a messaging limit of 2,000.

TIER_10K —- Indicates a messaging limit of 10,000.

TIER_100K —- Indicates a messaging limit of 100,000.

TIER_NOT_SET —- Indicates the business phone number has not been used to send a message yet.

TIER_UNLIMITED —- Indicates the business phone number has higher throughput.

TIER_UNLIMITED

<EVENT>

Нить

Изменение лимита сообщений изменение пропускной способности

Возможные значения:

ONBOARDING —- Indicates the business phone number is still being registered.

УЛУЧШЕНИЕ ПРОПУСКНОЙ СПОСОБНОСТИ —- Indicates the business phone ~~число'~~число's throughput level has increased to higher throughput.

УЛУЧШЕНИЕ ПРОПУСКНОЙ СПОСОБНОСТИ

<MAX_DAILY_MESSAGES_LIMIT>

Нить

Indicates a change to the owning business ~~портфель'~~портфель'с лимит сообщений или throughput change.

Возможные значения:

TIER_50 —- Indicates a messaging limit of 50.

TIER_250 —- Indicates a messaging limit of 250.

TIER_2K —- Indicates a messaging limit of 2,000.

TIER_10K —- Indicates a messaging limit of 10,000.

TIER_100K —- Indicates a messaging limit of 100,000.

TIER_NOT_SET —- Indicates the business phone number has not been used to send a message yet.

TIER_UNLIMITED —- Indicates the business phone number has higher throughput.

TIER_2K

<OLD_LIMIT>

Нить

Этот параметр будет удален в феврале 2026 года. Вместо него используйте параметр max_daily_conversations_per_business .

Указывает на старый лимит сообщений .

Возможные значения:

TIER_50 —- Indicates a messaging limit of 50.

TIER_250 —- Indicates a messaging limit of 250.

TIER_2K —- Indicates a messaging limit of 2,000.

TIER_10K —- Indicates a messaging limit of 10,000.

TIER_100K —- Indicates a messaging limit of 100,000.

TIER_NOT_SET —- Indicates the business phone number has not been used to send a message yet.

TIER_UNLIMITED

<WEBHOOK_TRIGGER_TIMESTAMP>

Целое число

Временная метка Unix, указывающая на момент срабатывания веб-перехватчика.

1739321024

<WHATSAPP_BUSINESS_ACCOUNT_ID>

Нить

Идентификатор бизнес-аккаунта WhatsApp.

102290129340398

Пример

{
"вход": [
    {
"идентификатор": "102290129340398",
"время": 1748454394,
"изменения": [
        {
"ценить": {
"display_phone_number": "15550783881",
"событие": "THROUGHPUT_UPGRADE",
"current_limit": "TIER_UNLIMITED"
          },
"поле": "phone_number_quality_update"
        }
      ]
    }
  ],
"объект": "whatsapp_business_account"
}