Migrare da Resend

Limiti di compatibilità

SendHQ accetta i campi JSON comuni in stile Resend per gli invii HTTP diretti, ma non è un sostituto drop-in dell'SDK di Resend. Punta il tuo adattatore HTTP lato server a /api/v1/emails; non dare per scontato che un SDK con l'host di Resend hard-coded si possa riconfigurare.

Mappatura dei campi

from, to, cc, bcc, subject, html, text, reply_to e le headers personalizzate sicure si mappano direttamente. SendHQ accetta anche message_class, riferimenti a template ospitati, draft_id e campi di risposta/thread. I payload React specifici di Resend, gli array di allegati inline, i tag, le audience, i broadcast e i campi di invio programmato non hanno equivalenti accettati.

Allegati e template

Carica gli allegati in una bozza SendHQ, poi invia con draft_id. I template ospitati sono risorse SendHQ con versioni pubblicate e dati tipizzati; migra esplicitamente gli ID dei template e le chiamate di rendering invece di copiare l'identificativo di template di un provider.

Nuovi tentativi

Genera una Idempotency-Key stabile per ogni invio logico. Ritenta con lo stesso identico payload JSON e la stessa chiave. Se cambiano oggetto, corpo, destinatario, intestazione o dati del template, usa una nuova chiave; altrimenti SendHQ restituisce 409. Una risposta memorizzata riprodotta include Idempotent-Replayed: true.

Checklist per il passaggio

1. Verifica ogni dominio From e ogni indirizzo mittente esatto che userai.
2. Invia messaggi di testo e HTML controllati a una inbox di tua proprietà.
3. Verifica l'accettazione da parte del provider separatamente dagli eventi di consegna.
4. Metti alla prova la gestione di 409, 422, 423, 429 e 5xx.
5. Mantieni disponibile l'adattatore del provider precedente finché sia il percorso transazionale sia quello del ciclo di vita non superano i test.