Формулы и калькулятор в amoCRM

При переходе сделки на этап бота, бот автоматически заполнит поле по результатам расчёта.

• Выберите этап, где будет работать бот, и нажмите + Добавить триггер.
• В списке выберите Salesbot → настройте условия → нажмите + Добавить нового бота.
• В настройках бота перейдите в раздел Виджеты → выберите Формулы.
• Нажмите на иконку карандаша.

• Выберите поле, в которое будет записываться результат.
• Введите формулу. Пример: lead['Цена товара'] - lead['Себестоимость товара']
• При необходимости добавьте несколько формул → повторите шаги.

При необходимости добавить следующие шаги и завершить работу бота. Далее сохранить бота и настройки воронки.

Realtime-формулы настраиваются в общих настройках виджета «Формулы» (не в Salesbot).

1. Откройте общие настройки виджета «Формулы».
2. Нажмите на Добавить.

3. Введите/выберите поле, куда записывать результат.

4. Введите формулу.

5. Сохраните настройки.

Как это работает на фронте:

• После открытия карточки сделки формулы выполняются автоматически.
• При изменении значений полей в карточке формулы пересчитываются автоматически.
• Результат сразу записывается в выбранные поля в этой же карточке.
• Пересчёт выполняется с небольшой задержкой, чтобы избежать лишних пересчётов при вводе.

В формулах можно использовать любые математические операции:

• сложение (+)
• вычитание (-)
• умножение (*)
• деление (/)

Формула не ограничивается двумя переменными. Допускается использование любого количества полей и значений, необходимых для вычисления результата.

1. Перейдите в бота с формулами.
2. Нажмите Настройка переменных.

3. Создайте новую переменную, указав:

• Название (только латинские буквы).
• Значение (число или текст).

Важно при работе с переменными:

Если переменная не является числом, преобразуйте её в числовой тип:

Если переменная не является текстом, преобразуйте её в текстовый тип:

Это необходимо для корректной работы формул и предотвращения ошибок при вычислениях.

После этого переменную можно использовать в формулах наравне с полями amoCRM.

Данный сценарий позволяет ежедневно перемещать ограниченное количество сделок в указанное время. Например, не более 10 сделок в день.

Создайте поле

Создайте переменную

Настройте ежедневный сброс счетчика

Создайте триггер:
Время запуска: 00:00

Каждый день счетчик будет обнуляться.

Настройте обработку сделок

Создайте триггер на необходимое время, например:
Время запуска: 10:00

Добавьте формулу:

Следующим действием увеличьте счетчик:

Как работает логика

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

• запускается первая сделка;
• система проверяет значение countDeals;
• если значение меньше 10, в поле «Переместить» записывается «Да»;
• после этого счетчик увеличивается на 1.

Далее аналогично обрабатывается вторая, третья, четвёртая и последующие сделки.

Например:

• 1-я сделка → countDeals = 0 → флаг = «Да»;
• 2-я сделка → countDeals = 1 → флаг = «Да»;
• …
• 10-я сделка → countDeals = 9 → флаг = «Да»;
• 11-я сделка → countDeals = 10 → флаг = «Нет».

Начиная с одиннадцатой сделки условие уже не выполняется, поэтому поле «Переместить» получит значение «Нет». Таким образом, только первые 10 сделок получат флаг для дальнейшей обработки.

Настройте перемещение сделки

Внутри бота добавьте необходимое действие. Пример конфигурации — в папке на Яндекс.Диске: открыть папку.

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

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

Чтобы вызвать подсказку, введите символ "[". После этого появится выпадающий список доступных полей.

Иногда amoCRM воспринимает значения как текст, из-за чего вместо сложения получается «склейка» (например: 10+14+5 = 10145).

Чтобы этого избежать, каждое значение нужно оборачивать в parseInt().

Пример:

Создание логических условий (if-else в одну строку)

Пример:

• если поле1 = «успех» → результат «да»
• иначе → результат «нет»

Поддерживаются разные операторы сравнения:

• >= — больше или равно
• <= — меньше или равно
• > — больше
• < — меньше
• !== — не равно

Пример с условиями:

Можно проверять значения полей и возвращать разные результаты.

Этот пример показывает вложенное условие (тернарный оператор) — когда внутри одного условия используется ещё одно.

🔹 Разбор формулы:

1. Проверяется условие: если расстояние ≤ 10 км → результат «300р.»
2. Если первое условие не выполнено, проверяется второе: если расстояние ≤ 30 км → результат «1000».
3. Если оба условия не выполнены: результат по умолчанию → «2000».

• До 10 км → 300р.
• От 11 до 30 км → 1000
• Больше 30 км → 2000

Иногда в результате вычислений может получиться число с большим количеством знаков после запятой. Чтобы ограничить их количество, используйте функцию .toFixed(x), где:

x — это число знаков после запятой, которое должно остаться.

Пример:

Если сумма = 105, количество = 7, то результат будет 15.00 (2 знака после запятой).

Сделки (lead):

• lead['ID'] — ID сделки
• lead['Название'] — Название сделки
• lead['Бюджет'] — Бюджет
• lead['status_id'] — ID статуса
• lead['pipeline_id'] — ID воронки
• lead['status_name'] — Название статуса
• lead['pipeline_name'] — Название воронки
• lead['Ответственный'] — ФИО ответственного
• lead['Поле'] — Дополнительное поле сделки

Контакт (contact):

• contact['ID'] — ID контакта
• contact['ФИО'] — ФИО контакта
• contact['Имя'] — Имя
• contact['Фамилия'] — Фамилия
• contact['Ответственный'] — ФИО ответственного
• contact['Поле'] — Дополнительное поле контакта

Компания (company):

• company['ID'] — ID компании
• company['Название'] — Название компании
• company['Ответственный'] — ФИО ответственного
• company['Поле'] — Дополнительное поле компании

Последний счёт (invoice):

• last_invoice['Статус'] — Статус
• last_invoice['Юр. лицо'] — Юр. лицо
• last_invoice['Плательщик'] — Плательщик
• last_invoice['Тип НДС'] — Тип НДС
• last_invoice['Дата оплаты'] — Дата оплаты
• last_invoice['Позиции счета'] — Позиции счета
• last_invoice['Позиции счета']?.length — Кол-во позиций
• last_invoice['Комментарий'] — Комментарий
• last_invoice['Стоимость'] — Стоимость
• last_invoice['Ссылка на оплату'] — Ссылка на оплату
• last_invoice['Внешний идентификатор'] — Внешний идентификатор
• last_invoice['Причина отсутствия НДС'] — Причина отсутствия НДС
• last_invoice['Поставщик'] — Поставщик
• last_invoice['Система налогообложения'] — Система налогообложения
• last_invoice['Ссылка на сделку'] — Ссылка на сделку
• last_invoice['Зашифрованная ссылка на оплату'] — Зашифрованная ссылка на оплату

Для работы со связанными сделками можно использовать массивы lead['contact_leads'] (сделки контакта) и lead['company_leads'] (сделки компании).

Примеры формул:

Число успешных сделок (статус 142):

Сумма успешных сделок (статус 142, сумма бюджетов):

Сумма сделок по числовому полю:

Число закрытых сделок (статус 143):

Число сделок в определенном статусе (пример ID статуса: 123123):

В формулах доступны переменные lead['notes'] (массив всех примечаний сделки) и lead['last_note_text'] (текст последнего примечания).

Примеры:

Текст последнего примечания:

Длина последнего входящего звонка (в секундах):

Длина последнего исходящего звонка (в секундах):

Дата последнего входящего звонка:

Дата последнего исходящего звонка:

Числовые:

Сложение чисел:

Вычитание:

Умножение:

Деление:

Преобразование числа в слова:

Текстовые:

Объединение строк:

Объединение с пробелом:

Разделение строки на блоки по 3 символа:

Флаги:

Значение: 'Да' (если отмечено) или пусто (если не отмечено).

Списки:

Чтение и запись как текст.

Мультисписки:

Значения считываются как текст, несколько значений разделяются ;

Сумма по всем спискам (тип Цена):

Сумма по конкретному списку:

Значение поля с ценой по ключу (пример: lead['list_sum_123'], где 123 — ID поля):

Ключ по названию поля из списка:

Разница дат (в днях):

Разница текущей даты и даты из поля:

Прибавить 7 дней:

Обновление даты +1 день (d — дни, M — месяцы, y — года):

Текущая дата:

Текущая дата + 7 дней:

Текст → число:

Число → текст:

ФИО в нужном падеже:

Операции со скобками:

Условия:

Если >10, то 1, иначе 0:

Проверка на равенство:

С текстом:

С вариантами:

В виджете доступны функции для автоматической привязки контактов и компаний к сделкам:

Привязка контактов

• Прикрепить контакт по Телефону — поиск контакта по номеру телефона
• Прикрепить контакт по Email — поиск контакта по адресу электронной почты
• Прикрепить контакт по кастомному полю — поиск контакта по любому кастомному полю (например, ИНН, внутренний ID и т.п.)

Привязка компаний

• Прикрепить компанию по кастомному полю — поиск компании по любому кастомному полю (например, ИНН, внутренний ID и т.п.)

При помощи этих функций можно автоматически находить и прикреплять контакты/компании к сделкам, либо создавать новые, если они не найдены. Настроить это можно с помощью Salesbot.

Настройка привязки по телефону или email

В выборе поля найдите раздел Функции:

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

Настройка привязки по кастомному полю

Для привязки контакта или компании по кастомному полю выберите нужное поле из списка доступных полей в интерфейсе виджета.

1. Выберите "Функции" → "Прикрепить контакт по кастомному полю" → выберите поле "ИНН" из списка
2. В формуле укажите поле сделки, откуда брать значение ИНН: return lead["ИНН"]

1. Выберите "Функции" → "Прикрепить компанию по кастомному полю" → выберите поле "Внутренний ID" из списка
2. В формуле укажите поле сделки, откуда брать ID: return lead["Внутренний ID"]

Конвертация валют

В формулах доступна функция convertCurrency() для автоматической конвертации валют по официальным курсам ЦБ РФ.

Формат функции: await convertCurrency(сумма, "исходная_валюта", "целевая_валюта")

Поддерживаемые валюты (54 валюты)

Основные мировые валюты:

• USD — Доллар США
• EUR — Евро
• GBP — Фунт стерлингов
• CHF — Швейцарский франк
• CNY — Китайский юань
• JPY — Японская иена
• RUB — Российский рубль

Популярные валюты: AUD (Австралийский доллар), CAD (Канадский доллар), NZD (Новозеландский доллар), HKD (Гонконгский доллар), SGD (Сингапурский доллар), TRY (Турецкая лира), INR (Индийская рупия), BRL (Бразильский реал), ZAR (Южноафриканский рэнд), KRW (Южнокорейская вона)

Валюты СНГ: KZT (Казахстанский тенге), BYN (Белорусский рубль), UAH (Украинская гривна), AZN (Азербайджанский манат), AMD (Армянский драм), GEL (Грузинский лари), KGS (Киргизский сом), MDL (Молдавский лей), TJS (Таджикский сомони), TMT (Туркменский манат), UZS (Узбекский сум)

Европейские валюты: PLN (Польский злотый), CZK (Чешская крона), HUF (Венгерский форинт), RON (Румынский лей), RSD (Сербский динар), DKK (Датская крона), NOK (Норвежская крона), SEK (Шведская крона)

Азиатские валюты: THB (Тайский бат), VND (Вьетнамский донг), IDR (Индонезийская рупия), MMK (Мьянманский кьят), BDT (Бангладешская така)

Ближний Восток: AED (Дирхам ОАЭ), SAR (Саудовский риял), QAR (Катарский риал), OMR (Оманский риал), BHD (Бахрейнский динар), EGP (Египетский фунт), IRR (Иранский риал)

И другие: DZD, MNT, BOB, CUP, NGN, ETB, XDR

Примеры использования

Пример 1: Конвертировать 100 долларов в рубли

Пример 2: Конвертировать бюджет сделки из долларов в евро

Пример 3: Посчитать 15% от бюджета и конвертировать в доллары

Пример 4: Конвертировать между валютами СНГ (тенге в рубли)

Особенности работы

• Курсы валют обновляются автоматически раз в день из API ЦБ РФ
• Результат округляется до 2 знаков после запятой
• Курсы кешируются для быстрой работы (повторные запросы выполняются мгновенно)
• Конвертация между любыми валютами (не обязательно через рубли)
• При ошибке возвращает исходную сумму