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

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

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

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

Ограничения

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

    Требования

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

      Настраивать

      Автоматический event identification is available as an opt-in feature to all business customers automatically. To receive event notifications, you must subscribe your app to the автоматические события webhook field. However, as soon as you do this, you may begin receiving these webhooks before you can process them. Therefore, complete these steps using a test app before moving your code to production and subscribing your production app to the webhook field.

      Шаг 1: Подпишитесь на поле веб-перехватчика automatic_events

      Navigate to the Панель управления приложения > Вебхуки > Configuration panel and subscribe to the автоматические события webhook field.

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

      Adjust your webhook callback code so that it can successfully process автоматические события webhook payloads.
      структура мероприятий по генерации лидов
      {
        "object": "whatsapp_business_account",
        "вход": [
          {
            "идентификатор": "<Идентификатор бизнес-аккаунта WhatsApp>",
            "изменения": [
              {
                "ценить": {
                  "messaging_product": "whatsapp",
                  "метаданные": {
                    "display_phone_number": "<НОМЕР ТЕЛЕФОНА ДЛЯ ОТОБРАЖЕНИЯ НА ТЕЛЕФОНЕ>",
                    "phone_number_id": "<Идентификатор номера бизнес-телефона>"
                  },
                  "automatic_events": [
                    {
                      "идентификатор": "<Идентификатор сообщения WhatsApp>",
                      "event_name": "LeadSubmitted",
                      "timestamp": <WEBHOOK_TRIGGER_TIMESTAMP>,
                      "ctwa_clid": "<CLICK_ID>"
                    }
                  ]
                },
                "field": "automatic_events"
              }
            ]
          }
        ]
      }
      Пример мероприятия по генерации лидов
      {
      "объект": "whatsapp_business_account",
      "вход": [
          {
      "идентификатор": "102290129340398",
      "изменения": [
              {
      "ценить": {
      "messaging_product": "WhatsApp",
      "метаданные": {
      "display_phone_number": "15550783881",
      "идентификатор_номера_телефона": "106540352242922"
                  },
      "automatic_events": [
                    {
      "идентификатор": "wamid.HBgLMTIwNjY3NzQ3OTgVAgASGBQzQUY3MDVCQzFBODE5ODU4MUZEOQA=",
      "event_name": "LeadSubmitted",
      "временная метка": 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": "Purchase",
                      "timestamp": <WEBHOOK_TRIGGER_TIMESTAMP>,
                      "ctwa_clid": "<CLICK_ID>",
                      "custom_data": {
                        "currency": "<CURRENCY_CODE>",
                        "value": <КОЛИЧЕСТВО>
                      }
                    }
                  ]
                },
                "field": "automatic_events"
              }
            ]
          }
        ]
      }
      Пример события покупки
      {
      "объект": "whatsapp_business_account",
      "вход": [
          {
      "идентификатор": "102290129340398",
      "изменения": [
              {
      "ценить": {
      "messaging_product": "WhatsApp",
      "метаданные": {
      "display_phone_number": "15550783881",
      "идентификатор_номера_телефона": "106540352242922"
                  },
      "automatic_events": [
                    {
      "идентификатор": "wamid.HBgLMTIwNjY3NzQ3OTgVAgARGBIwRkU4NDI5Nzk3RjZDMzE2RUMA",
      "event_name": "Purchase",
      "временная метка": 1749069131,
      "ctwa_clid": "Afc3nYt4TTydumlFFsatFz8bR2yHCtVA92Veu_zDE4DgAI-QqCwM6eC3-K3lTGHRiLxRTVXFEsdyKQQSa-2obZyuGBq_EYypt_OwbMihBV0pbUoRmrGnEjwFTHop-Px0TfA",
      "custom_data": {
      "валюта": "ДОЛЛАР США",
      "ценить": 25000
                      }
                    }
                  ]
                },
      "поле": "automatic_events"
              }
            ]
          }
        ]
      }
      Шаг 3: Запуск веб-хуков
      To trigger an автоматические события webhook:
        Получите доступ к вашей тестовой реализации встроенной регистрации.Аутентифицируйте процесс, используя компанию, у которой уже настроена реклама Click-to-WhatsApp.В Экран создания бизнес-активов, check the Instruct Meta to automatically identify order and lead events checkbox, and complete the flow.Откройте рекламное объявление Click-to-WhatsApp и нажмите на него, чтобы отправить сообщение компании.Используйте команду, чтобы ответить на сообщение, используя одну из приведенных ниже строк (она должна быть точной).
          For a purchase event: Your tracking number is AB123456789BRFor a lead gen event: I am interested in learning more about the product
          After you have triggered both автоматические события webhook payloads, confirm that your webhook callback has processed each webhook according to your business needs.
          Шаг 4: Сообщите о каждом событии, используя API конверсий (необязательно)
          You can optionally report each event using the API конверсий. Include any relevant values from the event webhook, as appropriate.
          Видеть Send events via Conversions API for additional information about reporting events.
          синтаксис генерации лидов
          curl 'https://graph.facebook.com/<API_VERSION>/<DATASET_ID>/events' \
          -H 'Content-Type: application/json' \
          -H 'Авторизация: Предъявитель' <ТОКЕН ДОСТУПА>' \
          -д '
          {
            "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 'Авторизация: Предъявитель' <ТОКЕН ДОСТУПА>' \
          -д '
          {
            "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": <КОЛИЧЕСТВО>
                },
                "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.В  «Сводка» прокрутите вниз до  «Конфиденциальность и обмен данными» .Используйте переключатели « Автоматически определять ...», чтобы включить или отключить автоматическое определение событий по своему усмотрению.
            
    
                    
            
    
            

            
            
        
            
    
            

    
            

    
    
            
        
            
             Вернуться наверх