Як налаштувати alias у розсилках?

Alias (точка входу) необхідний для переходу в сценарій бота та відображення кнопок у розсилці. Налаштування alias дозволяє направляти користувачів до потрібного блоку сценарію після отримання розсилки.

Коли знадобиться

Потрібно додати кнопки в розсилку для переходу в сценарій бота.
Треба направити користувачів до конкретного блоку сценарію після отримання повідомлення.
Потрібно створити інтерактивну розсилку з можливістю взаємодії.

Що важливо знати

Alias — ідентифікатор точки входу в сценарій бота, який використовується в розсилках.
Alias має бути написаний латиницею.
Початкові символи не можуть бути цифрами.
Якщо alias на момент відправки в сценарії боту відсутній, текст розсилки все одно відправиться, але перехід у сценарій не відбудеться (кнопки не з'являться, користувач залишиться на поточній позиції в сценарії).
Після завершення розсилки переконайтеся, що у сценарії є блок з кнопками для подальших дій.

Перед початком

Ви увійшли в систему з правами інтегратора або адміністратора.
Ви маєте доступ до конструктора сценаріїв.
У вас є шаблон розсилки або ви створюєте новий.
Ви знаєте, до якого блоку сценарію потрібно направити користувачів.

Покрокова інструкція

Налаштування alias в сценарії

Перейдіть у конструктор сценаріїв бота.
Додайте блок "З'єднання між точками (точка входу)" в сценарій.
У налаштуваннях блоку вкажіть "Назву action'а" (наприклад, welcome_message або promo_offer).
- Назва має бути написана латиницею
- Не може починатися з цифр
З'єднайте блок точки входу з блоком "Повідомлення з клавіатурою".
У блоці повідомлення додайте кнопки, які будуть відображатися в розсилці.
Збережіть зміни в сценарії.

Використання alias в шаблоні розсилки

У модулі Broadcast відкрийте шаблон розсилки для редагування або створіть новий.
У полі "Alias action сценарію" введіть назву action'а, яку ви вказали в сценарії (наприклад, welcome_message).
Переконайтеся, що alias точно відповідає назві в сценарії (з урахуванням регістру).
Збережіть шаблон.

Важливі вимоги до alias

✅ Alias має бути написаний латиницею.
✅ Початкові символи не можуть бути цифрами.
⚠️ Якщо alias на момент відправки в сценарії боту відсутній: текст розсилки відправиться, але перехід у сценарій не виконається (кнопки не з'являться).

Приклади правильних alias:

welcome_message
promo_offer_2024
support_chat

Приклади неправильних alias:

123welcome (починається з цифр)
привітання (кирилиця)
welcome message (пробіли)

Що відбувається після

Після отримання розсилки користувачі побачать кнопки (якщо вони додані в блок повідомлення) та зможуть перейти до відповідного блоку сценарію, натиснувши на кнопку. Система направить користувача до блоку з вказаним alias.

⚠️ Важливо: Після завершення розсилки переконайтеся, що у сценарії є блок з кнопками для подальших дій. Точка входу повинна містити Alias action сценарію, який вказується при заповненні розсилки.

Що відбувається, якщо alias не знайдено

Якщо в шаблоні розсилки вказано alias, якого немає в сценарії бота (або він видалений/перейменований):

Текст розсилки відправиться користувачу
Перехід у сценарій не виконається — кнопки не з'являться
Позиція користувача в сценарії не зміниться (не використовується стара позиція з попередніх розсилок)

Переконайтеся, що alias точно відповідає назві в сценарії (з урахуванням регістру).

Як переконатися, що все вдалось

Перевірте, що alias вказано правильно в шаблоні розсилки.
Переконайтеся, що alias існує в сценарії бота та з'єднаний з блоком повідомлення.
Створіть тестову розсилку та перевірте, що кнопки відображаються та працюють коректно.
Перевірте, що користувач потрапляє до потрібного блоку сценарію після натискання кнопки.