Как автоматически уведомить отправителей о возврате письма?

Когда вы используете HaskiMail для отправки писем, вся информация о возвратах отправляется в наш return-path, чтобы она была доступна на вашей странице активности, а также через наш API и вебхуки. Однако, в отличие от того, как это работает в других системах, подробности о возврате не отправляются на адрес, указанный в заголовке «From», для писем, которые были возвращены.

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

Требования

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

Получение адреса From

Когда вы получаете уведомление о возврате через вебхук, оно будет иметь следующий формат JSON:
{
  "ID": 42,
  "Type": "HardBounce",
  "TypeCode": 1,
  "Name": "Hard bounce",
  "Tag": "Test",
  "MessageID": "883953f4-6105-42a2-a16a-77a8eac79483",
  "ServerId": 23,
  "Description": "Сервер не смог доставить ваше письмо (например, неизвестный пользователь, почтовый ящик не найден)",
  "Details": "Тестовые детали возврата",
  "Email": "john@example.com",
  "From": "sender@example.com",
  "BouncedAt": "2014-08-01T13:28:10.2735393-04:00",
  "DumpAvailable": true,
  "Inactive": true,
  "CanActivate": true,
  "Subject": "Тема теста"
}

Уведомление отправителя

Так как вы уже отправляете письма через HaskiMail, вы, вероятно, знакомы с тем, как использовать наш API или SMTP для отправки сообщений. Вы можете использовать любые данные для уведомления отправителей о возврате, но мы рекомендуем включить, как минимум, следующие данные:
  • Email: Адрес получателя, который вызвал возврат
  • From: Адрес отправителя (куда будет отправлено уведомление о возврате)
  • Details: Подробности о возврате
  • Description: Описание возврата
  • Subject: Тема письма, которое вернулось