Вебхуки

Вебхуки дозволяють отримувати HTTP-сповіщення в реальному часі, коли в вашому акаунті Emailit відбуваються події, наприклад, коли електронний лист доставлено, повернуто або створено контакт.

Замість постійного опитування API для відстеження змін, вебхуки надсилають дані на ваш сервер у момент виникнення подій, що дає змогу створювати реактивні інтеграції та робочі процеси.

Як це працює

1. Ви створюєте кінцеву точку вебхука у своєму додатку, яка приймає POST запити
2. Ви реєструєте URL в панелі керування Emailit або через API
3. Коли відбувається подія, на яку ви підписані, Emailit надсилає POST запит на ваш URL з даними події
4. Ваша кінцева точка відповідає статус-кодом 2xx, підтверджуючи отримання

Структура події

Кожна подія вебхука має послідовну структуру:

{
  "event_id": "evt_2bH7kNwP5mQaV1sXgIdKe6pZr",
  "type": "email.delivered",
  "data": {
    "object": {
      ...
    }
  }
}

Доступні події

Emailit надсилає вебхук-сповіщення для наступних типів ресурсів:

• Електронні листи — події життєвого циклу доставки (прийнято, доставлено, повернуто тощо)
• Домени — створення, оновлення та видалення доменів
• Аудиторії — події управління аудиторіями
• Підписники — події життєвого циклу підписників
• Контакти — події управління контактами
• Шаблони — створення, оновлення та видалення шаблонів
• Блокування — зміни в списках блокування
• Перевірка електронних адрес — результати перевірки
• Списки перевірки електронних адрес — події масової перевірки списків

Повний перелік дивіться в розділі Типи подій.

Наступні кроки

• Типи подій — Повний список усіх доступних типів подій
• Запити вебхуків — Як структуровані HTTP-запити вебхуків
• Підпис запиту — Перевірка автентичності вебхуків за допомогою підписів