Переменные и подстановки {{...}} - как вставить имя и данные подписчика

Как вставить переменную (не печатайте скобки руками)

Самый надежный способ - использовать встроенный список:

• В поле ввода текста нажмите значок с фигурными скобками справа от поля, или начните печатать символ @.
• Появится список доступных переменных. Выберите нужную - в текст подставится готовый токен {{ключ}} без опечаток. Если пишете вручную:
• Синтаксис: {{имя_переменной}} - ровно две открывающие и две закрывающие скобки, без пробелов внутри.
• Регистр важен: {{First_Name}} и {{first_name}} - разные переменные.
• Пробел внутри {{ first_name }} сделает переменную непустой - она не найдется.

Системные переменные (доступны всегда)

Бот заполняет их автоматически, ничего настраивать не нужно:

Данные контакта

Берутся из профиля подписчика. При входящем сообщении в Telegram - из данных отправителя:

• {{first_name}} - имя
• {{last_name}} - фамилия
• {{full_name}} - полное имя (имя + фамилия)
• {{username}} - username в Telegram (без @)
• {{display_name}} - отображаемое имя Если у контакта поле не заполнено - подстановка вернет пустую строку (для полей из Telegram) или останется {{ключ}} без замены (для ненайденных переменных).

Пользовательские поля (кастомные поля)

Это ваши собственные поля контакта, которые вы создаете в разделе подписчиков. У каждого поля есть короткий идентификатор (слаг) - именно его подставляйте: {{слаг_поля}}. Пример: создали поле "Город" со слагом city - в сообщении пишете "Доставим в {{city}} за 2 дня". Доступны в каталоге переменных в группе "Кастомные поля".

Переменные, которые создают ноды

Нода "Ожидание ответа"

Сохраняет ответ пользователя в переменную с именем, которое вы задаете сами. Дополнительно тот же ответ всегда дублируется в {{user_answer}}. Если задали имя answer - дальше доступны и {{answer}}, и {{user_answer}}.

Нода "Сохранить в переменную"

Создает переменную с вашим именем и значением. Само значение тоже поддерживает подстановки - можно собирать новую переменную из других.

Нода "Внешний запрос (API)"

Кладет ответ сервера в переменную с заданным именем. Весь ответ (или весь JSON-текст) записывается как одна строка.

Нода "Google Таблицы"

Создает несколько переменных с общим префиксом (по умолчанию sheet): {{sheet_found}} (нашлось ли что-то), {{sheet_row}} (номер строки), {{sheet_<заголовок столбца>}} (значения колонок). При ошибке - {{sheet_error}}. Все такие переменные показываются в каталоге в группе "Переменные флоу".

Когда переменная НЕ подставляется

Если переменная с таким именем не найдена - в тексте буквально останется {{ключ}}. Бот ничего не придумывает. Частые причины:

• Опечатка в имени ({{frist_name}}) - используйте список через @.
• Нода, создающая переменную, стоит НИЖЕ по сценарию, чем нода, ее использующая. Переменную можно применять только в нодах, стоящих после той, что ее создала.
• Поле контакта пустое - переменная останется неподставленной.

Область видимости: переменные живут в рамках сессии

• Значения сохраняются между шагами и между сообщениями внутри одного прохода по сценарию.
• Переменные переживают паузы (ожидание ответа, задержку по времени) - они не сбрасываются.
• У каждого подписчика свои значения; переменные одной сессии не видны другому контакту.
• Чтобы сохранить данные навсегда (между разными запусками сценария), записывайте в пользовательское поле через "Установить поле".

Если не получается

• В сообщении видны сами скобки {{first_name}} - имя переменной не совпадает с существующей: опечатка, пробелы внутри {{ }}, другой регистр, или переменная еще не создана к этому шагу. Вставляйте через @ или кнопку со скобками.
• Вместо имени - пусто - у контакта поле не заполнено. Проверьте карточку контакта или задайте значение ранее через "Установить поле".
• {{user_answer}} пустой или старый - до этого места не было ноды "Ожидание ответа". Убедитесь, что нода ожидания отработала перед использованием этой переменной.
• @ не открывает список переменных - перед @ стоит буква или другой @ (система воспринимает как email или handle). Ставьте @ в начале или после пробела, или нажмите кнопку со скобками справа от поля.

Лимиты и тариф

Механизм подстановок доступен на всех тарифах. Технического лимита на количество подстановок в одном тексте нет. Ограничения есть у нод, которые создают переменные (например, "Google Таблицы" или "Внешний запрос").