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

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

Функции переменных и констант 

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

Системные

Данные в такой переменной появляются в момент получения сообщения от клиента. Системные переменные содержат информацию о диалоге:

• Мессенджеры — доступные мессенджеры, используются в блоке «Отправка сообщения *»;
• Линии — доступные линии, используются в блоке «Отправка сообщения *»;
• 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;
• email — почтовый адрес, с которого пришло сообщение;
• file_in_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);
• name — имя клиента (указать как в ChatApp Dialog);
• name_chat — имя чата, из которого отправили сообщение;
• outgoing_side — показывает, если последнее сообщение является исходящим;
• phone — номер телефона, с которого пришло сообщение;
• responsible — ID ответственного за диалог сотрудника;
• sender — проверка отправителя: сотрудник или робот. Возможные значения поля sender: employee, system;
• tag — метка диалога, используется только в блоке «Условие»;
• username — username клиента.

Диалоговые

Значение такой переменной уникально для каждого диалога. Например, если бот ведет одновременно 2 диалога, изменение локальной переменной в одном диалоге не повлияет на значение такой же переменной в другом диалоге.

Локальную переменную можно создать и изменить. Для этого:

1. Зайдите в редактор сценариев;
2. В углу справа нажмите «Переменные»;
3. Кликните по или по уже существующей переменной;
4. Выберите тип данных;
5. Введите название и значение (можно сохранить с пустым значением);
6. Нажмите «Сохранить».

Глобальная

Значение глобальной переменной одно для всех диалогов. Ее можно создать и изменить. Глобальной переменной, например, является линия или мессенджер, в котором сейчас общается бот. 

Для этого:

1. Зайдите в редактор сценариев;
2. В углу справа нажмите «Переменные»;
3. Кликните по или по уже существующей переменной;
4. Выберите тип переменной;
5. Выберите тип данных;
6. Введите название и значение;
7. Нажмите сохранить.

Константа 

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

Использование переменных в тексте

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

Использование переменных доступно в следующих блоках:

• Отправить сообщение
• Отправка сообщения*
• Отправка webhook
• Открыть диалог
• Закрыть диалог

Если будет выбрана локальная или системная переменная, но значение будет недоступно, то ничего не подставляется.

Видеоурок

Видеоурок о работе с переменными и константами в Конструторе ботов:

*Instagram принадлежит Meta, признанной в Российской Федерации экстремистской организацией