Спам, уведомления и важность

Категории

primary

Письма от людей и ответы на отправленные вами сообщения.

updates

Рассылки, массовые письма, уведомления, чеки и автоответы.

spam

Письма, не прошедшие проверку на спам или аутентификацию, либо те, о которых вы сообщили как о спаме. Скрыты из всех списков, если их не запросить явно.

Сигналы письма

SendHQ читает заголовки с вердиктами, которые принимающий сервис добавляет до доставки: результаты проверки на спам и вирусы, а также результаты SPF, DKIM и DMARC. Доверие оказывается только первому вхождению, потому что отправитель может дописать похожие заголовки, но не может поставить их раньше заголовков получателя. Спамом считаются: письмо с вирусом, письмо, не прошедшее проверку на спам, письмо с непройденным DMARC, письмо, не прошедшее одновременно SPF и DKIM, неаутентифицированное письмо от имени вашего собственного домена, а также письмо от отправителя, которому вы никогда не писали, не прошедшее ни DKIM, ни SPF. List-Unsubscribe, List-Id, признак массовой рассылки (bulk precedence), характерные следы сервисов массовых рассылок, маркеры auto-submitted и отправители в стиле no-reply делают письмо уведомлением. Заголовки читаются как настоящие строки заголовков, а не поиском по тексту письма.

История отправителя

Корпоративный домен считается одним отправителем, а потребительский почтовый ящик, например Gmail, — отдельно по каждому адресу. Если отправитель продолжает писать, а вы ни разу не писали на этот адрес и не отвечали в его цепочке, начиная со второго письма его сообщения становятся уведомлениями: холодные рассылки и серии повторных писем уходят из основных. Если вы писали кому-то другому в той же компании, порог повышается до трёх писем.

Важность

Письмо важно, если это ответ в начатой вами переписке, например в кампании по возвращению клиентов, или если вы отметили его отправителя как важного. Люди, которым вы писали, остаются в основных письмах без пометки. Рассылки и спам никогда не бывают важными, если вы не отметили отправителя как важного. Для классификации используются заголовки, отправитель и ваша собственная история переписки. Тексты писем не передаются никакой модели.

Исправления

PATCH /emails/:id с {"category": "spam"}, {"category": "primary"} или {"important": true} исправляет одно письмо и запоминает вердикт для его отправителя, переопределяя автоматические проверки для будущих писем этого отправителя. Жалоба на спам распространяется и на корпоративный домен отправителя, потому что массовые отправители меняют адреса. Передайте "learn": false, чтобы изменить только это письмо. Когда правила улучшаются, автоматически отсортированные письма сортируются заново; письма, которые вы переместили сами, никогда не меняются.

Чтение по категориям

GET /emails?direction=in&archived=false&category=primary — это основные входящие. Для других представлений используйте category=updates или category=spam, для разбора — important=true, а для поиска по всем папкам — include_spam=true. GET /labels возвращает счётчики mailbox для непрочитанных основных, непрочитанных уведомлений, важных и спама.