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

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

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

Панель адміністратора (рекомендовано)

Візуальне налаштування з перевіркою в реальному часі. Перезапуск не потрібен.

Змінні середовища

Традиційне налаштування через файл .env. Потребує перезапуску контейнера.

Варіант 1. Панель адміністратора (рекомендовано)

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

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

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

Пошта для сповіщень: використовується для підтвердження користувачів, скидання пароля, запрошень, системних сповіщень та подібних листів.
Пошта для автоматизацій: використовується як стандартний поштовий сервіс для дій автоматизації «Надіслати електронного листа». Для окремої дії «Надіслати електронного листа» також можна налаштувати власний SMTP-сервер.

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

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

Власний поштовий сервер у дії «Надіслати електронного листа»: застосовується лише до цієї конкретної дії «Надіслати електронного листа» в поточній автоматизації.
Панель адміністратора → Налаштування екземпляра → Електронна пошта → Пошта для автоматизацій: використовується для листів автоматизації, якщо для дії «Надіслати електронного листа» не налаштовано власний поштовий сервер.
Панель адміністратора → Налаштування екземпляра → Електронна пошта → Пошта для сповіщень: використовується для підтвердження користувачів, скидання пароля, запрошень, системних сповіщень та подібних листів. Також використовується для листів автоматизації як резервний варіант, якщо пошту для автоматизацій не налаштовано.
Змінні середовища 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`

Варіант 2. Змінні середовища

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

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

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

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

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

AWS SES

# Як отримати: консоль 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

Gmail

# Як отримати: обліковий запис 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-значний пароль застосунку

Microsoft 365 / Outlook

# Як отримати: центр адміністрування 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 або пароль застосунку

SendGrid

# Як отримати: панель 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

Ліцензія для самостійного розгортання

Швидкий старт

Панель адміністратора