Главная Вебхуки Как настроить вебхук для возвратов?

Как настроить вебхук для возвратов?

Обновлено Jan 21, 2026

Вебхуки для возвратов от HaskiMail позволяют получать уведомления в реальном времени каждый раз, когда отправленное вами письмо вызывает возврат. Эти уведомления о возвратах отправляются в виде HTTP POST на URL, который вы укажете в настройках канала отправки сообщений HaskiMail. Уведомления вебхуков для возвратов включают информацию, такую как отправитель, получатель, тема письма и причина возврата.

HTTP POST, содержащий информацию о возврате, отправляется в формате JSON:

{
  "RecordType": "Bounce",
  "MessageStream": "transactional",
  "ID": 42,
  "Type": "HardBounce",
  "TypeCode": 1,
  "Name": "Hard bounce",
  "Tag": "Test",
  "MessageID": "883953f4-6105-42a2-a16a-77a8eac79483",
  "Metadata": {
    "a_key": "a_value",
    "b_key": "b_value"
  },
  "ServerID": 23,
  "Description": "The server was unable to deliver your message (ex: unknown user, mailbox not found).",
  "Details": "Test bounce details",
  "Email": "john@example.com",
  "From": "sender@example.com",
  "BouncedAt": "2019-11-05T16:33:54.9070259Z",
  "DumpAvailable": true,
  "Inactive": true,
  "CanActivate": true,
  "Subject": "Test subject",
  "Content": "<Full dump of bounce>"
}

Что можно делать с уведомлениями о возвратах?

События вебхуков для возвратов можно использовать для различных целей, таких как:

  • Уведомление отправителей о возврате письма

  • Отслеживание тенденций возвратов

  • Предотвращение дальнейшей отправки на неверные адреса

  • Отслеживание адресов, которые вернулись, чтобы связаться с получателем через другой канал

Как именно вы будете использовать уведомления о возвратах, зависит от вас. Вы можете разработать дополнительную функциональность в коде URL вебхука для обработки уведомлений о возвратах, которые вы получаете.

Что нужно для получения уведомлений о возвратах?

Прежде чем настроить URL вебхука для возвратов в настройках канала отправки, ознакомьтесь с нашей документацией, чтобы разработать код для получения событий вебхуков. Если вы не знакомы с получением HTTP POST-запросов, возможно, вам потребуется помощь разработчика для создания и хостинга приложения, которое будет получать и обрабатывать уведомления о возвратах.

Как настроить URL вебхука для возвратов в HaskiMail?

Когда ваш URL будет хоститься и готов к получению и обработке уведомлений о возвратах, вы можете настроить его в настройках канала отправки HaskiMail.

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

  • Перейдите в раздел Вебхуки и нажмите кнопку Добавить вебхук.

  • Введите URL вебхука для возвратов в поле URL Вебхука.

  • После ввода URL, отметьте флажок для возврата и протестируйте URL вебхука, чтобы убедиться, что все работает.

  • Сохраните изменения после тестирования.

Тестирование возвратов в HaskiMail

HaskiMail предоставляет black hole домен, который позволяет протестировать все возможные ответы на возвраты, и каждый из этих ответов вызовет вебхук возврата. Письма, отправленные на этот домен, не повлияют на вашу репутацию отправителя.

Заключение

Теперь вы готовы воспользоваться этим мощным инструментом и начать использовать вебхуки для возвратов, чтобы получать уведомления о возвратах для вашего канала отправки.

Если у вас возникнут вопросы, не стесняйтесь обращаться к нам, и мы поможем!