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

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

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

сообщений бизнес-аккаунта WhatsApp для сообщений, отправляемых в группу или получаемых из группы.

Триггеры

Пользователь WhatsApp или компания отправляет сообщение в группу.Пользователь WhatsApp или компания получает сообщение в группе.

Синтаксис

{

"object": "whatsapp_business_account",
  "вход": [
    {
      "идентификатор": "<Идентификатор бизнес-аккаунта WhatsApp>",
      "изменения": [
        {
          "ценить": {
            "messaging_product": "whatsapp",
            "метаданные": {
              "display_phone_number": "<НОМЕР ТЕЛЕФОНА ДЛЯ ОТОБРАЖЕНИЯ НА ТЕЛЕФОНЕ>",
              "phone_number_id": "<Идентификатор номера бизнес-телефона>"
            },
            "контакты": [
              {
                "профиль": {
                  "имя": "<ИМЯ_ПОЛЬЗОВАТЕЛЯ_WHATSAPP>"
                },
                "wa_id": "<Идентификатор_пользователя_WhatsApp>",
                "identity_key_hash": "<IDENTITY_KEY_HASH>" <!-- only included if identity change check enableд -->
              }
            ],
            "сообщения": [
              {
                "от": "<Номер телефона пользователя WhatsApp>",
                "group_id": "<GROUP_ID>",
                "идентификатор": "<Идентификатор сообщения WhatsApp>",
                "временная метка": "<WEBHOOK_TRIGGER_TIMESTAMP>",
                "текст": {
                  "тело": "<MESSAGE_TEXT_BODY>"
                },
                "тип": "<ТИП СООБЩЕНИЯ>"
              }
            ],
          },
          "поле": "сообщения"
        }
      ]
    }
  ]
}

Параметры

Заполнитель Описание Пример значения

<BUSINESS_DISPLAY_PHONE_NUMBER>

Нить

Номер телефона компании, отображаемый на экране.

15550783881

<BUSINESS_PHONE_NUMBER_ID>

Нить

Идентификатор номера служебного телефона.

106540352242922

<GROUP_ID>

Нить

Строковый идентификатор группы, созданной с помощью API групп.

В этом поле отображается информация о том, когда сообщения были отправлены, получены или прочитаны из группы.

Узнайте больше об API групп

"Y2FwaV9ncm91cDoxNzA1NTU1MDEzOToxMjAzNjM0MDQ2OTQyMzM4MjAZD"

<IDENTITY_KEY_HASH>

Нить

Хэш ключа идентификации. Включается только в том случае, если включена проверки изменений идентификатора .

DF2lS5v2W6x=

<MESSAGE_TEXT_BODY>

Нить

Текст сообщения.

Что вы все думаете по этому поводу?

<MESSAGE_TYPE>

Нить

Тип отправляемого сообщения. Будет меняться в зависимости от сообщения, отправляемого группе.

В настоящее время API групп поддерживает:

ТекстСМИТекстовые шаблоныШаблоны на основе медиафайлов

текст

<WHATSAPP_BUSINESS_ACCOUNT_ID>

Нить

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

102290129340398

<WHATSAPP_MESSAGE_ID>

Нить

Идентификатор сообщения WhatsApp.

wamid.HBgLMTY1MDM4Nzk0MzkVAgASGBQzQUFERjg0NDEzNDdFODU3MUMxMAA=

<WEBHOOK_TRIGGER_TIMESTAMP>

Нить

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

1739321024

<WHATSAPP_USER_PHONE_NUMBER>

Нить

Номер телефона пользователя WhatsApp. Это то же самое значение, которое возвращает API вход Значение при отправке сообщения пользователю WhatsApp. Обратите внимание, что WhatsApp ~~пользователь'~~пользователь'Номер телефона и удостоверение личности могут не всегда совпадать.

+16505551234

<WHATSAPP_USER_PROFILE_NAME>

Нить

WhatsApp ~~пользователь'~~пользователь'Имя, как оно отображается в профиле пользователя в приложении WhatsApp.

Шина Нельсон

<WHATSAPP_USER_ID>

Нить

Идентификатор пользователя WhatsApp. Обратите внимание, что WhatsApp ~~пользователь'~~пользователь'Идентификационный номер и номер телефона могут не всегда совпадать.

16505551234

Пример

{
"объект": "whatsapp_business_account",
"вход": [
    {
"идентификатор": "102290129340398",
"изменения": [
        {
"ценить": {
"messaging_product": "WhatsApp",
"метаданные": {
"display_phone_number": "15550783881",
"идентификатор_номера_телефона": "106540352242922"
            },
"контакты": [
              {
"профиль": {
"имя": "Tiago Mingo"
                },
"ва_ид": "16505551234"
              }
            ],
"сообщения": [
              {
"от": "16505551234",
"group_id": "HBgLMTY1MDM4Nzk0MzkVAgASGBQzQTRBNjU5OUFFRTAzODEwMTQ0RgA",
"идентификатор": "wamid.HASDI128HJOPUERIH82ahdasd09ASDHi5>",
"временная метка": "1744344496",
"текст": {
"тело": "What does everyone think about this?"
                },
"тип": "текст"
              }
            ]
          },
"поле": "сообщения"
        }
      ]
    }
  ]
}