Обзор роботов Олчат

Роботы Олчат — это блоки автоматизации в Битрикс24, которые позволяют отправлять сообщения, файлы и другие данные в Telegram и MAX прямо из бизнес-процессов и роботов CRM. С их помощью можно автоматизировать коммуникацию с клиентами на всех этапах воронки продаж.

Что такое роботы Олчат

Роботы Олчат — это действия, которые появляются в редакторе роботов и бизнес-процессов Битрикс24 после установки приложения. Они позволяют:

Отправлять текстовые сообщения, файлы, контакты, геометки и голосовые сообщения
Создавать чаты в открытых линиях
Ожидать ответ от клиента и реагировать на него
Проверять наличие аккаунта в мессенджере по номеру телефона
Управлять диалогами открытых линий
Отправлять сообщения с интерактивными кнопками

Роботы доступны в разделе Олчат при добавлении нового робота в воронку сделок, лидов, контактов или счетов.

Полный список роботов

Робот	Описание
Отправить сообщение	Отправка текстового сообщения контакту
Отправить файл	Отправка файла, изображения или документа
Отправить контакт	Отправка карточки контакта (vCard)
Отправить геометку	Отправка GPS-координат с точкой на карте
Отправить голосовое	Отправка аудиофайла в виде голосового сообщения
Сообщение с кнопками	Отправка сообщения с инлайн-кнопками
Шаблонные кнопки	Отправка предустановленных шаблонов кнопок
Отправить ссылку	Отправка URL с предпросмотром
Проверка телефона	Проверка наличия аккаунта по номеру телефона
Создание чата ОЛ	Создание диалога в открытой линии
Ожидание сообщения	Приостановка БП до получения ответа клиента
Отправка через SMS	Отправка через интерфейс SMS-провайдера Битрикс24

MAX

Робот	Описание
Отправить сообщение	Отправка текстового сообщения контакту
Отправить файл	Отправка файла, изображения или документа
Отправить контакт	Отправка карточки контакта (vCard)
Отправить геометку	Отправка GPS-координат с точкой на карте
Сообщение с кнопками	Отправка сообщения с инлайн-кнопками
Шаблонные кнопки	Отправка предустановленных шаблонов кнопок
Проверка телефона	Проверка наличия аккаунта по номеру телефона
Создание чата ОЛ	Создание диалога в открытой линии
Ожидание сообщения	Приостановка БП до получения ответа клиента
Отправка через SMS	Отправка через интерфейс SMS-провайдера Битрикс24

Управление открытой линией

Робот	Описание
Информация о диалоге	Получение данных о текущем диалоге ОЛ
Перевод диалога	Перевод диалога на другого оператора или очередь
Изменение заголовка чата	Изменение названия чата открытой линии
Управление открытой линией	Принятие, завершение, перехват диалога
Информация о чате	Получение информации из мессенджера

Как добавить робота в воронку

Шаг 1. Откройте настройку роботов

Перейдите в раздел CRM (Сделки, Лиды или другой раздел), выберите нужную стадию воронки и нажмите кнопку Роботы.

Шаг 2. Добавьте робота

Нажмите Добавить на нужной стадии. В открывшемся окне выберите раздел Олчат в левом меню. Выберите нужного робота.

Шаг 3. Настройте параметры

Заполните параметры робота: выберите линию, укажите номер телефона (или другой идентификатор), введите текст сообщения и другие параметры.

Шаг 4. Сохраните настройки

Нажмите Сохранить. Робот начнёт работать при переходе сделки на соответствующую стадию.

Общие понятия

Линия

Линия — это подключённый аккаунт мессенджера (Telegram или MAX), привязанный к открытой линии Битрикс24. Каждый робот требует выбора линии, через которую будет выполняться действие.

Идентификатор получателя

Роботы Олчат поддерживают три способа идентификации получателя:

По номеру телефона — наиболее распространённый способ, телефон берётся из поля CRM-карточки
По ID чата — числовой идентификатор пользователя в мессенджере
По username — имя пользователя без символа @ (только для Telegram)

Подробнее о работе с номерами телефонов: Особенности номеров.

Публикация в открытую линию

Большинство роботов отправки поддерживают три режима публикации:

Режим	Описание
Входящим сообщением	Сообщение появляется в открытой линии как входящее
Исходящим сообщением	Сообщение появляется как исходящее от оператора
Без публикации	Сообщение отправляется в мессенджер, но не отображается в ОЛ

Запись в CRM

Опция Записать в CRM карточку добавляет запись об отправке в таймлайн CRM-карточки (сделки, лида, контакта). По умолчанию включена.

Асинхронное выполнение

Все роботы Олчат выполняются асинхронно (с использованием механизма подписки USE_SUBSCRIPTION). Это означает, что бизнес-процесс ожидает результат выполнения робота, прежде чем перейти к следующему шагу.

Подробнее: Настройки роботов.

Робот и действие бизнес-процесса

Роботы Олчат доступны в двух местах:

Роботы CRM — упрощённый интерфейс автоматизации в воронках сделок, лидов, контактов и счетов
Дизайнер бизнес-процессов — полнофункциональный конструктор для сложных сценариев

В обоих случаях используются одни и те же роботы Олчат, но интерфейс настройки может отличаться.

Возвращаемые значения

Каждый робот после выполнения возвращает набор значений, которые можно использовать в последующих роботах или условиях. Стандартные возвращаемые значения:

Значение	Тип	Описание
`is_sent`	bool	Результат отправки: `Y` (успешно) или `N` (ошибка)
`error`	string	Текст ошибки (если `is_sent = N`)
`error_code`	string	Код ошибки для программной обработки
`chat_id`	string	ID чата получателя (для роботов отправки)
`message_id`	string	ID отправленного сообщения

Подробнее о возвращаемых значениях каждого робота смотрите в соответствующих разделах. Полный список кодов ошибок: Описание ошибок.

Что дальше

Настройки роботов — общие настройки и параметры всех роботов
Переменные в роботах — как использовать поля CRM и результаты предыдущих роботов
Особенности номеров — правильный формат телефонных номеров
Отладка и поиск ошибок — как находить и исправлять проблемы