Переменные

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

Синтаксис переменных

Переменные обозначаются двойными фигурными скобками:

text

Привет, {{contact.name}}!
Бюджет сделки: {{deal.budget}} ₽
Ответственный: {{deal.responsible.name}}

Встроенные переменные

Данные сделки (deal)

Переменная	Описание	Пример
`deal.id`	ID сделки	12345
`deal.name`	Название	Продажа CRM
`deal.budget`	Бюджет	150000
`deal.status.name`	Название статуса	Переговоры
`deal.status.id`	ID статуса	142
`deal.pipeline.name`	Название воронки	Продажи
`deal.created_at`	Дата создания	2025-01-15T10:30:00Z
`deal.updated_at`	Дата обновления	2025-01-15T14:20:00Z
`deal.responsible.id`	ID ответственного	567
`deal.responsible.name`	Имя ответственного	Иван Петров
`deal.tags`	Теги (массив)	["VIP", "Срочно"]

Данные контакта (contact)

Переменная	Описание
`contact.id`	ID контакта
`contact.name`	Полное имя
`contact.first_name`	Имя
`contact.last_name`	Фамилия
`contact.email`	Email (основной)
`contact.phone`	Телефон (основной)
`contact.position`	Должность
`contact.company.name`	Название компании

Данные компании (company)

Переменная	Описание
`company.id`	ID компании
`company.name`	Название
`company.industry`	Сфера деятельности

Данные задачи (task)

Переменная	Описание
`task.id`	ID задачи
`task.text`	Текст задачи
`task.type`	Тип задачи
`task.due_date`	Срок выполнения
`task.result`	Результат выполнения

Кастомные поля

Кастомные поля amoCRM доступны через: {{deal.cf.field_name}} или {{contact.cf.field_name}}

Фильтры и модификаторы

Переменные можно трансформировать с помощью фильтров:

Форматирование дат

text

{{deal.created_at | date:"DD.MM.YYYY"}} → 15.01.2025
{{deal.created_at | date:"relative"}} → 2 дня назад
{{deal.created_at | date:"human"}} → 15 января 2025

Форматирование чисел

text

{{deal.budget | number}} → 150,000
{{deal.budget | currency:"RUB"}} → 150 000 ₽
{{deal.budget | currency:"USD"}} → $1,500.00

Работа со строками

text

{{contact.name | upper}} → ИВАН ПЕТРОВ
{{contact.name | lower}} → иван петров
{{contact.name | capitalize}} → Иван петров
{{contact.name | truncate:10}} → Иван Петр...

Массивы

text

{{deal.tags | join:", "}} → VIP, Срочно, Крупный клиент
{{deal.tags | first}} → VIP
{{deal.tags | count}} → 3

Условия

text

{{deal.budget > 100000 ? "VIP" : "Стандарт"}} → VIP
{{contact.email | default:"email@не.указан"}} → email@не.указан

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

В сценариях можно создавать собственные переменные:

yaml

# Установка переменной
- type: variable_set
  name: discount
  value: "{{deal.budget > 100000 ? 10 : 5}}"

# Использование
- type: send_email
  body: "Ваша скидка: {{vars.discount}}%"

Глобальные переменные

Доступны во всех сценариях:

Переменная	Описание	Пример
`now`	Текущая дата/время	2025-01-15T10:30:00Z
`today`	Сегодняшняя дата	2025-01-15
`yesterday`	Вчерашняя дата	2025-01-14
`tomorrow`	Завтрашняя дата	2025-01-16
`scenario.id`	ID текущего сценария	sc_12345
`scenario.name`	Название сценария	Приветствие новых клиентов
`execution.id`	ID текущего выполнения	ex_67890

Безопасность

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

Отладка переменных

Для проверки значений переменных используйте действие debug:

yaml

- type: debug
  message: "Сделка {{deal.name}}, бюджет {{deal.budget}}"

Вывод появится в логе выполнения сценария.