Von Resend migrieren

Kompatibilitätsgrenze

SendHQ akzeptiert die üblichen JSON-Felder im Resend-Stil für direkte HTTP-Sendungen, ist aber kein Drop-in-Ersatz für das Resend-SDK. Richten Sie Ihren eigenen serverseitigen HTTP-Adapter auf /api/v1/emails aus; gehen Sie nicht davon aus, dass sich ein SDK mit fest codiertem Resend-Host umkonfigurieren lässt.

Feldzuordnung

from, to, cc, bcc, subject, html, text, reply_to und sichere benutzerdefinierte headers werden direkt übernommen. SendHQ akzeptiert außerdem message_class, Referenzen auf gehostete template-Templates, draft_id sowie Antwort- und Thread-Felder. Resend-spezifische React-Payloads, Inline-Anhang-Arrays, Tags, Audiences, Broadcasts und Felder für geplanten Versand werden nicht als gleichwertig akzeptiert.

Anhänge und Templates

Laden Sie Anhänge in einen SendHQ-Entwurf hoch und senden Sie dann mit draft_id. Gehostete Templates sind SendHQ-Ressourcen mit veröffentlichten Versionen und typisierten Daten; migrieren Sie Template-IDs und Rendering-Aufrufe explizit, statt eine Template-Kennung des Providers zu kopieren.

Wiederholungsversuche

Erzeugen Sie pro logischer Sendung einen stabilen Idempotency-Key. Wiederholen Sie das identische JSON-Payload mit diesem Schlüssel. Ändert sich Betreff, Inhalt, Empfänger, Header oder Template-Daten, verwenden Sie einen neuen Schlüssel; andernfalls liefert SendHQ 409. Eine erneut ausgelieferte gespeicherte Antwort enthält Idempotent-Replayed: true.

Checkliste für die Umstellung

1. Verifizieren Sie jede From-Domain und jede exakte Absenderadresse, die Sie verwenden werden.
2. Senden Sie kontrollierte Text- und HTML-Nachrichten an ein eigenes Postfach.
3. Prüfen Sie die Annahme durch den Provider getrennt von den Zustell-Events.
4. Testen Sie die Behandlung von 409, 422, 423, 429 und 5xx.
5. Halten Sie den Adapter des bisherigen Providers bereit, bis sowohl die transaktionalen als auch die Lifecycle-Pfade bestehen.