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.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": "<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.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"
}
]
}
]
}
Шаг 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.
Если корпоративный клиент, которого вы уже подключили к системе, хочет включить эту функцию, вы можете отправить ему следующие инструкции: