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

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

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

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

Чтобы установить URL-адрес для вебхука о переходах пользователей по кнопкам-ссылкам в сообщениях WhatsApp, отправьте POST-запрос на URL-адрес https://app.edna.ru/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": "WHATSAPP",
		"outMessageId": number,
		"phone": "string",
		"url": "string",
		"shortLink": "string",
		"requestId": "string"
	},
	"type": "string",
	"version": "string",
	"timestamp": "string"
}

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

{
	"payload": {
		"sender": "test-channel",
		"templateId": 1333,
		"channelType": "WHATSAPP",
		"outMessageId": 5345345,
		"phone": "79991234567",
		"url": "google.ru",
		"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	Обязательный	Иcходная ссылка кнопки — статическая и динамическая части. Чтобы узнать иcходную ссылку кнопки, используйте метод API для получения списка шаблонов — параметр content.keyboard.rows.buttons.url. Получение списка шаблонов
payload.shortLink	string	Обязательный	Концевая часть уникальной ссылки для кнопки, заменённая индивидуально для каждого получателя сообщения WhatsApp.
requestId	string	Обязательный	Идентификатор сообщения. Соответствует значению requestId в ответе метода api/cascade/schedule. Параметр передается в вебхук только для сообщений, отправленных по API. Максимальная длина строки — 256 символов. Отправка сообщений
type	string	Обязательный	Тип события, о котором отправляется вебхук.
version	string	Обязательный	Версия метода API.
timestamp	string	Обязательный	Время перехода получателя по кнопке-ссылке из сообщения WhatsApp. Указывается в формате ISO 8601 (например, 2025-07-01T00:00:00Z).

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

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