> 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/email/05-email-zoho.md).

# Zoho Mail через 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](/learn/email/06-email-resend.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.iexexchanger.com/learn/email/05-email-zoho.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.