Resend через API

Подтвердите домен Resend, создайте ключ с минимальными правами и подключите встроенный API-драйвер

Что вы получите

iEXExchanger будет отправлять транзакционные письма через встроенное подключение Resend, без SMTP-хоста, порта и логина. Ключ будет ограничен отправкой и привязан к подтверждённому домену.

В системе есть отдельный драйвер Resend. Для обычного сценария выбирайте его, а не вводите Resend SMTP в подключение SMTP.

Подготовьте домен в Resend

1

Выберите домен отправки

Для совместной работы с корпоративной почтой удобно использовать поддомен, например notify.your-domain.example. Resend также рекомендует отдельный поддомен.

2

Добавьте домен

В Resend откройте Domains, добавьте выбранное имя и получите индивидуальные DNS-записи.

3

Опубликуйте записи

Добавьте SPF и DKIM точно в показанном виде. Если Resend показывает отдельную служебную MX/return-path запись, также скопируйте её без изменения. Не заменяйте ею MX основной корпоративной почты.

4

Дождитесь статуса Verified

Обновляйте проверку после распространения DNS. Если статус не меняется, используйте официальную диагностику домена.

5

Настройте DMARC

Добавьте DMARC после проверки SPF/DKIM и постепенно усиливайте политику. См. руководство Resend по DMARC.

Создайте API-ключ

1. Откройте API Keys — Create API Key.
2. Назовите ключ по системе и окружению, например iEXExchanger production.
3. Выберите минимальное право Sending access.
4. Если интерфейс позволяет, ограничьте ключ нужным доменом.
5. Скопируйте значение один раз в менеджер секретов.
6. Не добавляйте ключ в Git, документацию и сообщения.

Официальные правила: создание API-ключа и безопасное хранение ключей.

Создайте подключение Resend

Откройте «Настройки» — «Общие настройки» — «Уведомления» — «Подключения», нажмите «Добавить» и выберите Resend.

Поле iEXExchanger	Что указать
Название	Понятное внутреннее имя подключения
API-ключ	Только что созданный ключ Sending access
E-mail отправителя	Адрес подтверждённого домена или поддомена
Имя отправителя	Публичное название обменного пункта

После подтверждения домена Resend позволяет использовать адрес этого домена без создания отдельной записи sender. Желательно выбрать адрес, который реально принимает ответы; см. правила адреса отправителя Resend.

Проверьте по двум журналам

1

Проверьте подключение

Укажите контрольный E-mail в форме подключения и нажмите «Отправить тест».

2

Выполните «Проверить»

Сверьте состояние строки в iEXExchanger.

3

Откройте Resend Logs

Найдите отправку по времени и получателю. Отличите принятую, доставленную, отложенную и отклонённую отправку.

4

Проверьте конечный ящик

Откройте входящие и спам. Состояние в Resend не заменяет проверку отображения письма у клиента.

5

Вызовите реальное событие

Создайте новую контрольную заявку и проверьте выбранную аудиторию и отсутствие дубля через SMTP.

Типовые ошибки Resend

Симптом	Что проверить
Domain not verified	Точное имя DNS, отсутствие лишнего суффикса у DNS-хостинга, TTL и конфликтующие записи
Unauthorized / invalid API key	Ключ скопирован полностью, не отозван и имеет Sending access
Sender domain is not verified	From использует именно подтверждённый домен или поддомен
Принято, но письмо не пришло	Журнал, возврат или жалобу, спам, SPF/DKIM/DMARC и репутацию
Два одинаковых письма	То же событие включено и в Resend, и в SMTP

Ротация ключа без простоя

1. Создайте новый ключ с теми же минимальными правами.
2. Сохраните его в подключении iEXExchanger.
3. Отправьте проверочное письмо и вызовите реальное событие.
4. Только после подтверждения отзовите старый ключ в Resend.
5. Проверьте, что команда удалила старое значение из менеджера секретов.

Этап завершён, если

• домен Resend имеет статус Verified;
• SPF и DKIM опубликованы без конфликта;
• ключ ограничен отправкой;
• используется нативное подключение Resend;
• From относится к подтверждённому домену;
• отправка видна в Resend Logs и в конечном ящике;
• реальное событие проверено;
• SMTP не создаёт непреднамеренный дубль.

Другие сервисы подключайте по универсальной схеме SMTP.