# Як налаштувати шаблони email (хедер і футер)?

Шаблони email дозволяють задати єдиний HTML-хедер та HTML-футер для листів, що відправляються з кожної email-адреси. Усі листи з цієї адреси (відповіді оператора в email-чаті або листи з сценарію через action «Відправити email») автоматично отримають ваш логотип, привітання, контакти або інший оформлений блок зверху та знизу.

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

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

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

- **Хедер і футер** — це HTML-код. Їх можна задати окремо: тільки хедер, тільки футер або обидва. Хоча б одне з полів має бути заповнене при збереженні.
- **Список email** на сторінці — це ті самі адреси, що використовуються для відправки в операторській панелі та в скілл-групах (Gmail, Outlook, Mailgun тощо).
- **Застосування:** шаблон автоматично додається до листів, надісланих оператором у email-чаті та до листів, відправлених через action сценарію «Відправити email» з відповідної адреси. Якщо шаблон вимкнено або не налаштований — лист відправляється лише з тілом.
- **Розмір:** кожне поле (хедер або футер) обмежене за розміром (до 512 KB). При перевищенні збереження буде заблоковано з повідомленням про помилку.

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

- [ ] Ви увійшли в систему з правами, що дозволяють перегляд та збереження налаштувань операторської панелі (`settings.canShow` / `settings.canSave`).
- [ ] У системі налаштована хоча б одна email-адреса для відправки (наприклад, через Mailgun, Gmail або Outlook).

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

### 1. Відкрити сторінку «Шаблони email»

1. Перейдіть до модуля **Налаштування** (меню або адреса `/settings-page`).
2. У бічному меню відкрийте розділ **«Налаштування»** (операторська панель).
3. Натисніть пункт **«Шаблони email»** (`/settings-page/op-settings/email-templates`).

Відкриється таблиця з усіма email-адресами, доступними в системі. Для кожної адреси відображаються: сама адреса, позначка (label), чи є збережений шаблон, чи шаблон активний, та дія **«Налаштувати шаблон»**.

### 2. Відкрити редактор шаблону для обраної адреси

1. У таблиці знайдіть потрібну email-адресу.
2. Натисніть **«Налаштувати шаблон»**.

Відкриється панель (drawer) з двома полями для HTML: **Header HTML** та **Footer HTML**, перемикачем **«Застосовувати шаблон»** та блоком **«Прев'ю»**.

### 3. Заповнити хедер і/або футер

1. У полі **Header HTML** введіть HTML-код для верхньої частини листа (наприклад, логотип, привітання). Поле може залишатися порожнім, якщо потрібен лише футер.
2. У полі **Footer HTML** введіть HTML-код для нижньої частини листа (контакти, посилання, юридична інформація). Поле може залишатися порожнім, якщо потрібен лише хедер.
3. Переконайтеся, що **хоча б одне** з полів не порожнє — інакше збереження буде неможливе.
4. Перегляньте результат у блоці **«Прев'ю»**: там відображається, як виглядатиме лист (хедер + приклад тіла + футер).

**Порада:** Використовуйте прості HTML-теги (`<div>`, `<p>`, `<a>`, `<img>`, стилі в атрибуті `style`). Складні скрипти в листах не виконуються; прев'ю в інтерфейсі показується в безпечному режимі.

### 4. Зберегти шаблон

1. Переконайтеся, що перемикач **«Застосовувати шаблон»** увімкнено, якщо шаблон має застосовуватися до листів.
2. Натисніть **«Зберегти»**.

Після успішного збереження панель закривається, а в таблиці для цієї адреси з’являються позначки «Є шаблон» та «Активний». Усі наступні листи, відправлені з цієї адреси, отримають заданий хедер і футер.

### 5. Тимчасово вимкнути або видалити шаблон (за потреби)

- **Вимкнути без видалення:** У панелі редагування вимкніть перемикач **«Застосовувати шаблон»**. Зміни збережуться автоматично (або натисніть «Зберегти»). Листи з цієї адреси тимчасово будуть без хедера та футера; шаблон залишиться в системі і його можна знову ввімкнути.
- **Повністю видалити:** У панелі натисніть **«Видалити шаблон»**, підтвердіть дію. Шаблон буде видалено; листи з цієї адреси знову будуть лише з тілом.

## Типові помилки

- **«Обидва поля не можуть бути порожніми»** — при збереженні хоча б одне з полів (Header HTML або Footer HTML) має містити текст або HTML. Додайте хедер або футер і збережіть знову.
- **Помилка про перевищення розміру** — розмір одного з полів перевищує допустимий ліміт (512 KB). Скоротіть вміст або винесіть частину в окремі блоки.
- **Після збереження листи без хедера/футера** — перевірте, чи увімкнено перемикач «Застосовувати шаблон» для цієї адреси. Переконайтеся, що лист відправляється саме з тієї адреси, для якої налаштовано шаблон.

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

- [Налаштувати загальні налаштування](/uk/settings/how-to/configure-system-settings.md) — загальні параметри операторської панелі.
- [Налаштувати чати](/uk/settings/how-to/configure-chats.md) — налаштування діалогів.
- [Налаштувати тікети](/uk/settings/how-to/configure-tickets.md) — налаштування тікетів.