Создание сообщения в чат от робота

Активити (робот) «Создание сообщения в чат от робота» предназначено для использования в роботах и может быть полезно в следующих сценариях: автоматические ответы в чатах открытых линий, диалоги с кнопками выбора, отправка уведомлений от чат-бота без ожидания ответа и сбор ответа пользователя для дальнейшей обработки в бизнес-процессе.
Сообщение отправляется от имени указанного чат-бота. Активити (робот) поддерживает паузу с индикатором набора текста, до трёх кнопок в одном сообщении и три режима работы — с ожиданием ответа и без него.

Как работает активити (робот):
- Указываете ID чат-бота, ID чата (или он определяется автоматически из последнего события бота) и Текст сообщения;
- Выбираете Вариант работы чат-бота: без кнопок с ожиданием, без кнопок без ожидания или с кнопками и ожиданием нажатия;
- При необходимости задаёте Паузу перед отправкой — перед отправкой показывается индикатор «печатает»;
- В режимах с ожиданием бизнес-процесс приостанавливается до ответа пользователя или нажатия кнопки.

Сценарий работы активити бизнес-процесса

Важно:
- На портале должен быть создан и установлен чат-бот, его ID указывается в параметре «ID чат-бота»;
- Если поле «ID чата» не заполнено, активити (робот) попытается взять ID чата из последнего события ONIMBOTMESSAGEADD для указанного бота;
- В режиме «с кнопками и ожидать ответ» заполняется хотя бы одна кнопка; при нажатии возвращается номер нажатой кнопки;
- В режиме «без кнопок и ожидать ответ» возвращается текст ответа пользователя в поле answer_user;
- Пауза перед отправкой блокирует выполнение робота на указанное количество секунд — используйте её умеренно в массовых сценариях.

Описание параметров активити (робота)

Название поля	Описание и примеры использования
ID чат-бота	Обязательный параметр. Числовой идентификатор чат-бота на портале. Примеры: - {=Variable:BOT_ID} — ID из переменной или предыдущего шага; - 15 — фиксированный ID бота техподдержки.
ID чата	Необязательный параметр. Числовой идентификатор чата, куда отправляется сообщение. Примеры: - {=Variable:CHAT_ID} — из робота «Получение ID чата по сущности»; - 1489 — ID группового чата; - оставить пустым — если робот запущен в контексте диалога с ботом, ID может определиться автоматически из последнего события ONIMBOTMESSAGEADD.
Вариант работы чат-бота	Обязательный параметр. Доступные значения: - отправить сообщение без кнопок и ожидать ответ — БП ждёт текстовый ответ пользователя; - отправить сообщение без кнопок и не ожидать ответа — сообщение отправляется, БП продолжается сразу; - отправить сообщение с кнопками и ожидать ответ — БП ждёт нажатия одной из кнопок.
Текст сообщения	Обязательный параметр. Текст, который увидит пользователь в чате. Примеры: - Здравствуйте! Уточните, пожалуйста, номер вашего заказа; - Обращение {=Document:ID} принято в работу. Ожидайте ответа специалиста; - {=Variable:BOT_MESSAGE} — текст из переменной.
Пауза перед отправкой сообщения (в секундах)	Необязательный параметр. Перед отправкой бот показывает индикатор «печатает» и ждёт указанное время. Примеры: 3 — короткая пауза для естественности диалога; 10 — дать пользователю прочитать предыдущее сообщение.
Название кнопки 1 / 2 / 3	Необязательные параметры. Используются только при варианте «с кнопками и ожидать ответ». Заполните от одной до трёх кнопок. Примеры: Да, Нет, Перезвоните позже; Согласовано, На доработку, Отмена.
Стиль кнопки 1 / 2 / 3	Необязательный параметр для каждой кнопки. Предустановленные стили интерфейса Битрикс24: Базовый, Основной, Вторичный, Предупреждение. Если стиль не указан, используется «Базовый».
Цвет кнопки 1 / 2 / 3	Необязательный параметр. Устаревший способ задания цвета в формате HEX без решётки (например, d2f95f). При наличии «Стиля кнопки» предпочтительнее использовать стиль.

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

Описание примера	Решение
Приветствие в открытой линии без ожидания ответа	ID чат-бота = {=Variable:BOT_ID}, ID чата = {=Variable:CHAT_ID}, Вариант = без кнопок и не ожидать ответа, Текст = Добрый день! Мы получили ваше обращение и скоро ответим.
Запросить у клиента номер заказа и дождаться ответа	Вариант = без кнопок и ожидать ответ, Текст = Укажите, пожалуйста, номер заказа. После ответа используйте {=Variable:answer_user} в следующем шаге.
Согласование через кнопки «Да» и «Нет»	Вариант = с кнопками и ожидать ответ, Название кнопки 1 = Да, Стиль = Основной, Название кнопки 2 = Нет, Стиль = Предупреждение, Текст = Подтверждаете выполнение заявки {=Document:ID}?
Три варианта ответа для оператора	Кнопка 1 = Принято, Кнопка 2 = Передано специалисту, Кнопка 3 = Отложено, Текст = Выберите статус обработки обращения. Проверяйте button_pressed: 1, 2 или 3.
Отправка с паузой «печатает»	Пауза = 5, Вариант = без кнопок и не ожидать ответа, Текст = Формирую ответ по вашему запросу...
Сообщение в чат CRM-сущности	ID чата = {=Variable:CHAT_ID} из робота «Получение ID чата по сущности», Вариант = без кнопок и не ожидать ответа, Текст = По элементу {=Document:TITLE} назначен ответственный {=Document:ASSIGNED_BY_ID}.
Автоопределение чата из диалога с ботом	ID чат-бота = 15, ID чата оставить пустым, Вариант = без кнопок и ожидать ответ, Текст = Уточните тему обращения. Чат определится из последнего события бота.
Обработка ответа пользователя в переменную	После шага с ожиданием ответа сохраните answer_user в переменную {=Variable:CLIENT_REPLY} и используйте в условии или следующем роботе.
Разветвление БП по нажатой кнопке	После шага с кнопками добавьте условие: если button_pressed = 1 — ветка «Согласовано», если 2 — «Отклонено», если 3 — «Отложено».
Уведомление в групповой чат проекта от бота	ID чат-бота = {=Variable:PROJECT_BOT}, ID чата = 2156, Вариант = без кнопок и не ожидать ответа, Текст = Статус проекта обновлён: {=Variable:STATUS_TEXT}.

Важно о возвращаемых параметрах:
- В режиме «без кнопок и не ожидать ответа» поля answer_user и button_pressed будут пустыми;
- В режиме с кнопками button_pressed содержит номер нажатой кнопки (1, 2 или 3);
- Поле id_chat возвращает числовой ID чата, в который было отправлено сообщение.

Возвращаемые параметры данного активити:
- Ответ пользователя (answer_user) — текст ответа в режиме ожидания без кнопок;
- Какая кнопка нажата (button_pressed) — номер кнопки (1, 2 или 3) в режиме с кнопками;
- ID привязанной сущности (document_id) — ID документа, связанного с контекстом диалога;
- ID чата (id_chat) — числовой идентификатор чата, куда отправлено сообщение.

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

Создание сообщения в чат от робота