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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

**Приклади правильних alias:**
- `welcome_message`
- `promo_offer_2024`
- `support_chat`

**Приклади неправильних alias:**
- `123welcome` (починається з цифр)
- `привітання` (кирилиця)
- `welcome message` (пробіли)

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

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

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

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

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

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

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

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

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

## Пов'язані матеріали

- [Створити шаблон розсилки](/uk/broadcast/how-to/create-broadcast-template.md)
- [Надіслати розсилку з модуля Клієнти](/uk/broadcast/how-to/send-broadcast-from-clients.md)
- [Створити розсилку](/uk/broadcast/how-to/create-broadcast.md)