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

Обновлено: 23 июля 2026

Этот вебхук позволяет получать информацию о переходах пользователей по кнопкам-ссылкам в сообщениях WhatsApp. При переходе по кнопке-ссылке edna Pulse отправляет HTTP POST-запрос на указанный URL-адрес. В статье описан формат вебхука и передаваемых данных.

Настройка URL-адреса

Чтобы установить URL-адрес для вебхука о переходах пользователей по кнопкам-ссылкам в сообщениях WhatsApp, отправьте POST-запрос на URL-адрес https://app.edna.io/api/callback/set.

Установка URL-адресов для вебхуков

подсказка

Ваш URL-адрес должен быть реальным и доступным для запроса из публичного интернета. Используйте только безопасный протокол HTTPS — по умолчанию TCP-порт 443. Максимальная длина URL-адреса — 500 символов.

к сведению

Если доставка вебхука завершается ошибкой, edna Pulse выполняет до трёх повторных попыток отправки по схеме backoff: через 4, 128 и 2048 секунд после предыдущей попытки.

Также URL-адрес вебхука можно указать в личном кабинете edna Pulse: Интеграция → Настройка → Основной профиль → Webhook URL для отслеживания переходов по кнопке-ссылке WhatsApp.

Общая информация про API-ключи и вебхуки edna Pulse Управление вебхуками edna Pulse

Формат вебхука

{
    "payload": {
        "sender": "string",
        "templateId": number,
        "channelType": "string",
        "outMessageId": number,
        "phone": "string",
        "identifiers": [
            {
                "type": "string",
                "value": "string"
            },
            {
                "type": "string",
                "value": "string"
            },
            {
                "type": "string",
                "value": "string"
            },
            {
                "type": "string",
                "value": "string"
            }
        ],
        "url": "string",
        "shortLink": "string",
        "requestId": "string"
    },
    "type": "string",
    "version": "string",
    "timestamp": "string"
}

Пример вебхука

{
    "payload": {
        "sender": "test-channel",
        "templateId": 1312,
        "channelType": "WHATSAPP",
        "outMessageId": 5345345,
        "phone": "77771234567",
        "identifiers": [
            {
                "type": "PHONE",
                "value": "77771234567"
            },
            {
                "type": "WHATSAPP_BSUID",
                "value": "KZ.1234567890123456789"
            },
            {
                "type": "WHATSAPP_PARENT_BSUID",
                "value": "KZ.ENT.987654321987654321"
            },
            {
                "type": "WHATSAPP_USERNAME",
                "value": "@realsheenanelson"
            }
        ],
        "url": "google.kz",
        "shortLink": "f42kL",
        "requestId": "059cc352-f6a2-4fb0-b717-a56fa0c820bf"
    },
    "type": "short_link_visited",
    "version": "v1",
    "timestamp": "2025-08-10T12:32:56Z"
}

Параметры вебхука

Параметр	Тип данных	Характер	Описание
payload	object	Обязательный	Информация о типе события.
payload.sender	string	Обязательный	Название канала. Чтобы узнать название канала, используйте метод API для получения списка каналов — параметр subject. Получение списка каналов
payload.templateId	number	Обязательный	Идентификатор шаблона. Чтобы узнать идентификатор шаблона, используйте метод API для получения списка шаблонов — параметр id. Получение списка шаблонов
payload.channelType	string	Обязательный	Тип канала. Возможное значение — WHATSAPP (канал WhatsApp).
payload.outMessageId	number	Обязательный	Идентификатор сообщения.
payload.phone	string	Обязательный	Адрес получателя — номер телефона. Чтобы узнать адрес получателя, используйте метод API для запроса данных получателей — параметр addresses.address. Запрос данных получателей
payload.url	string	Обязательный	Исходная ссылка кнопки — статическая и динамическая части. Чтобы узнать исходную ссылку кнопки, используйте метод API для получения списка шаблонов — параметр content.keyboard.rows.buttons.url. Получение списка шаблонов
payload.shortLink	string	Обязательный	Концевая часть уникальной ссылки для кнопки, заменённая индивидуально для каждого получателя сообщения WhatsApp.
payload.identifiers	array of objects	Обязательный	Массив объектов с информацией о дополнительных идентификаторах получателя, связанных с каналом.
payload.identifiers.type	string	Обязательный	Тип идентификатора получателя. Возможные значения: - PHONE — номер телефона получателя. - WHATSAPP_BSUID — Business-Scoped User ID (BSUID). - WHATSAPP_PARENT_BSUID — Parent Business-Scoped User ID (Parent BSUID). - WHATSAPP_USERNAME — имя пользователя WhatsApp (@username).
payload.identifiers.value	string	Обязательный	Идентификатор получателя.
requestId	string	Обязательный	Идентификатор сообщения. Соответствует значению requestId в ответе метода api/cascade/schedule. Параметр передается в вебхук только для сообщений, отправленных по API. Максимальная длина строки — 256 символов. Отправка сообщений
type	string	Обязательный	Тип события, о котором отправляется вебхук.
version	string	Обязательный	Версия метода API.
timestamp	string	Обязательный	Время перехода получателя по кнопке-ссылке из сообщения WhatsApp. Указывается в формате ISO 8601 (например, 2025-07-01T00:00:00Z).

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

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