Правила обработки писем

Инструмент для управления потоками входящей и исходящей почты: администратор создает правила обработки писем, которые действуют на уровне домена и имеют приоритет над аналогичными правилами, заданными пользователями.

Права доступа, необходимые приложению для работы с правилами:

  • ya360_admin:mail_write_routing_rules — просмотр и изменение;
  • ya360_admin:mail_read_routing_rules — просмотр.

Термины

Правило обработки писем — инструкция, которая описывает, какое Действие нужно выполнить с письмом при выполнении Условия.

Действие — операция над письмом.

Возможные значения:

  • drop — не доставлять письмо;
  • forward — переслать письмо.

Условие — алгоритм проверки письма. Описание простых и составных условий приведено в разделе Описание параметра conditions.

Порядок работы

Правило обработки писем, настроенное через API, применяется либо к входящей почте, либо к исходящей. Это регулируется параметром direction запроса на создание правила. В зависимости от этого параметра каждое поступающее или отправляемое письмо проверяется на соответствие условию, например, по наличию в теме или заголовке письма определенных слов, по названию вложения, по адресу отправителя. Если соответствие установлено, то производится одно из действий:

  • доставка письма не производится;
  • письмо пересылается на заданный адрес.

Особенности

Правила обработки писем распространяются только на сотрудников с аккаунтами на домене организации. На остальных пользователей, например владельца организации с почтой вида login@yandex.ru или приглашенных пользователей с аккаунтами на Яндексе, правила не действуют.

Примеры правил

Для входящей почты:

  • пересылка всей входящей почты одного сотрудника другому сотруднику;
  • установка запрета написания писем на какой-либо адрес всем, кроме конкретных пользователей.

Для исходящей почты:

  • запрет на отправку писем на конкретные адреса;
  • пересылка писем с определенной темой на заданный адрес.

Правила обработки писем также позволяют устанавливать запрет всем сотрудникам на получение писем от конкретного отправителя. Однако задавать черные списки отправителей лучше через настройку списка запрещенных и разрешенных отправителей. Описание метода по работе со списком.

Endpoints