Правила обработки сообщений

Правила обработки, или Event Orchestration, позволяют принимать разные события через один входящий канал и выбирать действия по содержимому запроса. Например, ошибку production отправить эксплуатации с важностью «Критично», а новую заявку — поддержке с другим текстом и метками.

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

Как выбирается правило

Исходный запрос → обычные правила в порядке канала
→ первое совпавшее правило
  либо включённое правило по умолчанию
  либо базовые настройки канала
→ преобразования → метки и важность → шаблон → получатели

Выполняется только первое совпавшее правило. Остальные не добавляют свои действия. Если сообщение нужно двум командам, выберите обе в одном правиле. Более конкретные условия ставьте выше общих.

Правило по умолчанию выполняется, когда ни одно обычное правило не совпало. У него нет условий; к каналу подключается только одно такое правило. Без активного правила по умолчанию используются обычный шаблон и получатели канала.

Условия проверяются по исходному телу и Content-Type. Преобразования не запускают повторную проверку. Текстовые операции используют результат предыдущей операции, а JSON-пути всегда читают исходный запрос.

Создайте первое правило

Для простого примера подготовьте личный входящий канал «Проверка правил» и подтверждённый исходящий канал. Создайте текстовый шаблон с единственной подстановкой {{message}} и выберите его у входящего канала.

1. В личном контексте откройте «Правила обработки» и нажмите «Создать правило».
2. Назовите его «Ошибка сборки», выберите вид «По условиям» и оставьте включённым.
3. В блоке «Если» выберите «Исходный текст тела» → «Содержит» → build_failed.
4. В блоке «Тогда», в разделе «Текст сообщения и переменные», добавьте операцию «Задать текст сообщения». Введите Сборка завершилась с ошибкой.
5. Через «Добавить действие» добавьте «Изменить важность» и выберите «Ошибка».
6. Добавьте «Параметры доставки» и отметьте нужный исходящий канал. Если действие доставки не добавлять, сохранится базовый маршрут входящего канала.
7. Сохраните правило. На вкладке «Входящие каналы» выберите «Проверка правил» и нажмите «Подключить».
8. Нажмите «Проверить на примере», выберите этот канал, text/plain и тело build_failed. Должны быть выбраны ваше правило, текст Сборка завершилась с ошибкой, важность «Ошибка» и нужный исходящий канал.
9. Проверьте тело build_ok: правило не совпадёт, применятся базовые настройки канала. Затем отправьте оба сообщения по HTTP и проверьте историю и внешнюю доставку.

«Задать текст сообщения» вставляет буквальный текст с сохранением пробелов и переносов. Подстановки внутри этой операции не раскрываются; динамический текст собирайте шаблоном.

Получатели и наследование

Доставка победившего правила добавляет цели к базовым назначениям канала. Цели других правил не добавляются. В настройках канала все потенциальные назначения из подключённых правил видны серыми, с названием и ссылкой на правило; отключённые источники отмечены. Прямые назначения редактируются отдельно, их удаление не меняет назначения из правил. Одна цель показана со всеми основаниями, команды — без раскрытия состава.

Настройка	Действие не добавлено	Действие добавлено
Шаблон	Используется шаблон канала	Выбранный шаблон либо явно «Без шаблона»
Личная доставка	Связанные исходящие каналы	Базовые и выбранные исходящие каналы без повторов; пустой выбор сохраняет базовую доставку
Организационные получатели	Назначения канала	Базовые и выбранные сотрудники и команды без повторов; пустой выбор сохраняет базовые назначения
Метки	Правило не задаёт метки	Весь выбранный набор; пустой набор — «Без меток»
Важность	Не задана	Выбранное значение либо явно «Не задана»

Чтобы вернуть наследование шаблона, уберите действие шаблона. Чтобы не добавлять получателей правилом, уберите действие доставки или оставьте его списки пустыми: базовые назначения продолжат действовать.

В личном контексте внешней отправки нет, если и базовые исходящие каналы, и цели выбранного правила пусты. В организации личные сообщения сотрудникам не создаются, если оба источника не дают получателей. Если человек назначен, но не настроил «Мою доставку», сообщение доступно ему в ЛК.

Для организационной внешней доставки получатель настраивает канал в «Моей доставке». Назначение только через подключённое правило тоже добавляет канал в список, даже если правило или подключение отключено; получение сообщения зависит от применения правила. Подробности — в инструкции сотрудника.

Важность — метаданные: «Критично» само по себе не меняет получателей, не запускает эскалацию и не подтверждает реакцию человека. Метки выбираются из каталога текущего контекста; правило задаёт готовый набор, а не создаёт метку из произвольного поля JSON.

Подключение и проверка

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

Редактирование общего правила влияет на следующие сообщения всех подключённых каналов. Старые сообщения не пересчитываются. Подробнее — «Подключения, порядок и проверка».

Практические сценарии

• Один JSON-поток для разных команд — условия, разные получатели, метки и правило по умолчанию.
• IoT: Перегрев и восстановление температуры — событие от оборудования, важность и шаблон.
• Условия по тексту, JSON и Content-Type — справочник сравнений и типичных несовпадений.

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

Дальше

Полный справочник семи операций — действия, преобразования и переменные. Каталог и фильтры — метки и важность. Для личного маршрута начните с варианта CI/CD, для текстового мониторинга — с извлечения сервера.

Для статусов внешней задачи смотрите состояния AI и workflow: ошибка, ожидание ввода, завершение и явный default. Поиск определений и работа с несохранённой формой — подключения и проверка.