Вебхук о получении входящих сообщений

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

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

Например, если пользователь нажимает кнопку в сообщении WhatsApp, вебхук может содержать значение параметра payload — код кнопки, указанный при создании шаблона сообщения.

подсказка

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

Примеры вебхуков

Полученное текстовое сообщение

{
    "id": 101,
    "subject": "test_subject_WA",
    "subjectId": 345,
    "subscriber": {
        "id": 202,
        "identifier": "79000000000"
    },
    "userInfo": {
        "userName": "alex",
        "firstName": null,
        "lastName": null,
        "avatarUrl": null
    },
    "messageContent": {
        "type": "TEXT",
        "attachment": null,
        "location": null,
        "caption": null,
        "text": "Спасибо за помощь",
        "payload": null,
        "story": null,
        "items": null
    },
    "receivedAt": "2022-04-29T15:30:08Z",
    "replyOutMessageId": 5043874,
    "replyOutMessageExternalRequestId": "2c2dd5f1-5ad8-449d-9c38-b6bdf288f1e5",
    "replyInMessageId": null
}

Полученное текстовое сообщение с информацией о последнем исходящем сообщении

{
  "id": 152,
  "subject": "test_subject_WA",
  "subjectId": 342,
  "subscriber": {
    "id": 242,
    "identifier": "79000000000"
  },
  "userInfo": {
    "userName": "Alex",
    "firstName": null,
    "lastName": null,
    "avatarUrl": null
  },
  "messageContent": {
    "type": "TEXT",
    "attachment": null,
    "location": null,
    "referral": null,
    "caption": null,
    "text": "Добрый день! Заинтересовала белая кружка",
    "payload": null,
    "story": null,
    "items": null,
    "contact": null,
    "product": null,
    "catalog": null,
    "order": null
  },
  "receivedAt": "2025-12-09T05:00:00Z",
  "replyOutMessageId": null,
  "replyOutMessageExternalRequestId": null,
  "replyInMessageId": null,
  "lastMessage": {
    "outMessageId": 8542,
    "address": "79800000001",
    "contentType": "TEXT",
    "text": "Здравствуйте! Рады предложить Вам наши самые лучшие кружки! Ознакомьтесь со списком ниже.",
    "startTime": "2025-12-07T10:12:56Z"
  }
} 

Cообщение-реакция, полученное в ответ на сообщение с интерактивным меню
WhatsApp

{
    "id": 102,
    "subject": "test_subject_WA",
    "subjectId": 345,
    "subscriber": {
        "id": 202,
        "identifier": "79000000000"
    },
    "userInfo": {
        "userName": "alex",
        "firstName": null,
        "lastName": null,
        "avatarUrl": null
    },
    "messageContent": {
        "type": "LIST_PICKER",
        "attachment": null,
        "location": null,
        "caption": null,
        "text": null,
        "payload": null,
        "story": null,
        "items": [
            {
                "identifier": "01",
                "title": "item 1",
                "subtitle": null
            }
        ]
    },
    "receivedAt": "2022-04-29T15:27:40Z",
    "replyOutMessageId": null,
    "replyOutMessageExternalRequestId": null,
    "replyInMessageId": 537701
}

Входящее сообщение со значением `PRODUCT` в параметре `messageContent.type`

{
    "id": 803101,
    "subject": "test_subject_WA",
    "subjectId": 47610,
    "subscriber": {
        "id": 4633047,
        "identifier": "79997776655"
    },
    "userInfo": {
        "userName": "Иван Иванов",
        "firstName": null,
        "lastName": null,
        "avatarUrl": null
    },
    "messageContent": {
        "type": "PRODUCT",
        "attachment": null,
        "location": null,
        "caption": null,
        "text": "Hello",
        "payload": null,
        "story": null,
        "items": null,
        "contact": null,
        "product": {
            "id": "321",
            "catalogId": "123"
        },
        "catalog": null,
        "order": null
    },
    "receivedAt": "2024-08-05T08: 24: 14Z",
    "replyOutMessageId": null,
    "replyOutMessageExternalRequestId": null,
    "replyInMessageId": null
} 

Входящее сообщение со значением `ORDER` в параметре `messageContent.type`

{
    "id": 804201,
    "subject": "test_subject_WA",
    "subjectId": 47610,
    "subscriber": {
        "id": 4633047,
        "identifier": "79997776655"
    },
    "userInfo": {
        "userName": "Иван Иванов",
        "firstName": null,
        "lastName": null,
        "avatarUrl": null
    },
    "messageContent": {
        "type": "ORDER",
        "attachment": null,
        "location": null,
        "caption": null,
        "text": null,
        "payload": null,
        "story": null,
        "items": null,
        "contact": null,
        "product": null,
        "catalog": null,
        "order": {
            "catalogId": "1022121105031922",
            "products": [
                {
                    "id": "111222",
                    "quantity": 2,
                    "price": 5,
                    "currency": "RUB"
                }
            ]
        }
    },
    "receivedAt": "2024-08-05T12:44:22Z",
    "replyOutMessageId": null,
    "replyOutMessageExternalRequestId": null,
    "replyInMessageId": null
} 

Входящее сообщение с параметром `referral`

к сведению

Параметр позволяет получать информацию о месте, в котором клиент начал диалог в WhatsApp.

{
    "id": 115611,
    "subject": "test_WA",
    "subjectId": 195,
    "subscriber": {
        "id": 1111111,
        "identifier": "79000000000"
    },
    "userInfo": {
        "userName": "Anna",
        "firstName": null,
        "lastName": null,
        "avatarUrl": null
    },
    "messageContent": {
        "type": "TEXT",
        "attachment": null,
        "location": null,
        "referral": {
            "body": "This is a great product",
            "headline": "Our new product",
            "sourceId": "123",
            "sourceType": "ad",
            "sourceUrl": "https://www.fb.com"
        },
        "caption": null,
        "text": "text for test",
        "payload": null,
        "story": null,
        "items": null,
        "contact": null,
        "product": null,
        "catalog": null,
        "order": null
    },
    "receivedAt": "2024-01-11T11:20:00Z",
    "replyOutMessageId": null,
    "replyOutMessageExternalRequestId": null,
    "replyInMessageId": null
}

Входящее сообщение со значением `FLOW` в параметре `messageContent.type`

[
    {
        "id": 101,
        "subject": "test_subject_WA",
        "subjectId": 50520,
        "subscriber": {
            "id": 4633047,
            "identifier": "79997776655"
        },
        "userInfo": {
            "userName": "Иван Иванов",
            "firstName": null,
            "lastName": null,
            "avatarUrl": null
        },
        "messageContent": {
            "type": "FLOW",
            "attachment": null,
            "location": null,
            "referral": null,
            "caption": null,
            "text": "{\"flow_token\":\"example\"}",
            "payload": null,
            "story": null,
            "items": null,
            "contact": null,
            "product": null,
            "catalog": null,
            "order": null
        },
        "receivedAt": "2025-03-25T12:12:12Z",
        "replyOutMessageId": null,
        "replyOutMessageExternalRequestId": null,
        "replyInMessageId": null
    }
] 

[
    {
        "id": 101,
        "subject": "test_subject_WA",
        "subjectId": 50520,
        "subscriber": {
            "id": 4633047,
            "identifier": "79997776655"
        },
        "userInfo": {
            "userName": "Иван Иванов",
            "firstName": null,
            "lastName": null,
            "avatarUrl": null
        },
        "messageContent": {
            "type": "FLOW",
            "attachment": null,
            "location": null,
            "referral": null,
            "caption": null,
            "text": "{\"screen_0_Name_0\":\"Ivan\",\"screen_0_Order_number_1\":\"6\",\"screen_0_Choose_a_topic_2\":\"0_order\",\"flow_token\":\"example\"}",
            "payload": null,
            "story": null,
            "items": null,
            "contact": null,
            "product": null,
            "catalog": null,
            "order": null
        },
        "receivedAt": "2025-03-25T12:12:12Z",
        "replyOutMessageId": null,
        "replyOutMessageExternalRequestId": null,
        "replyInMessageId": null
    }
] 

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

Параметр	Тип данных	Описание
`id`	long	Идентификатор запроса.
`subject`	string	Название подписи.
`subjectId`	long	Идентификатор подписи. Можно узнать через метод получения списка каналов.
`subscriber`	object	Информация об отправителе сообщения.
`subscriber.id`	long	Идентификатор.
`subscriber.identifier`	string	Номер телефона.
`userInfo`	object	Информация о пользователе.
`userInfo.userName`	string	Имя.
`userInfo.firstName`	string	Фамилия.
`userInfo.lastName`	string	Отчество.
`userInfo.avatarUrl`	string	Аватар.
`messageContent`	object	Информация о сообщении.
`messageContent.text`	string (optional)	Текст сообщения. При использовании WhatsApp Flows в этом параметре будет приходить информация о Flow. WhatsApp Flows — Meta for Developers
`messageContent.type`	string	Тип сообщения. Возможные значения: `TEXT` — текстовое сообщение; `IMAGE` — изображение; `DOCUMENT` — документ, вложенный в сообщение; `VIDEO` — сообщение, содержащее видео; `AUDIO` — сообщение, содержащее звук; `PRODUCT` — сообщение, содержащее товар; `ORDER` — сообщение, содержащее заказ; `LIST_PICKER` — кнопки интерактивного меню WhatsApp; `FLOW` — сообщение, содержащее WhatsApp Flows. Использование WhatsApp Flows
`text`	string	Обязательный, если `contentType` = `TEXT`, `AUTHENTICATION` или `FLOW`. Текст сообщения, если `contentType` = `TEXT`. Текст сообщения, в которое будет вложен Flow, если `contentType` = `FLOW`. Одноразовый пароль, если `contentType` = `AUTHENTICATION`.
`messageContent.caption`	string (optional)	Название.
`messageContent.payload`	string (optional)	Код кнопки. Указывается при создании HSM-шаблона.
`messageContent.items`	object	Набор параметров, которые возвращаются в ответном сообщении от клиента, когда он реагирует на сообщение с интерактивным меню. Если сообщение клиента обычное (например, текст) и не является реакцией на сообщение с интерактивным меню, параметр возвращается следующим образом: `messageContent.items = null`.
`messageContent.items.title`	string (required)	Название элемента исходного интерактивного меню.
`messageContent.items.subtitle`	string (optional)	Подзаголовок элемента исходного интерактивного меню.
`messageContent.items.identifier`	integer (optional)	Сквозной для всего сообщения ID элемента, вернется в ответном сообщении пользователя.
`messageContent.location`	object (optional)	Адрес локации.
`messageContent.attachment`	object (optional)	`null` или данные документа.
`messageContent.attachment.url`	string (optional)	URL прикрепленного изображения, документа или видео.
`messageContent.attachmentname`	string (optional)	Название прикрепленного изображения, документа или видео.
`messageContent.attachmentsize`	string (optional)	Размер.
`messageContent.contact`	object (optional)	Карточка контакта, состоящая из полей: имя, фамилия, мобильный телефон.
`contact.firstName`	string (optional)	Имя в карточке контакта.
`contact.lastName`	string (optional)	Фамилия в карточке контакта.
`contact.phoneNumber`	string (optional)	Мобильный телефон в карточке контакта.
`receivedAt`	string	Дата и время получения.
`replyInMessageId`	long	Внутренний идентификатор цитируемого сообщения пользователя. Пользователь цитирует своё сообщение, отправленное компании.
`replyOutMessageId`	long	Внутренний идентификатор цитируемого сообщения компании. Пользователь цитирует сообщение, полученное от компании.
`replyOutMessageExternalRequestId`	long	Внешний идентификатор цитируемого сообщения компании, который она указывает при отправке исходящего сообщения по API. В том случае, если пользователь процитировал сообщение, полученное от компании.
`messageContent.referral`	object	Информация, полученная по скрытой от пользователя ссылке или из рекламного объявления.
`messageContent.referral.body`	string	Текст объявления, связанный с сообщением.
`messageContent.referral.headline`	string	Заголовок объявления, связанный с сообщением.
`messageContent.referral.sourceId`	string	Идентификатор объявления или публикации в Facebook*.
`messageContent.referral.sourceType`	string	Тип источника объявления. Возможные значения: - `ad` — объявление; - `post` — публикация.
`messageContent.referral.sourceUrl`	string	URL-адрес объявления, которое просмотрел пользователь.
`lastMessage`	object	Объект, содержащий информацию о последнем исходящем сообщении, отправленном получателю за последние 14 дней до получения входящего сообщения. Особенности: - Только для канала WhatsApp; - Возвращается только одно последнее исходящее сообщение, отправленное получателю из личного кабинета edna Pulse или по API edna Pulse за последние 14 дней до получения входящего. - Если подходящего исходящего сообщения нет - объект `lastMessage` не возвращается. - Можно включить или отключить возврат информации о последнем исходящем сообщении. По умолчанию функциональность выключена. Для включения возможности возврата информации о последнем исходящем сообщении — отправьте запрос в службу поддержки edna.
`lastMessage.outMessageId`	integer	Внутренний идентификатор исходящего сообщения.
`lastMessage.address`	string	Адрес получателя — номер телефона или другой идентификатор.
`lastMessage.contentType`	string	Тип сообщения. Возможные значения: - `TEXT` — текстовое сообщение.
`lastMessage.text`	string	Текст сообщения.
`lastMessage.startTime`	string	Время отправки сообщения в формате даты ISO 8601 durations. Например — `2025-07-01T00:00:00Z`.

к сведению

Вы можете дополнить набор элементов, которые возвращаются в результате запроса. Для этого используйте необходимые элементы из списка.

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

Примеры вебхуков​

Полученное текстовое сообщение​

Полученное текстовое сообщение с информацией о последнем исходящем сообщении​

Входящее сообщение со значением PRODUCT в параметре messageContent.type​

Входящее сообщение со значением ORDER в параметре messageContent.type​

Входящее сообщение с параметром referral​

Входящее сообщение со значением FLOW в параметре messageContent.type​

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

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

Примеры вебхуков

Полученное текстовое сообщение

Полученное текстовое сообщение с информацией о последнем исходящем сообщении

Входящее сообщение со значением `PRODUCT` в параметре `messageContent.type`

Входящее сообщение со значением `ORDER` в параметре `messageContent.type`

Входящее сообщение с параметром `referral`

Входящее сообщение со значением `FLOW` в параметре `messageContent.type`

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