Migra da Postmark

Questa guida fa corrispondere concetti, chiamate API, webhook, soppressioni e template di Postmark ai loro equivalenti in Emailit. Leggi prima Passa a Emailit per l’ordine generale e per sapere come usare entrambi i provider in parallelo.

Concetti

Per tenere separate la reputazione transazionale e quella di marketing, invia da domini o sottodomini diversi, come mail.acme.com per le ricevute e news.acme.com per le newsletter.

Aggiorna le chiamate API

POST /email di Postmark con un X-Postmark-Server-Token diventa POST /v2/emails con un bearer token. I nomi dei campi passano da PascalCase a snake_case:

curl https://api.postmarkapp.com/email \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "X-Postmark-Server-Token: $POSTMARK_SERVER_TOKEN" \
  -d '{
    "From": "Acme <hello@acme.com>",
    "To": "ada@example.com",
    "Subject": "Your receipt",
    "TextBody": "Thanks for your order.",
    "HtmlBody": "<p>Thanks for your order.</p>",
    "MessageStream": "outbound"
  }'

curl https://api.emailit.com/v2/emails \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Acme <hello@acme.com>",
    "to": "ada@example.com",
    "subject": "Your receipt",
    "text": "Thanks for your order.",
    "html": "<p>Thanks for your order.</p>"
  }'

Emailit non ha un endpoint batch. Invia una richiesta per messaggio, ciascuna con un massimo di 50 destinatari, e aggiungi un header Idempotency-Key così i nuovi tentativi sono sicuri. Vedi Invia un’email.

Cambia le impostazioni SMTP

Emailit non legge gli header X-PM-* come X-PM-Message-Stream o X-PM-Tag. Rimuovili e imposta invece il tracciamento sul dominio. Vedi Impostazioni SMTP.

Fai corrispondere gli eventi webhook

Emailit invia anche email.accepted quando l’API accetta un’email, evento per cui Postmark non ha un webhook.

Cambia il formato della richiesta:

• Postmark invia un record per richiesta e ne indica il nome in RecordType. Emailit invia un array JSON di massimo 100 eventi, con il nome in type e l’email in data.object.
• Usa data.object.id, l’ID em_ della risposta all’invio, al posto di MessageID. I tuoi valori meta sono in data.object.meta.
• I webhook di Postmark di solito sono protetti con credenziali di autenticazione basic nell’URL. Emailit invece firma ogni richiesta: verifica X-Emailit-Signature rispetto a X-Emailit-Timestamp e al tuo secret whsec_. Vedi Verifica le firme dei webhook.

for (const event of req.body) {
  const email = event.data.object;
  if (event.type === 'email.bounced') markBounced(email.to, email.id);
  if (event.type === 'email.complained') unsubscribe(email.to);
}

Sposta le soppressioni

1. Esporta le suppressions di ogni message stream di Postmark da cui invii, dalla pagina delle suppressions dello stream o con l’API suppressions dump. Includi hard bounce, segnalazioni di spam e soppressioni manuali.

2. Crea un unico CSV con le colonne email,type,reason:

   CSV

   email,type,reason
   old-address@example.com,recipient,postmark hard bounce
   angry@example.com,recipient,postmark spam complaint

   Usa il tipo recipient per gli indirizzi che non devono mai ricevere email. Blocca gli invii via API, SMTP e campagne. Per le persone che hanno solo rinunciato alle tue comunicazioni broadcast, usa il tipo unsubscribe, che ferma le campagne ma lascia passare le email transazionali.

3. In Email API›Suppressions, seleziona Import e carica il file. Ogni file può avere fino a 10.000 righe e pesare al massimo 8 MB. I duplicati vengono saltati.

Vedi Gestisci le soppressioni.

Sposta i template

Copia l’HTML di ogni template da Postmark, compreso il suo layout, poi importalo in Email Marketing›Templates o crealo con l’API dei template. Emailit non ha layout, quindi unisci layout e contenuto in un unico template. Usa lo stesso alias che usavi in Postmark, così le modifiche al codice restano minime.

I template di Postmark usano Mustachio. Temple copre i valori semplici e le condizioni:

Temple non applica mai l’escape all’HTML, quindi esegui l’escape dell’input degli utenti prima di passarlo. Un valore mancante diventa una stringa vuota, a meno che tu non aggiunga un valore predefinito, come {{name|"there"}}. Vedi Temple.

Cambia i DNS

Aggiungi il dominio in Email API›Domains e pubblica i record di Emailit. Usano nomi propri (emailit._domainkey, emailit.<domain> e, facoltativamente, go e inbound), quindi non entrano in conflitto con il record DKIM di Postmark né con il suo CNAME di return path pm-bounces. Mantieni il record DMARC. Dopo il passaggio, rimuovi i record di Postmark. Vedi Record DNS.

Se elabori la posta in entrata con Postmark, spostala su un sottodominio di ricezione di Emailit e aggiorna gli indirizzi che la tua app comunica. Vedi Configura le email in entrata.

Passaggi successivi

• Checklist per andare in produzione
• Configura un webhook
• Migrazione prioritaria: lascia che i tecnici di Emailit facciano la migrazione insieme a te