Формулы в сценариях

Формула — это способ научить бота считать и принимать решения без программиста. Если вы хоть раз писали в Excel или Google Таблицах что-то вроде =A1*B1, вы уже умеете.

Что такое формулы и зачем они

Формула — это способ научить бота считать и принимать решения без программиста. Если вы хоть раз писали в Excel или Google Таблицах что-то вроде =A1*B1, вы уже умеете.

Вместо ячеек здесь поля подписчика. Бот подставляет в формулу данные каждого конкретного человека и считает результат именно для него.

Что можно сделать с формулами:

  • посчитать сумму заказа: {Цена} * {Количество};
  • подвести итог квиза: сложить баллы за ответы и выдать уровень «Эксперт» или «Новичок»;
  • дать скидку: {Сумма} * 0,9 — минус 10%;
  • проверить условие: «баллов больше 25 и есть метка VIP» — тогда ведём в одну ветку, иначе в другую;
  • работать с датами: сколько дней до окончания подписки, сколько лет человеку по дате рождения.

Формулы работают во всех каналах: Telegram, VK, Avito, MAX, Одноклассники, почта, веб-чат и другие.


Два инструмента: посчитать или выбрать путь

Формулы живут в двух местах, и они делают разное. Простое правило: нужно число или текст — берите действие; нужно «да или нет» — берите условие.


Действие «Расчёт по формулам»Условие «По формуле»
Что делаетсчитает и записывает результат в полепроверяет и направляет подписчика в ветку «Да» или «Нет»
Примерпосчитать сумму заказа и сохранить в поле «Итого»если сумма больше 5000 — предложить бесплатную доставку
Где найтишаг «Действия»шаг «Условие» → «Добавить условие» → «По формуле»
Тарифбесплатно, на любом тарифетариф PRO

Почему условие только на PRO. Дело не в формулах: на PRO доступен весь шаг «Условие» целиком, с любыми проверками. Посчитать что угодно и записать в поле можно бесплатно.

Не перепутайте со старыми блоками. Действие «Математические операции со значением» и галочка «Сравнить с другим полем» остались как были и работают по-старому. Например, старое действие считает пустое поле нулём и округляет результат. Ваши готовые сценарии ничего не заметят, а для новых расчётов лучше брать «Расчёт по формулам».


Первая формула: пошагово

Пример 1. Считаем сумму заказа (действие)

У подписчика есть поля «Цена» и «Количество». Хотим получить сумму в поле «Итого».

  1. Откройте сценарий и добавьте шаг «Действия».
  2. Выберите действие «Расчёт по формулам».
  3. Выберите, в какое поле записать результат, — «Итого».
  4. В поле формулы начните печатать название поля или нажмите Ctrl+Пробел — появится список полей и функций. Соберите: {Цена} * {Количество}.
  5. Посмотрите на статус в блоке: должно быть «Формулы без замечаний».
  6. Сохраните и опубликуйте сценарий.

В одном действии можно написать несколько строк — они считаются по порядку, сверху вниз. Вид «Текстом» показывает все строки сразу, так удобнее читать.

Пример 2. Развилка по баллам (условие, PRO)

После квиза хотим отправить тех, у кого 25 баллов и больше, по одной ветке, а остальных — по другой.

  1. Добавьте шаг «Условие».
  2. Нажмите «Добавить условие» и выберите «По формуле».
  3. Напишите: {Баллы} >= 25.
  4. Соедините выход «Да» с тем, что получат отличники, а «Нет» — с остальными.

Важно: формула в условии должна отвечать на вопрос «да или нет?». {Баллы} >= 25 — подходит. А просто {Баллы} + 5 — нет, это число, а не ответ.

Шпаргалка: как писать правильно

Большинство ошибок — из-за мелочей. Вот они все в одном месте.

ЧтоТак правильноТак не сработает
Поле подписчика{Цена} — в фигурных скобкахЦена без скобок
Разделитель в функцииОКРУГЛ({Сумма}; 2) — точка с запятойОКРУГЛ({Сумма}, 2)
Дробные числа0,9 или 0.9 — оба варианта работают—
Текст"Эксперт" или «Эксперт» — в кавычкахЭксперт без кавычек
Склеить текст{Имя} & ", привет!" — знак &{Имя} + ", привет!"
И / ИЛИ / НЕ{Баллы} > 10 и {Возраст} >= 18 — словами&&, ||
«От … до …»{Баллы} > 1 и {Баллы} < 51 < {Баллы} < 5

Ещё несколько вещей, которые полезно знать:

  • Английские названия тоже работают: IF, ROUND, SUM, а вместо «и/или/не» — and, or, not.
  • Переименовать поле можно спокойно — формула не сломается, бот сам подтянет новое название. А вот если поле удалить, формулу придётся поправить.
  • Промежуточные значения (только в действии). Строка сумма = {Цена} * {Количество} запоминает результат под именем сумма, и его можно использовать в строках ниже. Но это черновик: в карточку подписчика оно не попадёт и в других блоках недоступно. Имя — одно слово, не совпадающее с названием функции или поля.
  • Системные поля нельзя выбрать для записи. Результат можно сохранить в своё поле подписчика или в глобальное поле.
  • Ограничения: до 4000 символов в формуле и до 30 строк в одном действии. Обычному сценарию этого хватает с большим запасом.

Полезные функции

Всего функций около 50, но для старта хватит нескольких. Заучивать ничего не нужно: нажмите Ctrl+Пробел в поле формулы — появится список с поиском и подсказками, что и куда писать.

Самые нужные

ФункцияЧто делаетПример
ЕСЛИвыбирает один из двух вариантовЕСЛИ({Баллы} >= 25; "Эксперт"; "Новичок")
ЕСЛИПУСТОподставляет запасное значение, если поле пустоеЕСЛИПУСТО({Баллы}; 0)
ОКРУГЛокругляет до нужного числа знаковОКРУГЛ({Сумма} * 0,9; 2)
МИН, МАКСберёт меньшее или большее значениеМИН({Скидка}; 30) — скидка не больше 30
СЕГОДНЯсегодняшняя датаСЕГОДНЯ()
ЕСТЬ_МЕТКАесть ли у подписчика меткаудобно для условий «если VIP — …»
ПОДПИСКА_АКТИВНАактивна ли у человека платная подпискапустить в закрытый раздел
ДНЕЙ_ДО_КОНЦА_ПОДПИСКИсколько дней осталось до конца подпискинапомнить о продлении за 3 дня

Что ещё есть

  • Числа: округление вверх и вниз, сумма, степень, корень, случайное число (СЛУЧМЕЖДУ — удобно для розыгрышей), красивый формат числа.
  • Текст: длина, заглавные и строчные буквы, убрать лишние пробелы, заменить слово, проверить «содержит» или «начинается с», оставить только цифры (удобно для телефонов).
  • Даты: текущее время, дней между датами, прибавить дни или месяцы, возраст по дате рождения, день недели, формат даты.
  • Списки: длина списка, элемент по номеру, есть ли значение в списке, сумма списка.

«Опиши словами»: формулу составит ИИ

Не хотите разбираться с синтаксисом — не надо. Опишите задачу обычными словами, и ИИ предложит готовую формулу. Это бесплатно: токены ИИ не списываются.

  1. Нажмите фиолетовую кнопку «Опиши словами» в блоке.
  2. Напишите, что нужно. Например: «Сложи баллы за три ответа. Если 25 и больше — Эксперт, иначе Новичок».
  3. ИИ покажет формулу. Иногда он сначала задаст уточняющий вопрос — тогда ответьте в поле «Ваш ответ».
  4. Выберите, что сделать: «Вставить», «Вставить и поправить самому» или «Отклонить».

ИИ ничего не меняет сам — формула появится в блоке, только когда вы нажмёте «Вставить». Если видите надпись «Не прошло проверку Botman», значит в формуле есть проблема: лучше переформулировать запрос или исправить вручную по подсказкам.

Запросов можно делать до 30 за 10 минут. Если ИИ перестал отвечать — подождите немного и попробуйте снова.

Перед публикацией: проверьте статус блока

Сценарий опубликуется даже с ошибкой в формуле. Поэтому то, что кнопка «Опубликовать» сработала, ещё не значит, что формула верная. Ошибка проявится уже у живых подписчиков.

Чтобы этого избежать, перед публикацией откройте каждый блок с формулой и посмотрите на статус:

Статус в блокеЧто делать
«Формулы без замечаний»всё хорошо, можно публиковать
«Есть предупреждения»формула работает, но стоит прочитать совет — чаще всего про пустые поля у новых подписчиков
«В формулах есть ошибки»не публикуйте, сначала исправьте

Ошибки подсвечиваются прямо в тексте формулы с пояснением по-русски. Часто рядом есть кнопка «Исправить» (или горячие клавиши Alt+Enter) — бот сам предложит исправление.

Если что-то не работает

Сценарий из-за ошибки в формуле не останавливается — он идёт дальше. Поэтому ошибка выглядит тихо:

  • условие всегда уводит в «Нет» — формула сломалась или дала пустое значение;
  • поле не заполняется — строка расчёта с ошибкой или результат пустой.

Про пустой результат: он специально не стирает поле, чтобы не потерять накопленное значение. Если поле нужно очистить, используйте действие «Очистить».

Сообщения об ошибках и что с ними делать

Что пишет ботКак исправить
«Формула пустая»вы ещё ничего не написали — впишите формулу
«Формула оборвалась: допишите значение»после знака (+, *, >) чего-то не хватает
Неизвестная функцияопечатка в названии — бот подскажет похожую; проверьте раскладку клавиатуры
Неизвестное или удалённое полеполе удалили или название написано с ошибкой — выберите поле через Ctrl+Пробел
Неверное число аргументовчего-то не хватает или есть лишнее; чаще всего стоит запятая вместо ;
Несовпадение типовтекст там, где нужно число (или наоборот)
Деление на нольв знаменателе ноль или пустое поле
«Не даёт ДА/НЕТ»в условии формула должна быть проверкой: {Баллы} > 10, а не {Баллы} + 10
Результат не подходит к полюнапример, текст пытаемся записать в числовое поле — выберите поле другого типа
Превышен пределформула слишком длинная — разбейте её на несколько строк

Предупреждение «пусто у нового подписчика» — не ошибка. Оно значит, что у человека, который только пришёл, поле ещё не заполнено. Оберните поле в ЕСЛИПУСТО: ЕСЛИПУСТО({Баллы}; 0) + 5 — тогда пустое поле посчитается как ноль.

Где посмотреть, что посчиталось

  • Трассировка сценария в разделе «Диагностика» — для каждой строки расчёта видно, куда писали, что получилось и была ли ошибка.
  • Карточка подписчика — записалось ли поле и что в нём лежит.

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

Не могу добавить условие «По формуле». Почему? Шаг «Условие» целиком доступен на тарифе PRO. А вот посчитать значение действием «Расчёт по формулам» можно на любом тарифе.

Я переименовал поле. Формула сломается? Нет, всё продолжит работать. Сломается, только если поле удалить.

Скопировал сценарий в другой аккаунт. Формулы работают? Да, ссылки на поля настраиваются при копировании сами.

Сценарий опубликовался — значит, формула верная? Не обязательно. Публикация не блокируется ошибками в формулах. Проверяйте статус в самом блоке.

Пустое поле считается как ноль, а результат округляется. Это ошибка? Скорее всего, вы используете старое действие «Математические операции со значением» — у него такое поведение. Для точных расчётов возьмите «Расчёт по формулам».

ИИ вставил формулу, а она не работает. Откройте блок и посмотрите замечания. Если вы нажали «Вставить и поправить самому», формула могла остаться с ошибкой — исправьте её по подсказке.

Можно использовать промежуточное значение в другом блоке? Нет, оно живёт только внутри своего действия. Чтобы значение было доступно дальше, запишите его в поле подписчика.

Ничего не помогло. Напишите в поддержку и приложите: текст формулы целиком, что вы ожидали и что получилось, текст замечания из блока (если есть) и скриншот сценария. Так мы разберёмся быстрее.

👆 На этом пока всё