> 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-gmail.md). # Подключение Gmail Gmail можно использовать как SMTP-почту для отправки системных писем из iEXExchanger. Через Gmail система может отправлять уведомления по заявкам, письма клиентам, уведомления администраторам, письма безопасности, подтверждения e-mail и другие сообщения. Для подключения используется почтовая служба SMTP. ## Где находится настройка Откройте панель управления и перейдите в раздел: **«Настройки» — «Общие настройки» — «Уведомления» — «E-mail уведомления»**
На этой странице настраивается почтовая служба для отправки системных писем. ## Какой Gmail можно использовать Есть два варианта подключения. {% stepper %} {% step %} ### Обычный Gmail Это почта вида: ``` example@gmail.com ``` Такой вариант можно использовать для тестов или небольших проектов. Для полноценного обменника лучше использовать доменную почту, потому что обычный Gmail имеет несколько ограничений: * отправитель будет выглядеть как `@gmail.com`; * сложнее использовать брендовый e-mail; * действуют лимиты Google на отправку; * Google может блокировать подозрительные SMTP-отправки. {% endstep %} {% step %} ### Google Workspace Google Workspace — это Gmail на вашем домене. Например: ``` support@example.com ``` Для обменника рекомендуется использовать именно этот вариант. Примеры системных адресов: ``` support@example.com noreply@example.com mail@example.com ``` Так письма будут отправляться с доменного адреса проекта, а не с обычного Gmail-аккаунта. {% endstep %} {% endstepper %} ## Что нужно подготовить Перед настройкой подготовьте: * доступ к Google-аккаунту или Google Workspace; * включённую двухэтапную аутентификацию; * пароль приложения Google; * e-mail, который будет использоваться для отправки; * доступ в панель управления iEXExchanger; * если используется Google Workspace — доступ к DNS домена. *** ## Включение двухэтапной аутентификации Для SMTP-подключения Gmail обычно требуется пароль приложения. Чтобы создать пароль приложения, сначала включите двухэтапную аутентификацию в Google-аккаунте. Откройте страницу безопасности Google: Перейдите в раздел безопасности аккаунта и включите двухэтапную аутентификацию. После включения Google может попросить подтвердить вход через телефон, приложение, резервный код или другой способ защиты. ## Создание пароля приложения Откройте страницу паролей приложений: Если страница недоступна, проверьте: * включена ли двухэтапная аутентификация; * не используется ли аккаунт с расширенной защитой Google; * не запрещены ли пароли приложений администратором Google Workspace; * не настроен ли вход только через электронные ключи безопасности. Создайте новый пароль приложения. В названии можно указать: **iEXExchanger SMTP** или: **smtp-exchanger** Google выдаст пароль приложения. Обычно это код из 16 символов. Скопируйте его и сохраните в безопасном месте. В iEXExchanger пароль нужно вставлять без пробелов. {% hint style="info" %} ## Важно Обычный пароль от Google-аккаунта чаще всего не подходит для SMTP. Используйте именно пароль приложения. {% endhint %} ## Если используется Google Workspace Если вы хотите отправлять письма с адреса вида: ``` support@example.com ``` домен должен быть подключён к Google Workspace. Для корректной работы почты также необходимо настроить DNS-записи домена. ## MX-запись MX-запись отвечает за получение входящей почты на домене. Для новых настроек Google Workspace обычно используется такая MX-запись: ``` Type: MX Name / Host: @ Priority: 1 Value: smtp.google.com ``` Если Google Admin Console показывает другие значения, используйте значения из вашей консоли Google. Если на домене уже были MX-записи другого почтового сервиса, их нужно удалить. Иначе входящая почта может работать неправильно. ## SPF-запись SPF подтверждает, что Google имеет право отправлять письма от имени вашего домена. Добавьте TXT-запись: ``` v=spf1 include:_spf.google.com ~all ``` Если SPF-запись уже существует, не создавайте вторую. Нужно объединить все отправляющие сервисы в одну SPF-запись. Две разные SPF-записи одновременно использовать нельзя. ## DKIM DKIM повышает доверие к письмам и помогает снизить риск попадания в спам. В Google Admin Console: 1. Откройте настройки Gmail. 2. Создайте DKIM-запись для домена. 3. Добавьте TXT-запись в DNS. 4. Дождитесь применения DNS. 5. Запустите аутентификацию DKIM. Обычно DKIM-запись имеет имя примерно такого вида: ``` google._domainkey ``` Точное имя и значение нужно брать из Google Admin Console. ## DMARC DMARC рекомендуется добавлять после SPF и DKIM. Для начала можно использовать мягкую политику: ``` v=DMARC1; p=none; rua=mailto:dmarc@example.com ``` После проверки доставки писем политику можно усилить. Не включайте строгую политику сразу, если не уверены, что SPF и DKIM работают корректно. *** ## Настройка Gmail в iEXExchanger Откройте раздел: **«Настройки» — «Общие настройки» — «Уведомления» — «E-mail уведомления»**
В поле «Почтовая служба» выберите: **SMTP** После этого заполните SMTP-настройки. *** ## Рекомендуемые SMTP-настройки Gmail Основной вариант: ``` Почтовая служба: SMTP SMTP хост: smtp.gmail.com SMTP порт: 465 Шифрование SMTP: SSL SMTP имя пользователя: support@example.com SMTP пароль: пароль приложения Google E-mail в качестве отправителя: support@example.com Имя в качестве отправителя: название обменника E-mail адрес службы поддержки: support@example.com E-mail адрес администратора: admin@example.com ``` Если используется обычный Gmail: ``` SMTP имя пользователя: example@gmail.com E-mail в качестве отправителя: example@gmail.com ``` Если порт `465` не работает, используйте второй вариант: ``` SMTP хост: smtp.gmail.com SMTP порт: 587 Шифрование SMTP: TLS ``` Для Gmail не используйте вариант без шифрования. *** ## Что указывать в полях {% stepper %} {% step %} ### SMTP хост Укажите: ``` smtp.gmail.com ``` {% endstep %} {% step %} ### SMTP порт Для SSL используйте: ``` 465 ``` Для TLS используйте: ``` 587 ``` Обычно сначала пробуют вариант `465 + SSL`. Если подключение не работает, можно попробовать `587 + TLS`. {% endstep %} {% step %} ### SMTP имя пользователя Укажите полный e-mail Google-аккаунта. Для Google Workspace: ``` support@example.com ``` Для обычного Gmail: ``` example@gmail.com ``` {% endstep %} {% step %} ### SMTP пароль Укажите пароль приложения Google. Обычный пароль от Google-аккаунта использовать не рекомендуется. {% endstep %} {% step %} ### Шифрование SMTP Для порта `465` выберите: ``` SSL ``` Для порта `587` выберите: ``` TLS ``` {% endstep %} {% step %} ### Шифрование SMTP Для порта `465` выберите: ``` SSL ``` Для порта `587` выберите: ``` TLS ``` {% endstep %} {% step %} ### E-mail в качестве отправителя Укажите адрес, от имени которого система будет отправлять письма. Лучше использовать тот же адрес, который указан в поле «SMTP имя пользователя». Пример: ``` support@example.com ``` Если указать другой адрес, Gmail может не разрешить отправку или показать письмо как отправленное от имени другого адреса. {% endstep %} {% step %} ### Имя в качестве отправителя Укажите название обменника или службы поддержки. Например: ``` Example Exchange ``` или: ``` Служба поддержки Example Exchange ``` {% endstep %} {% step %} ### E-mail адрес службы поддержки Укажите адрес службы поддержки. Например: ``` support@example.com ``` {% endstep %} {% step %} ### E-mail адрес администратора Укажите e-mail администратора для внутренних уведомлений. Например: ``` admin@example.com ``` Если получателей несколько, укажите их через запятую: ``` admin@example.com, manager@example.com ``` {% endstep %} {% endstepper %} *** ## Если нужно отправлять с alias-адреса Иногда SMTP-аккаунт один, а отправлять письма нужно с другого адреса. Например: ``` SMTP имя пользователя: main@example.com E-mail в качестве отправителя: support@example.com ``` Так можно делать только если адрес `support@example.com` добавлен и подтверждён в Gmail как адрес отправителя. В Gmail это настраивается в разделе: «Настройки» — «Все настройки» — «Аккаунты и импорт» — «Отправлять письма как» Если alias не подтверждён, Gmail может отклонить отправку или показать реальный адрес отправителя. Для простой и стабильной настройки лучше использовать один и тот же адрес: ``` SMTP имя пользователя: support@example.com E-mail в качестве отправителя: support@example.com ``` ## Включение e-mail уведомлений На странице «E-mail уведомления» проверьте общие параметры отправки. Должны быть включены: ``` Отправлять уведомления Отправлять письма ``` Если общая отправка выключена, система может сохранить SMTP-настройки, но письма отправляться не будут. Также можно отдельно включать или отключать разные типы писем: * изменение статуса заявки; * успешная выплата партнёрских бонусов; * подтверждение вывода вознаграждений; * реквизиты по запросу; * пересчёт суммы; * восстановление заявки; * отложенная заявка; * уведомление о чёрном списке реквизитов; * успешный вход; * вход с нового устройства; * подтверждение e-mail; * блокировка из-за попыток входа; * автоматическая регистрация; * проверка счёта; * проверка личности; * новые заявки для администратора; * заявки на выплаты; * новые отзывы. Оставьте включёнными только те уведомления, которые действительно нужны вашему проекту. ## Проверка отправки письма После заполнения настроек нажмите «Сохранить». Затем отправьте тестовое письмо через кнопку тестовой отправки на странице настроек e-mail. После отправки проверьте: * папку «Входящие»; * папку «Спам»; * папку «Промоакции»; * правильность e-mail службы поддержки; * правильность e-mail администратора. Если тестовое письмо пришло, Gmail SMTP подключён корректно. ## Частые ошибки
Ошибка «Неверный пароль» Возможные причины: * указан обычный пароль от Google-аккаунта; * пароль приложения введён с ошибкой; * пароль приложения был сброшен после смены пароля Google; * двухэтапная аутентификация не включена; * администратор Google Workspace запретил пароли приложений. Что сделать: 1. Включите двухэтапную аутентификацию. 2. Создайте новый пароль приложения. 3. Вставьте его в поле «SMTP пароль» без пробелов. 4. Сохраните настройки. 5. Отправьте тестовое письмо.
Нет пункта «Пароли приложений» Такое может быть, если: * не включена двухэтапная аутентификация; * аккаунт подключён к расширенной защите Google; * используется рабочий аккаунт, где администратор запретил пароли приложений; * для входа настроены только электронные ключи безопасности. Если это Google Workspace, обратитесь к администратору Google Workspace.
Ошибка timeout Возможные причины: * сервер не может подключиться к `smtp.gmail.com`; * порт `465` или `587` заблокирован; * выбран неправильный тип шифрования; * хостинг ограничивает исходящие SMTP-подключения. Что сделать: 1. Проверьте связку `465 + SSL`. 2. Если не работает, попробуйте `587 + TLS`. 3. Убедитесь, что SMTP host указан как `smtp.gmail.com`. 4. Если ошибка остаётся, обратитесь к хостинг-провайдеру и попросите проверить исходящие подключения на порты `465` и `587`.
Письма отправляются, но попадают в спам Проверьте: * SPF-запись; * DKIM; * DMARC; * совпадает ли домен отправителя с доменом Google Workspace; * не используется ли обычный Gmail вместо доменной почты; * не превышены ли лимиты отправки; * не выглядит ли текст письма как спам. Для доменной почты обязательно настройте SPF и DKIM.
Письма не приходят администраторам Проверьте поле: ``` E-mail адрес администратора ``` Если адресов несколько, они должны быть указаны через запятую. Также проверьте, включены ли нужные уведомления для администраторов.
Клиенты не получают письма Проверьте: * включён ли параметр «Отправлять письма»; * включён ли нужный тип клиентского уведомления; * указан ли e-mail клиента; * не отключено ли поле e-mail в настройках обмена; * не попадает ли письмо в спам; * не превышены ли лимиты Gmail.
*** ## Ограничения Gmail Gmail и Google Workspace имеют лимиты на отправку писем. Для Google Workspace лимит может составлять до 2000 сообщений в день на один пользовательский аккаунт, но Google может применять дополнительные ограничения. Для пробных аккаунтов лимиты ниже. Если обменник отправляет много писем, Gmail может быть не лучшим вариантом. Для высокой нагрузки лучше использовать специализированный почтовый сервис или отдельный SMTP-провайдер. ## Рекомендации по безопасности Рекомендуется: * использовать отдельный почтовый ящик для сайта; * включить двухэтапную аутентификацию; * использовать пароль приложения; * не использовать личный аккаунт владельца проекта; * не хранить пароль приложения в открытых документах; * после смены пароля Google создать новый пароль приложения; * периодически проверять тестовую отправку писем; * для доменной почты настроить SPF, DKIM и DMARC. *** ## Краткая схема настройки 1. Войдите в Google-аккаунт. 2. Включите двухэтапную аутентификацию. 3. Создайте пароль приложения. 4. Если используется Google Workspace, настройте DNS домена. 5. В панели управления откройте **«Настройки» — «Общие настройки» — «Уведомления» — «E-mail уведомления».** 6. Выберите почтовую службу SMTP. 7. Укажите `smtp.gmail.com`. 8. Укажите порт `465` и шифрование `SSL`. 9. Введите полный e-mail как SMTP-логин. 10. Введите пароль приложения как SMTP-пароль. 11. Укажите e-mail отправителя. 12. Укажите имя отправителя. 13. Укажите e-mail поддержки и администратора. 14. Включите отправку e-mail уведомлений. 15. Сохраните настройки. 16. Отправьте тестовое письмо. *** ## Коротко Для подключения Gmail к iEXExchanger используйте SMTP. Откройте раздел «Настройки» — «Общие настройки» — «Уведомления» — «E-mail уведомления», выберите почтовую службу SMTP и укажите данные Gmail. Для большинства случаев используется: ``` SMTP хост: smtp.gmail.com SMTP порт: 465 Шифрование SMTP: SSL SMTP имя пользователя: support@example.com SMTP пароль: пароль приложения Google ``` Для обменника лучше использовать Google Workspace с доменным адресом, например `support@example.com`, а не обычный `example@gmail.com`. --- # 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/guide/uvedomleniya/uvedomlenie-po-e-mail/podklyuchenie-gmail.md?ask=&goal= ``` `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.