Bot Variables в AI промптах

Как переиспользовать ссылки, идентификаторы и константы в «AI Manager — обзор» — , шаге , и через макрос {{variables.name}} . Сокращение длинных URL?

Обновлено 30 августа 2026 г.5 мин

Как переиспользовать ссылки, идентификаторы и константы в «AI Manager — обзор» AI Manager — обзор — AI Settings — личность бота, шаге AI Reply — умный ответ через AI, Send message — отправка готового сообщения и Webhook — отправка данных наружу через макрос{{variables.name}}. Сокращение длинных URL и типовые паттерны.

Справочник по разделу — Bot Variables — переиспользуемые значения. Здесь — практика подстановки в AI и сообщениях. Данные по каждому лиду — это Custom Fields — пользовательские поля, не путать с переменными бота.

С чего начать

Ниже — зачем нужны Variables, как отличить их от полей лида, синтаксис и типовые места использования в AI и сообщениях.

Зачем нужны Variables

Зачем Variables

Одно значение (ссылка, промокод, URL) переиспользуется во flow и промптах: правка в одном месте обновляет все подстановки.

Одно и то же значение (ссылка регистрации, промокод, URL поддержки) часто фигурирует в десятке мест флоу и промптов. Без переменных каждое изменение — ручная правка и риск забыть один из узлов. С переменными меняете Value в одном месте — подстановка обновляется везде, где используется макрос.

Variables и Custom Fields

Variables и Custom Fields

Variables — общие константы бота. Данные конкретного лида — Custom Fields и макросы {{fields.*}}. не путайте роли.

	Bot Variables	Custom Fields
Уровень	Бот	Лид
Значение	Одинаково для всех лидов этого бота	Индивидуально у каждого лида
Макрос	{{variables.name}}	{{fields.key}} или синтаксис из справки CRM
Источник правки	Bot Settings → Bot Variables	Оператор, AI Recognition, интеграции, Webhook

Правило: Variables — общие константы бота. Custom Fields — персональные данные лида.

Создание и синтаксис

Синтаксис

{{variables.name}} — имя ровно как в настройке, двойные скобки, без пробелов внутри. Опечатка часто уходит в чат как текст.

CRM → Bot → AI Manager — обзор → Automation & AI → Bot Variables — переиспользуемые значения → добавить переменную: имя (латиница, без пробелов, часто camelCase или snake_case) + Value.

Подстановка:

{{variables.regLink}}

{{variables.support_link}}

{{variables.promoCode}}

Требования к синтаксису: двойные фигурные скобки, без пробелов внутри, имя точно как в настройке. Варианты вроде {{Variables.regLink}}, { variables.regLink }, {{variable.regLink}} обычно не работают.

Где использовать

Где подставляется

Значение подставляется перед отправкой в модель или в сообщение лиду — зависит от экрана. ниже разобрано по типам шагов.

`AI Settings`

AI Settings — детальный разбор

Global Legend, Restrictions и Response Style — удобно держать стабильные ссылки регистрации, поддержки и юридические формулировки.

В AI Settings — личность бота, Restrictions, Response Style значение подставляется перед отправкой в модель.

Пример:

You help users register on the partner platform.

The registration link is: {{variables.regLink}}

When user asks how to register, send them this link.

For support questions, refer to: {{variables.supportLink}}

Смена партнёрской ссылки — обновление одной переменной. новые ответы пойдут с новым URL.

Поддерживаемые поля для макросов уточняйте в актуальной справке: не во всех экранах AI Settings — личность бота подстановка может быть включена одинаково.

`AI Reply` — Reply Addition Info

AI Reply — детальный разбор шага

Reply Addition Info — для акций и параметров, которые меняются чаще, чем вся легенда: промо, сроки, скидка.

Удобно для акций и параметров, которые меняются чаще, чем легенда бота:

Current promotion: {{variables.currentPromo}}

Promo code: {{variables.promoCode}} — valid until {{variables.promoExpires}}

Discount: {{variables.discountPercent}}%

Детали блоков шага — AI Reply — детальный разбор шага.

Send Message

Текст и inline-кнопки используют те же макросы — единый источник правды с AI и рассылками.

Текст сообщения и при необходимости URL inline-кнопок — см. Send message — отправка готового сообщения.

Welcome! Register here: {{variables.regLink}}

Need help? {{variables.supportLink}}

Our Telegram channel: {{variables.channelLink}}

`Webhook`

Webhook

URL и параметры окружения (staging/prod) удобно вынести в переменные. детали по экранам — в документации продукта.

В URL или теле Webhook переменные помогают держать endpoint и параметры окружения в одном месте (staging/prod) — Webhook — отправка данных наружу.

Shorten the link

Длинный URL можно показывать короче: выберите домен из списка и проверьте трекинг и смешение с другими макросами в тесте.

Для переменной, чей Value — длинный URL, есть опция Shorten the link и выбор домена из Domains — собственные домены. Лиду показывается короткая ссылка на вашем домене с редиректом на полный URL.

Пример исходного Value (параметры трекинга условные):

https: //partner.example/register?utm_campaign=111&utm_source=222&...

После включения сокращения лид может видеть вид вроде:

https: //mydomain.com/qp7h3zi

Короткие ссылки обычно удобнее копировать и выглядят аккуратнее в чате. эффект по CTR зависит от аудитории и оформления.

Важно: если в Value смешиваются макросы трекера ({{tracker.clickid}}и т.д.) и переменные, поведение зависит от того, на каком этапе выполняется сокращение и подстановка — проверьте на тестовом лиде в Messenger. Не предполагайте вложенную подстановку{{variables.a}}внутри{{variables.b}}без проверки в продукте.

Сценарии по нишам

Готовые идеи имён и применения — используйте как чертёж и адаптируйте под свой продукт и комплаенс.

Арбитраж. regLink с длинным tracking URL + Shorten + ваш домен. та же переменная в Legend, Reply Addition, Send Message.

Sales. currentPromo, promoCode, срок действия — в Reply Addition на шагах возражений и закрытия.

Поддержка. faqUrl, docsUrl, returnsUrl — единая точка правды при переезде базы знаний.

E-commerce. deliveryDays, freeDeliveryThreshold — правила доставки без правки каждого промпта.

Инфобизнес. nextStreamStart, streamPrice — обновление перед новым потоком.

Антипаттерны

Не храните в Variables персональные данные лица, секреты и «магические» вложенные макросы — это ломается и небезопасно.

Хранить в Variables то, что индивидуально для лида — используйте Custom Fields — пользовательские поля и макросы полей.

Неясные имена (x,link1) — через месяц не разберёте. используйте regLinkPocketOption,promoMarch2026.

Вложенные макросы в Value переменной — часто не раскрываются. держите значения «плоскими».

Секреты в Variables — доступно тем, кто видит настройки бота. API-ключи и пароли храните в защищённых механизмах компании / секретах интеграций, не в открытом Value.

Частые вопросы

Короткие ответы на типовые сомнения — раскрывайте пункты ниже при необходимости.

Связанное

Карточки ведут в соседние материалы по AI Settings, шагам и настройке бота.

AI Manager — обзор

Что такое AI Manager в Chatterfy , какие у него слои (Settings, Reply, Routings, Recognition, Models, Variables) и с каких статей начать. AI Manager …

AI Models — полное руководство по AI-моделям в Chatterfy

AI Models — раздел Bot Settings для выбора моделей AI Routing и AI Summary, управления качеством ответов и оценки стоимости диалога.

AI Recognition — обработка медиа

AI Recognition — обработка медиа через AI AI Recognition — функция внутри Automation & AI, которая позволяет AI обрабатывать медиафайлы пользователя. AI может работать с: голосовыми сообщениями; фотог

AI Routings — маршрутизация по смыслу

Шаг AI Routings — нечёткая маршрутизация. Подключается после AI Reply и направляет лида на разные следующие шаги в зависимости от смысла его ответа.

Что умеет AI в Chatterfy

Что умеет AI: автоответы, маршрутизация, распознавание медиа и CRM-данные. AI работает внутри flow, не вместо него.

Как улучшить качество AI

Как улучшить качество AI: проверить настройки, промпты, restrictions, routing, модели и качество исходных данных в боте.