API для автоматических событий | Документация для разработчиков
API автоматических событий
Обновлено: 18 ноября 2025 г
Корпоративные клиенты, использующие встроенную функцию регистрации, могут включить автоматическую идентификацию событий:
Если корпоративный клиент дает согласие, Meta использует комбинацию регулярных выражений и обработки естественного языка для анализа новых сообщений клиента, исходящих от рекламы Click-to-WhatsApp. Если наш анализ определяет, что произошло событие генерации лида или покупки, automatic_events , описывающий это событие. Затем вы можете сообщить о событии для клиента, используя API конверсий, чтобы клиент мог использовать его на поверхности Meta (в 2026 году, см. Ограничения ниже).
Чтобы узнать больше о том, как работает эта функция, ознакомьтесь с этими дополнительными материалами .
Ограничения
Требования
Настраивать
Автоматическая идентификация событий доступна всем корпоративным клиентам в качестве дополнительной функции. Для получения уведомлений о событиях необходимо подписать ваше приложение на automatic_events . Однако, как только вы это сделаете, вы можете начать получать эти веб-перехватчики до того, как сможете их обработать. Поэтому выполните эти шаги, используя тестовое приложение, прежде чем переносить свой код в рабочую среду и подписывать ваше рабочее приложение на поле веб-перехватчика.
Шаг 1: Подпишитесь на поле веб-перехватчика automatic_events
Перейдите в панель управления приложениями > Веб-перехватчики > конфигурации и подпишитесь на automatic_events .
Шаг 2: Настройте функцию обратного вызова веб-перехватчика
Измените код обратного вызова веб-перехватчика таким образом, чтобы он успешно обрабатывал automatic_events .
структура мероприятий по генерации лидов
{
"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 > " },
"automatic_events": [
{
"id": "
< WHATSAPP_MESSAGE_ID > ", "event_name": "LeadSubmitted",
"timestamp":
< WEBHOOK_TRIGGER_TIMESTAMP > , "ctwa_clid": "
< CLICK_ID > " }
]
},
"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.HBgLMTIwNjY3NzQ3OTgVAgASGBQzQUY3MDVCQzFBODE 5ODU4MUZEOQA=" , "event_name"
: "LeadSubmitted" , "timestamp"
: 1749069089 , "ctwa_clid"
: "Afc3nYt4TTydumlFFsatFz8bR2yHCtVA92Veu_zDE4DgAI-Qq CwM6eC3-K3lTGHRiLxRTVXFEsdyKQQSa-2obZyuGBq_EYypt_O wbMihBV0pbUoRmrGnEjwFTHop-Px0TfA" }
]
},
"field"
: "automatic_events" }
]
}
]
}
структура события покупки
{
"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 > " },
"automatic_events": [
{
"id": "
< WHATSAPP_MESSAGE_ID > ", "event_name": "Purchase",
"timestamp":
< WEBHOOK_TRIGGER_TIMESTAMP > , "ctwa_clid": "
< CLICK_ID > ", "custom_data": {
"currency": "
< CURRENCY_CODE > ", "value":
< AMOUNT > }
}
]
},
"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.HBgLMTIwNjY3NzQ3OTgVAgARGBIwRkU4NDI5Nzk3RjZ DMzE2RUMA" , "event_name"
: "Purchase" , "timestamp"
: 1749069131 , "ctwa_clid"
: "Afc3nYt4TTydumlFFsatFz8bR2yHCtVA92Veu_zDE4DgAI-Qq CwM6eC3-K3lTGHRiLxRTVXFEsdyKQQSa-2obZyuGBq_EYypt_O wbMihBV0pbUoRmrGnEjwFTHop-Px0TfA" , "custom_data"
: { "currency"
: "USD" , "value"
: 25000 }
}
]
},
"field"
: "automatic_events" }
]
}
]
}
Шаг 3: Запуск веб-хуков
Для запуска automatic_events :
После того, как вы запустили оба automatic_events , убедитесь, что ваш обратный вызов веб-перехватчика обработал каждый из них в соответствии с вашими бизнес-потребностями.
Шаг 4: Сообщите о каждом событии, используя API конверсий (необязательно)
При желании вы можете отправлять отчеты о каждом событии, используя API конверсий . При необходимости укажите все соответствующие значения из веб-перехватчика события.
Дополнительную информацию об отчётности о событиях см. в разделе «Отправка событий через API конверсий»
синтаксис генерации лидов
curl 'https://graph.facebook.com/
< API_VERSION > / < DATASET_ID > /events' \ -H 'Content-Type: application/json' \
-H 'Authorization: Bearer
< ACCESS_TOKEN > ' \ -d '
{
"data": [
{
"event_name": "LeadSubmitted",
"event_time":
< WEBHOOK_TRIGGER_TIMESTAMP > , "action_source": "business_messaging",
"messaging_channel": "whatsapp",
"user_data": {
"ctwa_clid": "
< CLICK_ID > " },
"messaging_outcome_data": {
"outcome_type": "automatic_events"
}
}
]
}
'
синтаксис события покупки
curl 'https://graph.facebook.com/
< API_VERSION > / < DATASET_ID > /events' \ -H 'Content-Type: application/json' \
-H 'Authorization: Bearer
< ACCESS_TOKEN > ' \ -d '
{
"data": [
{
"event_name": "Purchase",
"event_time":
< WEBHOOK_TRIGGER_TIMESTAMP > , "action_source": "business_messaging",
"messaging_channel": "whatsapp",
"user_data": {
"ctwa_clid": "
< CLICK_ID > " },
"custom_data": {
"currency": "
< CURRENCY_CODE > ", "value":
< AMOUNT > },
"messaging_outcome_data": {
"outcome_type": "automatic_events"
}
}
]
}
'
Включение и отключение через Meta Business Suite
Корпоративные клиенты, уже прошедшие регистрацию через встроенную систему авторизации, могут включить автоматическую идентификацию событий с помощью Meta Business Suite.
Если корпоративный клиент, которого вы уже подключили к системе, хочет включить эту функцию, вы можете отправить ему следующие инструкции: