# Почта и внешние сервисы

Подключение к SMTP-серверу для отправки писем, параметры работы с Telegram Bot API и параметры исходящих HTTP-соединений.

Как изменить параметры и применить изменения, описано в разделе [Параметры .env](https://webim.ru/kb/11.0/settings/env/). Все параметры на этой странице необязательные.

## Отправка почты { #email }

Параметры SMTP-сервера, через который **Webim** отправляет письма: пароли сотрудников, письма для восстановления пароля, уведомления и истории диалогов. Если в настройке Constance `CUSTOM_POST_SERVER_URL` задан HTTP-сервер отправки почты, письма аккаунта отправляются через него (см. [Custom Post Server](https://webim.ru/kb/11.0/settings/constance/misc.html#custom-post-server)).

| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
| `EMAIL_HOST` | Строка | `mailhog` | Адрес SMTP-сервера, например `smtp.example.local`. Значение по умолчанию — тестовый почтовый сервер среды разработки; в рабочей установке задайте адрес Вашего SMTP-сервера. Пустое значение равносильно отсутствующему параметру. |
| `EMAIL_PORT` | Целое число | `1025` | Порт SMTP-сервера. Обычно используются порты `587` (вместе с `EMAIL_USE_TLS=True`), `465` (вместе с `EMAIL_USE_SSL=True`) или `25`. Пустое значение равносильно отсутствующему параметру. |
| `EMAIL_USE_TLS` | Логический | `False` | Шифрование соединения командой STARTTLS, обычно на порту `587`. |
| `EMAIL_USE_SSL` | Логический | `False` | Шифрованное соединение SSL/TLS с момента подключения, обычно на порту `465`. Не включайте одновременно с `EMAIL_USE_TLS`. |
| `EMAIL_HOST_USER` | Строка | Пусто | Имя пользователя для аутентификации на SMTP-сервере. Пустое значение — письма отправляются без аутентификации. |
| `EMAIL_HOST_PASSWORD` | Строка | Пусто | Пароль для аутентификации на SMTP-сервере. |
| `EMAIL_TIMEOUT` | Целое число, секунды | `20` | Тайм-аут операций с SMTP-сервером. |
| `DEFAULT_FROM_EMAIL` | Строка | `no-reply@example.local` | Адрес отправителя писем **Webim** по умолчанию, например `no-reply@chat.example.local`. Укажите адрес, с которого Ваш SMTP-сервер разрешает отправку. |
| `MAIL_CHANNEL_TIMEOUT_SECONDS` | Целое число, секунды | `20` | Тайм-аут операций с IMAP- и SMTP-серверами почтовых каналов. |

## Telegram { #telegram }

| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
| `TELEGRAM_BOT_API_URL` | URL | Пусто | Адрес собственного сервера Telegram Bot API для всей установки, например `https://tg-api.example.local`. Используется для каналов Telegram, в настройках которых не задан свой адрес, если не задана и настройка Constance `TELEGRAM_BOT_API_URL` (см. [Каналы, боты и опросы](https://webim.ru/kb/11.0/settings/constance/channels-bots.html#channels)). Пустое значение — используется `api.telegram.org`.<br>Адрес должен начинаться с `http://` или `https://` и содержать имя хоста, иначе **Webim** не запускается. |
| `TELEGRAM_BOT_API_SSL_VERIFY_SKIP` | Логический | `False` | Отключает проверку SSL-сертификата сервера Telegram Bot API для каналов, в настройках которых этот параметр не задан явно. Проверку также отключает настройка Constance `TELEGRAM_BOT_API_SSL_VERIFY_SKIP`. Используйте только для собственного сервера Bot API с самоподписанным сертификатом. |
| `TELEGRAM_WEBHOOK_PROXY_URL` | URL | Пусто | Адрес прокси-сервера для регистрации вебхуков Telegram, например `https://tg-proxy.example.local`. Используется для каналов, в настройках которых не задан свой прокси-сервер.<br>При регистрации вебхука **Webim** отправляет запрос `GET <адрес>/register?url=<адрес вебхука>` (путь `/register` добавляется, если его нет в адресе) и регистрирует в Telegram адрес из поля `url` JSON-ответа.<br>Адрес должен начинаться с `http://` или `https://` и содержать имя хоста, иначе **Webim** не запускается. |
| `TELEGRAM_WEBHOOK_PROXY_SSL_VERIFY_SKIP` | Логический | `False` | Отключает проверку SSL-сертификата при запросе к прокси-серверу из `TELEGRAM_WEBHOOK_PROXY_URL`. На запросы к Telegram Bot API и к прокси-серверам из настроек каналов не влияет. |

## Исходящие HTTP-соединения { #http }

Параметры соединений **Webim** с внешними сервисами: ботами, обработчиками событий, API каналов и другими.

| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
| `HTTP_CA_BUNDLE` | Путь к файлу | Набор сертификатов пакета certifi | Файл с сертификатами доверенных удостоверяющих центров (PEM) для проверки сертификатов при исходящих HTTPS-соединениях: с ботами, обработчиками вебхуков, API каналов, S3-хранилищем и SMTP-сервером. Пустое значение — используется хранилище сертификатов операционной системы.<br>Чтобы доверять сертификатам внутреннего удостоверяющего центра, укажите файл, который содержит и стандартные корневые сертификаты, и сертификат Вашего удостоверяющего центра. Сертификаты для подключения к PostgreSQL, Kafka и другим инфраструктурным сервисам задаются отдельными параметрами (`DATABASE_SSL_ROOT_CERT`, `*_SSL_CA_LOCATION`). |
| `HTTP_POOL_ENABLED` | Логический | `True` | Повторное использование соединений для исходящих HTTP-запросов (пул соединений). Без пула каждый запрос к внешнему сервису устанавливает новое соединение. Выключайте только по рекомендации технической поддержки **Webim**. |
| `HTTP_POOL_CONNECTIONS_PER_HOST` | Целое число | `4` | Максимальное число одновременных соединений с одним внешним хостом в одном процессе. Общее число соединений с хостом равно этому значению, умноженному на число процессов **Webim**. |
| `HTTP_POOL_HOSTS_PER_SESSION` | Целое число | `32` | Максимальное число внешних хостов, соединения с которыми хранятся в пуле одного процесса. При превышении закрываются соединения с хостом, к которому дольше всего не было запросов. |
| `HTTP_POOL_MAX_CLIENTS` | Целое число | `32` | Максимальное число пулов соединений в одном процессе. Отдельный пул создаётся для каждого сочетания прокси-сервера и режима проверки сертификатов. |
| `HTTP_POOL_KEEPALIVE_EXPIRY_SECONDS` | Целое число, секунды | `30` | Время, после которого неиспользуемое соединение закрывается. |
| `CHANNEL_PROXY_TEST_TIMEOUT_SECONDS` | Целое число, секунды | `10` | Тайм-аут проверки прокси-сервера в настройках канала. |
| `CHANNEL_OUTBOUND_RETRY_DELAYS_SECONDS` | Список чисел через запятую, секунды | `1,3,10` | Паузы между повторными попытками отправить сообщение в пользовательский канал (Custom Channel) при ответе с кодом `5xx`, тайм-ауте или ошибке соединения. Число значений равно числу повторных попыток.<br>Значение не может быть пустым, иначе **Webim** не запускается. |

---

Источник: https://webim.ru/kb/11.0/settings/env/integrations.html
