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

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

справочник по веб-перехватчикам automatic_events

Обновлено: 5 ноября 2025 г
В этом руководстве описаны события-триггеры и содержимое полезной нагрузки для automatic_events .
automatic_events , который отправил вам сообщение через вашу рекламу Click to WhatsApp, если вы включили по автоматическим событиям .

Триггеры

    Обнаружено событие, связанное с привлечением потенциального клиента, в чате между компанией и пользователем, который отправил сообщение компании через рекламное объявление, размещенное через Click to WhatsApp.Событие покупки зафиксировано в чате между компанией и пользователем, который отправил сообщение компании через рекламу, размещенную через Click to WhatsApp.

    Синтаксис

    { "object": "whatsapp_business_account", "entry": [ { "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID> ", "изменения": [ { "значение": { "messaging_product": "whatsapp", "метаданные": { "отображаемый_номер_телефона": "<BUSINESS_DISPLAY_PHONE_NUMBER> ", "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID> " }, "automatic_events": [ { "id": "<WHATSAPP_MESSAGE_ID> ", "event_name": "<EVENT_NAME> ", "временная метка":<WEBHOOK_TRIGGER_TIMESTAMP> , "ctwa_clid": "<AD_CLICK_ID> ",<!-- Only included for purchase events --> "custom_data": { "currency": "<CURRENCY_CODE> ", "ценить":<AMOUNT> } } ] }, "field": "automatic_events" } ] } ] }

    Параметры

    Заполнитель Описание Пример значения
    <AD_CLICK_ID>
    Нить
    Идентификатор клика по рекламе в WhatsApp.
    Свойство ctwa_clid полностью опускается для сообщений, исходящих от рекламы в статусе WhatsApp ( размещение рекламы в статусе WhatsApp ) .
    Aff-n8ZTODiE79d22KtAwQKj9e_mIEOOj27vDVwFjN80dp4_0NiNhEgpGo0AhemvuSoifXaytfTzcchptiErTKCqTrJ5nW1h7IHYeYymGb5K5J5iTROpBhWAGaIAeUzHL50
    <AMOUNT>
    Нить
    Сумма покупки рассчитывается как цена товара, умноженная на 1000.
    25000
    <BUSINESS_DISPLAY_PHONE_NUMBER>
    Нить
    Номер телефона компании, отображаемый на экране.
    15550783881
    <BUSINESS_PHONE_NUMBER_ID>
    Нить
    Идентификатор номера служебного телефона.
    106540352242922
    <CURRENCY_CODE>
    Нить
    Код валюты.
    доллар США
    <EVENT_NAME>
    Нить
    Название события. Возможные значения:
      LeadSubmitted — указывает на потенциальное событие.Покупка — Обозначает событие покупки.
      Покупка
      <WEBHOOK_TRIGGER_TIMESTAMP>
      Целое число
      Временная метка Unix, указывающая на момент срабатывания веб-перехватчика.
      1739321024
      <WHATSAPP_MESSAGE_ID>
      Нить
      Идентификатор сообщения WhatsApp.
      wamid.HBgLMTY1MDM4Nzk0MzkVAgASGBQzQUFERjg0NDEzNDdFODU3MUMxMAA=
      <WHATSAPP_BUSINESS_ACCOUNT_ID>
      Нить
      Идентификатор бизнес-аккаунта WhatsApp.
      102290129340398

      Примеры

      Мероприятие по генерации лидов

      { "object": "whatsapp_business_account", "entry": [ { "id": "102290129340398", "changes": [ { "value": { "messaging_product": "whatsapp", "metadata": { "display_phone_number": "15550783881", "phone_number_id": "106540352242922" }, "automatic_events": [ { "id": "wamid.HBgLMTIwNjY3NzQ3OTgVAgASGBQzQUY3MDVCQzFBODE5ODU4MUZEOQA=", "event_name": "LeadSubmitted", "timestamp": 1749069089, "ctwa_clid": "Afc3nYt4TTydumlFFsatFz8bR2yHCtVA92Veu_zDE4DgAI-QqCwM6eC3-K3lTGHRiLxRTVXFEsdyKQQSa-2obZyuGBq_EYypt_OwbMihBV0pbUoRmrGnEjwFTHop-Px0TfA" } ] }, "field": "automatic_events" } ] } ] }

      событие покупки

      { "object": "whatsapp_business_account", "entry": [ { "id": "102290129340398", "changes": [ { "value": { "messaging_product": "whatsapp", "metadata": { "display_phone_number": "15550783881", "phone_number_id": "106540352242922" }, "automatic_events": [ { "id": "wamid.HBgLMTIwNjY3NzQ3OTgVAgARGBIwRkU4NDI5Nzk3RjZDMzE2RUMA", "event_name": "Purchase", "timestamp": 1749069131, "ctwa_clid": "Afc3nYt4TTydumlFFsatFz8bR2yHCtVA92Veu_zDE4DgAI-QqCwM6eC3-K3lTGHRiLxRTVXFEsdyKQQSa-2obZyuGBq_EYypt_OwbMihBV0pbUoRmrGnEjwFTHop-Px0TfA", "custom_data": { "currency": "USD", "value": 25000 } } ] }, "field": "automatic_events" } ] } ] }