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

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

Отслеживание событий кликов

Обновлено: 10 февраля 2026 г
API для маркетинговых сообщений WhatsApp (ранее известный как Marketing Messages Lite API) теперь доступен для всех пользователей.
Доступно только через API маркетинговых сообщений для WhatsApp (MM API для WhatsApp) и Ads Manager
Мы отправляем полезную нагрузку веб-хука, когда пользователи нажимают на текст или призыв к действию вашего маркетингового сообщения. Вы можете подписаться на этот веб-хук, чтобы собирать эти данные и использовать их для принятия решений по вашей кампании.

Ограничения

    В настоящий момент эта функция недоступна для всех пользователейСобытия кликов доступны только для сообщений, отправленных за последние 7 дней

    Вебхуки

    To receive this webhook, subscribe to the бизнес-аккаунт WhatsApp webhook topic. The webhook payload is on the сообщения field and is delivered as below:
    {
    "объект": "whatsapp_business_account",
    "вход": [
        {
    "идентификатор": "<WHATSAPP_BUSINESS_ACCOUNT_ID> ",
    "изменения": [
            {
    "ценить": {
    "messaging_product": "WhatsApp",
    "метаданные": {
    "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
    "идентификатор_номера_телефона": "<BUSINESS_PHONE_NUMBER_ID>"
                },
    "user_actions": [
                  {
    "action_type": "marketing_messages_link_click",
    "временная метка": "<time_of_click>",
    "marketing_messages_link_click_data": {
    "click_component": "cta" | "тело",
    "product_id": "sku_id",
    "click_id": "click_id",
    "tracking_token": "example_token"
                    }
                  }
                ]
              },
    "поле": "сообщения"
            }
          ]
        }
      ]
    }
    
Название поля

Тип поля

Описание поля

    тип_действия
    Необходимый
Нить
    Название действия
    метка времени
    Необходимый
метка времени Unix
    Отметка времени, когда произошло событие
    click_component
    Необязательный
Перечисление
    The click action Can either be cta или тело
    click_id
    Необязательный
Нить
    Уникальный идентификатор клика. Он также добавляется к исходному URL-адресу, когда пользователь переходит по этой ссылке.
    отслеживающий_токен
    Необязательный
Нить
    Внутренний метатокен для обработки и отслеживания
    продукт_id
    Необязательный
Нить
    Идентификатор продукта, если он был присвоен в Ads Manager или Marketing API.
    
    
            
    
    
    

            
    
        
    
    
    

    
    

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