> 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-resend.md). # Подключение Resend Resend — это сервис для отправки транзакционных писем через API. В iEXExchanger Resend используется как отдельная почтовая служба и не требует настройки SMTP-хоста, порта, логина, пароля и шифрования. Через Resend можно отправлять системные письма: * уведомления клиентам по заявкам; * письма о смене статуса заявки; * письма подтверждения e-mail; * уведомления о входе и новом устройстве; * письма администраторам о новых заявках; * уведомления о проверках, выплатах, отзывах и других событиях. ## Где находится настройка Откройте панель управления и перейдите в раздел: **«Настройки» — «Общие настройки» — «Уведомления» — «E-mail уведомления»**
На этой странице выбирается почтовая служба и настраиваются параметры отправки писем. ## Чем Resend отличается от SMTP При SMTP вы подключаете почтовый ящик через сервер, порт, логин и пароль. Например: ``` smtp.gmail.com 465 SSL support@example.com пароль приложения ``` При Resend всё работает иначе. Система отправляет письма через API-ключ Resend. Для Resend в iEXExchanger нужно указать: * Resend API Key; * e-mail отправителя; * имя отправителя; * e-mail службы поддержки; * e-mail администратора. SMTP-поля для Resend не используются. *** ## Что нужно подготовить Перед настройкой подготовьте: * аккаунт Resend; * домен или поддомен для отправки писем; * доступ к DNS-записям домена; * подтверждённый домен в Resend; * API-ключ Resend; * доступ в панель управления iEXExchanger. Для полноценной отправки писем клиентам необходимо подтвердить собственный домен. Тестовый домен `resend.dev` подходит только для проверки и имеет ограничения. ## Какой домен лучше использовать Для отправки через Resend рекомендуется использовать отдельный поддомен. Например: ``` notifications.example.com mail.example.com updates.example.com ``` Такой подход безопаснее для основного домена и удобнее для настройки доставляемости. Пример: ``` Основной сайт: example.com Почта поддержки: support@example.com Домен для отправки через Resend: notifications.example.com Отправитель: noreply@notifications.example.com ``` Если необходимо отправлять письма именно с адреса: ``` support@example.com ``` тогда в Resend нужно подтверждать основной домен: ``` example.com ``` Если на основном домене уже работает почта через Google, Яндекс, Zoho или другой сервис, внимательно проверяйте DNS-записи, чтобы не нарушить входящую почту. *** ## Регистрация в Resend Перейдите на сайт: Создайте аккаунт или войдите в существующий. После входа откройте панель управления Resend. ## Добавление домена в Resend В Resend откройте раздел: ``` Domains ``` Нажмите: ``` Add Domain ``` Укажите домен или поддомен, который будет использоваться для отправки писем. Рекомендуемый вариант: ``` notifications.example.com ``` или: ``` mail.example.com ``` После добавления Resend покажет DNS-записи, которые нужно добавить у вашего DNS-провайдера. ## Настройка DNS-записей Откройте панель управления DNS вашего домена. Это может быть панель регистратора домена, Cloudflare, FastPanel или другой сервис, где управляются DNS-записи. Resend выдаст набор записей для подтверждения домена и настройки отправки. Обычно это записи типа: ``` TXT MX ``` Также могут быть записи, связанные с DKIM, SPF и Return-Path. Добавляйте DNS-записи точно так, как их показывает Resend. Не меняйте имя записи, значение, точки, подчёркивания и другие символы. После добавления записей вернитесь в Resend и запустите проверку домена. Проверка часто проходит в течение 15 минут, но иногда DNS-записи могут применяться до 72 часов. {% hint style="warning" %} ## Важная информация про MX-записи Если вы используете Resend только для отправки писем, а входящая почта уже работает через Google, Яндекс, Zoho или другой сервис, будьте осторожны с MX-записями. Не удаляйте существующие MX-записи основной почты, если не понимаете, зачем это нужно. Именно поэтому лучше использовать отдельный поддомен для Resend. Например: ``` notifications.example.com ``` В этом случае DNS-записи Resend будут относиться к поддомену и не сломают входящую почту на основном домене: ``` example.com ``` {% endhint %} *** ## Создание API-ключа Resend После подтверждения домена откройте в Resend раздел: ``` API Keys ``` Нажмите: ``` Create API Key ``` Укажите понятное название. Например: ``` iEXExchanger Production ``` Для iEXExchanger достаточно ключа с правом отправки писем. Если Resend предлагает выбрать права доступа, выберите: ``` Sending access ``` Если доступна привязка к домену, выберите домен, который был добавлен для отправки писем. После создания Resend покажет API-ключ. Пример формата: ``` re_xxxxxxxxxxxxxxxxxxxxxxxxx ``` Скопируйте ключ сразу. Resend не показывает значение ключа повторно после создания. Если ключ потерян, создайте новый и замените его в iEXExchanger. *** ## Настройка Resend в iEXExchanger Откройте раздел: **«Настройки» — «Общие настройки» — «Уведомления» — «E-mail уведомления»**
В блоке «Почтовая служба» выберите: **Resend (рекомендуется)** После выбора Resend появится поле: **Resend API Key**
Вставьте в него API-ключ из личного кабинета Resend. Пример: ``` re_xxxxxxxxxxxxxxxxxxxxxxxxx ``` *** ## Настройка отправителя Даже при использовании Resend необходимо заполнить данные отправителя. {% stepper %} {% step %} ### E-mail в качестве отправителя Укажите e-mail, с которого будут отправляться письма. Если в Resend подтверждён домен: ``` notifications.example.com ``` можно указать: ``` noreply@notifications.example.com ``` Если в Resend подтверждён основной домен: ``` example.com ``` можно указать: ``` support@example.com ``` Домен в e-mail отправителя должен совпадать с доменом или поддоменом, подтверждённым в Resend. Если указать отправителя с неподтверждённого домена, письма не будут отправляться. {% endstep %} {% step %} ### Имя в качестве отправителя Укажите название обменника или службы поддержки. Например: ``` Example Exchange ``` или: ``` Служба поддержки Example Exchange ``` Клиенты будут видеть это имя в письмах. {% endstep %} {% step %} ### E-mail службы поддержки Поле «E-mail адрес службы поддержки» используется как контактный адрес поддержки в письмах клиентам. Например: ``` support@example.com ``` Рекомендуется указывать реальный почтовый ящик, куда клиенты могут написать. Даже если отправитель указан как: ``` noreply@notifications.example.com ``` адрес поддержки лучше указывать реальный: ``` support@example.com ``` {% endstep %} {% step %} ### E-mail администратора Поле «E-mail адрес администратора» используется для внутренних уведомлений. Например: ``` admin@example.com ``` Если получателей несколько, укажите их через запятую: ``` admin@example.com, manager@example.com ``` На эти адреса могут приходить уведомления о новых заявках, выплатах, проверках, отзывах и других событиях. {% endstep %} {% endstepper %} *** ## Рекомендуемая настройка Пример для поддомена Resend: ``` Почтовая служба: Resend (рекомендуется) Resend API Key: re_xxxxxxxxxxxxxxxxxxxxxxxxx E-mail в качестве отправителя: noreply@notifications.example.com Имя в качестве отправителя: Example Exchange E-mail адрес службы поддержки: support@example.com E-mail адрес администратора: admin@example.com ``` Пример для основного домена: ``` Почтовая служба: Resend (рекомендуется) Resend API Key: re_xxxxxxxxxxxxxxxxxxxxxxxxx E-mail в качестве отправителя: support@example.com Имя в качестве отправителя: Example Exchange E-mail адрес службы поддержки: support@example.com E-mail адрес администратора: admin@example.com ``` ## Включение e-mail уведомлений На странице «E-mail уведомления» проверьте общие настройки. Должны быть включены: ``` Отправлять уведомления Отправлять письма ``` Если общий параметр отправки писем выключен, Resend может быть настроен правильно, но письма отправляться не будут. Также можно отдельно включать или отключать письма для разных событий: * изменение статуса заявки; * успешная выплата партнёрских бонусов; * подтверждение вывода вознаграждений; * реквизиты по запросу; * пересчёт суммы; * восстановление заявки; * отложенная заявка; * чёрный список реквизитов; * успешный вход; * вход с нового устройства; * подтверждение e-mail; * блокировка из-за попыток входа; * автоматическая регистрация; * проверка счёта; * проверка личности; * новые заявки для администратора; * заявки на выплаты; * новые отзывы. Оставьте включёнными только те уведомления, которые действительно нужны вашему проекту. *** ## Проверка отправки письма После заполнения настроек нажмите: ``` Сохранить ``` Затем используйте кнопку: ``` Тестовое сообщение ``` Тестовое письмо отправляется на адрес, указанный как e-mail службы поддержки. После отправки проверьте: * папку «Входящие»; * папку «Спам»; * папку «Промоакции»; * статус отправки в Resend; * логи писем в Resend Dashboard. Если письмо пришло, интеграция работает. ## Где смотреть отправленные письма в Resend В Resend Dashboard можно смотреть историю отправки. Обычно для этого используется раздел: ``` Logs ``` Там можно проверить: * было ли письмо отправлено; * какой e-mail был получателем; * какой e-mail был отправителем; * был ли отказ доставки; * была ли ошибка API-ключа; * не отклонено ли письмо из-за неподтверждённого домена. Это удобно для диагностики, если тестовое письмо из iEXExchanger не приходит. *** ## Частые ошибки
Письмо не отправляется Проверьте: * выбрана ли почтовая служба «Resend (рекомендуется)»; * вставлен ли API-ключ; * не скопирован ли ключ с пробелами; * активен ли ключ в Resend; * подтверждён ли домен в Resend; * совпадает ли домен отправителя с подтверждённым доменом; * включён ли параметр «Отправлять письма».
Ошибка из-за resend.dev Если используется отправитель вида: ``` onboarding@resend.dev ``` Resend разрешит отправлять тестовые письма только на e-mail вашего аккаунта Resend. Для отправки клиентам необходимо: 1. Добавить собственный домен в Resend. 2. Подтвердить DNS-записи. 3. Указать в iEXExchanger отправителя на вашем домене. Например: ``` noreply@notifications.example.com ``` или: ``` support@example.com ```
Ошибка из-за неподтверждённого домена Если в iEXExchanger указан отправитель: ``` support@example.com ``` а в Resend подтверждён только: ``` notifications.example.com ``` письмо может не отправиться. В этом случае нужно либо подтвердить в Resend домен: ``` example.com ``` либо изменить отправителя на адрес с подтверждённого поддомена: ``` noreply@notifications.example.com ```
Письма попадают в спам Проверьте: * все ли DNS-записи Resend подтверждены; * добавлен ли DMARC; * не используется ли подозрительный текст письма; * не указан ли несуществующий или неподходящий отправитель; * не отправляется ли слишком много одинаковых писем; * не превышены ли лимиты аккаунта. Также рекомендуется использовать понятное имя отправителя и реальный адрес поддержки.
Тестовое письмо не приходит Проверьте: * e-mail службы поддержки; * папку «Спам»; * статус письма в Resend Logs; * API-ключ; * домен отправителя; * включена ли отправка e-mail уведомлений. Если в Resend письмо отображается как отправленное, но не приходит получателю, проблема может быть на стороне почтового ящика получателя или DNS-доставляемости.
API-ключ потерян Resend не показывает значение API-ключа повторно. Если ключ потерян: 1. Откройте Resend Dashboard. 2. Перейдите в раздел API Keys. 3. Создайте новый API-ключ. 4. Скопируйте его. 5. Вставьте новый ключ в iEXExchanger. 6. Сохраните настройки. 7. Отправьте тестовое письмо. 8. Старый ключ можно удалить.
*** ## Лимиты Resend На бесплатном аккаунте Resend действуют ограничения по количеству писем. Обычно бесплатный аккаунт подходит только для тестов или небольшого объёма отправки. Если обменник отправляет много уведомлений, рекомендуется выбрать подходящий платный тариф Resend. Также учитывайте, что если письмо отправляется нескольким получателям через To, CC или BCC, каждый получатель может считаться отдельно. ## Нужны ли Webhooks Resend Для базовой отправки писем из iEXExchanger webhooks Resend не нужны. Достаточно: * подтвердить домен; * создать API-ключ; * вставить API-ключ в панели управления; * указать отправителя; * включить уведомления; * отправить тестовое письмо. Webhooks могут использоваться для сложной аналитики доставки, но для стандартной настройки почтовых уведомлений они не требуются. ## Нужен ли отдельный почтовый ящик в Resend Resend не требует создавать отдельный e-mail-ящик или sender identity. После подтверждения домена можно отправлять письма с любого адреса на этом домене. Например, если подтверждён домен: ``` example.com ``` можно отправлять с адресов: ``` support@example.com noreply@example.com mail@example.com ``` Но лучше использовать адрес, который может принимать ответы клиентов. Если адрес не существует как реальный почтовый ящик, клиент может ответить на письмо, но вы это письмо не получите. ## Рекомендации по безопасности Рекомендуется: * создавать отдельный API-ключ только для iEXExchanger; * использовать ключ только с правом отправки писем, если Resend позволяет выбрать такое ограничение; * не публиковать API-ключ в документах, чатах и скриншотах; * удалить старые и неиспользуемые API-ключи; * при подозрении на утечку сразу создать новый ключ и заменить его в iEXExchanger; * использовать отдельный поддомен для отправки писем; * настроить SPF, DKIM и DMARC; * периодически проверять Logs в Resend. ## Краткая схема настройки 1. Зарегистрируйтесь на Resend. 2. Откройте раздел Domains. 3. Нажмите Add Domain. 4. Добавьте домен или поддомен для отправки писем. 5. Скопируйте DNS-записи Resend. 6. Добавьте DNS-записи у вашего DNS-провайдера. 7. Дождитесь подтверждения домена. 8. Откройте раздел API Keys. 9. Создайте API-ключ для iEXExchanger. 10. Скопируйте API-ключ. 11. В панели управления откройте **«Настройки» — «Общие настройки» — «Уведомления» — «E-mail уведомления».** 12. Выберите **«Resend (рекомендуется)».** 13. Вставьте Resend API Key. 14. Укажите e-mail отправителя. 15. Укажите имя отправителя. 16. Укажите e-mail службы поддержки. 17. Укажите e-mail администратора. 18. Включите отправку уведомлений и писем. 19. Сохраните настройки. 20. Отправьте тестовое письмо. 21. Проверьте получение письма и Logs в Resend. ## Коротко Resend подключается к iEXExchanger через API-ключ, а не через SMTP. Для настройки откройте **«Настройки» — «Общие настройки» — «Уведомления» — «E-mail уведомления»**, выберите **«Resend (рекомендуется)»**, вставьте API-ключ Resend и укажите данные отправителя. Для рабочего обменника рекомендуется использовать подтверждённый поддомен, например: ``` notifications.example.com ``` и отправителя: ``` noreply@notifications.example.com ``` Адрес поддержки лучше указывать реальный, например: ``` support@example.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-resend.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.