Сообщение в чат Битрикс24
Отправляет текст выбранным пользователям и чатам Битрикс24.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую проблему решает
Робот полезен для координатора, уведомляющего сотрудников или рабочие чаты о событии CRM. Ответственные узнают о согласовании с задержкой, потому что менеджер вручную пишет в несколько диалогов. Робот отправляет подготовленный текст выбранным пользователям и чатам.
Что делает и когда применять
Отправляет текст выбранным пользователям и чатам Битрикс24.
Можно указать несколько получателей и системный формат сообщения. Все получатели проверяются перед отправкой; ошибка хотя бы одной отправки отражается в результате.
Что подготовить
Нужен установленный робот из приложения «CRM роботы 2.0 + AI» и право на настройку автоматизации нужной CRM-воронки или шаблона бизнес-процесса. Пользователю, от имени которого работает приложение, должны быть доступны выбранные CRM-элементы и нужное действие с ними.
Соберите правильные ID чатов или личных диалогов и ID пользователей. Укажите хотя бы одного получателя и проверьте доступ отправляющего пользователя. Выберите обычный или системный формат сообщения.
Как настроить и использовать
- Откройте автоматизацию нужной сущности и выберите стадию, на которой нужен робот «Сообщение в чат Битрикс24». В шаблоне бизнес-процесса добавьте одноимённое действие.
- Соберите правильные ID чатов или личных диалогов и ID пользователей. Укажите хотя бы одного получателя и проверьте доступ отправляющего пользователя. Выберите обычный или системный формат сообщения.
- Заполните Пользователи, Текст сообщения, Системное сообщение. Для рабочего сценария подставьте значения полей документа или результаты предыдущих действий вместо учебных данных ниже.
- Проверьте обязательные поля и варианты выбора в таблице настроек. Сохраните действие и свяжите его результаты с дальнейшими условиями процесса.
- Выполните пробный запуск на отдельном учебном элементе. Сначала проверьте статус и пояснение ошибки, затем содержательный результат и ветку, выбранную следующим действием.
Параметры робота
В полях формы, которые допускают несколько значений, добавляйте каждое значение отдельным элементом через редактор. Обычные текстовые, числовые и списковые поля заполняйте в указанном для них формате.
Имена полей ниже совпадают с настройками действия. Значения из таблицы относятся к самому роботу; результаты предыдущих шагов выбирайте через подстановку значения в редакторе.
| Поле в настройках | Что передать | Обязательность и исходное значение |
|---|---|---|
ID чатов или личных диалогов (chatId) |
Формат: строка. Можно передать несколько значений. | Необязательно. Значение по умолчанию в настройках не задано |
Пользователи (userId) |
Формат: user. Можно передать несколько значений. | Необязательно. Значение по умолчанию в настройках не задано |
Текст сообщения (text) |
Формат: текст. | Обязательно. Значение по умолчанию в настройках не задано |
Системное сообщение (system) |
Формат: да/нет. | Обязательно. Значение по умолчанию в настройках не задано |
Учебный пример
Пример показывает способ настройки на вымышленных данных и ожидаемый смысл результата; это не отчёт о запуске на вашем портале.
- Пользователи (
userId):[17]. - Текст сообщения (
text):Учебный заказ согласован; проверьте задачу на исполнение.. - Системное сообщение (
system):N.
При корректном получателе 17 сервис принимает отправку сообщения в его диалог. Все получатели проверяются до отправки, но ошибка одной из отправок всё равно отражается в результате. Автоматического подтверждения прочтения результат не содержит.
Какие данные возвращает и что делать дальше
| Результат | Какое значение получает следующий шаг |
|---|---|
Статус выполнения (status) |
да/нет |
Пояснение ошибки (error) |
строка |
Связывайте следующий шаг со статусом отправки и фиксируйте ошибку для разбора. При неясном результате сначала проверьте диалоги, чтобы повторный запуск не отправил одинаковый текст ещё раз.
Ошибки и ограничения
Проверяйте результат действия до следующего изменения карточки. Ошибка доступа, неверный идентификатор и отсутствие найденного элемента требуют разных веток процесса. Не подставляйте нулевой или пустой результат как идентификатор существующего документа.