> For the complete documentation index, see [llms.txt](https://docs.iexexchanger.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.iexexchanger.com/learn/6.-e-mail-i-uvedomleniya/05-email-zoho.md).

# Zoho Mail через SMTP

Создайте корпоративный ящик Zoho, пароль приложения и рабочее SMTP-подключение

## Что вы получите

Уведомления будут отправляться через отдельный корпоративный ящик Zoho с шифрованием и паролем приложения. Адрес отправителя будет соответствовать авторизованному ящику или разрешённому псевдониму.

## Подготовьте Zoho Mail

{% stepper %}
{% step %}

### Добавьте и подтвердите домен

В консоли администратора Zoho добавьте домен компании и подтвердите владение записью, которую показывает сервис. Используйте [официальную инструкцию проверки домена](https://www.zoho.com/mail/help/adminconsole/domain-verification.html).
{% endstep %}

{% step %}

### Настройте приём и подпись

Если Zoho принимает вашу почту, добавьте его MX. Затем опубликуйте SPF и DKIM из консоли Zoho и проверьте статус каждой записи.
{% endstep %}

{% step %}

### Создайте служебный ящик

Создайте отдельный адрес для системы, например `notify@your-domain.example`. Не используйте личный ящик сотрудника.
{% endstep %}

{% step %}

### Включите многофакторную защиту

Защитите аккаунт владельца и служебный доступ по политике компании.
{% endstep %}

{% step %}

### Создайте пароль приложения

При включённой 2FA откройте **Zoho Account — Security — Application Specific Passwords**, создайте отдельный пароль для iEXExchanger и сохраните его сразу: значение показывается один раз. См. [инструкцию Zoho по паролям приложений](https://help.zoho.com/portal/en/kb/accounts/manage-your-zoho-account/articles/mfa-application-specific-passwords).
{% endstep %}
{% endstepper %}

## Возьмите параметры именно своего аккаунта

Zoho использует разные серверы в зависимости от типа организации и дата-центра. Откройте **Server Configuration Details** в своём аккаунте и скопируйте показанные значения.

Частые варианты из [официальной таблицы SMTP Zoho](https://www.zoho.com/mail/help/zoho-smtp.html):

| Сценарий                                      | Сервер             | Порт и защита           |
| --------------------------------------------- | ------------------ | ----------------------- |
| Личный или бесплатный организационный аккаунт | `smtp.zoho.com`    | 465 + SSL или 587 + TLS |
| Платная организация с собственным доменом     | `smtppro.zoho.com` | 465 + SSL или 587 + TLS |

Это ориентир, а не универсальное значение. При расхождении используйте сервер, показанный в вашем Zoho.

## Создайте SMTP-подключение

Откройте **«Настройки» — «Общие настройки» — «Уведомления» — «Подключения»**, нажмите **«Добавить»**, выберите **SMTP** и задайте название.

| Поле iEXExchanger  | Значение Zoho                                                 |
| ------------------ | ------------------------------------------------------------- |
| SMTP-server        | Сервер из Server Configuration Details                        |
| Порт               | `587` для TLS или `465` для SSL по выбранному режиму          |
| Шифрование         | `TLS` для 587 или `SSL` для 465                               |
| Логин              | Полный E-mail служебного ящика                                |
| Пароль             | Отдельный пароль приложения, если он требуется политикой Zoho |
| E-mail отправителя | Тот же ящик или разрешённый в Zoho псевдоним                  |
| Имя отправителя    | Публичное название обменного пункта                           |

{% hint style="warning" %}
Логин и адрес отправителя должны быть согласованы. Если адрес не принадлежит авторизованному ящику и для него нет разрешённого alias, Zoho может вернуть **Relaying Disallowed**.
{% endhint %}

## Проверьте подключение

1. Сохраните форму с выключенным подключением.
2. Убедитесь, что пароль отмечен как заполненный и не показывается полностью.
3. Включите подключение.
4. Укажите отдельный адрес в **«E-Mail для проверки»**.
5. Нажмите **«Отправить тест»**.
6. Выполните действие **«Проверить»** в строке подключения.
7. Проверьте входящие, спам и заголовки письма.
8. Включите одно событие и проверьте его новой контрольной заявкой.

## Типовые ошибки Zoho

| Ошибка                     | Причина                                                                          | Что сделать                                                                       |
| -------------------------- | -------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
| Authentication failed      | Неверный логин, обычный пароль вместо пароля приложения или ограничение аккаунта | Сверить полный E-mail, создать новый пароль приложения, проверить разрешение SMTP |
| Relaying Disallowed        | Отправитель не совпадает с ящиком или разрешённым alias                          | Исправить From либо добавить и подтвердить псевдоним в Zoho                       |
| Connection refused/timeout | Неверный сервер, порт или блокировка исходящего соединения                       | Сверить Server Configuration Details и сетевые правила сервера                    |
| TLS/SSL error              | Порт не соответствует типу шифрования                                            | Использовать 587 + TLS либо 465 + SSL по данным аккаунта                          |
| Письмо принято, но в спаме | Не завершены SPF/DKIM/DMARC или низкая репутация                                 | Проверить DNS, заголовки и журнал доставки Zoho                                   |

{% hint style="danger" %}
Не отключайте 2FA ради SMTP. Создайте отдельный пароль приложения и отзовите только его при компрометации.
{% endhint %}

## Этап завершён, если

* [ ] домен и ящик подтверждены в Zoho;
* [ ] SMTP-server взят из текущего аккаунта;
* [ ] порт соответствует шифрованию;
* [ ] используется отдельный пароль приложения;
* [ ] From принадлежит ящику или разрешённому alias;
* [ ] техническое письмо дошло и прошло проверку заголовков;
* [ ] реальное событие дошло нужной аудитории;
* [ ] обычный пароль Zoho нигде не опубликован.

Альтернативный транзакционный канал настраивается в уроке [Resend через API](https://docs.iexexchanger.com/learn/6.-e-mail-i-uvedomleniya/06-email-resend.md).
