Контекстные переменные и данные CRM
Без переменных промпт — статический текст. С переменными бот знает текущее время, обращается к клиенту по имени и показывает свободные слоты для записи. Переменные подставляются автоматически при каждом сообщении — вам нужно только вставить их в промпт.
Два типа переменных
| Тип | Формат | Пример | Откуда данные |
|---|---|---|---|
| Контекстные | +func_name-args:params+ | +current_time-args:tz=UTC+3,language=ru+ | Системные (время, календарь) |
| CRM-переменные | [variable_name] | [client_name] | Карточка лида в CRM |
Контекстные переменные
Три системные переменные, доступные во всех типах инструкций.
Текущее время
Подставляет текущую дату и время в указанном часовом поясе и языке.
Формат:
+current_time-args:tz=UTC+0,language=ru+Параметры:
| Параметр | Описание | Примеры значений |
|---|---|---|
tz | Часовой пояс | UTC+0, UTC+3 (Москва), UTC+2 (Рига) |
language | Язык вывода | ru, en, lv, de |
Пример в промпте:
Текущее время: +current_time-args:tz=UTC+3,language=ru+
Используй время для:
- Приветствия: «Доброе утро» / «Добрый день» / «Добрый вечер»
- Проверки: если сейчас нерабочее время — предложи перезвонить завтраДень недели
Подставляет название текущего дня недели.
Формат:
+page_day+Пример в промпте:
Сегодня: +page_day+
Если сегодня суббота или воскресенье — сообщи клиенту,
что запись возможна только на рабочие дни.Свободные слоты
Подставляет список свободных временных слотов из Google Calendar.
Формат:
+free_slots+Пример в промпте:
Доступные слоты для записи: +free_slots+
Предложи клиенту выбрать удобное время из списка.
Если свободных слотов нет — предложи другую дату.Для работы free_slots необходимо подключить Google Calendar к боту. Без подключения переменная будет пустой.
CRM-переменные
CRM-переменные берут данные из карточки лида в подключённой CRM. Доступны в типах: «Ответы и операции», «Только операции», «Для Дожимов».
Формат:
[variable_name]Стандартные CRM-переменные
Эти переменные доступны по умолчанию для большинства CRM:
| Переменная | Описание | Пример значения |
|---|---|---|
[client_name] | Имя клиента | Иван |
[phone] | Телефон клиента | +7 999 123-45-67 |
[email] | Email клиента | ivan@example.com |
[order_id] | Номер заказа | 12345 |
[order_status] | Статус заказа | В обработке |
[price] | Цена | 5 000 руб. |
[language] | Язык клиента | RU |
[manager_name] | Имя ответственного менеджера | Ольга |
Пользовательские CRM-переменные
Помимо стандартных, доступны все пользовательские поля из вашей CRM. Названия переменных совпадают с названиями полей в CRM.
Список доступных CRM-переменных зависит от настроек вашей CRM. Чтобы увидеть актуальный список, нажмите кнопку «CRM-переменные» в панели инструментов редактора.
Как вставить переменную в промпт
Откройте редактор инструкции
Создайте или откройте существующую инструкцию.
Нажмите нужную кнопку в панели инструментов
- «Контекст» — для контекстных переменных (время, день, слоты)
- «CRM-переменные» — для данных из CRM (имя, телефон, поля)
Выберите переменную из списка
Кликните на нужную переменную — она автоматически вставится в текст промпта в правильном формате.
Доступность по типам инструкций
| Переменные | Только ответы | Ответы и операции | Только операции | Для Дожимов |
|---|---|---|---|---|
| Контекстные (время, день, слоты) | ✅ | ✅ | ✅ | ✅ |
| CRM-переменные (имя, телефон, поля) | ❌ | ✅ | ✅ | ✅ |
Примеры использования
Персонализированное приветствие
Здравствуйте, [client_name]!
Текущее время: +current_time-args:tz=UTC+3,language=ru+
Если сейчас утро (до 12:00) — начни с «Доброе утро, [client_name]!»
Если день (12:00-17:00) — «Добрый день, [client_name]!»
Если вечер (после 17:00) — «Добрый вечер, [client_name]!»Запись на приём с учётом расписания
Свободные слоты: +free_slots+
Сегодня: +page_day+
Предложи клиенту [client_name] записаться на приём.
Покажи 3-5 ближайших свободных слотов из списка.
Если сегодня выходной — предложи ближайший рабочий день.Дожим с персонализацией
Напиши напоминание клиенту [client_name].
Язык клиента: [language]
Если язык RU — пиши на русском.
Если язык LV — пиши на латышском.
Если язык EN — пиши на английском.
Упомяни, что свободные слоты скоро закончатся.Частые вопросы
Что такое контекстные переменные?
Контекстные переменные — это динамические данные, которые автоматически подставляются в промпт при каждом сообщении. Три переменные: текущее время (current_time), день недели (page_day) и свободные слоты (free_slots). Они делают промпт «живым» — бот знает который час, какой день и когда есть свободное время.
Чем отличаются контекстные переменные от CRM-переменных?
Контекстные — системные данные (время, календарь), формат +func_name+. CRM-переменные — данные из карточки лида в CRM (имя, телефон, поля), формат [variable_name]. Оба типа подставляются автоматически, но из разных источников.
В каких типах инструкций доступны переменные?
Контекстные переменные доступны во всех типах. CRM-переменные — в типах «Ответы и операции», «Только операции» и «Для Дожимов». В типе «Только ответы» CRM-переменные недоступны, потому что этот тип не подключается к CRM.