Отправить персональные уведомления пользователям Битрикс24

Данное активити позволяет отправлять персональные уведомления пользователям Битрикс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. Это необязательный параметр. Если не задано, то используется поле "Текст уведомления". Пример: {=Variable:EMAIL_TEXT}.

Когда использовать отдельный текст для почты:
- Если основной текст содержит BB-коды, которые некорректно отображаются в email;
- Когда нужен более развёрнутый текст для почтового уведомления;
- Для добавления дополнительных ссылок и контактов в email-версию;
- Если нужен упрощённый текст без форматирования для почты.

Тег уведомления: В данном поле указывается тег, уникальный в рамках системы. Это необязательный параметр, но очень важный для контроля дублирования уведомлений. Пример: {=Variable:NOTIFICATION_TAG} или "PERSONAL_DEAL_123".

Важно (особенности работы тегов): При добавлении уведомления с существующим тегом другие уведомления с таким же тегом будут удалены. Это позволяет избежать дублирования однотипных уведомлений у пользователя.

Примеры использования тегов:
- TAG="PERSONAL_DEAL_123" - для персональных уведомлений о конкретной сделке;
- TAG="PERSONAL_TASK_456" - для личных напоминаний о задаче;
- TAG="WELCOME_MESSAGE" - для приветственных сообщений;
- TAG="BIRTHDAY_GREETING_2025" - для персональных поздравлений.

Если отправить новое уведомление с тем же тегом, старое уведомление с этим тегом удалится автоматически.

Дополнительный тег: В данном поле указывается дополнительный тег, без проверки на уникальность. Это необязательный параметр. Используется для дополнительной классификации уведомлений. Пример: {=Variable:SUB_TAG} или "TYPE|PERSONAL".

Отличие от основного тега:
- Основной тег (TAG) - проверяется на уникальность, удаляет предыдущие уведомления с таким же тегом;
- Дополнительный тег (SUB_TAG) - НЕ проверяется на уникальность, используется только для группировки.

Примеры использования дополнительного тега:
- SUB_TAG="TYPE|PERSONAL" - тип персонального сообщения;
- SUB_TAG="CATEGORY|GREETING" - категория приветствий;
- SUB_TAG="EVENT|BIRTHDAY" - событие день рождения;
- SUB_TAG="PRIORITY|HIGH" - высокий приоритет.

Вложение: В данном поле можно указать вложение к уведомлению в формате Битрикс24. Это необязательный параметр. Используется для передачи структурированных данных в уведомлении. Пример: {=Variable:ATTACH}.

Формат вложений: Вложения передаются в специальном формате Битрикс24 Attach, который позволяет создавать изображения, ссылки, файлы, сетки с данными, форматированные блоки информации. Подробнее о формате вложений можно узнать в документации Битрикс24 REST API (раздел im.attach).

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения.
Возвращаемые параметры для данного активити:
- Сообщение об ошибке.

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

Отправить персональные уведомления пользователям Битрикс24