Вебхук об изменении статуса сообщения

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

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

подсказка

WhatsApp

Viber

Вебхук доступен для всех каналов.

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

Чтобы установить URL-адрес для вебхука об изменении статуса сообщения, отправьте 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 для статусов.

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

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

{
    "requestId": "test-00135",
    "messageId": 8681748,
    "cascadeId": 11,
    "cascadeStageUUID": "001-test001",
    "subject": "test_subject",
    "subjectId": 2,
    "status": "DELIVERED",
    "statusAt": "2025-01-30T11:07:55Z",
    "error": null,
    "comment": null,
    "paymentData": {
        "@type": "WhatsAppConversationPaymentData",
        "conversationId": "test0001",
        "conversationType": "marketing",
        "chargeable": true,
        "type": "WHATSAPP_CONVERSATION"
    }
}

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

Параметр	Тип данных	Характер	Описание
requestId	string	Обязательный	Идентификатор запроса, на основании которого формируется и отправляется сообщение.
cascadeId	long	Обязательный	Идентификатор каскада.
cascadeStageUUID	string	Обязательный	null или данные.
subject	string	Обязательный	Название подписи.
subjectId	long	Обязательный	Идентификатор подписи. Можно узнать через метод получения списка каналов. Получение списка каналов
status	string	Обязательный	Статус сообщения.
statusAt	string	Обязательный	Время последнего обновления статуса сообщения. Указывается в формате ISO 8601. Например: 2023-10-31T11:07:56Z.
error	string	Необязательный	null или данные. Ошибка при доставке сообщения.
comment	string	Необязательный	Текстовый комментарий. Указывается при отправке сообщения. Значение параметра также отображается в детальном отчете. Может использоваться для маршрутизации чат-ботов.
paymentData	object	Обязательный	Набор параметров для канала WhatsApp, которые передают информацию о диалоге.
conversationId	string	Обязательный	Идентификатор диалога. Передается для канала WhatsApp.
conversationType	string	Обязательный	Категория диалога. Передается для канала WhatsApp.
chargeable	boolean	Необязательный	Тип диалога: платный или бесплатный. Передается для канала WhatsApp для статусов DELIVERED и READ.
messageId	integer	Обязательный	Внутренний идентификатор сообщения.

Ожидаемый формат ответа

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

Статусы доставки сообщения

Статус	Описание
SENT	Сообщение отправлено адресату.
DELIVERED	Сообщение доставлено адресату.
READ	Сообщение прочитано адресатом.
UNDELIVERED	Сообщение отправлено, но не доставлено адресату.
CANCELLED	Отправка сообщения отменена.
EXPIRED	Сообщение не получило статус DELIVERED, поскольку: - истекло время, указанное при настройке каскада; - истекло время на доставку сообщения (TTL), определенное каналом по умолчанию. Время на доставку сообщения в каналах (TTL)
FAILED	Ошибка обработки сообщения.

к сведению

При интеграции учитывайте, что список статусов может быть расширен.

Ошибки при получении статусов сообщений

Ошибка	Описание
not-template-match	Сообщение не соответствует допустимому шаблону.
too-long-message	Длина сообщения превышает допустимый лимит.
media-request-failed	Ошибка загрузки файла.
error-subject-unknown	Указанная подпись не разрешена клиенту. Предварительно активируйте все подписи.
error-address-format	Неправильный формат номера абонента.
duplicated	Попытка отправки дубликата сообщения в течение 5 минут.