Отправка системного уведомления

Данное активити (робот) позволяет отправлять системные уведомления пользователям Битрикс24.
Результатом работы является отправка уведомления указанному пользователю с возможностью настройки тегов и вложений.

Описание параметров активити

Название поля	Описание и примеры использования
ID пользователя	В данном поле указывается числовой идентификатор пользователя, которому будет отправлено системное уведомление. Это обязательный параметр. Пример: {=Document:ASSIGNED_BY_ID} или [U1]. Форматы указания пользователя: - Числовой ID: 1, 25, 100; - Формат с префиксом: [U1], [U25]; - Можно использовать переменные из предыдущих активити или полей сущности. Как получить ID пользователя: - Из полей CRM-сущностей (ответственный, контакт и т.д.); - Из результатов активити поиска пользователей; - Использовать текущего пользователя через системные переменные; - Из справочника сотрудников портала.
Текст уведомления	В данном поле указывается текст системного уведомления, который увидит пользователь. Это обязательный параметр. Поддерживается форматирование текста, BB-коды и HTML-разметка. Пример: {=Variable:MESSAGE_TEXT}. Форматирование текста уведомления: - Можно использовать BB-коды: [b]жирный[/b], [i]курсив[/i], [u]подчёркнутый[/u]; - Поддерживается HTML-разметка для более сложного форматирования; - Можно вставлять ссылки на элементы CRM, задачи, файлы; - Доступны переменные и поля из текущей сущности.
Текст для почты	В данном поле можно указать альтернативный текст уведомления, который будет использоваться при отправке на email. Это необязательный параметр. Если не указан, то в email будет отправлен текст из поля "Текст уведомления". Пример: {=Variable:EMAIL_TEXT}. Когда использовать отдельный текст для почты: - Если основной текст содержит BB-коды, которые некорректно отображаются в email; - Когда нужен более развёрнутый текст для почтового уведомления; - Для добавления дополнительных ссылок и контактов в email-версию; - Если нужен упрощённый текст без форматирования для почты.
Тег уведомления	В данном поле указывается уникальный тег уведомления в рамках системы. Это необязательный параметр, но очень важный для контроля дублирования уведомлений. Пример: {=Variable:NOTIFICATION_TAG} или "DEAL_STATUS_123". Важно (особенности работы тегов): При добавлении уведомления с существующим тегом все предыдущие уведомления с таким же тегом будут автоматически удалены. Это позволяет избежать дублирования однотипных уведомлений у пользователя. Примеры использования тегов: - TAG="DEAL_STATUS_123" - для уведомлений об изменении статуса конкретной сделки; - TAG="TASK_DEADLINE_456" - для напоминаний о дедлайне задачи; - TAG="PAYMENT_REMINDER" - для напоминаний об оплате; - TAG="DAILY_REPORT_2025-01-15" - для ежедневных отчётов с датой. Если отправить новое уведомление с тем же тегом, старое уведомление с этим тегом удалится автоматически.
Дополнительный тег	В данном поле указывается дополнительный тег без проверки на уникальность. Это необязательный параметр. Используется для дополнительной классификации уведомлений. Пример: {=Variable:SUB_TAG} или "CATEGORY\|URGENT". Отличие от основного тега: - Основной тег (TAG) - проверяется на уникальность, удаляет предыдущие уведомления с таким же тегом; - Дополнительный тег (SUB_TAG) - НЕ проверяется на уникальность, используется только для группировки. Примеры использования дополнительного тега: - SUB_TAG="CATEGORY\|URGENT" - категория срочности; - SUB_TAG="TYPE\|PAYMENT" - тип уведомления; - SUB_TAG="PROJECT\|25" - привязка к проекту; - SUB_TAG="DEPARTMENT\|SALES" - привязка к отделу.
Вложение	В данном поле можно указать вложение к уведомлению в формате Битрикс24. Это необязательный параметр. Используется для передачи структурированных данных в уведомлении. Пример: {=Variable:ATTACH}. Формат вложений: Вложения передаются в специальном формате Битрикс24 Attach, который позволяет создавать изображения, ссылки, файлы, сетки с данными, форматированные блоки информации. Подробнее о формате вложений можно узнать в документации Битрикс24 REST API (раздел im.attach).
Делать отладочные сообщения в журнал БП	Варианты да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Примеры использования активити

Описание примера	Решение
Уведомление об изменении статуса сделки	Параметры: ID пользователя - {=Document:ASSIGNED_BY_ID} (ответственный за сделку), Текст уведомления - "Сделка #{=Document:ID} «{=Document:TITLE}» переведена на стадию 'Выставлен счёт'. Сумма счёта: {=Document:OPPORTUNITY} руб.", Тег уведомления - DEAL_STATUS_{=Document:ID}, Дополнительный тег - CATEGORY\|DEAL_STATUS.
Напоминание о задаче с дедлайном	Параметры: ID пользователя - {=Document:RESPONSIBLE_ID} (ответственный за задачу), Текст уведомления - "⏰ Напоминание: задача «{=Document:TITLE}» должна быть выполнена через 2 часа! Срок: {=Document:DEADLINE}", Текст для почты - "Уважаемый коллега! Напоминаем, что задача '{=Document:TITLE}' должна быть завершена {=Document:DEADLINE}. Ссылка на задачу: [ссылка]", Тег уведомления - TASK_REMINDER_{=Document:ID}, Дополнительный тег - TYPE\|DEADLINE_ALERT.
Уведомление руководителя о превышении суммы сделки	Параметры: ID пользователя - 1 (ID руководителя отдела продаж), Текст уведомления - "🔔 Крупная сделка! Менеджер {=Document:ASSIGNED_BY_PRINTABLE} создал сделку на сумму {=Document:OPPORTUNITY} руб. Требуется контроль. Сделка: {=Document:TITLE}", Тег уведомления - BIG_DEAL_ALERT_{=Document:ID}, Дополнительный тег - ALERT\|BIG_AMOUNT.
Ежедневная сводка по задачам	Параметры: ID пользователя - {=Variable:user_id} (из переменной цикла по всем сотрудникам), Текст уведомления - "Доброе утро! У вас {=Variable:task_count} активных задач. Задачи с истекающим сроком: {=Variable:urgent_tasks}", Текст для почты - "Ежедневная сводка по задачам на {=Variable:current_date}. Активных задач: {=Variable:task_count}. Срочных задач: {=Variable:urgent_count}. Подробнее в Битрикс24.", Тег уведомления - DAILY_TASKS_{=Variable:current_date}, Дополнительный тег - REPORT\|DAILY.
Уведомление об ошибке в процессе	Параметры: ID пользователя - 1 (ID администратора системы), Текст уведомления - "⚠️ ОШИБКА в бизнес-процессе! Процесс: '{=Document:BP_NAME}', Документ: {=Document:ID}, Ошибка: {=Variable:error_message}", Тег уведомления - BP_ERROR_{=Document:BP_ID}_{=Variable:timestamp}, Дополнительный тег - ERROR\|CRITICAL.
Информирование руководителей о достижении KPI	Параметры: ID пользователя - {=Variable:MANAGER_ID}, Текст уведомления - "KPI достигнут! Показатель: {=Variable:KPI_NAME}, Значение: {=Variable:KPI_VALUE}, Цель: {=Variable:KPI_TARGET}. Отлично!", Тег уведомления - KPI_ACHIEVED_{=Variable:KPI_ID}_{=Variable:MONTH}, Дополнительный тег - REPORT\|KPI.
Уведомление о необходимости согласования документов	Параметры: ID пользователя - {=Document:APPROVER_ID}, Текст уведомления - "Требуется согласование документа '{=Document:TITLE}'. Документ: {=Document:ID}, Инициатор: {=Document:CREATED_BY_PRINTABLE}", Тег уведомления - DOC_APPROVAL_{=Document:ID}, Дополнительный тег - TYPE\|APPROVAL.
Автоматическое информирование о статусе выполнения бизнес-процессов	Параметры: ID пользователя - {=Document:ASSIGNED_BY_ID}, Текст уведомления - "Бизнес-процесс '{=Variable:BP_NAME}' завершён. Результат: {=Variable:RESULT}. Документ: {=Document:ID}", Тег уведомления - BP_COMPLETE_{=Document:ID}, Дополнительный тег - TYPE\|BP_STATUS.
Информирование о новых назначениях и изменениях в рабочих задачах	Параметры: ID пользователя - {=Document:NEW_ASSIGNED_BY_ID}, Текст уведомления - "Назначение: Вы назначены исполнителем задачи '{=Document:TITLE}'. Срок: {=Document:DEADLINE}, Приоритет: {=Document:PRIORITY}", Тег уведомления - TASK_ASSIGNED_{=Document:ID}, Дополнительный тег - TYPE\|ASSIGNMENT.
Уведомление о превышении лимитов	Параметры: ID пользователя - {=Variable:MANAGER_ID}, Текст уведомления - "⚠️ Внимание! Превышен лимит по показателю '{=Variable:LIMIT_NAME}'. Текущее значение: {=Variable:CURRENT_VALUE}, Лимит: {=Variable:LIMIT_VALUE}", Тег уведомления - LIMIT_EXCEEDED_{=Variable:LIMIT_ID}, Дополнительный тег - ALERT\|LIMIT.

Сценарий работы робота

Активити "Отправка системного уведомления" предназначено для использования в роботах и может быть полезно в следующих сценариях:

Уведомление ответственного о важных изменениях в сделке, лиде или другой CRM-сущности;
Напоминания о приближающихся дедлайнах задач и событий;
Информирование руководителей о достижении KPI или превышении лимитов;
Уведомление о необходимости согласования документов;
Автоматическое информирование о статусе выполнения бизнес-процессов;
Отправка персональных отчётов и сводок по расписанию;
Уведомление об ошибках или проблемах в автоматизированных процессах;
Информирование о новых назначениях и изменениях в рабочих задачах.

Отличие системных уведомлений от персональных и сообщений в чат:
- Системное уведомление (im.notify.system.add) - официальное уведомление от системы, отображается в центре уведомлений;
- Персональное уведомление (im.notify.personal.add) - персональное сообщение, больше похоже на личное обращение;
- Сообщение в чат (imbot.message.add) - требует наличия чат-бота, отображается как сообщение в чате.

Используйте системные уведомления для:
- Официальных оповещений о статусах и изменениях;
- Напоминаний о важных событиях;
- Технических уведомлений от автоматизированных процессов;
- Информирования о необходимости действий.

Возвращаемые параметры данного активити:
- Статус отправки (send_status) - Y (успешно) или N (ошибка);
- ID уведомления (notification_id) - числовой идентификатор созданного уведомления (для дальнейшего использования);
- Сообщение об ошибке (s_error_logs) - сообщение о результате выполнения или описание ошибки.

Лучшие практики использования тегов:
1. Используйте уникальные теги для каждого типа уведомлений;
2. Включайте в тег ID документа, чтобы уведомления не смешивались между разными сущностями;
3. Используйте префиксы для категоризации: DEAL_, TASK_, LEAD_, PROJECT_;
4. Добавляйте дату в тег для ежедневных/еженедельных уведомлений;
5. Дополнительный тег используйте для группировки по типам: ALERT|, REPORT|, INFO|, ERROR|.

Ваша корзина пуста

Отправка системного уведомления