Макросы

Открыть в новом окне по ссылке

Макрос — это особая строка внутри текстового блока, который во время отправки заменяется необходимыми данными:

• значение одного из полей в профиле подписчика (Например имя или значение кастомного поля)
• относительная дата (текущая дата или текущая дата + X дней)
• глобальные переменные
• индивидуальные ссылки для работы той или иной интеграции (например Автоматизация приема платежей)

Конструкции имеют следующий вид: {%first_name%} - в фигурных скобках прописывается название поля или параметры даты.

Пример:
Макрос {%first_name%} автоматически заменится на имя подписчика внутри сообщения. 

(!) В URL-кнопках макросы будут работать. Они определяются Ботхелпом, на их место подставляются нужные данные, затем ссылка будет сокращена и примет вид   https://s.bothelp.io/xxxxxx

(!) Нельзя использовать макросы внутри сокращенных ссылок из сторонних сервисов. В таком случае Ботхелп не сможет найти макрос и подставить на его место текст. 

Где найти макросы?

Во всех текстовых блоках макросы находятся в меню <...>

Поле как макрос

Любое поле может быть использовано как макрос. Для этого выберите нужное поле из списка макросов. Значение поля будет вставлено в текст без изменений.

Варианты использования: 

- для обращения к подписчику по имени используйте макрос поля "Имя"; 

- для вывода результатов викторины используйте макрос поля "Баллы", в котором вы делали подсчёт.

Макросы в названиях кнопок в Ботах

В названии инлайн-кнопки в боте можно использовать макросы:

• значение одного из полей в профиле подписчика (Например имя или значение кастомного поля);
• относительная дата (текущая дата или текущая дата + X дней);
• глобальные переменные;

В названии одной кнопки можно использовать одновременно несколько макросов и вручную введенный текст.
Все знаки, которые выйду за лимит, будут закрыты многоточием “…”

Важно! Если подписчику отправлена кнопка с макросом пустого поля, то могут возникнуть ошибки (В Telegram-ботах такая кнопка не отправится, в ВК-ботах не отправится кнопка и остальные элементы карточки, в ботах других каналов такие кнопки не будут работать).
Если вы опасаетесь того, что можете случайно отправить "пустой" макрос, то добавьте любой символ/эмодзи в название данной кнопки.

Макрос в названии кнопки можно выбрать и вставить с помощью кнопки <...> в поле ввода названия кнопки.

Генератор случайных чисел

Макрос подставляет вместо себя рандомное число из интервала, который указан в скобках. Формат макроса: {?random_num(0,99)?} - вместо такого макроса вернется случайное число от 0 до 99

• Доступен только для Числовых полей
• Диапазон можно задавать свой (любой)

• Можно использовать в мат операциях
• Можно вставлять просто в текстовых сообщениях

Например, вы хотите выдавать случайный размер скидки от 10% до 50%. Тогда макрос будет выглядеть так {?random_num(10,50)?}

Макрос оплаты

Когда вы создаете автоматизацию оплаты ей присваивается определенный макрос. Внутри текста он отображается как {%payment_x%}, а после отправки в тексте сообщения формируется ссылка, которая ведет на лендинг оплаты.
Чтобы добавить макрос оплаты, выберите его из списка. Подписчику придет сообщение со ссылкой на лендинг оплаты.

Макросы utm-меток

Макросы хранят в себе те данные, которые передались в ссылке при подписке, а именно все utm-метки. Вы можете добавить к ссылке ведущей на ваш сайт, одну метку ?{%utm_source%} или сразу все при помощи макроса ?{%ref%}.
Позже вы сможете отследить эти метки на своем сайте и провести анализ.

Макрос относительной даты

Этот макрос позволяет не указывать точную дату, а задать значение, которое будет подставляться на лендинге или в сообщении. Расчет даты происходит от сегодняшнего дня.
Пример макроса даты {%today+1 (d F)%}. Подробнее об их использовании читайте в статье: Относительная дата ↗.

Макрос разделения времени

Для лендингов существует специфический макрос, который покажет разный контент в зависимости от времени в которое подписчик зашел на лендинг. Пример макроса {%split 18:00 today (d F) | today+1 (d F)%}. Узнать больше ↗

Если вы не нашли ответ на свой вопрос, задайте его нам в чате внутри кабинета либо напишите на hello@bothelp.io 😃

Получите 14 дней полного функционала платформы для создания рассылок, автоворонок и чат-ботов BotHelp.

Получить 14 дней бесплатно