Переменные в роботах

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

Переменные полей CRM

Основной источник данных для роботов — поля CRM-карточки. Они подставляются через выбор из списка или вставку шаблона.

Как вставить переменную

При заполнении параметра робота нажмите кнопку «…» (три точки) справа от поля ввода. Откроется окно выбора переменных.

Стандартные поля CRM

Переменная	Описание
`{{Имя}}`	Имя контакта
`{{Фамилия}}`	Фамилия контакта
`{{Телефон}}`	Номер телефона
`{{Email}}`	Адрес электронной почты
`{{ID}}`	ID сущности (сделки, лида)
`{{Название}}`	Название сделки или лида
`{{Стадия}}`	Текущая стадия
`{{Сумма}}`	Сумма сделки
`{{Ответственный}}`	Ответственный сотрудник

Пользовательские поля

Пользовательские поля CRM также доступны как переменные. Они отображаются в окне выбора с названиями, заданными при создании поля.

Результаты предыдущих роботов

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

Как использовать результаты

Добавьте робота (например, Проверка телефона)
В следующем роботе или условии выберите переменные из результатов предыдущего робота

Пример: проверка и отправка

Робот 1: [Telegram] Найти аккаунт
  → Возвращает: found, user_id, username, first_name

Условие: если found = Y
  → Робот 2: [Telegram] Отправить сообщение
    → Получатель: {=Результат робота 1 > user_id}
    → Тип идентификатора: По ID чата

Доступные результаты по роботам

Каждый робот Олчат возвращает свой набор значений. Наиболее часто используемые:

Робот	Полезные результаты
Проверка телефона	`found`, `user_id`, `username`, `first_name`
Отправить сообщение	`is_sent`, `chat_id`, `message_id`
Создать ОЛ чат	`is_sent`, `dialog_id`, `chat_id`
Ожидание ответа	`received_message`, `wake_reason`, `timed_out`
Информация о диалоге	`status`, `operator_id`, `crm_deal_id`

Системные переменные

В бизнес-процессах доступны системные переменные Битрикс24:

Переменная	Описание
`{{Текущая дата}}`	Текущая дата
`{{Текущее время}}`	Текущее время
`{{Кто запустил}}`	Пользователь, запустивший процесс
`{{ID документа}}`	ID обрабатываемого документа

Форматирование переменных

Переменные подставляются как есть. Если нужно изменить формат, используйте возможности бизнес-процессов Битрикс24:

Конкатенация строк для объединения нескольких переменных
Условное форматирование через дополнительные блоки
Математические вычисления для числовых значений

Пример персонализированного сообщения

Здравствуйте, {{Имя}}!

Ваша сделка «{{Название}}» на сумму {{Сумма}} руб.
переведена на стадию «{{Стадия}}».

Ваш менеджер: {{Ответственный}}

Примечания и рекомендации

Переменные доступны как в роботах CRM, так и в дизайнере бизнес-процессов
В дизайнере бизнес-процессов дополнительно доступны переменные процесса и параметры шаблона
Результаты роботов доступны только для роботов, расположенных на той же или последующих стадиях