Webhook отправляет вашей системе уведомление после события в QWERTYMAIL: доставки, ошибки, открытия, перехода, отписки или жалобы. Это позволяет обновлять CRM и аналитику без постоянного опроса API.
Что понадобится
- доступный по HTTPS адрес обработчика на вашем сервере;
- разработчик, который примет и проверит входящие данные;
- понимание, какие типы сообщений и события нужны системе.
Создайте webhook
- Откройте «Автоматизация» → «Webhooks».
- Нажмите «Создать новый webhook».
- Введите понятное внутреннее название.
- Укажите полный HTTPS‑адрес обработчика.
Выберите типы сообщений
Можно получать события для обычных рассылок, одиночных писем по шаблону, триггерных сообщений и API‑отправок. Отмечайте только те категории, которые обрабатывает ваша система.
Выберите события
- доставлено, не доставлено или пропущено;
- открытие и переход;
- отписка и жалоба на спам;
- отклонение сообщения.
Начинайте с минимума. Например, для очистки CRM достаточно событий недоставки, отписки и спама.
Требования к обработчику
- Принимайте запросы только на выделенном адресе.
- Проверяйте структуру и обязательные поля события.
- Отвечайте быстро успешным HTTP‑статусом после приёма данных.
- Обрабатывайте повторное событие безопасно: оно не должно создавать дубли.
- Не записывайте персональные данные в открытые логи.
Как протестировать
- Сохраните webhook.
- Отправьте тестовое письмо на собственный адрес.
- Выполните выбранное действие.
- Проверьте журнал обработчика и обновление данных в своей системе.
Важно. Переходы и открытия подходят для аналитики, но подтверждение покупки лучше получать из вашей CRM или платёжной системы.
Частые вопросы
Webhook заменяет API?
Нет. API используется, когда ваша система обращается к QWERTYMAIL. Webhook работает в обратную сторону и сообщает о событиях.
Что делать, если события не приходят?
Проверьте HTTPS‑адрес, доступность обработчика, выбранные события и серверный журнал. Затем повторите тест.
Следующий шаг: свяжите события webhook со статусами получателей и используйте их для сегментации базы.