Переменная — это хранилище данных, которому мы присваиваем имя. А далее это хранилище мы заполняем данными и можем ими воспользоваться, например обратится в боте к клиенту по имени.
Функции переменных и констант
В редакторе доступны локальные, системные и глобальные переменные, а также константа. Локальные, глобальные и константы можно создавать и изменять в ручную, системные — нет.
Системные
Данные в такой переменной появляются в момент получения сообщения от клиента. Системные переменные содержат информацию о диалоге:
- company_id — id вашей компании, на которую пришло сообщение.
- email — почтовый адрес с которого пришло сообщение
- license_id — линия на которую пришло сообщение
- message — текст сообщения клиента
- messenger_type — канал с которого пришло сообщение (мессенджер или e-mail)
- name — Имя клиента (подставляется имя как в ChatAppDialog)
- phone — номер телефона с которого пришло сообщение
- responsible — ответственный за диалог сотрудник
- username — username клиента
- date — дата
- day_of_week — день недели
- time — время
Системные переменные даты и времени можно использовать отдельно от сообщения клиента. Если сообщения от клиента нет, то берется настоящее дата и время зоны МСК, если сообщение есть, то из временной зоны вашей компании.
Важно! Системные переменные нельзя использовать с блоком Входящий Webhook. При ручном вводе системных переменных в блок появляется следующая ошибка:
Локальные
Значение такой переменной уникально для каждого диалога. Например, если бот ведет одновременно 2 диалога, изменение локальной переменной в одном диалоге не повлияет на значение такой же переменной в другом диалоге.
Локальную переменную можно создать и изменить. Для этого:
- Зайдите в редактор сценариев;
- В углу справа нажмите «Переменные»;
- Кликните по
или по уже существующей переменной;
- Выберите тип данных;
- Введите название и значение (можно сохранить с пустым значением);
- Нажмите «Сохранить».
Глобальная
Значение глобальной переменной одно для всех диалогов. Ее можно создать и изменить. Глобальной переменной, например, является линия или мессенджер, в котором сейчас общается бот.
Для этого:
- Зайдите в редактор сценариев;
- В углу справа нажмите «Переменные»;
- Кликните по
или по уже существующей переменной;
- Выберите тип переменной;
- Выберите тип данных;
- Введите название и значение;
- Нажмите сохранить.
Константа
Константа — это величина, которая при выполнении программы остается неизменной. Ее свойства такие же, как у глобальной, но она не может быть изменена в процессе диалога.
Использование переменных в тексте:
В редакторе можно использовать переменные в тексте сообщения. Обозначается переменная двойными скобками {{var}}, а на ее место подставляется значение из переменной. В качестве переменной можно задать любую существующую переменную.
Использование переменных доступно в следующих блоках:
- Отправить сообщение
- Отправка сообщения*
- Отправка webhook
- Открыть диалог
- Закрыть диалог
Список блоков, которые поддерживают переменные будет пополняться. Мы активно над этим работаем.
Если будет выбрана локальная или системная переменная, но значение будет недоступно, то ничего не подставляется.
Видеоурок
Если у вас остались вопросы, мы сделали видеоурок о переменных и константах в конструторе бота