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

Например, вы можете автоматически вставлять имя актёра (менеджера, сотрудника), название компании, ссылку на продукт, промокод или любое другое значение, заданное заранее. Это особенно удобно, если вы хотите стандартизировать шаблоны сообщений, но при этом сохранить индивидуальный подход.

Что такое кастомные макросы

Переменные — это элементы, которые позволяют вам задавать кастомные макросы в настройках спота.
Все переменные, заданные в споте, становятся доступны для использования в бизнес-процессах (БП), связанных с этим спотом.
Использовать их можно, например:

• в блоке «Отправить сообщение»,
• или в блоке «Вебхук».

Как добавить кастомный макрос 

Для создания переменной переходим в раздел «Споты». 

Нажмите кнопку «Переменные», затем выберите «Добавить переменную».

В открывшемся окне заполните поля:

Название — укажите удобное для вас имя переменной (например, Имя ответственного менеджера).

Значение — введите уникальное имя макроса, начиная со слова variable.
Например: variable__manager или variable__product.
 

⚠️ Важно: каждому макросу должно соответствовать уникальное значение — одинаковые названия использовать нельзя.

Нажмите кнопку «Сохранить».

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

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

Как выбрать и задать макрос в споте 

Перейдите в редактирование нужного спота и откройте раздел «Переменные».

Нажмите кнопку «Добавить переменную».

В поле «Переменная» выберите название нужного макроса из выпадающего списка.

В поле «Значение» укажите текст, который должен подставляться вместо макроса.
Например:

для {variable__manager} — Татьяна Никулина

для {variable__product} — CRM SmartFlow

Нажмите кнопку «Внести изменения».

Как использовать макрос в сообщениях

Чтобы использовать переменную в тексте, добавьте её в фигурных скобках.
Например:

Если в настройках спота указано:

Значение = Татьяна Никулина

То сообщение при отправке примет вид:

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

1. В приветственном сообщении:

2. В уведомлении для клиента:

💡 Примеры кастомных макросов

1. Макросы для коммуникации

2. Макросы для персонализации сообщений

Действия с переменными

• Редактирование — изменяйте настройки уже созданной переменной.
• Удаление — удалите ненужную переменную.

⚙️Редактирование столбцов

По нажатию кнопки "Редактировать" открывается окно настройки таблицы, где вы можете:

• Настроить отображение/скрытие нужных столбцов с помощью иконки 👁
• Закрепить столбцы в начале таблицы – иконка 📌
• Перетаскивать строки для изменения порядка отображения

После внесения нужных изменений необходимо нажать кнопку "Внести изменения".

Использование переменных в вебхуках

Кастомные макросы (переменные), заданные в настройках спота, можно использовать не только в текстах сообщений, но и в блоке «Вебхук» внутри бизнес-процессов.
Это позволяет передавать динамические данные во внешние системы: CRM, аналитику, сервисы уведомлений и любые API.

Общий принцип работы

Логика использования переменных в вебхуке выглядит следующим образом:

• В настройках спота создаются переменные (кастомные макросы).
• Для каждой переменной в конкретном споте задаётся значение.
• В бизнес-процессе настраивается блок «Вебхук».
• В теле вебхука используются макросы в формате {variable__name}.
• При выполнении бизнес-процесса макросы автоматически заменяются на реальные значения.
• Во внешний сервис отправляется уже заполненный данными запрос.

Использование переменных в теле вебхука

Переменные можно вставлять в любое текстовое поле вебхука:

• тело запроса (Body),
• параметры,
• заголовки (Headers),
• URL (если поддерживается).

Пример вебхука с переменными

Как это работает на практике

Если в настройках спота заданы значения:

variable__leadname = Иван Петров

variable__actorname = Анна Смирнова

variable__company = ООО «ТехноПлюс»

variable__status = Новый лид

variable__source = Сайт

Во внешний сервис будет отправлен следующий JSON:

Использование переменных в URL вебхука

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

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

Использование переменных в заголовках (Headers)

Это удобно, если нужно передать данные для авторизации или маршрутизации:

Важные особенности и ограничения

• Если для переменной не задано значение, в вебхук будет передана пустая строка.
• Названия макросов чувствительны к точному совпадению — ошибка в имени приведёт к некорректной подстановке.
• Переменные подставляются в момент выполнения бизнес-процесса, а не при сохранении.

Рекомендации по использованию

• Используйте понятные и единообразные имена макросов (variable__leadname, variable__deal_id).
• Передавайте через вебхуки только необходимые данные, чтобы не перегружать запрос.
• Для сложных интеграций используйте ID и статусы, а не свободный текст.
• Проверяйте вебхук в тестовом сценарии перед использованием в продакшене.

Типовые сценарии использования

• Передача данных лида в CRM
• Отправка информации о статусе сделки
• Логирование событий во внешнюю систему
• Синхронизация данных между спотами
• Интеграция с аналитическими и BI-сервисами

Преимущества кастомных макросов

🔄 Автоматизация: данные подставляются автоматически, без ручного редактирования.

💬 Персонализация: каждое сообщение выглядит индивидуально и живо.

⚙️ Гибкость: можно создавать любые переменные под нужды конкретного спота.

🧩 Единообразие: один шаблон можно использовать в разных процессах и сценариях.