Чтобы настроить передачу данных из карточек Битрикс24 в сценарий бота или в текст сообщений, используйте переменные. Они позволяют передавать такую информацию, как имя контакта,email, номер телефона, название компании и т.д.
¶ Настройка переменных в Битрикс24
Добавляются переменные при импорте шаблона. Для этого:
-
Нажмите кнопку +Добавить переменную, чтобы добавить новую строку с полями создания переменной и кнопкой удаления.
-
Введите название переменной в поле Имя без фигурных скобок.
-
Выберите из выпадающего списка в поле Сущность ту сущность, из которой будут браться данные для заполнения переменной сценария. Учитывайте наличие связей между сущностями. Например, если вы будете инициировать обзвон из карточки лида, а брать информацию из карточки контакта, то нужно обязательно связать карточку лида с контактом, иначе переменная останется пустой.
-
Выберите из выпадающего списка поле сущности, из которого будут браться данные для заполнения переменной сценария.
-
(Опционально) Включите опцию Обязательность к заполнению:
- При включении диалог начнется только при получении данных для заполнения этой переменной. Если переменная останется пустой или ее не удастся заполнить по какой-то причине, то диалог завершится с ошибкой «Переменная не определена».
- При выключении диалог начнется в любом случае. Если переменная останется пустой, то бот произнесет или напишет в сообщении название переменной. Пример:
- Если боту удалось получить значение для переменной: «Здравствуйте, Иван! Рад сообщить, что у нас началась акция…!»
- Если боту не удалось получить значение для переменной: «Здравствуйте,
name! Рад сообщить, что у нас началась акция…!»
Всего можно добавить не более 64 переменных.
¶ Использование переменных в сценарии бота
Чтобы передать боту переменную, пропишите в тексте нужного блока сценария название переменной в фигурных скобках через объект clientMetadata, например {clientMetadata.name}.
При работе сценария бот возьмет значение указанного поля выбранной сущности в переменную.
¶ Использование переменных для сообщений
Чтобы использовать переменные при рассылке сообщений, задайте их в шаблоне сообщения без фигурных скобок.
