Webhooks

Вебхук — это способ оповещения о произошедшем в системе событии с помощью пользовательских обратных вызовов по HTTP.

Настройте вебхук в разделе enKodНастройки, чтобы получать уведомления о событиях на свой URL.

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

На данный момент доступны POST запросы для событий:

  • Сообщение отправлено (Email)
  • Oшибка доставки (Email)
  • Открытие сообщения (Email)
  • Клик в сообщении (Email)
  • Жалоба (Email)
  • Шаблонное сообщение отправлено (WhatsApp)
  • Шаблонное сообщение доставлено (WhatsApp)
  • Шаблонное сообщение прочитано (WhatsApp)
  • Входящее сообщение получено (WhatsApp)
  • Ошибка доставки шаблонного сообщения (WhatsApp)
  • Подписка на группу рассылок (Email)
  • Отписка от группы рассылок (Email)
  • Добавление контакта

Тело фиксировано и выглядит следующим образом:

Сообщение отправлено (Email)

{
  "event": "message sent",
  "message_id": 4,
  "message_uid": "0123456789_012_012_01234",
  "sending_type": "instant",
  "name": "Sending message (test)",
  "from": "[email protected]",
  "to": "[email protected]"
}

где

  • event - событие (сообщение отправлено)
  • message_id - идентификатор сообщения
  • message_uid - уникальный uid сообщения
  • sending_type - условие отправки сообщения
    • instant - мгновенное
    • scheduled - запланированное
    • regular - регулярное
    • byAPI - по API
    • byEvent - по событию
    • DOI - письмо-подтверждение
    • scenario - сообщение сценария
  • name - тема сообщения
  • from - емейл отправителя
  • to - емейл получателя

Ошибка доставки (Email)

{
  "event": "delivery bounce",
  "message_id": 4,
  "message_uid": "0123456789_012_012_01234",
  "sending_type": "instant",
  "name": "Error while sending message (test)",
  "from": "[email protected]",
  "to": "[email protected]",
  "error_message": "Some error message"
}

где

  • event - событие (ошибка доставки)
  • message_id - идентификатор сообщения
  • message_uid - уникальный uid сообщения
  • sending_type - условие отправки сообщения
    • instant - мгновенное
    • scheduled - запланированное
    • regular - регулярное
    • byAPI - по API
    • byEvent - по событию
    • DOI - письмо-подтверждение
    • scenario - сообщение сценария
  • name - тема сообщения
  • from - емейл отправителя
  • to - емейл получателя
  • error_message - текст ошибки

Открытие сообщения (Email)

{
  "event": "message open",
  "message_id": 4,
  "message_uid": "0123456789_012_012_01234",
  "sending_type": "instant",
  "name": "Open message (test)",
  "from": "[email protected]",
  "to": "[email protected]"
}

где

  • event - событие (открытие сообщения)
  • message_id - идентификатор сообщения
  • message_uid - уникальный uid сообщения
  • sending_type - условие отправки сообщения
    • instant - мгновенное
    • scheduled - запланированное
    • regular - регулярное
    • byAPI - по API
    • byEvent - по событию
    • DOI - письмо-подтверждение
    • scenario - сообщение сценария
  • name - тема сообщения
  • from - емейл отправителя
  • to - емейл получателя

Клик в сообщении (Email)

{
  "event": "message clicked",
  "message_id": 4,
  "message_uid": "0123456789_012_012_01234",
  "sending_type": "instant",
  "name": "Click in message (test)",
  "from": "[email protected]",
  "to": "[email protected]",
  "click_url": "https://clicked.link/"
}

где

  • event - событие (клик в сообщении)
  • message_id - идентификатор сообщения
  • message_uid - уникальный uid сообщения
  • sending_type - условие отправки сообщения
    • instant - мгновенное
    • scheduled - запланированное
    • regular - регулярное
    • byAPI - по API
    • byEvent - по событию
    • DOI - письмо-подтверждение
    • scenario - сообщение сценария
  • name - тема сообщения
  • from - емейл отправителя
  • to - емейл получателя
  • click_url - URL клика

Жалоба (Email)

{
  "event": "сomplaint",
  "message_id": 4,
  "message_uid": "0123456789_012_012_01234",
  "sending_type": "instant",
  "name": "Complaint in message (test)",
  "from": "[email protected]",
  "to": "[email protected]"
}

где

  • event - событие (жалоба)
  • message_id - идентификатор сообщения
  • message_uid - уникальный uid сообщения
  • sending_type - условие отправки сообщения
    • instant - мгновенное
    • scheduled - запланированное
    • regular - регулярное
    • byAPI - по API
    • byEvent - по событию
    • DOI - письмо-подтверждение
    • scenario - сообщение сценария
  • name - тема сообщения
  • from - емейл отправителя
  • to - емейл получателя

Шаблонное сообщение отправлено (WhatsApp)

{
  "event": "whatsapp template sent",
  "template_name": "template_example",
  "message_id": 123,
  "sending_type": "scenario",
  "from_number": "70000000000",
  "to_number": "71111111111"
}

где

  • event - событие (шаблонное сообщение отправлено)
  • template_name - название шаблона
  • message_id - id сообщения
  • sending_type - условие отправки сообщения
    • scenario - сообщение сценария
  • from_number - номер отправителя (в формате 7хххххххххх)
  • to_number - номер получателя (в формате 7хххххххххх)

Шаблонное сообщение доставлено (WhatsApp)

{
  "event": "whatsapp template delivered",
  "template_name": "template_example",
  "message_id": 123,
  "sending_type": "scenario",
  "from_number": "70000000000",
  "to_number": "71111111111"
}

где

  • event - событие (шаблонное сообщение доставлено)
  • template_name - название шаблона
  • message_id - id сообщения
  • sending_type - условие отправки сообщения
    • scenario - сообщение сценария
  • from_number - номер отправителя (в формате 7хххххххххх)
  • to_number - номер получателя (в формате 7хххххххххх)

Шаблонное сообщение прочитано (WhatsApp)

{
  "event": "whatsapp template read",
  "template_name": "template_example",
  "message_id": 123,
  "sending_type": "scenario",
  "from_number": "70000000000",
  "to_number": "71111111111"
}

где

  • event - событие (шаблонное сообщение прочитано)
  • template_name - название шаблона
  • message_id - id сообщения
  • sending_type - условие отправки сообщения
    • scenario - сообщение сценария
  • from_number - номер отправителя (в формате 7хххххххххх)
  • to_number - номер получателя (в формате 7хххххххххх)

Входящее сообщение получено (WhatsApp)

{
  "event": "whatsapp inbox message received",
  "message": "some text",
  "from_number": "71111111111",
  "to_number": "70000000000"
}

где

  • event - событие (входящее сообщение получено)
  • message - сообщение (текст входящего сообщения)
  • from_number - номер отправителя: контакта, отправившего входящее (в формате 7хххххххххх)
  • to_number - номер получателя: номер WA, настроенный у вас в аккаунте (в формате 7хххххххххх)

Ошибка доставки шаблонного сообщения (WhatsApp)

{
  "event": "whatsapp template bounce",
  "template_name": "template_example",
  "message_id": 123,
  "sending_type": "scenario",
  "from_number": "70000000000",
  "to_number": "71111111111",
  "error_message": "Some error message"
}

где

  • event - событие (ошибка доставки шаблонного сообщения)
  • template_name - название шаблона
  • message_id - id сообщения
  • sending_type - условие отправки сообщения
    • scenario - сообщение сценария
  • from_number - номер отправителя (в формате 7хххххххххх)
  • to_number - номер получателя (в формате 7хххххххххх)
  • error_message - текст ошибки

Подписка на группу рассылок (Email)

{
  "event": "mailing group subscribe",
  "email": "[email protected]",
  "group_id": 4,
  "group_name": "Person subscribe (test)",
  "channel": "email"
}

где

  • event - событие (подписка на группу рассылок)
  • email - емейл контакта
  • group_id - идентификатор группы рассылок
  • group_name - системное имя группы рассылок
  • channel - канал группы рассылок

Отписка от группы рассылок (Email)

{
  "event": "mailing group unsubscribe",
  "email": "[email protected]",
  "group_id": 4,
  "group_name": "Person unsubscribe (test)",
  "channel": "email"
}

где

  • event - событие (отписка от группы рассылок)
  • email - емейл контакта
  • group_id - идентификатор группы рассылок
  • group_name - системное имя группы рассылок
  • channel - канал группы рассылок

Добавление контакта

{
  "event": "contact adding",
  "email": "[email protected]",
  "phone": "80123456789",
  "groups_names": [
    "test_group_0",
    "test_group_1"
  ],
  "groups_ids": [
    0,
    1
  ]
}

где

  • event - событие (добавление контакта)
  • email - емейл контакта
  • phone - телефон контакта
  • groups_names - системные имена групп рассылок, на которые был подписан контакт при добавлении
  • groups_ids - идентификаторы групп рассылок, на которые был подписан контакт при добавлении
Последнее изменение: 2024.03.22 14:35 — Elizaveta Ivannikova