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

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

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

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

Ограничения

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

    Вебхуки

    Чтобы получить этот веб-хук, подпишитесь на whatsapp_business_account . Полезная нагрузка веб-хука находится в сообщений и доставляется следующим образом:
    {
    "object""whatsapp_business_account",
    "entry": [
        {
    "id"",
    "changes": [
            {
    "value": {
    "messaging_product""whatsapp",
    "metadata": {
    "display_phone_number"",
    "phone_number_id""
                },
    "user_actions": [
                  {
    "action_type""marketing_messages_link_click",
    "timestamp"",
    "marketing_messages_link_click_data": {
    "click_component""cta" | "body",
    "product_id""sku_id",
    "click_id""click_id",
    "tracking_token""example_token"
                    }
                  }
                ]
              },
    "field""messages"
            }
          ]
        }
      ]
    }
    Название поля Тип поля Описание поля
    тип_действия
    Обязательная строка
    Название действия
    метка времени
    Обязательная метка времени Unix
    Отметка времени, когда произошло событие
    click_component
    Необязательное перечисление
    Действие клика может быть либо (cta) , либо содержимым страницы (body).
    click_id
    Необязательная строка
    Уникальный идентификатор клика. Он также добавляется к исходному URL-адресу, когда пользователь переходит по этой ссылке.
    отслеживающий_токен
    Необязательная строка
    Внутренний метатокен для обработки и отслеживания
    продукт_id
    Необязательная строка
    Идентификатор продукта, если он был присвоен в Ads Manager или Marketing API.