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

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

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

Обновлено: 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.