Сообщение в чат
Робот «Сообщение в чат» отправляет сообщение в групповой чат, чат проекта или личный чат с сотрудником в бизнес-процессах и роботах Битрикс24. Сообщение уходит от имени администратора, установившего робота. Принимает ID чата и текст с форматированием. Возвращает признак «Успешно» Y/N и ID отправленного сообщения.
Робот пишет в мессенджер Битрикс24 из бизнес-процесса: в рабочий чат отдела, в чат проекта или лично сотруднику. Штатное уведомление приходит в колокольчик, а здесь сообщение попадает в ленту чата, где его видят все участники и могут ответить. На вход подаются чат и текст. Чат указывается как chat123 или просто 123 для группового чата, sg12 для чата проекта и user_5 для личного чата с сотрудником; если в поле только число, отдельная настройка определяет, считать его ID чата или ID сотрудника. Сообщение отправляется от имени администратора, установившего робота, и он должен состоять в чате. Типовые случаи применения: сообщить отделу продаж о новой заявке с сайта; отправить в чат проекта отметку о смене стадии; написать ответственному лично. Возвращает «Успешно» Y/N и ID сообщения для следующих шагов.
Какие параметры принимает робот?
| Параметр | Тип | Обязательный? | По умолчанию |
|---|---|---|---|
| Чат: chat123 или 123 — групповой чат, sg12 — чат проекта, user_5 — личный чат с сотрудником | string | да | |
| Как понимать число без префикса | select | — | chat |
| Текст сообщения (уходит от имени администратора, установившего робота; он должен состоять в чате) | text | да |
Что возвращает робот?
| Параметр | Тип |
|---|---|
| Успешно (Y/N) | string |
| ID сообщения | int |
Какие ошибки может вернуть робот?
Эти сообщения робот пишет в журнал бизнес-процесса, когда не может выполнить шаг. По тексту видно, что исправить в настройках или данных.
- Ошибка: чат не распознан — укажите chat123, 123, sg12 или user_5
- Ошибка: пустой текст сообщения
- Ошибка отправки: проверьте, что чат существует и администратор, установивший робота, состоит в нём
Сценарий: новая заявка в чат отдела продаж
- С сайта приходит лид с пометкой «срочно»
- Робот отправляет в чат отдела сообщение с именем клиента и ссылкой на лид
- Свободный менеджер отвечает в чате и берёт лид в работу