> ## Documentation Index
> Fetch the complete documentation index at: https://help.teable.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Налаштування поштового сервісу

> Увімкніть поштовий сервіс, щоб активувати сповіщення електронною поштою в застосунку, самостійне скидання пароля, листи із запрошеннями та інші функції.

## Способи налаштування

Teable підтримує два способи налаштування поштового сервісу:

<CardGroup cols={2}>
  <Card title="Панель адміністратора (рекомендовано)" icon="sliders" href="#option-1-admin-panel-recommended">
    Візуальне налаштування з перевіркою в реальному часі. Перезапуск не потрібен.
  </Card>

  <Card title="Змінні середовища" icon="code" href="#option-2-environment-variables">
    Традиційне налаштування через файл `.env`. Потребує перезапуску контейнера.
  </Card>
</CardGroup>

***

<h2 id="option-1-admin-panel-recommended">
  Варіант 1. Панель адміністратора (рекомендовано)
</h2>

Найпростіше налаштувати електронну пошту через панель адміністратора:

1. Увійдіть як адміністратор (перший зареєстрований користувач)
2. Перейдіть до **Панель адміністратора** → **Налаштування екземпляра**
3. Знайдіть розділ **Електронна пошта**
4. Налаштуйте **Пошту для сповіщень** і **Пошту для автоматизацій** відповідно до потреб

<Tip>
  Налаштування в панелі адміністратора підтримують **перевірку в реальному часі** — ви можете переконатися, що параметри SMTP працюють, перш ніж зберігати їх.
</Tip>

* **Пошта для сповіщень**: використовується для підтвердження користувачів, скидання пароля, запрошень, системних сповіщень та подібних листів.
* **Пошта для автоматизацій**: використовується як стандартний поштовий сервіс для дій автоматизації «Надіслати електронного листа». Для окремої дії «Надіслати електронного листа» також можна налаштувати власний [SMTP-сервер](/uk/basic/automation/actions/communication/smtp-sender).

### Джерела налаштувань і пріоритет

Рекомендуємо спочатку налаштувати поштовий сервіс у розділі **Панель адміністратора → Налаштування екземпляра → Електронна пошта**. Застосовується такий порядок пріоритетності:

1. **Власний поштовий сервер у дії «Надіслати електронного листа»**: застосовується лише до цієї конкретної дії «Надіслати електронного листа» в поточній автоматизації.
2. **Панель адміністратора → Налаштування екземпляра → Електронна пошта → Пошта для автоматизацій**: використовується для листів автоматизації, якщо для дії «Надіслати електронного листа» не налаштовано власний поштовий сервер.
3. **Панель адміністратора → Налаштування екземпляра → Електронна пошта → Пошта для сповіщень**: використовується для підтвердження користувачів, скидання пароля, запрошень, системних сповіщень та подібних листів. Також використовується для листів автоматизації як резервний варіант, якщо пошту для автоматизацій не налаштовано.
4. **Змінні середовища `BACKEND_MAIL_*`**: стандартна конфігурація пошти на рівні розгортання. Використовується лише як резервний варіант, якщо відповідну поштову скриньку не налаштовано в панелі адміністратора.

### Поля налаштувань

| Поле               | Опис                               | Приклад                     |
| ------------------ | ---------------------------------- | --------------------------- |
| Адреса сервера     | Адреса SMTP-сервера                | `smtp.gmail.com`            |
| Порт               | Порт SMTP                          | `465` (SSL) або `587` (TLS) |
| SSL/TLS            | Чи використовувати SSL/TLS         | `true`                      |
| Ім’я користувача   | Користувач для автентифікації SMTP | `noreply@company.com`       |
| Пароль             | Пароль SMTP або пароль застосунку  | `xxxxxxxxxxxxxx`            |
| Адреса відправника | Адреса в полі «Від»                | `noreply@company.com`       |
| Ім’я відправника   | Відображуване ім’я                 | `Сповіщення Teable`         |

***

<h2 id="option-2-environment-variables">
  Варіант 2. Змінні середовища
</h2>

Якщо у вашому розгортанні зручніше використовувати конфігураційні файли, задайте змінні середовища:

<Note>
  Рекомендуємо спочатку налаштувати пошту для сповіщень і пошту для автоматизацій у розділі **Панель адміністратора → Налаштування екземпляра → Електронна пошта**. Змінні середовища переважно використовуються як стандартні налаштування та резервна конфігурація на рівні розгортання.
</Note>

```sh theme={null}
BACKEND_MAIL_HOST=smtp.example.com
BACKEND_MAIL_PORT=465
BACKEND_MAIL_SECURE=true
BACKEND_MAIL_SENDER=noreply@company.com
BACKEND_MAIL_SENDER_NAME=Teable
BACKEND_MAIL_AUTH_USER=username
BACKEND_MAIL_AUTH_PASS=your_password
```

<Note>
  Після зміни змінних середовища необхідно **перезапустити** контейнер Teable, щоб зміни набули чинності.
</Note>

***

## Приклади для постачальників SMTP

<Accordion title="AWS SES">
  ```sh theme={null}
  # Як отримати: консоль AWS → Simple Email Service → Налаштування SMTP → Створити облікові дані SMTP
  BACKEND_MAIL_HOST=email-smtp.us-east-1.amazonaws.com  # Замініть на свій регіон
  BACKEND_MAIL_PORT=465
  BACKEND_MAIL_SECURE=true
  BACKEND_MAIL_SENDER=noreply@yourdomain.com  # Має бути підтверджена адреса відправника
  BACKEND_MAIL_SENDER_NAME=Сповіщення Teable
  BACKEND_MAIL_AUTH_USER=your_smtp_username   # Ім’я користувача AWS SMTP
  BACKEND_MAIL_AUTH_PASS=xxxxxxxxxxxxxx       # Пароль AWS SMTP
  ```
</Accordion>

<Accordion title="Gmail">
  ```sh theme={null}
  # Як отримати: обліковий запис Google → Безпека → Двоетапна перевірка → Паролі застосунків
  BACKEND_MAIL_HOST=smtp.gmail.com
  BACKEND_MAIL_PORT=465
  BACKEND_MAIL_SECURE=true
  BACKEND_MAIL_SENDER=you@gmail.com
  BACKEND_MAIL_SENDER_NAME=Сповіщення Teable
  BACKEND_MAIL_AUTH_USER=you@gmail.com
  BACKEND_MAIL_AUTH_PASS=xxxxxxxxxxxxxx  # 16-значний пароль застосунку
  ```
</Accordion>

<Accordion title="Microsoft 365 / Outlook">
  ```sh theme={null}
  # Як отримати: центр адміністрування Microsoft 365 → Безпека → Політики та правила → Автентифікація електронної пошти
  BACKEND_MAIL_HOST=smtp.office365.com
  BACKEND_MAIL_PORT=587
  BACKEND_MAIL_SECURE=true
  BACKEND_MAIL_SENDER=your.name@yourdomain.com
  BACKEND_MAIL_SENDER_NAME=Сповіщення Teable
  BACKEND_MAIL_AUTH_USER=your.name@yourdomain.com
  BACKEND_MAIL_AUTH_PASS=xxxxxxxxxxxxxx  # Ваш пароль Microsoft 365 або пароль застосунку
  ```
</Accordion>

<Accordion title="SendGrid">
  ```sh theme={null}
  # Як отримати: панель SendGrid → Налаштування → Ключі API → Створити ключ API
  BACKEND_MAIL_HOST=smtp.sendgrid.net
  BACKEND_MAIL_PORT=465
  BACKEND_MAIL_SECURE=true
  BACKEND_MAIL_SENDER=noreply@yourdomain.com
  BACKEND_MAIL_SENDER_NAME=Сповіщення Teable
  BACKEND_MAIL_AUTH_USER=apikey
  BACKEND_MAIL_AUTH_PASS=xxxxxxxxxxxxxx  # Ваш ключ API SendGrid
  ```
</Accordion>

***

## Пов’язана документація

* [Довідник змінних середовища](/uk/deploy/env)
* [Огляд панелі адміністратора](/uk/basic/admin-panel/overview)
