> 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/guide/uvedomleniya/uvedomlenie-po-e-mail/podklyuchenie-zoho-mail.md).
# Подключение Zoho Mail
Zoho Mail можно подключить к iEXExchanger через SMTP и использовать для отправки системных писем клиентам и администраторам.
iEXExchanger использует это подключение только для отправки. Входящие письма из Zoho Mail система не загружает и не обрабатывает.
{% hint style="info" %}
Общие переключатели E-mail, адрес службы поддержки, получатели административных писем, список событий и их приоритеты настраиваются отдельно на странице «Уведомление по E-mail».
В этой инструкции рассматриваются только подготовка Zoho Mail и создание SMTP-подключения в iEXExchanger.
{% endhint %}
{% content-ref url="/pages/OkKDfMApGsB2m3bvCsHg" %}
[Уведомление по E-mail](/guide/uvedomleniya/uvedomlenie-po-e-mail.md)
{% endcontent-ref %}
## Когда использовать Zoho Mail
Zoho Mail подходит для обычной системной почты обменного пункта:
* писем по заявкам;
* уведомлений клиентам;
* сообщений администраторам;
* подтверждения E-mail;
* уведомлений безопасности;
* сообщений о проверках и выплатах.
Zoho Mail не предназначен для массовых рассылок и резких всплесков автоматической отправки. Сервис применяет ограничения исходящей почты, которые зависят от типа аккаунта, репутации отправителя, качества получателей и характера отправки.
Если проект отправляет большой объём транзакционных писем, лучше использовать специализированный сервис для такой нагрузки, например Resend или ZeptoMail.
Актуальные ограничения Zoho Mail опубликованы в [официальной документации Zoho](https://www.zoho.com/mail/help/adminconsole/rates-and-limits.html).
## Какой почтовый ящик использовать
Для SMTP можно использовать обычный аккаунт Zoho Mail или корпоративную почту на собственном домене.
{% stepper %}
{% step %}
### Обычный адрес Zoho Mail
Адрес может выглядеть так:
```
exchange-mail@zohomail.com
```
Фактический домен адреса может зависеть от региона регистрации аккаунта.
Если отдельного ящика ещё нет:
1. Откройте [регистрацию Zoho Mail](https://www.zoho.com/mail/signup.html).
2. Создайте отдельный почтовый аккаунт.
3. Подтвердите регистрацию.
4. Войдите в [Zoho Mail](https://mail.zoho.com/).
5. Проверьте отправку обычного письма через веб-интерфейс.
Для iEXExchanger рекомендуется использовать отдельный служебный ящик, а не личную почту владельца или сотрудника.
{% endstep %}
{% step %}
### Почта на собственном домене
Для рабочего проекта удобнее использовать адрес на домене обменного пункта, например:
```
support@example.com
```
или:
```
noreply@example.com
```
Такой ящик создаётся в организации Zoho Mail и может использоваться как системный отправитель iEXExchanger.
{% endstep %}
{% endstepper %}
## Создание корпоративной почты в Zoho
Если корпоративная почта уже настроена и нужный ящик работает, перейдите к разделу **«Как определить SMTP-сервер»**.
{% stepper %}
{% step %}
### Создание организации
Откройте [Zoho Mail](https://www.zoho.com/mail/signup.html) и зарегистрируйте вариант для корпоративной почты.
После создания аккаунта откройте: [Zoho Mail Admin Console](https://mailadmin.zoho.com/)
Аккаунт владельца организации имеет повышенные права, поэтому защитите его отдельным паролем и MFA и сохраните доступ к способам восстановления.
{% endstep %}
{% step %}
### Добавление домена
В Zoho Mail Admin Console:
1. Откройте **«Domains»**.
2. Нажмите **«Add»**.
3. Укажите основной домен обменного пункта.
4. Добавьте домен.
5. Выполните подтверждение владения.
Например:
```
example.com
```
Для подтверждения потребуется доступ к DNS-зоне домена.
{% content-ref url="/pages/p1Gm5iDWlX7fh95MUVut" %}
[Файлы подтверждений](/guide/sait/faily-podtverzhdenii.md)
{% endcontent-ref %}
{% content-ref url="/spaces/uyjsNtEAtO6Sby8CHWyD/pages/43DGhWN1Ki1aj8RrllVR" %}
[Настройка DNS](/help-center/administrirovanie/seti-i-bezopasnost/cloudflare/nastroika-dns.md)
{% endcontent-ref %}
Zoho может предложить TXT, CNAME, Domain Connect или другой доступный способ. Используйте запись, которую показывает Zoho именно для вашей организации и домена.
Подробная инструкция: [Добавление домена в Zoho Mail](https://www.zoho.com/mail/help/adminconsole/add-domains.html)
{% endstep %}
{% step %}
### Подтверждение домена
После добавления:
1. Откройте созданный домен.
2. Выберите доступный способ подтверждения.
3. Скопируйте запись, которую показывает Zoho.
4. Добавьте её в DNS.
5. Дождитесь обновления DNS.
6. Вернитесь в Zoho Mail Admin Console.
7. Выполните проверку.
Не копируйте DNS-записи из чужого примера — значения подтверждения создаются для конкретного домена и аккаунта.
Подробнее: [Подтверждение домена Zoho Mail](https://www.zoho.com/mail/help/adminconsole/domain-verification.html)
{% endstep %}
{% endstepper %}
## Создание почтового ящика
Для SMTP рекомендуется создать отдельного пользователя с собственным почтовым ящиком.
Например:
```
support@example.com
```
или:
```
notifications@example.com
```
В Zoho Mail Admin Console:
1. Откройте **«Users»**.
2. Нажмите **«Add»**.
3. Укажите имя пользователя.
4. В Username укажите нужную часть адреса, например `support`.
5. Выберите домен.
6. Создайте пароль.
7. Оставьте обычную роль пользователя, если административный доступ не требуется.
8. Нажмите **«Add»**.
Для SMTP требуется именно почтовый аккаунт пользователя. Одного адреса группы или рассылки недостаточно.
Если для нового сотрудника включена обязательная смена временного пароля:
1. Войдите под созданным пользователем.
2. Замените временный пароль.
3. Откройте Zoho Mail.
4. Проверьте работу почтового ящика.
5. После этого создайте отдельный пароль приложения.
Подробнее: [Добавление пользователей Zoho Mail](https://www.zoho.com/mail/help/adminconsole/adding-users.html)
## DNS для корпоративной почты
Если используется собственный домен, настройте DNS в соответствии с Zoho Mail.
Основные записи:
* MX;
* SPF;
* DKIM;
* DMARC.
### MX
MX-записи используются для получения входящей почты и ответов клиентов.
Если почтовый ящик нужен не только как SMTP-отправитель, но и для получения сообщений, направьте MX-записи домена на Zoho.
### SPF
SPF определяет серверы, которым разрешено отправлять почту от имени домена.
{% hint style="warning" %}
Для одного домена должна использоваться одна SPF-запись.
Если SPF уже содержит другой почтовый сервис, не создавайте вторую SPF-запись. Разрешённые источники необходимо объединить в одном правиле.
{% endhint %}
### DKIM
DKIM добавляет подпись к исходящим письмам и помогает получателю проверить, что письмо действительно отправлено разрешённой почтовой системой.
### DMARC
DMARC определяет правила обработки писем, которые не проходят проверки SPF или DKIM.
Точные значения DNS берите из Zoho Mail Admin Console для своего домена.
Официальные инструкции:
* [настройка MX](https://www.zoho.com/mail/help/adminconsole/configure-email-delivery.html);
* [настройка SPF](https://www.zoho.com/mail/help/adminconsole/spf-configuration.html);
* [настройка DKIM](https://www.zoho.com/mail/help/adminconsole/dkim-configuration.html);
* [настройка DMARC](https://www.zoho.com/mail/help/adminconsole/dmarc-policy.html).
## Как определить SMTP-сервер
Не используйте один и тот же SMTP-сервер для всех аккаунтов Zoho без проверки.
Сервер может зависеть от:
* типа аккаунта;
* тарифа;
* личного или корпоративного адреса;
* дата-центра, в котором находится аккаунт.
Поэтому правильное значение лучше получить непосредственно из настроек подключаемого почтового ящика.
### Где посмотреть SMTP
Войдите в тот Zoho Mail, который будет подключён к iEXExchanger.
Откройте: **«Settings» — «Mail Accounts»**
Выберите основной адрес **«Primary Account»** и откройте настройки **«SMTP»**.
Скопируйте указанный там сервер исходящей почты.
Официальная инструкция: [Zoho SMTP Settings](https://www.zoho.com/mail/help/zoho-smtp.html)
### Распространённые адреса
Для некоторых аккаунтов дата-центра `.com` могут использоваться:
Тип аккаунта
Пример SMTP-сервера
Личный Zoho Mail
smtp.zoho.com
Доменная организация
smtp.zoho.com или smtppro.zoho.com
Используйте конкретное значение, которое показывает ваш аккаунт Zoho.
{% hint style="warning" %}
Не меняйте доменную зону SMTP-сервера вручную.
Аккаунт Zoho может находиться в дата-центре `.eu`, `.in`, `.com.au`, `.jp`, `.ca`, `.ae`, `.sa` или другом регионе. Скопируйте полный SMTP-адрес из настроек почтового ящика.
{% endhint %}
## Создание пароля приложения
Для iEXExchanger рекомендуется создать отдельный пароль приложения.
Если для аккаунта включена MFA, обычный пароль аккаунта для SMTP использовать нельзя — необходим пароль приложения.
Войдите именно в тот Zoho-аккаунт, которому принадлежит подключаемый почтовый ящик.
Откройте: [Zoho Accounts](https://accounts.zoho.com/)
Затем:
1. Перейдите в **«Security»**.
2. Откройте **«Application Specific Passwords»** или **«App Passwords»**.
3. Нажмите **«Generate New Password»**.
4. Укажите название:
```
iEXExchanger SMTP
```
5. Нажмите **«Generate»**.
6. Скопируйте пароль.
Созданный пароль показывается один раз.
Если он потерян, просмотреть его повторно нельзя. Удалите старый пароль и создайте новый.
{% hint style="info" %}
Отдельный пароль приложения удобнее основного пароля аккаунта: его можно отозвать только для iEXExchanger без смены основного пароля Zoho.
{% endhint %}
Пароль должен быть создан в аккаунте подключаемого почтового ящика. Не используйте пароль владельца организации или другого сотрудника.
## Создание SMTP-подключения в iEXExchanger
В панели управления откройте:
**«Настройки» — «Общие настройки» — «Уведомления» — «Подключения»**
Затем:
1. Нажмите **«Добавить»**.
2. В поле **«Тип подключения»** выберите **«SMTP»**.
3. Укажите название, например **«Zoho Mail»**.
4. Нажмите **«Создать»**.
5. Найдите новое подключение.
6. Нажмите на его название.
Новое подключение создаётся как выключенный черновик. Оно не используется для рабочих писем, пока настройка не завершена.
{% content-ref url="/pages/OkKDfMApGsB2m3bvCsHg" %}
[Уведомление по E-mail](/guide/uvedomleniya/uvedomlenie-po-e-mail.md)
{% endcontent-ref %}
## Настройки Zoho SMTP
Для первоначального подключения используйте следующую схему.
| Поле | Значение |
| -------------------------- | --------------------------------------- |
| **«SMTP-сервер»** | Точное значение из настроек Zoho Mail |
| **«Порт»** | `465` |
| **«Шифрование»** | `SSL` |
| **«Логин»** | Полный E-mail почтового ящика |
| **«Пароль»** | Пароль приложения Zoho |
| **«E-mail отправителя»** | Тот же почтовый адрес |
| **«Имя отправителя»** | Название обменника или службы поддержки |
| **«Подключение включено»** | Включено |
### SMTP-сервер
Укажите точный SMTP-сервер, который отображается в настройках подключаемого Zoho Mail.
Например:
```
smtp.zoho.com
```
или:
```
smtppro.zoho.com
```
Значение из вашего аккаунта Zoho имеет приоритет над примерами из этой инструкции.
### Порт и шифрование
Основной вариант:
```
Порт: 465
Шифрование: SSL
```
Zoho также поддерживает альтернативный вариант:
```
Порт: 587
Шифрование: TLS
```
Для первоначальной настройки рекомендуется начать с `465 + SSL`.
Если сервер обменного пункта не может установить соединение через порт `465`, проверьте `587 + TLS`.
Не используйте **«Без шифрования»** для рабочего подключения Zoho Mail через интернет.
### Логин
В поле **«Логин»** всегда указывайте полный почтовый адрес.
Например:
```
support@example.com
```
или:
```
exchange-mail@zohomail.com
```
Не указывайте только часть адреса до `@`.
Также не используйте:
* адрес другого сотрудника;
* адрес группы;
* адрес рассылки без собственного аккаунта;
* неподтверждённый почтовый адрес.
### Пароль
В поле **«Пароль»** укажите пароль приложения, созданный в аккаунте этого же почтового ящика.
Если MFA включена, основной пароль аккаунта для SMTP не используется.
### E-mail отправителя
Для первой настройки рекомендуется указать тот же адрес, который используется в поле **«Логин»**.
Например:
```
Логин: support@example.com
E-mail отправителя: support@example.com
```
Zoho также может разрешать отправку с почтового алиаса, принадлежащего этому же пользователю.
Если требуется использовать алиас:
1. Добавьте алиас пользователю в Zoho Mail.
2. Убедитесь, что адрес появился в его почтовом аккаунте.
3. Оставьте основной адрес в поле **«Логин»**.
4. Укажите разрешённый алиас в поле **«E-mail отправителя»**.
5. Выполните тестовую отправку.
Если адрес отправителя не разрешён для авторизованного аккаунта, Zoho может вернуть:
```
Relaying Disallowed
```
Для простой настройки используйте основной E-mail аккаунта.
### Имя отправителя
В поле **«Имя отправителя»** укажите название, которое должен видеть получатель.
Например:
```
Example Exchange
```
или:
```
Служба поддержки Example Exchange
```
Имя отправителя не заменяет E-mail и не участвует в SMTP-авторизации.
## Включение подключения
После заполнения параметров включите: **«Подключение включено»**
и нажмите **«Сохранить»**.
Выключенное подключение сохраняет конфигурацию, но не используется для рабочих уведомлений.
## Проверка подключения
Перед включением рабочих событий отправьте тестовое письмо.
В форме подключения найдите: **«E-Mail для проверки»**
Затем:
1. Укажите адрес, к которому у вас есть доступ.
2. Нажмите **«Отправить тест»**.
3. Дождитесь результата.
4. Проверьте папку «Входящие».
5. Проверьте папку «Спам».
6. Убедитесь, что адрес и имя отправителя отображаются правильно.
Кнопка **«Отправить тест»** сначала сохраняет текущую конфигурацию, а затем выполняет реальную отправку.
Если тест не требуется, параметры можно сохранить обычной кнопкой **«Сохранить»**.
Успешная проверка означает, что Zoho принял письмо для отправки. Она не гарантирует попадание письма непосредственно во «Входящие».
## Проверка из списка подключений
После сохранения вернитесь на страницу: **«Уведомления» — «Подключения»**
Найдите Zoho Mail.
Откройте **«Другие действия»** и выберите: **«Проверить»**
После успешной проверки подключение должно отображаться без ошибки.
Если параметры были исправлены после предыдущей ошибки, выполните проверку повторно, чтобы обновить состояние.
## Папка «Отправленные»
Zoho Mail может сохранять письма, отправленные через SMTP, в папке **Sent**.
Для системной почты это может приводить к накоплению большого количества копий автоматических сообщений.
Если такие копии не нужны:
1. Откройте Zoho Mail.
2. Перейдите в **«Settings» — «Mail Accounts»**.
3. Выберите подключаемый почтовый адрес.
4. Откройте **«SMTP»**.
5. Отключите **«Save copy of sent emails»**.
После этого SMTP-письма не будут дополнительно сохраняться в папке отправленных, если настройка применяется вашим аккаунтом Zoho.
## Завершение настройки E-mail
Успешное SMTP-подключение ещё не включает рабочие события iEXExchanger автоматически.
После теста откройте общую страницу «Уведомления по E-mail» и настройте:
{% content-ref url="/pages/OkKDfMApGsB2m3bvCsHg" %}
[Уведомление по E-mail](/guide/uvedomleniya/uvedomlenie-po-e-mail.md)
{% endcontent-ref %}
* **«Отправка уведомлений»**;
* **«Уведомления по E-mail»**;
* **«E-Mail адрес службы поддержки»**;
* **«E-Mail адреса администраторов»**;
* события для клиентов;
* события для администраторов;
* приоритеты событий.
Эти параметры относятся ко всей почтовой системе и поэтому отдельно в инструкции Zoho Mail не настраиваются.
## Если возникает ошибка `Authentication Failed` или `535`
Ошибка означает проблему с SMTP-авторизацией.
Проверьте последовательно:
1. В поле **«Логин»** указан полный почтовый адрес.
2. Пароль приложения создан именно в аккаунте этого ящика.
3. Пароль приложения не был удалён.
4. Новый пользователь хотя бы один раз вошёл в Zoho Mail.
5. Временный пароль пользователя был заменён, если это требовалось.
6. Используется SMTP-сервер именно вашего аккаунта и дата-центра.
7. Аккаунт пользователя активен.
8. Политики организации разрешают использование внешнего SMTP-подключения.
Если MFA включена, не используйте основной пароль Zoho.
## Ошибка `Relaying Disallowed`
Ошибка обычно означает, что **«E-mail отправителя»** не соответствует аккаунту, который прошёл SMTP-авторизацию, или не является разрешённым алиасом этого аккаунта.
Для первоначальной настройки используйте:
```
Логин: support@example.com
E-mail отправителя: support@example.com
```
Если используется алиас, убедитесь, что он действительно добавлен к этому пользователю в Zoho Mail.
Также проверьте:
* отсутствие опечаток;
* правильный SMTP-сервер;
* принадлежность адреса отправителя этому аккаунту.
## Нет соединения с SMTP-сервером
Проверьте:
* точное значение **«SMTP-сервер»**;
* дата-центр Zoho;
* порт `465`;
* **«SSL»**;
* исходящие соединения сервера обменного пункта.
Если `465 + SSL` не работает, проверьте:
```
587 + TLS
```
Некоторые хостинг-провайдеры ограничивают исходящие SMTP-подключения.
Если оба порта недоступны, обратитесь к администратору сервера или хостинг-провайдеру.
Не используйте порт `25` для обычного подключения iEXExchanger к Zoho.
## Письма отправляются только внутри организации
Проверьте политики в Zoho Mail Admin Console.
Ограничение может быть связано с:
* разрешением отправки только на домены организации;
* списком разрешённых внешних доменов;
* ограничением исходящей почты;
* разрешёнными IP для почтовых клиентов.
Если организация ограничивает почтовые клиенты по IP, добавьте фактический публичный IP сервера, с которого iEXExchanger подключается к Zoho.
## Аккаунт временно ограничен для отправки
Zoho может ограничить исходящую почту при обнаружении необычной или слишком интенсивной отправки.
Причинами могут быть:
* большое количество писем за короткое время;
* большое количество недействительных адресов;
* большое число возвратов;
* резкое увеличение количества получателей;
* поведение, похожее на массовую рассылку;
* превышение действующих лимитов аккаунта.
Не пытайтесь обходить такое ограничение повторными массовыми отправками.
Проверьте состояние аккаунта в Zoho и при необходимости обратитесь в поддержку сервиса.
Если высокая транзакционная нагрузка является обычной для проекта, используйте специализированный сервис для такой отправки.
## Тест прошёл, но письмо не получено
Проверьте:
* правильность **«E-Mail для проверки»**;
* папку «Спам»;
* SPF;
* DKIM;
* DMARC;
* состояние домена в Zoho Mail Admin Console;
* правила почтовой системы получателя.
Если необходимо, используйте доступные в Zoho инструменты диагностики доставки и Message Trace.
Успешный SMTP-тест подтверждает передачу письма в Zoho, но не гарантирует его отображение во **«Входящих»** у получателя.
## Подключение перестало работать после изменения MFA
Если после изменения настроек безопасности Zoho старый пароль приложения больше не работает:
1. Откройте Zoho Accounts.
2. Удалите старый пароль приложения.
3. Создайте новый пароль:
```
iEXExchanger SMTP
```
4. Откройте подключение Zoho Mail в iEXExchanger.
5. Введите новый пароль.
6. Нажмите **«Отправить тест»**.
7. Проверьте получение письма.
## Изменение сохранённого SMTP-пароля
iEXExchanger не показывает полный сохранённый пароль.
Если при повторном открытии подключения поле отображается как уже заполненное и пароль менять не требуется, оставьте поле пустым.
Существующее значение сохранится.
Для замены:
1. Создайте новый пароль приложения Zoho.
2. Откройте подключение.
3. Введите новый пароль.
4. Выполните **«Отправить тест»**.
5. Убедитесь, что соединение снова работает.
## Тест проходит, но обычные уведомления не отправляются
Если тестовая отправка работает, SMTP-подключение уже установлено.
Дополнительно проверьте в iEXExchanger:
* включено ли **«Подключение включено»**;
* включена ли **«Отправка уведомлений»**;
* включены ли **«Уведомления по E-mail»**;
* включено ли нужное событие у подключения;
* сохранены ли настройки событий;
* существует ли корректный E-mail получателя.
Повторно менять SMTP-сервер или пароль без причины в такой ситуации не требуется.
## Письма отправляются с задержкой
Если Zoho принимает тестовые письма, но рабочие события отправляются с задержкой, причина может находиться в обработке уведомлений на сервере iEXExchanger.
Попросите технического администратора проверить:
* Laravel Horizon;
* очереди уведомлений;
* Redis;
* планировщик Laravel;
* журналы ошибок уведомлений.
Для такой диагностики не требуется передавать пароль приложения Zoho.
## Рекомендации по безопасности
Для production рекомендуется использовать отдельный почтовый ящик специально для системной отправки.
Например:
```
notifications@example.com
```
или:
```
noreply@example.com
```
Не подключайте аккаунт владельца Zoho-организации, если для отправки можно создать обычного пользователя.
Для SMTP:
* создайте отдельный пароль приложения;
* включите MFA для почтового аккаунта;
* сохраните способы восстановления аккаунта;
* не передавайте SMTP-пароль в переписке;
* не размещайте пароль в документации;
* не добавляйте его на скриншоты;
* удаляйте неиспользуемые пароли приложений;
* ограничьте доступ к Zoho Mail Admin Console;
* периодически проверяйте состояние исходящей почты.
Если пароль приложения стал известен постороннему лицу:
1. Удалите его в Zoho Accounts.
2. Создайте новый.
3. Замените пароль в iEXExchanger.
4. Выполните тестовую отправку.
## Проверка настройки
Подключение Zoho Mail настроено правильно, если:
* создан отдельный почтовый аккаунт;
* для корпоративной почты подтверждён домен;
* создан отдельный пользователь с почтовым ящиком;
* выполнен первый вход в Zoho Mail;
* временный пароль заменён, если это требовалось;
* SMTP-сервер скопирован из настроек используемого аккаунта;
* учтён дата-центр Zoho;
* создан отдельный пароль приложения;
* используется порт `465`;
* выбрано **«SSL»**;
* в **«Логин»** указан полный E-mail;
* **«E-mail отправителя»** соответствует этому аккаунту или разрешённому алиасу;
* указано **«Имя отправителя»**;
* включено **«Подключение включено»**;
* тестовое письмо успешно отправлено;
* тестовое письмо получено;
* подключение не показывает ошибку;
* для собственного домена настроены необходимые DNS-записи;
* в общей системе E-mail включены нужные события и переключатели.
После успешной проверки Zoho Mail готов использоваться как SMTP-подключение iEXExchanger.
