Почта
Страница для администраторов. Здесь описано, как TAktom отправляет письма: сброс пароля, уведомления, ответы клиентам Service Desk и письма из правил автоматизации.
Как устроена почта
Собственных почтовых настроек и встроенного SMTP-клиента у TAktom нет. Письма отправляет транспорт — функция, которую вы включаете, заполняете данными своего провайдера и назначаете на те виды писем, которые она должна обслуживать.
Значит, шагов два, и без обоих ничего не доставляется:
- Включить и настроить транспорт.
- Назначить его на назначение — иначе письма этого вида просто не уходят.
Запасного варианта нет
Если на назначение не выбран транспорт, письма этого вида не доставляются — они не уходят «каким-нибудь другим» каналом. Попытка при этом всё равно записывается в журнал отправок с результатом «ошибка» и кодом MAIL_NOT_CONFIGURED, так что пробел виден, а не спрятан. Это сделано намеренно: какой провайдер везёт вашу почту — решение администратора, а не догадка системы.
Доступные транспорты
| Транспорт | Чем отправляет | Особенности |
|---|---|---|
| Шлюз платформы | Почтовый шлюз платформы | Ключей провайдера у вашей установки нет вовсе. Вариант по умолчанию для инстансов, развёрнутых платформой. Не поддерживает копии (cc) и склейку писем в цепочку; действуют квоты. |
| AWS SES | Amazon SES | Поддерживает всё, включая цепочки переписки. |
| SendGrid | SendGrid Mail Send API | Поддерживает всё. |
| Google Workspace | Gmail API от имени пользователя вашего домена | Требует настройки domain-wide delegation на стороне Google. |
Транспорты не исключают друг друга — можно держать несколько сразу и возить разные письма через разных провайдеров. Вложения в письмах не поддерживает ни один транспорт — почтовый API продукта их не предусматривает.
Каждый транспорт честно объявляет свои возможности, и ядро отбрасывает поля, которые он не умеет, вместо того чтобы падать: письмо уйдёт без копии или без склейки в цепочку, но уйдёт.
Настройка транспорта
- Убедитесь, что транспорт разрешён конфигурацией инстанса, и включите его в разделе Админ → Плагины (см. Функции и настройки).
- Откройте Админ → Почта и выберите транспорт во вложенном меню.
- Введите данные провайдера на его странице. Реквизиты живут именно здесь, в интерфейсе, — переменных окружения для них нет.
- Отправьте пробное письмо и убедитесь, что провайдер его принимает.
Исключение — шлюз платформы
У шлюза платформы поля адреса и токена обычно пустые, и это норма: их выдают инстансу при развёртывании. Заполнять их нужно, только чтобы переопределить выданные значения — при переносе инстанса или отладке. Страница показывает, какой адрес используется фактически и откуда он взят.
Ограничение темпа отправки
У шлюза платформы на его странице задаются собственные пределы — сколько писем инстанс отправляет в минуту и в сутки (0 — без ограничения). Это не дубликат квот платформы, а защита от них: превышение квоты на стороне платформы означает потерянное письмо, поэтому инстанс держит свой предел заведомо ниже и растягивает пачку писем во времени вместо того, чтобы упереться в отказ.
Практические следствия:
- отправка одного письма из большой пачки может занять несколько секунд — это ожидаемо, письмо всё равно уйдёт;
- слишком низкий предел (единицы писем в минуту) приводит к обратному: ожидание превышает допустимое, и письма начинают отваливаться с ошибкой о темпе;
- окна скользящие — последние 60 секунд и последние 24 часа, без всплеска на границе суток. На странице видно, сколько писем ушло за оба окна.
Массовые рассылки этим каналом не делаются: у шлюза нет копий и склейки писем в цепочку, а число адресатов одного письма ограничено.
Назначение транспортов
Письма разделены по назначениям, и каждое настраивается отдельно:
| Назначение | Что охватывает | Где назначается |
|---|---|---|
| Системные письма | Сброс пароля и другие письма об учётной записи. | Админ → Настройки |
| Уведомления | Письма об изменениях в задачах, которые вас касаются. | Админ → Шлюзы оповещений |
| Service Desk | Письмо клиенту, когда агент ответил в обращении. | Админ → Service Desk |
| Автоматизация | Письма из действия «Отправить письмо» в правиле. | Админ → Автоматизация |
Каждое назначение задаётся там, где настраивается сама функция, а не общим списком. Сводная картина — какой транспорт что обслуживает — на странице Админ → Почта.
Контроль доставки
На странице Админ → Почта есть и журнал отправок: каждая попытка, её результат и причина отказа. С него стоит начинать разбор, когда кто-то сообщает, что не пришла ссылка на сброс пароля или уведомление, — включая описанный выше случай «транспорт не назначен».
Журнал хранит письмо целиком: полный список адресатов, тему и текст. Он отвечает не только на вопрос «дошло ли», но и «что именно было отправлено», — и по этой же причине содержит переписку с клиентами и тексты уведомлений. Учитывайте это, раздавая доступ к разделу администрирования.
Что дальше
- Функции и настройки — включение функций.
- Поиск и уведомления — как выглядят сами уведомления.
- Автоматизация — правила, отправляющие письма.