Перейти к содержимому
AISARAISAR
Все инструкции

Переменные, константы и кнопки в сценариях

Как подставлять данные заявки и контакта в сообщения, хранить общие значения в константах компании, добавлять кнопки и ветвить сценарий по ответу клиента.

Подстановки в тексте шага

Во всех текстовых полях шагов (сообщение, адрес и тело запроса, заголовок) работают подстановки вида {{ путь }}. Проще всего вставлять их кнопкой «Вставить переменную»: она показывает только то, что есть в вашем сценарии.

Начало путиЧто внутри
triggerДанные запуска. Для вебхука: {{trigger.body.Имя поля}}, для других триггеров поля события.
contactДанные контакта: {{contact.name}}, {{contact.phone}}, {{contact.email}}, {{contact.tags}}.
varsПеременные сценария: {{vars.имя}}. Их задают шаги «Установить переменную», запрос контакта и сохранение ответа внешнего запроса.
constКонстанты компании: {{const.site_url}}.
nodesРезультаты предыдущих шагов.
  • Если корень известен, но значения нет, подставляется пустая строка. Неизвестный корень остаётся в тексте как есть.
  • Список или объект подставляется как компактный JSON.
  • В адресе запроса значения из заявки или контакта нельзя ставить в часть до первого слэша (адрес сервера): там можно писать только текст или константу компании. В пути и параметрах переменные разрешены.

Переменные сценария

Шаг «Установить переменную» (set-variable) записывает значение в переменную запуска: set (задать), increment или decrement (изменить число), clear (очистить). Имя начинается с латинской буквы, дальше буквы, цифры, подчёркивание, до 64 символов. В одном запуске не больше 50 переменных, значение до 8 КБ. При превышении шаг завершается ошибкой, а запуск продолжается.

Ответ внешнего запроса тоже можно сохранить в переменные: в шаге запроса укажите путь в JSON-ответе, например $.data.id, и имя переменной (несколько полей). В пробном прогоне запрос не отправляется, поэтому переменные остаются пустыми.

Операция «Извлечь по шаблону» (extract) берёт текст из поля значения (подстановки {{…}} работают только в нём), ищет по регулярному выражению первое совпадение и кладёт в переменную указанную группу захвата: по номеру или по имени (capture_group, пустое значение означает всё совпадение). Шаблон (pattern) и флаги i, m, s (regex_flags) вводятся буквально, без подстановки переменных. Проверяются первые 8 КБ текста. Нет совпадения или нет такой группы: переменная очищается, шаг при этом не падает. Ошибка шаблона или превышение лимитов завершает шаг ошибкой, запуск продолжается. Пример: из «Мой заказ №4512» шаблон №(\d+) положит в vars.order значение 4512. Подробнее о шаблонах: условия и управление потоком.

Блоки «Найти контакт», «Найти сделку» и «Получить значение поля» тоже пишут в переменные: ID найденного (по умолчанию found_contact_id и found_deal_id) и значения выбранных полей, например сумму сделки. Такие переменные работают в условиях и подстановках, как и остальные: {{vars.found_deal_id}} берут «Сменить этап сделки» и «Удалить». Если ничего не найдено, переменные блока очищаются. Подробно: CRM-блоки в сценариях.

Константы компании

Константа это значение, общее для всех сценариев компании: адрес сайта, ссылка на прайс, номер для связи. Меняете в одном месте, и обновляются все сценарии. Управление: в редакторе сценария пункт «Константы компании…».

  • Ключ: строчные латинские буквы, цифры и подчёркивание, начинается с буквы, до 64 символов. Пример: site_url.
  • Значение до 2000 символов, описание до 255. Не больше 100 констант на компанию.
  • Не храните в константах пароли и ключи доступа: их видят все, кто может редактировать сценарии.
  • Если удалить константу, которая используется в сценарии, подстановка станет пустой. AISAR это не проверяет заранее, предупреждение показывается в окне удаления.

Через API константы доступны по GET, POST /v1/automations/constants и PATCH, DELETE /v1/automations/constants/{constant}. Подробнее: REST, автоматизации.

Кнопки в сообщении

В шаге отправки сообщения можно добавить кнопки («Добавить кнопку»): не больше 10, текст кнопки до 80 символов. Каждая кнопка получает на холсте свою ветвь.

КаналКак выглядят кнопки
WhatsApp BusinessКнопки ответа, до 3, текст до 20 символов.
Telegram BotВстроенные кнопки, до 10.
Instagram, MessengerБыстрые ответы, до 13, текст до 20 символов.
Личный WhatsApp (QR), Telegram Business, emailНумерованный список в тексте: 1. Название. Клиент отвечает номером или названием.

Если кнопок больше, чем канал показывает, или текст длиннее лимита, сообщение уходит нумерованным списком, ничего не теряется. В режиме голосового сообщения кнопки не применяются.

Ветвление по ответу клиента

После шага с кнопками добавьте «Ждать ответ» и включите режим ветвления. Тогда выходы шага такие:

  • по одной ветви на каждую кнопку;
  • «Что-то другое»: клиент ответил текстом, не совпавшим с кнопкой (ветвь работает, только если к ней подведена связь);
  • «Нет ответа через N»: время ожидания вышло. В этом режиме время ожидания обязательно: минуты, часы или дни, от 1 минуты до 30 суток, по умолчанию 24 часа. На холсте ветка подписывается, например, «Нет ответа через 2 ч». Переключатель «Рабочее время» (по умолчанию выключен) считает минуты и часы только внутри графика работы компании, а дни рабочими днями; без графика время календарное.

Без кнопок выходов два: «Ответил» и «Нет ответа через N». Без включённого режима ветвления шаг работает как раньше: пауза по таймеру, а при ответе клиента ветка обрывается. Сообщение клиента, которое сценарий принял как ответ, не запускает ИИ-агента и не стартует «Сообщение получено» этого же сценария.

Запрос телефона или email

Шаг «Запросить телефон или email» (request-contact) просит клиента прислать контакт. Если значение уже есть в карточке, сообщение не отправляется и сценарий идёт дальше по ветви «Получен контакт». В Telegram Bot для телефона показывается кнопка отправки номера (только в личном чате), в остальных каналах просьба идёт текстом. Номер из контакта Telegram принимается, только если он принадлежит самому клиенту. После шага добавьте «Ждать ответ» с ветвлением.

Сбор данных: «Спросить и сохранить»

Блок «Спросить и сохранить» (ask-question) задаёт клиенту вопрос, проверяет ответ, при неверном ответе переспрашивает и записывает результат в переменную, поле карточки или контакт. Вопрос, ожидание и проверка собраны в одном блоке: отдельное «Ждать ответа» после него не нужно. Вопрос уходит в канале диалога запуска, либо в канале, выбранном в блоке.

Тип ответаЧто принимаемЧто сохраняем
ТекстЛюбой непустой ответ.Первые 1000 символов.
Число12 или 12,5, до шести знаков после запятой. Можно задать границы «От» и «До».Число с точкой: 12.5.
ТелефонКарточка контакта из WhatsApp или один номер в тексте.Международный формат по стране компании: +12025550147.
E-mailРовно один адрес.Строчными буквами.
Дата25.11.2026, 25.11.26, 25/11/2026, 2026-11-25. Несуществующую дату (31.02) не принимаем.В виде 2026-11-25.
Вариант из спискаОт 1 до 10 вариантов, подпись до 64 символов. Клиент нажимает кнопку, пишет номер варианта или подпись (регистр не важен).Подпись варианта.
ШаблонРегулярное выражение должно найтись в тексте ответа. Проверить шаблон можно заранее, см. REST, автоматизации.Весь ответ.

Стикер или фото без подписи считаются неверным ответом и тратят попытку.

Попытки и ожидание

  • «Попыток всего»: от 1 до 5, по умолчанию 3. Первый вопрос тоже считается попыткой, значение 1 означает «не переспрашивать».
  • «Текст переспроса» необязателен: если пусто, вопрос повторяется как был. В обоих текстах работают подстановки {{…}}, до 4096 символов.
  • «Сколько ждать»: минуты, часы или дни, от 1 минуты до 30 суток, пусто означает 24 часа. Срок отсчитывается заново после каждого вопроса и переспроса.
  • Переключатель «Рабочее время» (по умолчанию выключен): минуты и часы считаются только внутри графика работы компании, дни считаются рабочими днями. Общий потолок остаётся 30 календарных суток. Если график не задан, время считается календарным.

Куда сохранить ответ

  • «Переменная» обязательна: имя начинается с латинской буквы, дальше буквы, цифры и _, до 64 символов. Дальше в сценарии ответ доступен как {{vars.имя}}.
  • «Записать в поле»: дополнительно положить ответ в поле контакта или своё поле контакта или диалога, как это делает шаг «Обновить поле». Поля в архиве и защищённые выбрать нельзя.
  • «Добавить в контакт» (только для телефона и e-mail): добавить номер или адрес в контакт. Если он уже принадлежит другому контакту, в карточку не добавляется, а в запуске остаётся отметка.
  • «Не перезаписывать заполненное поле» включено по умолчанию: то, что оператор уже вписал в карточку, ответ клиента не затрёт. Переменная запуска заполняется в любом случае. Выключите переключатель, если ответ должен заменять прежнее значение.

Если поле не записалось (например, оно в архиве) или в нём уже есть значение, выход остаётся «Собрано», а в итоге шага появляется отметка (field_already_filled, identifier_already_filled, identifier_belongs_to_other_contact и коды вида field_…). Текст ответа в журнал запусков не попадает: он хранится только в переменной и в выбранных полях.

Выходы и причины

ВыходКогда
СобраноПолучен верный ответ и сохранён.
Не удалосьПопытки кончились, вопрос не удалось отправить или блок нельзя выполнить. Причина записывается в журнал.
Нет ответа через …Клиент не ответил за отведённое время.
Причина (выход «Не удалось»)Что значит
attempts_exhaustedВсе попытки потрачены на неверные ответы.
send_failedВопрос или переспрос не отправился: окно 24 часа закрыто, контакт заблокирован, тихие часы и другие причины отправки.
no_contactУ запуска нет контакта.
group_dialog_not_supportedВ групповых диалогах блок не работает.
invalid_configБлок настроен неверно, например неизвестный тип ответа.
variable_limitВ запуске уже 50 переменных или значение слишком большое.
kids_not_supportedВ компаниях Kids блок недоступен.

В пробном прогоне вопрос не отправляется, запуск идёт по выходу «Нет ответа через …». Когда сценарий закончится, платформа может отправить событие вебхука automation.run.finished: в нём только метаданные запуска, а собранные ответы передавайте шагом «Отправить вебхук» на выходе «Собрано». Подробнее: Автоматизации: основы.

Шаблон WhatsApp Business в сценарии

Шаг «Отправить шаблон WhatsApp» (send-whatsapp-template) отправляет клиенту утверждённый Meta шаблон. В настройках шага выберите канал WhatsApp Business, шаблон и заполните его переменные: можно вписать текст или подставить значение, например {{contact.name}} или {{trigger.body.Name}}. Шаблон должен быть утверждён и принадлежать выбранному каналу.

Для запуска из заявки через вебхук это единственный способ написать клиенту первым в WhatsApp Business вне окна 24 часа: шаблон может открыть диалог, а обычный текст вне окна пропускается (причина whatsapp_window_closed). Значения переменных AISAR приводит к виду, который принимает Meta: переносы строк и длинные пробелы заменяются, слишком длинное значение обрезается.

Если в шаблоне есть кнопки быстрого ответа (quick_reply), следующим шагом поставьте «Ждать ответ» с режимом ветвления: клиент нажимает кнопку, и сценарий идёт по ветви этой кнопки, как в разделе выше. Кнопки со ссылкой и звонком в ветвление не входят.

Почему сообщение не ушло

Если шаг не отправил сообщение, сценарий не падает: шаг помечается пропущенным, а причина записывается в журнал запусков.

КодЧто значит
whatsapp_window_closed, instagram_window_closed, messenger_window_closedОкно 24 часа закрыто, обычный текст отправить нельзя. В WhatsApp Business напишите первым шаблоном.
template_not_selected, template_not_foundШаблон не выбран или удалён.
template_not_approvedШаблон ещё не утверждён Meta или отклонён.
template_channel_mismatchШаблон принадлежит другому каналу.
template_param_missingНе заполнена переменная шаблона или подстановка вернула пустое значение.
template_requires_wabaШаг с шаблоном работает только в канале WhatsApp Business.
contact_opted_outКлиент отказался от сообщений.
contact_blocked, contact_hiddenКонтакт заблокирован или скрыт от сценария.
plan_message_limitИсчерпан лимит исходящих сообщений тарифа, новый диалог не открыт.
channel_cannot_start_conversationЧерез этот канал нельзя начать диалог первым.
quiet_hours, frequency_cappedСейчас тихие часы компании или клиенту уже писали слишком часто.
empty_bodyТекст сообщения пустой.

Открыть и закрыть диалог

  • «Закрыть диалог» (close-conversation) закрывает диалог запуска или последний активный диалог контакта. Опрос удовлетворённости отправляется, только если включена опция отправки.
  • «Открыть диалог» (open-conversation) открывает диалог или переключает сценарий на уже активный диалог контакта.
Сценарий на «Диалог закрыт» с шагом «Открыть диалог» и сценарий на «Диалог открыт заново» с шагом «Закрыть диалог» вместе образуют цикл. AISAR ограничивает глубину таких каскадов, но не стройте их намеренно.

Смотрите также