Маршрутизация почты
API для управления правилами маршрутизации исходящей почты в организации.
Назначение правил
Правила маршрутизации позволяют администратору организации настраивать отправку исходящих писем:
-
Принудительно отправлять письма на указанный адрес почтового сервера для заданных доменов.
-
Выбирать маршрут отправки для заданных доменов в зависимости от типа получателя:
- на указанный адрес почтового сервера;
- Яндекс-получателям (определяется по UID в blackbox).
-
Принудительно отправлять все исходящие письма организации на указанный адрес почтового сервера.
-
Принудительно отправлять письма внешним получателям на указанный адрес почтового сервера.
В одном правиле можно указать только один адрес почтового сервера.
Ограничения и приоритеты
-
Для организации допустимо только одно правило, охватывающее все исходящие письма. Чтобы создать или удалить такое правило, укажите в качестве домена получателя пустую строку (
""). -
Правила с указанным доменом имеют приоритет над правилом с пустым доменом.
-
Приоритет работает следующим образом:
- если домен получателя совпадает с доменом в правиле — письмо отправляется по этому правилу;
- если совпадений нет — применяется правило с пустым доменом (
"").
Обработка доменов
Все операции с правилами выполняются на основе IDN-представления доменов.
Следующие варианты записи считаются идентичными:
домен0.оргДОМЕН0.ОРГxn--0-gtbd1agd.xn--c1avg
Разрешения
Разрешения на использование сервиса, которые доступны при настройке приложения:
ya360_admin:mail_read_domain_routes— для просмотра правил маршрутизации;ya360_admin:mail_write_domain_routes— для создания, обновления и удаления правил.