Обзор
Каждое письмо в Emailit имеет статус, который точно показывает, на каком этапе жизненного цикла оно находится. Существует 12 статусов, каждый со своим цветом и значением. Статус всегда отражает самое актуальное состояние письма.
Справочник статусов
| Статус | Цвет | Описание |
|---|---|---|
| accepted | 🟡 | Письмо принято к доставке и обрабатывается. |
| scheduled | 🟡 | Письмо запланировано к отправке на время, указанное в scheduled_at. |
| delivered | 🟢 | Письмо успешно доставлено на почтовый сервер получателя. |
| bounced | 🔴 | Письмо окончательно не удалось доставить. Почтовый сервер получателя отклонил сообщение (жёсткий отказ). |
| attempted | 🟠 | Была предпринята попытка доставки, но произошла временная ошибка. Система может автоматически повторить попытку. |
| failed | 🔴 | Письмо не удалось доставить из-за конкретной ошибки в процессе доставки. |
| rejected | 🔴 | Письмо было изначально принято к доставке, но затем отклонено. |
| loaded | 🔵 | Содержимое письма было загружено получателем. Используется для отслеживания открытий и требует включения трекинга на отправляющем домене. |
| clicked | 🟣 | Получатель кликнул по ссылке внутри письма. Требует включения отслеживания кликов на отправляющем домене. |
| suppressed | ⚪ | Адрес электронной почты получателя находится в списке подавления, и письмо не было отправлено. |
| received | 🟢 | Входящее письмо было получено на ваш домен. |
| complained | 🔴 | На это письмо была подана жалоба о спаме (обратная связь) получателем. |
Поток статусов
Типичное письмо проходит следующий путь:
- accepted — письмо поступает в систему
- delivered — почтовый сервер получателя принимает его
- loaded — получатель открывает письмо (если включено отслеживание)
- clicked — получатель кликает по ссылке (если включено отслеживание)
Если что-то идёт не так, письмо может попасть в одно из состояний ошибки:
- attempted — временная ошибка, возможна повторная попытка
- bounced — постоянная ошибка, повторные попытки не будут предприниматься
- failed — ошибка доставки
- rejected — отклонено после первоначального принятия
Запланированные письма
Когда вы отправляете письмо с временной меткой scheduled_at в будущем, оно получает статус scheduled вместо accepted. Письмо будет обработано и доставлено в указанное время.
Вы можете отменить запланированное письмо до его отправки или обновить время его отправки.
Подавленные письма
Если получатель находится в списке подавления вашего рабочего пространства, письмо немедленно получит статус suppressed и не будет доставлено. Это защищает вашу репутацию отправителя, избегая известных проблемных адресов.
Статусы отслеживания
Статусы loaded и clicked требуют включения отслеживания на вашем отправляющем домене. При включении:
- loaded фиксируется при загрузке пикселя отслеживания в письме
- clicked фиксируется при переходе по отслеживаемой ссылке в письме
Эти статусы включают дополнительные метаданные, такие как IP-адрес получателя и пользовательский агент.
Проверка статуса письма
Вы можете проверить текущий статус любого письма с помощью эндпоинта Получить письмо или просмотреть статусы писем в панели управления Emailit.