Migrer fra SendGrid

Å flytte fra SendGrid til Mailhuset er stort sett en endring av hvordan forespørselen ser ut: SendGrid legger mottakere og innhold i listene personalizations og content, mens Mailhuset holder dem flate. Sett av en ettermiddag, mest til venting på DNS.

1. Verifiser sendedomenet

Legg til domenet under Domains og publiser SPF-, DKIM- og DMARC-postene, på samme måte som domeneautentiseringen i SendGrid. Se Verifiser et sendedomene. Behold SendGrid-postene til du har byttet over, så begge leverandørene kan sende samtidig.

Sender du via SendGrid sin SMTP-tjeneste i stedet for API-et? Da kan du hoppe over steg 2: pek SMTP-innstillingene i appen din mot smtp.mailhuset.com (port 587 med STARTTLS) med en SMTP-pålogging, uten kodeendringer. SMTP er inkludert i betalte abonnementer.

2. Bytt API-kallet

En SendGrid-forespørsel som denne:

{
  "personalizations": [{ "to": [{ "email": "a@example.com" }] }],
  "from": { "email": "hello@yourdomain.com", "name": "Acme" },
  "subject": "Kvitteringen din",
  "content": [{ "type": "text/html", "value": "<p>Takk for bestillingen</p>" }]
}

blir til:

POST https://api.mailhuset.com/v1/email
Authorization: Bearer $MAILHUSET_API_KEY

{ "from": "Acme <hello@yourdomain.com>", "to": ["a@example.com"],
  "subject": "Kvitteringen din", "html": "<p>Takk for bestillingen</p>" }

SendGrid sender én forespørsel med flere personalizations som separate meldinger. I Mailhuset gjør du det med POST /v1/email/batch, opptil 500 meldinger per kall. Se Send e-post via API-et, eller bruk et offisielt SDK.

3. Lag malene på nytt

Lag de dynamiske SendGrid-malene på nytt under Templates. Gi hver mal et alias og send de samme dataene som templateModel. Enkle felt fungerer som før: {{ first_name }}, punktstier som {{ order.total }}, og {{{ raw_html }}} for HTML uten escaping.

Mailhuset-maler har ikke {{#if}}- eller {{#each}}-blokker. Der en SendGrid-mal går gjennom varelinjer eller viser en del bare noen ganger, bygger du den delen i koden din og sender den inn som ett felt (for eksempel {{{ items_html }}}), eller sender ferdig html direkte. Se Maler.

4. Ta med blokkeringslisten

Eksporter returer, spamklager og avmeldinger fra SendGrid, og importer dem, så Mailhuset aldri sender til en adresse SendGrid allerede har lært å unngå:

POST https://api.mailhuset.com/v1/suppressions/import
Authorization: Bearer $MAILHUSET_API_KEY

{ "entries": [
  { "address": "old@example.com", "reason": "HARD_BOUNCE" },
  { "address": "angry@example.com", "reason": "COMPLAINT" },
  { "address": "optout@example.com", "reason": "UNSUBSCRIBE" }
] }

Opptil 20 000 oppføringer per kall. Ugyldige rader hoppes over og telles, uten at importen feiler. Se Blokkeringer.

5. Pek webhooks mot Mailhuset

Legg til endepunktet under Webhooks og koble SendGrids Event Webhook-typer:

SendGrids processed tilsvarer at Mailhuset godtar API-kallet ditt, og deferred har ingen hendelse fordi Mailhuset prøver på nytt for deg. Hver Mailhuset-hendelse er signert, så verifiser den med signeringshemmeligheten til endepunktet. Se Webhooks.

6. Bytt over

Send en del av trafikken gjennom Mailhuset først, følg leveranser og hendelser i Activity, og flytt så resten. Øk volumet over noen dager i stedet for i ett hopp, så e-postleverandørene blir vant til den nye sendeveien.

Spørsmål underveis? Send e-post til support@mailhuset.com.

Trenger du hjelp? Send e-post til support@mailhuset.com.