Migrar do Resend

Limites de compatibilidade

O SendHQ aceita os campos JSON comuns no estilo do Resend para envios HTTP diretos, mas não é um substituto direto do SDK do Resend. Aponte seu próprio adaptador HTTP no lado do servidor para /api/v1/emails; não presuma que um SDK com o host do Resend fixo no código possa ser reconfigurado.

Mapeamento de campos

from, to, cc, bcc, subject, html, text, reply_to e headers personalizados seguros têm mapeamento direto. O SendHQ também aceita message_class, referências a template hospedado, draft_id e campos de resposta/thread. Payloads React específicos do Resend, arrays de anexos inline, tags, audiences, broadcasts e campos de envio agendado não são equivalentes aceitos.

Anexos e templates

Envie os anexos para um rascunho do SendHQ e depois envie com draft_id. Os templates hospedados são recursos do SendHQ com versões publicadas e dados tipados; migre os IDs de template e as chamadas de renderização de forma explícita, em vez de copiar o identificador de template de um provedor.

Novas tentativas

Gere uma Idempotency-Key estável para cada envio lógico. Repita o mesmo payload JSON com essa chave. Se o assunto, o corpo, o destinatário, um cabeçalho ou os dados do template mudarem, use uma nova chave; caso contrário, o SendHQ retorna 409. Uma resposta armazenada e reproduzida inclui Idempotent-Replayed: true.

Checklist de migração

1. Verifique cada domínio From e cada endereço de remetente exato que você vai usar.
2. Envie mensagens controladas em texto e HTML para uma caixa de entrada sua.
3. Confirme a aceitação pelo provedor separadamente dos eventos de entrega.
4. Teste o tratamento de 409, 422, 423, 429 e 5xx.
5. Mantenha o adaptador do provedor anterior disponível até que os fluxos transacionais e de ciclo de vida passem.