Вебхук-запрос о переходе получателя по кнопке-ссылке в WhatsApp

Обновлено: 12 сентября 2025

Чтобы получать вебхук-запросы о переходе получателя по кнопке-ссылке из сообщения WhatsApp, перейдите в раздел Интеграция → Настройка в личном кабинете edna Pulse и в настройке Webhook URL для отслеживания переходов по кнопке-ссылке WhatsApp укажите URL-адрес для вебхук-запросов — конечную точку вашей системы, которая будет обрабатывать входящие POST-запросы от edna Pulse.

Настройки API

Формат вебхук-запроса

{
    "payload": {
        "sender": "string",
        "templateId": integer,
        "channelType": "WHATSAPP",
        "outMessageId": integer,
        "phone": "string",
        "url": "string",
        "shortLink": "string"
    },
    "type": "string",
    "version": "string",
    "timestamp": "string"
}

Пример вебхук-запроса

{
    "payload": {
        "sender": "test-channel",
        "templateId": 1333,
        "channelType": "WHATSAPP",
        "outMessageId": 5345345,
        "phone": "37512312312",
        "url": "google.ru",
        "shortLink": "https://evtb.me/link/f42kL"
    },
    "type": "short_link_visited",
    "version": "v1",
    "timestamp": "2025-08-10T12:32:56Z"
}

Параметры вебхук-запроса

Параметр	Тип данных	Характер	Описание
payload	object	Обязательный	Информация о типы события.
payload.sender	string	Обязательный	Название подписи. Чтобы узнать название подписи, используйте метод API для получения списка каналов — параметр subject. Получение списка каналов
payload.templateId	integer	Обязательный	Идентификатор шаблона. Чтобы узнать идентификатор шаблона, используйте метод API для получения списка шаблонов — параметр id. Получение списка шаблонов
payload.channelType	string	Обязательный	Тип канала. Возможное значение — WHATSAPP (канал WhatsApp).
payload.outMessageId	integer	Обязательный	Идентификатор сообщения.
payload.phone	string	Обязательный	Адрес получателя — номер телефона. Чтобы узнать адрес получателя, используйте метод API для запроса данных получателей — параметр addresses.address. Запрос данных получателей
payload.url	string	Обязательный	Иcходная ссылка кнопки — статическая и динамическая части. Чтобы узнать иcходную ссылку кнопки, используйте метод API для получения списка шаблонов — параметр content.keyboard.rows.buttons.url. Получение списка шаблонов
payload.shortLink	string	Обязательный	Уникальная ссылка кнопки, заменённая индивидуально для каждого получателя сообщения WhatsApp.
type	string	Обязательный	Тип события, о котором отправляется вебхук-запрос.
version	string	Обязательный	Версия метода API.
timestamp	string	Обязательный	Время перехода получателя по кнопке-ссылке из сообщения WhatsApp. Указывается в формате ISO 8601 (например, 2025-07-01T00:00:00Z). ISO 8601 - Convention

Формат ответа

В ответ на вебхук-запрос от вашего сервера должен возвращаться статус с кодом 200.

Если в ответ на вебхук-запрос не возвращается статус с кодом 200 — edna Pulse выполняет еще 10 попыток отправки вебхук-запроса с интервалом 2*Х секунд между попытками (где Х — номер попытки), пока в ответ не придет код 200 (т. е. каждые 4, 8, 16, 32, 64, 128, 256, 512, 1024, 2048 секунд).