---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.2
alternate:
  - https://yandex.ru/dev/api360/doc/ru/ref/RoutingService/index.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/api360/doc/ru/llms.txt

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

<!-- markdownlint-disable-file -->

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

Права доступа, необходимые приложению для работы с правилами:
* `ya360_admin:mail_write_routing_rules` — просмотр и изменение;
* `ya360_admin:mail_read_routing_rules` — просмотр.

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

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

Возможные значения:
- drop — не доставлять письмо;
- forward — переслать письмо.

**Условие** — алгоритм проверки письма. Описание простых и составных условий приведено в разделе [Описание параметра `conditions`](https://yandex.ru/dev/api360/doc/ru/routing.md).

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

#### Особенности

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

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

Для исходящей почты:
* запрет на отправку писем на конкретные адреса;
* пересылка писем с определенной темой на заданный адрес.

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

#### 


## Endpoints

- [Просмотреть список правил](https://yandex.ru/dev/api360/doc/ru/ref/RoutingService/RoutingService_GetRules.md)
- [Задать список правил](https://yandex.ru/dev/api360/doc/ru/ref/RoutingService/RoutingService_SetRules.md)