Настройки роботов

Все роботы Олчат имеют ряд общих настроек, которые влияют на их поведение. В этом разделе описаны параметры, актуальные для всех или большинства роботов.

Выбор линии

Большинство роботов Олчат требуют выбора линии — подключённого аккаунта мессенджера. Линия определяет:

• Через какой мессенджер (Telegram или MAX) будет выполнено действие
• Через какой аккаунт будет отправлено сообщение или выполнен запрос
• К какой открытой линии Битрикс24 привязан результат

При настройке робота в поле Линия отображается выпадающий список доступных линий. Каждая линия подписана номером и названием.

Заметка

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

Тип идентификатора

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

Тип	Описание	Telegram	MAX
По номеру телефона	Поиск по номеру телефона в международном формате	Да	Да
По ID чата	Числовой идентификатор пользователя в мессенджере	Да	Да
По username	Имя пользователя без @	Да	Нет

По умолчанию выбран тип По номеру телефона — наиболее распространённый для CRM-сценариев.

Совет

Если вы знаете ID чата получателя (например, из робота Проверка телефона), используйте тип По ID чата — это наиболее надёжный способ идентификации.

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

Все роботы Олчат используют механизм подписки (USE_SUBSCRIPTION = Y). Это означает:

1. Робот запускает операцию и возвращает токен ожидания
2. Битрикс24 приостанавливает бизнес-процесс
3. По завершении операции Олчат отправляет результат через bizproc.event.send
4. Бизнес-процесс продолжает выполнение с полученными результатами

Такой подход обеспечивает:

• Надёжность — результат гарантированно возвращается в бизнес-процесс
• Доступ к возвращаемым значениям — переменные is_sent, error, chat_id и другие доступны в последующих роботах
• Корректная обработка ошибок — при ошибке бизнес-процесс получает код и описание

Заметка

Из-за асинхронного выполнения между запуском робота и получением результата проходит небольшое время (обычно 1-5 секунд). Это нормальное поведение.

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

Роботы отправки сообщений поддерживают три режима публикации:

Режим	Описание	Когда использовать
Входящим сообщением	Сообщение появляется в ОЛ как входящее	По умолчанию; чтобы оператор видел отправку в чате
Исходящим сообщением	Сообщение появляется как исходящее от оператора	Когда робот действует от имени оператора
Без публикации	Сообщение отправляется только в мессенджер	Когда не нужно отображать в ОЛ

Запись в CRM карточку

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

Запись содержит:

• Тип действия (отправка сообщения, файла и т.д.)
• Краткое содержание (текст сообщения, имя файла)
• Статус (успешно / ошибка)

Скрытые роботы

Некоторые роботы Олчат могут быть скрыты из интерфейса выбора роботов, но остаются доступными через API. Скрытие управляется параметром is_hidden в настройках Олчат. Это позволяет:

• Упростить список доступных роботов для операторов
• Скрыть продвинутые роботы от неопытных пользователей
• Сохранить работоспособность ранее настроенных роботов

Заметка

Параметр is_hidden влияет только на отображение в интерфейсе Олчат и не влияет на видимость робота в Битрикс24. Робот, зарегистрированный в Битрикс24, всегда доступен в редакторе роботов CRM.

Уведомление о наборе текста

Для роботов отправки сообщений в MAX доступна опция Уведомление о наборе текста. При включении перед отправкой сообщения получатель видит статус «печатает…» в течение указанного количества секунд (от 1 до 20).

Это создаёт впечатление живого общения и полезно в автоматизированных диалоговых сценариях.

Отключение превью ссылок

Для Telegram доступна опция Отключить превью ссылок. При включении URL в тексте сообщения не будут сопровождаться предпросмотром (заголовок, описание, изображение страницы).

Что дальше

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