Уведомить сотрудников
Робот «Уведомить сотрудников» отправляет системное уведомление одному или нескольким сотрудникам в бизнес-процессах и роботах Битрикс24. Уведомление приходит в колокольчик от имени приложения, а не от конкретного человека. Принимает список получателей и текст с BB-кодами. Возвращает признак «Успешно» Y/N и число отправленных уведомлений.
Робот шлёт уведомление в колокольчик выбранным сотрудникам. В отличие от сообщения в чат, системное уведомление не создаёт диалог и не выглядит как письмо от коллеги: оно приходит от приложения, поэтому подходит для служебных напоминаний. На вход подаются получатели — один или несколько сотрудников, в том числе ответственный из карточки, — и текст уведомления; поддерживаются BB-коды, например жирный шрифт и ссылки. Отделы и группы в поле «Кому» пропускаются: указывайте конкретных людей. Типовые случаи применения: предупредить руководителя о крупной сделке; напомнить ответственному про просроченную задачу; сообщить бухгалтерии, что счёт оплачен. Возвращает «Успешно» = Y, если уведомление получили все адресаты, и число отправленных уведомлений — по нему видно частичную доставку.
Какие параметры принимает робот?
| Параметр | Тип | Обязательный? | По умолчанию |
|---|---|---|---|
| Кому | user | да | |
| Текст уведомления (поддерживает BB-коды) | text | да |
Что возвращает робот?
| Параметр | Тип |
|---|---|
| Успешно (Y/N) | string |
| Отправлено уведомлений | int |
Какие ошибки может вернуть робот?
Эти сообщения робот пишет в журнал бизнес-процесса, когда не может выполнить шаг. По тексту видно, что исправить в настройках или данных.
- Ошибка: не выбран ни один сотрудник (отделы и группы не поддерживаются)
- Ошибка: пустой текст уведомления
- Ошибка: уведомление доставлено {sent} из {total} сотрудников
Сценарий: крупная сделка под контролем руководителя
- Сделка на сумму больше миллиона переходит в стадию «Согласование»
- Робот отправляет руководителю отдела уведомление со ссылкой на сделку
- Руководитель видит его в колокольчике и сразу открывает карточку