Переменные, константы и кнопки в сценариях
Как подставлять данные заявки и контакта в сообщения, хранить общие значения в константах компании, добавлять кнопки и ветвить сценарий по ответу клиента.
Подстановки в тексте шага
Во всех текстовых полях шагов (сообщение, адрес и тело запроса, заголовок) работают подстановки вида {{ путь }}. Проще всего вставлять их кнопкой «Вставить переменную»: она показывает только то, что есть в вашем сценарии.
| Начало пути | Что внутри |
|---|---|
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. |
| Ровно один адрес. | Строчными буквами. | |
| Дата | 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) открывает диалог или переключает сценарий на уже активный диалог контакта.