Переменные и константы в Конструкторе ботов

Переменная — это хранилище данных, которому присвоено имя. В переменные можно внести значения и использовать, например, для обращения к клиенту по имени. Чтобы воспользоваться переменными, зайдите в Конструктор ботов. В редакторе сценариев доступны локальные, системные и глобальные переменные, а также константы. Локальные, глобальные и константы можно создавать и изменять вручную, системные — нет. Системные Данные в такой переменной появляются в момент получения сообщения от клиента. Системные переменные содержат информацию о диалоге:

Мессенджеры — доступные мессенджеры, используются в блоке «Отправка сообщения *»;
Линии — доступные линии, используются в блоке «Отправка сообщения *»;
chat_is_open — статус чата: закрыт — «False» или открыт — «True»;
company_id — ID компании, к которой привязан бот;
date — текущая дата в часовом поясе компании в формате %d.%m.%Y;
datetime — текущая дата и время в часовом поясе компании в формате %d.%m.%Y %H:%M:%S;
time — текущее время в часовом поясе компании в формате %d.%m.%Y %H:%M:%S;
day_of_week — день недели в часовом поясе компании, возможные значения: Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday;
day_of_month — день месяца в числовом формате, например, 27;
email — почтовый адрес, с которого пришло сообщение;
file_in_message — проверка наличия файла в сообщении;
file_link — ссылка на файл;
file_or_message — текст сообщения либо ссылка на файл;
from_app_id — ID приложения или CRM-системы, из которых пришло сообщение (возможные значения — bitrix, amo, yclients, altegio, null, native, webchat, mobileapp, cabinet, msbot, app_ );
from_side — отправитель сообщения, возможные значения: out, in. В некоторых случаях может быть пустое;
id_chat — ID диалога с клиентом;
license_id — линия, на которую пришло сообщение;
link — ссылка на объявление Авито (начиная с https://);
message — текст сообщения;
messenger_type — канал или email, с которого пришло сообщение. Нужно сделать условие вида messenger_type = и указать одно из возможных значений: WhatsApp (WhatsApp Business Api), grWhatsApp (WhatsApp WEB), caWhatsApp (WhatsApp Cloud API), ViberBot, Telegram, TelegramBot, Avito, Vkontakte, Instagram*, Facebook*, vkNotify, email);
month_eng — обозначение месяца на английском языке;
month_ru — обозначение месяца на русском языке;
name — имя клиента (указать как в Scenario Dialogs);
name_chat — имя чата, из которого отправили сообщение;
outgoing_side — показывает, если последнее сообщение является исходящим;
phone — номер телефона, с которого пришло сообщение;
responsible — ID ответственного за диалог сотрудника;
sender — проверка отправителя: сотрудник или робот. Возможные значения поля sender: employee, system;
tag — метка диалога, используется только в блоке «Условие»;
telegram_subtype — указание Telegram bot или Telegram Business аккаунт;
username — username клиента.

Системные переменные даты и времени можно использовать отдельно от сообщения клиента. Если сообщения от клиента нет, то берутся текущие дата и время зоны GMT+3. Если сообщение от клиента пришло, то из часового пояса компании.


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

Диалоговые Значение такой переменной уникально для каждого диалога. Например, если бот ведет одновременно 2 диалога, изменение локальной переменной в одном диалоге не повлияет на значение такой же переменной в другом диалоге. Локальную переменную можно создать и изменить. Для этого: 1. Зайдите в редактор сценариев. 2. В углу справа нажмите «Переменные».

3. Кликните по

или по уже существующей переменной. 4. Выберите тип данных. 5. Введите название и значение (можно сохранить с пустым значением).

6. Нажмите «Сохранить». Глобальные Значение глобальной переменной одно для всех диалогов. Ее можно создать и изменить. Глобальной переменной, например, является линия или мессенджер, в котором сейчас общается бот. Для этого: 1. Зайдите в редактор сценариев. 2. В углу справа нажмите «Переменные».

3. Кликните по

или по уже существующей переменной. 4. Выберите тип переменной. 5. Выберите тип данных. 6. Введите название и значение.

7. Нажмите сохранить. Константа Константа — это величина, которая при выполнении программы остается неизменной. Ее свойства такие же, как у глобальной, но она не может быть изменена в процессе диалога.


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

Использование переменных в тексте В редакторе можно использовать переменные в тексте сообщения. Обозначается переменная двойными скобками {{var}}, а на ее место подставляется значение из переменной. В качестве переменной можно задать любую существующую переменную. Если будет выбрана локальная или системная переменная, но значение будет недоступно, то ничего не подставляется.