Переход с Resend

Граница совместимости

SendHQ принимает распространённые JSON-поля в стиле Resend при прямой HTTP-отправке, но не является полноценной заменой SDK Resend. Направьте собственный серверный HTTP-адаптер на /api/v1/emails; не рассчитывайте, что SDK с жёстко прописанным хостом Resend удастся перенастроить.

Сопоставление полей

from, to, cc, bcc, subject, html, text, reply_to и безопасные пользовательские headers сопоставляются напрямую. SendHQ также принимает message_class, ссылки на хранимые шаблоны template, draft_id и поля ответа/цепочки. Специфичные для Resend React-нагрузки, массивы встроенных вложений, теги, аудитории, рассылки (broadcasts) и поля отложенной отправки не имеют принимаемых аналогов.

Вложения и шаблоны

Загрузите вложения в черновик SendHQ, а затем отправьте письмо с draft_id. Хранимые шаблоны — это ресурсы SendHQ с опубликованными версиями и типизированными данными; переносите ID шаблонов и вызовы рендеринга явно, а не копируйте идентификатор шаблона провайдера.

Повторные попытки

Генерируйте один стабильный Idempotency-Key на каждую логическую отправку. Повторяйте идентичную JSON-нагрузку с этим ключом. Если меняется тема, тело, получатель, заголовок или данные шаблона, используйте новый ключ; иначе SendHQ вернёт 409. Повторно выданный сохранённый ответ содержит Idempotent-Replayed: true.

Чек-лист переключения

1. Подтвердите каждый домен From и каждый конкретный адрес отправителя, который будете использовать.
2. Отправьте контрольные текстовые и HTML-письма в собственный почтовый ящик.
3. Проверяйте приём провайдером отдельно от событий доставки.
4. Проверьте обработку 409, 422, 423, 429 и 5xx.
5. Сохраняйте адаптер предыдущего провайдера, пока не пройдут проверку и транзакционные, и жизненные (lifecycle) сценарии.