Вебхуки для возвратов от 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 вебхука для возвратов в настройках канала отправки, ознакомьтесь с нашей документацией, чтобы разработать [код для получения событий вебхуков](https://haskimail.ru/developer/webhooks/bounce-webhook). Если вы не знакомы с получением HTTP POST-запросов, возможно, вам потребуется помощь разработчика для создания и хостинга приложения, которое будет получать и обрабатывать уведомления о возвратах.

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

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

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

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

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

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

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

![](https://haskimail.ru/assets_out/\_i/tild6537-3234-4261-a566-643530323662___\_.jpg)

![](https://haskimail.ru/assets_out/\_i/tild3861-3766-4432-b332-343164396430__\_.jpg)

## **Тестирование возвратов в Haskimail**

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

## **Заключение**

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