Вебхук для жалоб на спам

Что такое жалоба на спам? #

Жалоба на спам регистрируется, когда пользователь в своем почтовом ящике нажимает кнопку «Это спам» в таких почтовых клиентах, как Yahoo, Hotmail, AOL и других. В идеале у вас не должно быть жалоб на спам, но они все же случаются. Как только жалоба на спам зарегистрирована, Haskimail деактивирует этот адрес и не позволит вам активировать его повторно.

В индустрии email-рассылок жалобы на спам — это четкий показатель злоупотреблений и некачественных практик отправки. Нам важно серьезно относиться к этим жалобам, чтобы обеспечивать наилучшую доставляемость для всех наших клиентов. Если вы считаете, что жалоба на спам была ошибочной и адрес следует повторно активировать, пожалуйста, свяжитесь напрямую со службой поддержки Haskimail.

Примечание: Дата и время в поле BouncedAt передаются в формате ISO 8601.

Настройка URL вебхука для жалоб на спам #

Через веб-интерфейс Haskimail

Войдите в аккаунт Haskimail, выберите нужный Сервер и Канал, а затем перейдите на вкладку «Вебхуки». Нажмите «Добавить вебхук», введите URL в поле «URL вебхука» и установите флажок напротив события «Жалоба на спам» (COMPLAINED).

Через API

Вы можете настроить событие COMPLAINED с помощью API как при создании нового вебхука, так и при редактировании уже существующего.

Данные вебхука для жалоб на спам #

Пример полного JSON-документа, который будет отправлен POST-запросом на ваш URL вебхука, показан справа. Ниже приведено краткое описание некоторых ключевых полей:

• message_id — идентификатор сообщения.
• event — COMPLAINED
• custom_vars — пользовательские метаданные, которые были добавлены в письмо.
• recipient — email-адрес, на котором произошла жалоба.
• campaign_id — значение Tag, переданное при отправке.
• event_time — временная метка, когда произошла жалоба.
• server_id — id сервера, через который было отправлено письмо.
• stream_id — id канала, через который было отправлено письмо.

{
  "event": "COMPLAINED",
  "message_id": "883953f4-6105-42a2-a16a-77a8eac79483",
  "campaign_id": "Test",
  "custom_vars" : {
    "a_key" : "a_value",
    "b_key": "b_value"
   },
  "server_id": 23,
  "stream_id": 25,
  "recipient": "ivan@example.com",
  "event_time": "2019-11-05 16:33:54"
}

Как можно использовать данные о жалобах на спам #

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

• Мгновенно узнавать, что конкретное письмо было явно помечено как спам, и предпринимать дальнейшие действия на основе этого события.
• Использовать данные для создания статистики, специфичной для вашего приложения.
• Предоставлять пользователям интерфейс, позволяющий им отслеживать, что произошло с их email-уведомлениями.