Макрос — это особая строка внутри текстового блока, который во время отправки заменяется необходимыми данными:
- значение одного из полей в профиле подписчика (например, имя или значение кастомного поля);
- относительная дата (текущая дата или текущая дата + X дней);
- глобальные переменные;
- индивидуальные ссылки для работы той или иной интеграции (например, автоматизация приёма платежей).
Конструкции имеют следующий вид: {%first_name%}
В фигурных скобках прописываются название поля или параметры даты.
Пример:
Макрос {%first_name%} автоматически заменится на имя подписчика внутри сообщения.
(!) В URL-кнопках макросы будут работать. Они определяются BotHelp, на их место подставляются нужные данные, затем ссылка будет сокращена и примет вид https://s.bothelp.io/xxxxxx
(!) Нельзя использовать макросы внутри сокращённых ссылок из сторонних сервисов. В таком случае BotHelp не сможет найти макрос и подставить на его место текст.
Где найти макросы?
Во всех текстовых блоках макросы находятся в меню <…>.
Поле как макрос
Любое поле может быть использовано как макрос. Для этого выберите нужное поле из списка макросов. Значение поля будет вставлено в текст без изменений.
Варианты использования:
— для обращения к подписчику по имени используйте макрос поля «Имя»;
— для вывода результатов викторины используйте макрос поля «Баллы», в котором вы делали подсчёт.
Макросы в названиях кнопок в ботах
В названии инлайн-кнопки в боте можно использовать макросы:
- значение одного из полей в профиле подписчика. Например, имя или значение кастомного поля;
- относительная дата (текущая дата или текущая дата + 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)%}. Узнать больше ↗
Если вы не нашли ответ на свой вопрос, задайте его нам в чате внутри кабинета либо напишите на [email protected] 😃
Получите 14 дней полного функционала платформы для создания рассылок, автоворонок и чат-ботов BotHelp.