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

Обновлено: 29 апреля 2026

Чтобы получать вебхук-запросы о переходе получателя по кнопке-ссылке из сообщения WhatsApp, перейдите на вкладку Интеграция → Настройка → Основной профиль в личном кабинете edna Pulse и в настройке Webhook URL для отслеживания переходов по кнопке-ссылке WhatsApp укажите URL-адрес для вебхук-запросов — конечную точку вашей системы, которая будет обрабатывать входящие POST-запросы от 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. Параметр передается в webhook-запрос только для сообщений, отправленных по API. Максимальная длина строки — 256 символов. Отправка сообщений
type	string	Обязательный	Тип события, о котором отправляется вебхук-запрос.
version	string	Обязательный	Версия метода API.
timestamp	string	Обязательный	Время перехода получателя по кнопке-ссылке из сообщения WhatsApp. Указывается в формате ISO 8601 (например, 2025-07-01T00:00:00Z).

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

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

Если в ответ на вебхук-запрос не возвращается статус с кодом 200 — edna Pulse выполняет еще 10 попыток отправки вебхук-запроса с интервалом 2^Х секунд между попытками (где Х — номер попытки), пока в ответ не придет код 200.

подсказка

Таким образом, при отсутствии ответа запрос повторяется через 4, 8, 16, 32, 64, 128, 256, 512, 1024, 2048 секунд после первой попытки.