Отправить персональные уведомления пользователям Битрикс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).
Делать отладочные сообщения в журнал БП	Варианты да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. Важно: ID отправителя берётся из поля "Запускать от имени". Уведомление будет отправлено от имени пользователя, указанного в этом поле.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

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

Описание примера	Решение
Поздравление с днём рождения	Параметры: ID пользователя получателя - {=Document:ID} (ID сотрудника), Текст персонального уведомления - "🎉 Поздравляем с Днём рождения, {=Document:NAME}! Желаем крепкого здоровья, профессиональных успехов и достижения всех целей!", Текст уведомления для почты - "Уважаемый {=Document:NAME}! От лица всего коллектива поздравляем Вас с Днём рождения! Желаем счастья, здоровья и новых профессиональных достижений.", Тег уведомления - BIRTHDAY_{=Document:ID}_{=Variable:current_year}, Дополнительный тег - EVENT\|BIRTHDAY.
Приветствие нового сотрудника	Параметры: ID пользователя получателя - {=Document:ID} (ID нового сотрудника), Текст персонального уведомления - "Добро пожаловать в команду, {=Document:NAME}! 👋 Мы рады видеть Вас в нашей компании. Если возникнут вопросы, обращайтесь к своему наставнику или в отдел кадров.", Текст уведомления для почты - "Здравствуйте, {=Document:NAME}! Добро пожаловать в нашу компанию! В этом письме Вы найдете основную информацию для начала работы...", Тег уведомления - WELCOME_MESSAGE_{=Document:ID}, Дополнительный тег - TYPE\|WELCOME.
Персональное напоминание о встрече	Параметры: ID пользователя получателя - {=Document:ATTENDEE_ID} (ID участника встречи), Текст персонального уведомления - "📅 {=Document:ATTENDEE_NAME}, через 30 минут у Вас встреча: '{=Document:EVENT_NAME}'. Место: {=Document:LOCATION}. Не забудьте подготовить необходимые материалы!", Тег уведомления - MEETING_REMINDER_{=Document:EVENT_ID}_{=Document:ATTENDEE_ID}, Дополнительный тег - TYPE\|REMINDER.
Благодарность за выполненную работу	Параметры: ID пользователя получателя - {=Document:RESPONSIBLE_ID} (ответственный за задачу), Текст персонального уведомления - "⭐ {=Document:RESPONSIBLE_NAME}, благодарим за отличную работу над задачей '{=Document:TITLE}'! Ваш профессионализм и ответственный подход высоко ценятся командой.", Тег уведомления - THANK_YOU_{=Document:ID}, Дополнительный тег - TYPE\|GRATITUDE.
Уведомление о бонусе	Параметры: ID пользователя получателя - {=Document:USER_ID}, Текст персонального уведомления - "💰 Отличная новость, {=Document:USER_NAME}! Вам начислен бонус в размере {=Document:BONUS_AMOUNT} руб. за {=Document:REASON}. Продолжайте в том же духе!", Текст уведомления для почты - "Уважаемый {=Document:USER_NAME}! Информируем Вас о начислении премии в размере {=Document:BONUS_AMOUNT} руб. Основание: {=Document:REASON}.", Тег уведомления - BONUS_NOTIFICATION_{=Document:USER_ID}_{=Variable:timestamp}, Дополнительный тег - TYPE\|BONUS.
Персональные поздравления с годовщиной работы	Параметры: ID пользователя получателя - {=Document:USER_ID}, Текст персонального уведомления - "🎊 {=Document:USER_NAME}, поздравляем с {=Document:YEARS} летним юбилеем работы в компании! Благодарим за преданность и профессионализм!", Тег уведомления - ANNIVERSARY_{=Document:USER_ID}_{=Document:YEARS}, Дополнительный тег - EVENT\|ANNIVERSARY.
Индивидуальное информирование о результатах выполнения задач	Параметры: ID пользователя получателя - {=Document:RESPONSIBLE_ID}, Текст персонального уведомления - "✅ Задача '{=Document:TITLE}' успешно выполнена! Результат: {=Variable:RESULT}. Отличная работа!", Тег уведомления - TASK_COMPLETE_{=Document:ID}, Дополнительный тег - TYPE\|TASK_STATUS.
Личное напоминание о необходимости выполнения действий	Параметры: ID пользователя получателя - {=Document:ASSIGNED_BY_ID}, Текст персонального уведомления - "⏰ {=Document:ASSIGNED_BY_PRINTABLE}, напоминаем о необходимости выполнить действие по сделке '{=Document:TITLE}'. Срок истекает {{=dateadd({=Document:CLOSEDATE}, '-1d')}}.", Тег уведомления - ACTION_REMINDER_{=Document:ID}, Дополнительный тег - TYPE\|REMINDER.
Индивидуальное сообщение при назначении ответственным	Параметры: ID пользователя получателя - {=Document:NEW_ASSIGNED_BY_ID}, Текст персонального уведомления - "👤 {=Document:NEW_ASSIGNED_BY_PRINTABLE}, Вы назначены ответственным за сделку '{=Document:TITLE}'. Сумма: {=Document:OPPORTUNITY} руб.", Тег уведомления - DEAL_ASSIGNED_{=Document:ID}, Дополнительный тег - TYPE\|ASSIGNMENT.
Персональное уведомление о достижении цели	Параметры: ID пользователя получателя - {=Document:USER_ID}, Текст персонального уведомления - "🏆 {=Document:USER_NAME}, поздравляем с достижением цели! Вы выполнили план продаж на {=Variable:PERCENT}%. Так держать!", Тег уведомления - GOAL_ACHIEVED_{=Document:USER_ID}_{=Variable:MONTH}, Дополнительный тег - TYPE\|ACHIEVEMENT.

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

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

Персональные поздравления сотрудников с днём рождения или годовщиной работы;
Личные напоминания о важных встречах и мероприятиях;
Индивидуальное информирование о результатах выполнения задач;
Персональные благодарности и поощрения от руководства;
Личные уведомления о бонусах, премиях и достижениях;
Приветственные сообщения для новых сотрудников;
Персональные напоминания о необходимости выполнения действий;
Индивидуальные сообщения при назначении ответственным за задачу или сделку.

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

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

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

Лучшие практики использования персональных уведомлений:
1. Используйте обращение к пользователю по имени для создания дружественной атмосферы;
2. Персонализируйте текст в зависимости от контекста и получателя;
3. Используйте эмодзи для создания более живого и дружелюбного стиля общения;
4. Для важных формальных уведомлений лучше использовать системные уведомления;
5. Применяйте уникальные теги для предотвращения спама и дублирования сообщений.

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

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