Migrer fra Mailgun

Mailgun tar imot skjemakodede forespørsler med prefiksede valgfelt (o:, h:, v:); Mailhuset tar én JSON-kropp med vanlige feltnavn. Begrepene passer godt sammen, så sett av en ettermiddag, mest til venting på DNS.

1. Verifiser sendedomenet

Legg til domenet under Domains og publiser SPF-, DKIM- og DMARC-postene, slik du gjorde for Mailgun. Se Verifiser et sendedomene. Behold Mailgun-postene til du har byttet over, så begge kan sende samtidig.

Sender du via Mailgun 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

Et Mailgun-kall som dette:

curl -s --user "api:$MAILGUN_API_KEY" \
  https://api.eu.mailgun.net/v3/yourdomain.com/messages \
  -F from="Acme <hello@yourdomain.com>" \
  -F to=a@example.com \
  -F subject="Kvitteringen din" \
  -F html="<p>Takk for bestillingen</p>"

blir til:

curl -s https://api.mailhuset.com/v1/email \
  -H "Authorization: Bearer $MAILHUSET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "from": "Acme <hello@yourdomain.com>", "to": ["a@example.com"],
        "subject": "Kvitteringen din", "html": "<p>Takk for bestillingen</p>" }'

Sendedomenet hentes fra from-adressen, ikke fra URL-en. For å sende mange meldinger i ett kall bruker du POST /v1/email/batch (opptil 500). Se Send e-post via API-et, eller bruk et offisielt SDK.

3. Lag malene på nytt

Lag Mailgun-malene på nytt under Templates med et alias, og send variablene du la i h:X-Mailgun-Variables 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 Mailgun-mal går gjennom en liste eller har betingelser, bygger du den delen i koden din og sender den inn som ett felt, eller sender ferdig html direkte. Se Maler.

4. Ta med blokkeringslisten

Eksporter returer, klager og avmeldinger for domenet ditt fra Mailgun, og importer dem, så Mailhuset aldri sender til en adresse Mailgun 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 Mailgun-hendelsene:

Mailguns accepted tilsvarer at Mailhuset godtar API-kallet ditt, og en midlertidig failed 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. Flytt innkommende ruter

Hvis du tar imot e-post gjennom Mailgun Routes, lager du dem på nytt under Inbound: Mailhuset tolker hver melding til JSON og sender den til webhooken din. Se Innkommende e-post.

7. Bytt over

Send en del av trafikken gjennom Mailhuset først, følg leveranser og hendelser i Activity, og flytt så resten over noen dager i stedet for i ett hopp.

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

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