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

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

Справочник по веб-перехватчикам системных сообщений

Обновлено: 22 октября 2025 г
сообщений бизнес-аккаунта WhatsApp для системных сообщений.
Note that unlike other incoming messages webhooks, system сообщения вебхуки дон'дон't include a контакты множество.

Триггеры

    Пользователь WhatsApp меняет свой номер телефона, указанный в WhatsApp.

    Синтаксис

    {
    "object": "whatsapp_business_account", "entry": [ { "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>", "changes": [ { "value": { "messaging_product": "whatsapp", "metadata": { "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>", "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>" }, "messages": [ { "from": "<WHATSAPP_USER_PHONE_NUMBER>", "id": "<WHATSAPP_MESSAGE_ID>", "timestamp": "<WEBHOOK_TRIGGER_TIMESTAMP>", "type": "system", "system": { "body": "User <WHATSAPP_USER_PROFILE_NAME> changed from <WHATSAPP_USER_PHONE_NUMBER> to <NEW_WHATSAPP_USER_PHONE_NUMBER>", "wa_id": "<NEW_WHATSAPP_USER_ID>", "type": "user_changed_number" } } ] }, "field": "messages" } ] } ] }

    Параметры

    Заполнитель Описание Пример значения
    <BUSINESS_DISPLAY_PHONE_NUMBER>
    Нить
    Номер телефона компании, отображаемый на экране.
    15550783881
    <BUSINESS_PHONE_NUMBER_ID>
    Нить
    Идентификатор номера служебного телефона.
    106540352242922
    <NEW_WHATSAPP_USER_ID>
    Нить
    New WhatsApp user ID. Note that a WhatsApp пользователь'пользователь'Идентификационный номер и номер телефона могут не всегда совпадать.
    12195555358
    <NEW_WHATSAPP_USER_PHONE_NUMBER>
    Нить
    New WhatsApp user phone number. Note that a WhatsApp пользователь'пользователь'Номер телефона и удостоверение личности могут не всегда совпадать.
    12195555358
    <WEBHOOK_TRIGGER_TIMESTAMP>
    Нить
    Временная метка Unix, указывающая на момент срабатывания веб-перехватчика.
    1739321024
    <WHATSAPP_BUSINESS_ACCOUNT_ID>
    Нить
    Идентификатор бизнес-аккаунта WhatsApp.
    102290129340398
    <WHATSAPP_MESSAGE_ID>
    Нить
    Идентификатор сообщения WhatsApp.
    wamid.HBgLMTY1MDM4Nzk0MzkVAgASGBQzQUFERjg0NDEzNDdFODU3MUMxMAA=
     Нить
    WhatsApp user phone number. Note that a WhatsApp пользователь'пользователь'Номер телефона и удостоверение личности могут не всегда совпадать.
    16505551234
     Нить
    WhatsApp пользователь'пользователь'Имя, как оно отображается в профиле пользователя в приложении WhatsApp.
    Шина Нельсон

    Пример

    { "object": "whatsapp_business_account", "entry": [ { "id": "102290129340398", "changes": [ { "value": { "messaging_product": "whatsapp", "metadata": { "display_phone_number": "15550783881", "phone_number_id": "106540352242922" }, "messages": [ { "from": "16505551234", "id": "wamid.HBgLMTk4MzU1NTE5NzQVAgASGAoxMTgyMDg2MjY3AA==", "timestamp": "1750269342", "system": { "body": "Пользователь Шина Нельсон изменила свой номер с 16505551234 на 12195555358", "wa_id": "12195555358", "type": "user_changed_number" }, "type": "system" } ] }, "field": "messages" } ] } ] }