Когда вы используете 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: Тема письма, которое вернулось