> 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-yandeks-pochty.md). # Подключение Яндекс Почты Яндекс Почту можно подключить к iEXExchanger через SMTP и использовать для отправки системных писем клиентам и администраторам. Через это подключение iEXExchanger только отправляет письма. Входящие сообщения из почтового ящика система не загружает и не обрабатывает. Для подключения можно использовать: * обычный почтовый ящик Яндекса; * корпоративный ящик Яндекс 360 для бизнеса. {% hint style="info" %} Общие переключатели E-mail, адреса администраторов, адрес службы поддержки, выбор событий и их приоритеты настраиваются отдельно в общей инструкции. На этой странице рассматривается только подготовка Яндекс Почты и её подключение к iEXExchanger. {% endhint %} {% content-ref url="/pages/OkKDfMApGsB2m3bvCsHg" %} [Уведомление по E-mail](/guide/uvedomleniya/uvedomlenie-po-e-mail.md) {% endcontent-ref %} ## Какую почту использовать {% stepper %} {% step %} ### Обычная Яндекс Почта Обычный адрес выглядит, например, так: ``` exchange-mail@yandex.ru ``` Такой ящик можно использовать для первоначальной настройки, тестового проекта или рабочего обменного пункта. Для iEXExchanger рекомендуется создать отдельный служебный аккаунт, а не использовать личную почту владельца или сотрудника. Если почтового ящика ещё нет: 1. Создайте отдельный Яндекс ID. 2. Выберите логин будущего служебного ящика. 3. Добавьте необходимые способы восстановления доступа. 4. Откройте Яндекс Почту под созданным аккаунтом. 5. Убедитесь, что почтовый ящик работает. Перед подключением стороннего приложения Яндекс рекомендует хотя бы один раз войти в веб-интерфейс Почты. Это также позволяет принять необходимые условия использования сервисов. {% endstep %} {% step %} ### Яндекс 360 для бизнеса Для production-проекта можно использовать корпоративный адрес на собственном домене, например: ``` support@example.com ``` или: ``` noreply@example.com ``` В Яндекс 360 рабочий почтовый ящик создаётся для сотрудника организации на подключённом домене. Если корпоративная почта ещё не подготовлена: 1. Подключите Яндекс 360 для бизнеса. 2. Добавьте и подтвердите домен организации. 3. Создайте отдельного сотрудника для системной почты. 4. Используйте для него адрес, например `support@example.com` или `noreply@example.com`. 5. Войдите под созданным сотрудником в Яндекс Почту. 6. Если используется временный пароль, замените его. 7. Убедитесь, что почтовый ящик открывается и работает. Пароль приложения необходимо создавать именно в аккаунте того почтового ящика, который будет подключаться к iEXExchanger. Не создавайте SMTP-пароль в аккаунте владельца организации, если отправка будет выполняться с другого сотрудника. {% endstep %} {% endstepper %} Для обычного подключения удобнее использовать отдельный почтовый ящик сотрудника с собственным адресом, а не алиас другого пользователя. ## Настройка домена для Яндекс 360 Если используется корпоративная почта на собственном домене, завершите настройку DNS для Яндекс 360. Особенно важно проверить: * SPF; * DKIM. Яндекс использует SPF для указания серверов, которым разрешена отправка почты от имени домена. DKIM добавляет криптографическую подпись к исходящим сообщениям. {% hint style="warning" %} Не создавайте несколько отдельных SPF-записей для одного домена. Если SPF уже существует и требуется добавить ещё один почтовый сервис, разрешённые источники необходимо объединить в одной SPF-записи. {% endhint %} Если DNS домена делегирован Яндексу, часть необходимых записей может создаваться автоматически. При самостоятельном управлении DNS используйте значения, которые показывает Яндекс 360 для вашего домена. ## Разрешение доступа почтовых программ Перед подключением iEXExchanger необходимо разрешить использование почтового ящика сторонними почтовыми приложениями. Настройка выполняется внутри того аккаунта, который будет использоваться для SMTP. В Яндекс Почте откройте: **«Настройки» — «Все настройки» — «Почтовые программы»** В блоке доступа почтовых программ: 1. Включите доступ по IMAP. 2. Убедитесь, что разрешены **«Пароли приложений и OAuth-токены»**. 3. Сохраните изменения. Хотя iEXExchanger использует только отправку по SMTP и не получает входящие письма через IMAP, Яндекс указывает эти настройки и для сценария, в котором приложение только отправляет почту. ## Создание пароля приложения Для подключения iEXExchanger не рекомендуется использовать основной пароль от Яндекс ID. Создайте отдельный пароль приложения для почты. В Яндекс ID откройте раздел безопасности и перейдите к **«Пароли приложений»**. Затем: 1. Выберите создание нового пароля. 2. Выберите тип **«Почта»**. 3. Укажите понятное название, например `iEXExchanger SMTP`. 4. Нажмите **«Далее»**. 5. Скопируйте созданный пароль. Яндекс показывает пароль приложения только один раз. Если вы закрыли окно и не сохранили пароль, удалите созданный пароль и создайте новый. {% hint style="info" %} По информации Яндекса, новый пароль приложения может начать действовать через 2–3 часа. Если все параметры указаны правильно, но сразу после создания пароля SMTP возвращает ошибку авторизации, повторите проверку позже. {% endhint %} ## Создание подключения в iEXExchanger После подготовки Яндекс Почты создайте SMTP-подключение. В панели управления откройте: **«Настройки» — «Общие настройки» — «Уведомления» — «Подключения»**
Затем: 1. Нажмите **«Добавить»**. 2. В поле **«Тип подключения»** выберите **«SMTP»**. 3. Укажите название, например **«Яндекс Почта»** или **«Яндекс 360»**. 4. Нажмите **«Создать»**. 5. Найдите новое подключение в списке. 6. Нажмите на его название. Новое подключение создаётся как черновик. Письма не начнут отправляться, пока обязательные параметры не заполнены и подключение не включено. {% content-ref url="/pages/OkKDfMApGsB2m3bvCsHg" %} [Уведомление по E-mail](/guide/uvedomleniya/uvedomlenie-po-e-mail.md) {% endcontent-ref %} ## SMTP-настройки Яндекса Для основного подключения используйте: | Поле | Значение | | -------------------------- | --------------------------------------- | | **«SMTP-сервер»** | `smtp.yandex.ru` | | **«Порт»** | `465` | | **«Шифрование»** | `SSL` | | **«Логин»** | Логин подключаемого почтового ящика | | **«Пароль»** | Пароль приложения | | **«E-mail отправителя»** | Полный адрес подключаемого ящика | | **«Имя отправителя»** | Название обменника или службы поддержки | | **«Подключение включено»** | Включено | Основные официальные параметры Яндекс SMTP — `smtp.yandex.ru`, порт `465` и защищённое SSL-соединение. ### Название подключения В поле **«Название»** укажите название, по которому сможете определить подключение в административной панели. Например: ``` Яндекс Почта ``` или: ``` Яндекс 360 — системные письма ``` Название не влияет на данные, которые увидит получатель письма. ### SMTP-сервер Укажите: ``` smtp.yandex.ru ``` Этот сервер используется Яндексом для исходящей почты. ### Порт Основной вариант: ``` 465 ``` ### Шифрование Для порта `465` выберите: ``` SSL ``` Эта комбинация является основным вариантом подключения к SMTP Яндекса. ### Альтернативный порт Если сервер или хостинг не позволяет установить соединение через `465`, можно проверить альтернативный вариант: ``` Порт: 587 Шифрование: TLS ``` Яндекс также поддерживает порт `587` для SMTP-клиентов, которые начинают соединение без первоначального SSL-соединения и затем используют защищённое подключение. Для обычной установки сначала используйте: ``` 465 + SSL ``` {% hint style="warning" %} Не выбирайте **«Без шифрования»** для рабочего подключения Яндекс Почты через интернет. {% endhint %} ### Логин для обычной Яндекс Почты Если используется обычный адрес: ``` exchange-mail@yandex.ru ``` в качестве логина Яндекс указывает часть адреса до символа `@`: ``` exchange-mail ``` ### Логин для Яндекс 360 Для корпоративного почтового ящика Яндекс 360 используйте полный адрес. Например: ``` support@example.com ``` Для корпоративных ящиков Яндекс отдельно требует указывать полный адрес почтового ящика в качестве логина. ### Пароль В поле **«Пароль»** вставьте пароль приложения, созданный для типа **«Почта»**. Не используйте: * основной пароль Яндекс ID; * временный пароль сотрудника; * пароль владельца организации; * пароль приложения, созданный для другого сервиса или другого аккаунта. Пароль должен принадлежать именно тому почтовому аккаунту, который указан в SMTP-логине. ### E-mail отправителя В поле **«E-mail отправителя»** рекомендуется указать полный адрес того же ящика, через который выполняется SMTP-авторизация. Для обычной Яндекс Почты: ``` exchange-mail@yandex.ru ``` Для Яндекс 360: ``` support@example.com ``` На первом этапе не используйте другой адрес отправителя, даже если он относится к тому же домену. Если адрес отправителя не соответствует пользователю, авторизованному на SMTP-сервере, Яндекс может вернуть ошибку: ``` Sender address rejected: not owned by auth user ``` Яндекс указывает, что такая ошибка возникает, когда адрес отправителя не совпадает с адресом пользователя SMTP-авторизации. ### Имя отправителя В поле **«Имя отправителя»** укажите название, которое должен видеть получатель. Например: ``` Example Exchange ``` или: ``` Служба поддержки Example Exchange ``` Это отображаемое имя. Оно не заменяет **«E-mail отправителя»**. ## Включение подключения После заполнения параметров включите: **«Подключение включено»** и сохраните настройки. Само включение подключения ещё не означает, что через него будут отправляться все E-mail-события. Список событий настраивается отдельно. ## Тестовая отправка Перед включением рабочих уведомлений проверьте SMTP. В форме подключения найдите: **«E-Mail для проверки»** Укажите адрес, к которому у вас есть доступ. Затем нажмите: **«Отправить тест»** iEXExchanger сохранит текущие параметры и выполнит реальную тестовую отправку. После этого проверьте: * папку «Входящие»; * папку «Спам»; * результат проверки в административной панели. Успешный тест означает, что iEXExchanger смог передать письмо почтовому сервису. Он не гарантирует, что любое последующее письмо всегда будет попадать во «Входящие»: дальнейшая доставка зависит также от домена, почтовых фильтров и репутации отправителя. ## Проверка из списка подключений После сохранения также можно открыть страницу: **«Уведомления» — «Подключения»** Найдите Яндекс-подключение, откройте **«Другие действия»** и выполните: **«Проверить»**
Если проверка проходит успешно, подключение должно отображаться без ошибки. Если после исправления SMTP-параметров в таблице продолжает отображаться старая ошибка, выполните проверку повторно. ## Завершение настройки E-mail После успешного подключения Яндекс Почты необходимо настроить общую систему E-mail-уведомлений. Откройте общую инструкцию **«Уведомления по E-mail»** и проверьте: {% content-ref url="/pages/OkKDfMApGsB2m3bvCsHg" %} [Уведомление по E-mail](/guide/uvedomleniya/uvedomlenie-po-e-mail.md) {% endcontent-ref %} * **«Отправка уведомлений»**; * **«Уведомления по E-mail»**; * **«E-Mail адрес службы поддержки»**; * **«E-Mail адреса администраторов»**; * события для клиентов; * события для администраторов; * приоритеты уведомлений. Эти параметры являются общими для всех SMTP и Resend-подключений и поэтому не дублируются в инструкции по Яндекс Почте. {% hint style="warning" %} Успешное SMTP-подключение не включает E-mail-события автоматически. После теста обязательно проверьте список **«Уведомления»** у подключения и общие параметры доставки. {% endhint %} ## Изменение сохранённого пароля iEXExchanger не возвращает полный сохранённый SMTP-пароль в браузер. После повторного открытия формы пароль может отображаться как уже заполненный. Если менять его не требуется, оставьте поле пустым — ранее сохранённое значение останется без изменений. Чтобы заменить пароль: 1. Создайте новый пароль приложения в Яндекс ID. 2. Откройте SMTP-подключение. 3. Введите новый пароль в поле **«Пароль»**. 4. Нажмите **«Отправить тест»**. 5. Убедитесь, что письмо успешно получено. ## Если пароль приложения больше не работает Яндекс сбрасывает созданные пароли приложений после некоторых операций с аккаунтом. В частности, все пароли приложений сбрасываются после восстановления доступа к аккаунту или использования действия выхода со всех устройств. Если SMTP раньше работал, но после таких действий перестал авторизоваться: 1. Откройте Яндекс ID. 2. Создайте новый пароль приложения типа **«Почта»**. 3. Замените пароль в iEXExchanger. 4. Выполните тестовую отправку. ## Ошибка авторизации Если iEXExchanger не может авторизоваться в SMTP Яндекса, проверьте параметры последовательно.
Проверьте пароль Убедитесь, что в поле **«Пароль»** используется пароль приложения, а не основной пароль Яндекс ID.
Проверьте аккаунт Пароль приложения должен быть создан именно в аккаунте подключаемого почтового ящика.
Проверьте доступ почтовых программ В Яндекс Почте откройте: **«Настройки» — «Все настройки» — «Почтовые программы»** Проверьте, что разрешён доступ почтовых программ и включены **«Пароли приложений и OAuth-токены»**. Яндекс рекомендует также включить IMAP даже при настройке только SMTP.
Проверьте логин Для обычного `@yandex.ru` проверьте логин Яндекс ID. Для Яндекс 360 укажите полный корпоративный E-mail.
Проверьте первый вход Войдите под этим аккаунтом в веб-интерфейс Яндекс Почты. Если условия использования сервисов ещё не были приняты, первая авторизация в веб-интерфейсе позволяет завершить этот этап. Яндекс отдельно указывает это как одну из причин проблем с подключением почтовых программ.
Учтите задержку нового пароля Если пароль приложения создан только что, подождите 2–3 часа и выполните тест повторно.
Ошибка Sender address rejected: not owned by auth user Эта ошибка означает, что адрес отправителя не соответствует аккаунту, который используется для SMTP-авторизации. Например, если используется: ``` Логин: support@example.com ``` укажите: ``` E-mail отправителя: support@example.com ``` Не используйте на этапе первоначальной настройки адрес другого сотрудника, другого почтового ящика или неподтверждённый адрес.
Нет соединения с SMTP-сервером Проверьте: ``` SMTP-сервер: smtp.yandex.ru Порт: 465 Шифрование: SSL ``` Эти параметры соответствуют основной SMTP-конфигурации Яндекса. Если соединение не устанавливается, проверьте, разрешает ли сервер обменного пункта исходящие соединения на порт `465`. Некоторые хостинг-провайдеры ограничивают исходящий SMTP-трафик. Если `465` недоступен, можно проверить альтернативное подключение через порт `587` с соответствующим защищённым режимом. Если оба варианта недоступны, обратитесь к системному администратору или хостинг-провайдеру.
Подключение работало, но перестало Если параметры раньше работали, сначала проверьте, не выполнялись ли: * восстановление доступа к Яндекс ID; * выход со всех устройств; * удаление пароля приложения; * изменение учётных данных. После восстановления доступа и выхода со всех устройств Яндекс сбрасывает пароли приложений. В таком случае создайте новый пароль и замените его в iEXExchanger.
Письмо отправлено, но не получено Если тест в iEXExchanger завершился успешно, но письмо не появилось во входящих, проверьте: * правильность адреса получателя; * папку «Спам»; * состояние почтового ящика; * SPF корпоративного домена; * DKIM корпоративного домена; * фильтры на стороне получателя. Для корпоративной почты Яндекс 360 корректная настройка SPF и DKIM помогает почтовым системам проверять отправителя.
Письма отклоняются как спам Если Яндекс отклоняет отправку с сообщением о подозрении на спам, проверьте состояние почтового аккаунта и возможность обычной отправки через веб-интерфейс. Яндекс рекомендует в таком случае выполнить обычную ручную отправку письма непосредственно из Яндекс Почты и проверить аккаунт. Для production также проверьте SPF и DKIM, если используется собственный домен.
Всё настроено правильно, но обычные уведомления не приходят Если тестовое письмо отправляется, SMTP уже работает. Дальше проверьте настройки iEXExchanger: * включено ли **«Подключение включено»**; * включена ли **«Отправка уведомлений»**; * включены ли **«Уведомления по E-mail»**; * включено ли нужное событие у этого SMTP-подключения; * сохранены ли изменения списка событий; * указан ли корректный E-mail получателя. Если тест работает, а рабочее событие не отправляется, повторно вводить SMTP-параметры без причины не требуется.
Письма отправляются с задержкой Если SMTP-проверка проходит успешно, но обычные E-mail-события долго остаются необработанными, причина может находиться не в Яндекс Почте, а в фоновой обработке уведомлений iEXExchanger. Передайте техническому администратору на проверку: * Laravel Horizon; * очереди уведомлений; * Redis; * планировщик Laravel; * журналы ошибок уведомлений. Не передавайте ему пароль приложения, если для диагностики он не требуется.
*** ## Рекомендации по безопасности Для рабочего подключения рекомендуется использовать отдельный почтовый аккаунт. Не используйте личный ящик владельца или сотрудника, если можно создать отдельный служебный адрес. Для Яндекс 360 предпочтительно создать отдельного сотрудника, например: ``` notifications@example.com ``` или: ``` noreply@example.com ``` Создавайте отдельный пароль приложения специально для iEXExchanger. Например: ``` iEXExchanger SMTP ``` Если пароль стал известен постороннему лицу: 1. Удалите его в Яндекс ID. 2. Создайте новый. 3. Замените пароль в iEXExchanger. 4. Выполните тестовую отправку. Если подключение больше не используется, удалите соответствующий пароль приложения в Яндекс ID. Удаление пароля немедленно лишает использующее его приложение доступа к аккаунту. Для Яндекс 360 также защитите аккаунты владельца организации и сотрудника, которому принадлежит SMTP-ящик. Яндекс рекомендует использовать дополнительные средства защиты корпоративных аккаунтов, включая двухфакторную аутентификацию. ## Проверка настройки Подключение Яндекс Почты выполнено правильно, если: * создан отдельный почтовый ящик; * вход в Яндекс Почту работает; * пользователь хотя бы один раз открыл веб-интерфейс почты; * доступ почтовых программ разрешён; * разрешены пароли приложений; * создан отдельный пароль типа **«Почта»**; * используется `smtp.yandex.ru`; * используется порт `465`; * выбрано **«SSL»**; * указан правильный логин; * в **«E-mail отправителя»** указан адрес подключаемого ящика; * указано **«Имя отправителя»**; * включено **«Подключение включено»**; * тестовое письмо успешно отправлено; * тестовое письмо получено; * подключение не показывает ошибку; * для Яндекс 360 проверены SPF и DKIM; * в общей системе E-mail включены необходимые события и общие переключатели. После успешной проверки Яндекс Почта готова использоваться как SMTP-подключение iEXExchanger.