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

API автоматических событий

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

Корпоративные клиенты, использующие встроенную функцию регистрации, могут включить автоматическую идентификацию событий:

Встроенный экран подписки для автоматической идентификации событий

Если корпоративный клиент дает согласие, Meta использует комбинацию регулярных выражений и обработки естественного языка для анализа новых сообщений клиента, исходящих от рекламы Click-to-WhatsApp. Если наш анализ определяет, что произошло событие генерации лида или покупки, automatic_events , описывающий это событие. Затем вы можете сообщить о событии для клиента, используя API конверсий, чтобы клиент мог использовать его на поверхности Meta (в 2026 году, см. Ограничения ниже).

Чтобы узнать больше о том, как работает эта функция, ознакомьтесь с этими материалами.дополнительными

Ограничения

Автоматическая идентификация событий — это новая функция. Ваши бизнес-клиенты не смогут видеть или использовать автоматические события, сообщаемые через Conversions API в MetaStop, до 2026 года. Однако вы можете предоставлять эту информацию своим клиентам, используя собственное решение, и раньше. Это позволит им глубже понять потребности, предпочтения и эффективность рекламы своих собственных клиентов.Автоматическая идентификация событий недоступна для корпоративных клиентов в Европейском Союзе, Великобритании и Японии.

Требования

Вы уже внедрили встроенную систему регистрации и можете регистрировать бизнес-клиентов, которые успешно завершат этот процесс.Ваш сервер веб-хуков успешно обрабатывает веб-хуки.

Настраивать

~~Автоматический~~ Функция идентификации событий доступна всем корпоративным клиентам по желанию и автоматически активируется автоматически. Для получения уведомлений о событиях необходимо подписать приложение на соответствующую рассылку ~~автоматические события~~ Поле веб-перехватчика. Однако, как только вы это сделаете, вы можете начать получать эти веб-перехватчики, прежде чем сможете их обработать. Поэтому выполните эти шаги, используя тестовое приложение, прежде чем переносить свой код в продакшн и подписывать ваше продакшн-приложение на поле веб-перехватчика.

~~Перейдите к~~ ~~Панель управления приложения~~ > ~~Вебхуки~~ > ~~Конфигурация~~ ~~панель и подпишитесь~~ ~~автоматические события~~ ~~Поле веб-перехватчика.~~

Шаг 2: Настройте функцию обратного вызова веб-перехватчика

~~Измените код обратного вызова веб-перехватчика таким образом, чтобы он успешно обрабатывал запросы~~ ~~автоматические события~~ ~~Полезные нагрузки веб-хуков.~~

структура мероприятий по генерации лидов

{
  "object": "whatsapp_business_account",
  "вход": [
    {
      "идентификатор": "<Идентификатор бизнес-аккаунта WhatsApp>",
      "изменения": [
        {
          "ценить": {
            "messaging_product": "whatsapp",
            "метаданные": {
              "display_phone_number": "<НОМЕР ТЕЛЕФОНА ДЛЯ ОТОБРАЖЕНИЯ НА ТЕЛЕФОНЕ>",
              "phone_number_id": "<Идентификатор номера бизнес-телефона>"
            },
            "automatic_events": [
              {
                "идентификатор": "<Идентификатор сообщения WhatsApp>",
                "event_name": "LeadSubmitted",
                "временная метка": <WEBHOOK_TRIGGER_TIMESTAMP>,
                "ctwa_clid": "<ИД_КЛИКА>"
              }
            ]
          },
          "поле": "автоматические_события"
        }
      ]
    }
  ]
}

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

{
"объект": "whatsapp_business_account",
"вход": [
    {
"идентификатор": "102290129340398",
"изменения": [
        {
"ценить": {
"messaging_product": "WhatsApp",
"метаданные": {
"display_phone_number": "15550783881",
"идентификатор_номера_телефона": "106540352242922"
            },
"automatic_events": [
              {
"идентификатор": "wamid.HBgLMTIwNjY3NzQ3OTgVAgASGBQzQUY3MDVCQzFBODE5ODU4MUZEOQA=",
"event_name": "Заявка подана",
"временная метка": 1749069089,
"ctwa_clid": "Afc3nYt4TTydumlFFsatFz8bR2yHCtVA92Veu_zDE4DgAI-QqCwM6eC3-K3lTGHRiLxRTVXFEsdyKQQSa-2obZyuGBq_EYypt_OwbMihBV0pbUoRmrGnEjwFTHop-Px0TfA"
              }
            ]
          },
"поле": "automatic_events"
        }
      ]
    }
  ]
}

структура события покупки

{
  "object": "whatsapp_business_account",
  "вход": [
    {
      "идентификатор": "<Идентификатор бизнес-аккаунта WhatsApp>",
      "изменения": [
        {
          "ценить": {
            "messaging_product": "whatsapp",
            "метаданные": {
              "display_phone_number": "<НОМЕР ТЕЛЕФОНА ДЛЯ ОТОБРАЖЕНИЯ НА ТЕЛЕФОНЕ>",
              "phone_number_id": "<Идентификатор номера бизнес-телефона>"
            },
            "automatic_events": [
              {
                "идентификатор": "<Идентификатор сообщения WhatsApp>",
                "event_name": "Покупка",
                "временная метка": <WEBHOOK_TRIGGER_TIMESTAMP>,
                "ctwa_clid": "<ИД_КЛИКА>",
                "custom_data": {
                  "валюта": "<КОД ВАЛЮТЫ>",
                  "ценить": <КОЛИЧЕСТВО>
                }
              }
            ]
          },
          "поле": "автоматические_события"
        }
      ]
    }
  ]
}

Пример события покупки

{
"объект": "whatsapp_business_account",
"вход": [
    {
"идентификатор": "102290129340398",
"изменения": [
        {
"ценить": {
"messaging_product": "WhatsApp",
"метаданные": {
"display_phone_number": "15550783881",
"идентификатор_номера_телефона": "106540352242922"
            },
"automatic_events": [
              {
"идентификатор": "wamid.HBgLMTIwNjY3NzQ3OTgVAgARGBIwRkU4NDI5Nzk3RjZDMzE2RUMA",
"event_name": "Покупка",
"временная метка": 1749069131,
"ctwa_clid": "Afc3nYt4TTydumlFFsatFz8bR2yHCtVA92Veu_zDE4DgAI-QqCwM6eC3-K3lTGHRiLxRTVXFEsdyKQQSa-2obZyuGBq_EYypt_OwbMihBV0pbUoRmrGnEjwFTHop-Px0TfA",
"custom_data": {
"валюта": "ДОЛЛАР США",
"ценить": 25000
                }
              }
            ]
          },
"поле": "automatic_events"
        }
      ]
    }
  ]
}

Шаг 3: Запуск веб-хуков

~~Для запуска~~ ~~автоматические события~~ ~~вебхук:~~

~~Получите доступ к вашей тестовой реализации встроенной регистрации.Аутентифицируйте процесс, используя компанию, у которой уже настроена реклама Click-to-WhatsApp.~~В ~~Экран создания бизнес-активовпроверьте~~ ~~Дайте указание Meta автоматически определять порядок и ведущие события~~ ~~Поставьте галочку и завершите процесс.Откройте рекламное объявление Click-to-WhatsApp и нажмите на него, чтобы отправить сообщение компании.~~Используйте команду, чтобы ответить на сообщение, используя одну из приведенных ниже строк (она должна быть точной).

~~Для участия в акции по совершению покупок:~~ ~~Ваш номер отслеживания: AB123456789BR~~~~Для мероприятия по привлечению потенциальных клиентов:~~ ~~Мне интересно узнать больше о продукте~~

~~После того, как вы активировали оба~~ ~~автоматические события~~ Убедитесь, что ваш обработчик веб-хуков обработал каждый веб-хук в соответствии с потребностями вашего бизнеса.

Шаг 4: Сообщите о каждом событии, используя API конверсий (необязательно)

~~При желании вы можете сообщить о каждом событии, используя..~~ ~~API конверсийПри необходимости укажите все соответствующие значения из веб-перехватчика событий.~~

~~Видеть~~ ~~Отправляйте события через API конверсий~~ ~~Для получения дополнительной информации о порядке сообщения о происшествиях.~~

синтаксис генерации лидов

curl 'https://graph.facebook.com/<API_VERSION>/<DATASET_ID>/события' \
-H 'Content-Type: application/json' \
-H 'Авторизация: Предъявитель' <ТОКЕН ДОСТУПА>' \
-д '
{
  "данные": [
    {
      "event_name": "LeadSubmitted",
      "event_time": <WEBHOOK_TRIGGER_TIMESTAMP>,
      "action_source": "business_messaging",
      "messaging_channel": "whatsapp",
      "user_data": {
        "ctwa_clid": "<ИД_КЛИКА>"
      },
      "messaging_outcome_data": {
        "outcome_type": "automatic_events"
      }
    }
  ]
}
'

синтаксис события покупки

curl 'https://graph.facebook.com/<API_VERSION>/<DATASET_ID>/события' \
-H 'Content-Type: application/json' \
-H 'Авторизация: Предъявитель' <ТОКЕН ДОСТУПА>' \
-д '
{
  "данные": [
    {
      "event_name": "Покупка",
      "event_time": <WEBHOOK_TRIGGER_TIMESTAMP>,
      "action_source": "business_messaging",
      "messaging_channel": "whatsapp",
      "user_data": {
        "ctwa_clid": "<ИД_КЛИКА>"
      },
      "custom_data": {
        "валюта": "<КОД ВАЛЮТЫ>",
        "ценить": <КОЛИЧЕСТВО>
      },
      "messaging_outcome_data": {
        "outcome_type": "automatic_events"
      }
    }
  ]
}
'

Включение и отключение через Meta Business Suite

Корпоративные клиенты, уже прошедшие регистрацию через встроенную систему авторизации, могут включить автоматическую идентификацию событий с помощью Meta Business Suite.

В панели настроек Meta Business Suite выбран аккаунт WhatsApp Business, на вкладке «Сводка» отображаются флажки для включения этой функции.

Если корпоративный клиент, которого вы уже подключили к системе, хочет включить эту функцию, вы можете отправить ему следующие инструкции:

Получите доступ к Meta Business Suite по https://business.facebook.com.адресуПерейдите в Настройки > Аккаунты > Аккаунты WhatsApp и выберите свой бизнес-аккаунт WhatsApp.прокрутите вниз до «Конфиденциальность и обмен данными» В «Сводка» .Используйте переключатели «Автоматически определять...», чтобы включить или отключить автоматическое определение событий по своему усмотрению.