Guida
Migra da Mailjet
Passa da Mailjet a Emailit. Fai corrispondere coppie di chiavi API e mittenti, converti le chiamate della Send API v3.1 e il linguaggio di template, cambia le impostazioni SMTP e sposta webhook, esclusioni e liste di contatti.
Questa guida fa corrispondere concetti, chiamate API, webhook, soppressioni, template e contatti di Mailjet 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
| Mailjet | Emailit |
|---|---|
| API key principale e API key dei sub-account | Account e workspace. Ogni workspace ha i propri domini, chiavi, membri e crediti. |
| Coppia di API key (chiave pubblica e chiave segreta) | Chiave API: Full Access, oppure Sending Only facoltativamente limitata a un dominio |
| Mittenti: singoli indirizzi e interi domini | Domini di invio. Gli indirizzi mittente singoli non sono disponibili. |
SandboxMode |
Nessuna modalità di test. I nuovi workspace sono in modalità sandbox e consegnano solo ai membri del workspace. |
| Template e linguaggio di template di Mailjet | Template con un alias e versioni, elaborati con Temple |
| Event API, un URL per tipo di evento | Webhook: un endpoint può ricevere tutti i tipi di evento |
| Parse API | Email in entrata |
| Exclusion list, contatti che hanno segnalato spam e indirizzi bloccati | Soppressioni |
| Contatti, liste di contatti e proprietà dei contatti | Contatti, liste e campi personalizzati |
| Segmenti | Scegli ed escludi le liste in ogni campagna. I segmenti sono in alpha e aperti solo al team di Emailit. |
| Campagne e automazioni | Campagne e automazioni (beta) |
CustomID, EventPayload, CustomCampaign |
meta |
| Statistiche e cronologia dei messaggi | Email APIEmails, Email APILogs e report delle campagne |
Aggiorna le chiamate API
POST /v3.1/send di Mailjet accetta l’autenticazione basic e un elenco Messages con campi in PascalCase. POST /v2/emails di Emailit accetta un bearer token e un solo messaggio con campi in minuscolo:
curl https://api.mailjet.com/v3.1/send \
--user "$MJ_APIKEY_PUBLIC:$MJ_APIKEY_PRIVATE" \
-H "Content-Type: application/json" \
-d '{
"Messages": [{
"From": { "Email": "hello@acme.com", "Name": "Acme" },
"To": [{ "Email": "ada@example.com" }],
"Subject": "Your receipt",
"TextPart": "Thanks for your order.",
"HTMLPart": "<p>Thanks for your order.</p>"
}]
}'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>"
}'| Mailjet (Send API v3.1) | Emailit |
|---|---|
| Autenticazione basic con la chiave pubblica e la chiave segreta | Authorization: Bearer secret_… |
api.mailjet.com, oppure api.us.mailjet.com per gli account USA |
Un solo host, api.emailit.com |
Messages[], fino a 50 per chiamata |
Un messaggio per richiesta |
From: { Email, Name } |
from: "Name <email>" |
To, Cc, Bcc con Email e Name |
to, cc, bcc come stringa o array di massimo 50 ciascuno |
ReplyTo |
reply_to |
Subject, TextPart, HTMLPart |
subject, text, html |
Headers |
headers |
Attachments[] con ContentType, Filename, Base64Content |
attachments[] con content_type, filename, content |
InlinedAttachments[] con ContentID |
attachments[] con un content_id, a cui fai riferimento come cid: nell’HTML |
CustomID, EventPayload, CustomCampaign |
meta, ad esempio meta: { "custom_id": "order-123" }, restituito negli eventi webhook |
TemplateID, TemplateLanguage: true e Variables |
template (un alias o un ID) e variables |
TrackOpens, TrackClicks |
tracking: { "loads": true, "clicks": true } |
URLTags |
Aggiungi i parametri UTM ai tuoi link. Le campagne li aggiungono per te. |
Globals |
Non disponibile. Ripeti i campi comuni in ogni richiesta. |
Risposta con MessageUUID e MessageID per ogni destinatario |
200 con id (em_…), status: "accepted" e, con più destinatari, ids con un ID per ciascuno |
Gli ID di Emailit sono stringhe, quindi non devi più gestire i grandi valori interi di MessageID di Mailjet. Emailit supporta anche la programmazione con scheduled_at e i nuovi tentativi sicuri con un header Idempotency-Key. Vedi Invia un’email.
Cambia le impostazioni SMTP
| Impostazione | Mailjet | Emailit |
|---|---|---|
| Host | in-v3.mailjet.com |
smtp.emailit.com |
| Porta | 587, 588, 2525, 25 o 80 (STARTTLS), 465 (TLS) |
587, 2587, 2525 o 25 (STARTTLS), 465 (TLS) |
| Nome utente | La tua API key pubblica | emailit |
| Password | La tua API key segreta | La tua chiave API di Emailit |
Emailit non legge gli header di Mailjet, come X-Mailjet-Campaign, X-MJ-CustomID, X-MJ-EventPayload, X-Mailjet-TrackOpen, X-Mailjet-TrackClick, X-MJ-TemplateID o X-MJ-Vars. Rimuovili. Imposta il tracciamento sul dominio e usa l’API quando ti servono template o metadati. Vedi Impostazioni SMTP.
Fai corrispondere gli eventi webhook
| Evento Mailjet | Evento Emailit |
|---|---|
sent |
email.delivered |
bounce |
email.bounced. Emailit invia anche email.attempted per ogni tentativo non riuscito che ritenta. |
blocked |
email.suppressed quando l’indirizzo ha una soppressione recipient |
spam |
email.complained |
open |
email.loaded |
click |
email.clicked |
unsub |
email.unsubscribed, solo per le email delle campagne |
| Route della Parse API | email.received, poi recupera il contenuto con GET /emails/{id} |
Emailit invia anche email.accepted quando l’API accetta un’email. Vedi Tipi di evento.
Cambia il formato della richiesta:
- Mailjet richiede un URL per ogni tipo di evento e invia un evento per richiesta, a meno che tu non raggruppi gli eventi. Un webhook di Emailit può sottoscrivere molti tipi di evento e invia un array JSON di massimo 100 eventi, quindi esegui un ciclo sul corpo.
- Il nome dell’evento passa da
eventatype, e l’email si trova indata.object. Usadata.object.id, l’IDem_della risposta all’invio, al posto diMessageIDoMessage_GUID, edata.object.toal posto diemail. I tuoi valorimeta, che sostituisconoCustomIDePayload, sono indata.object.meta. - Per
email.loadededemail.clicked,data.objectè il caricamento o il clic. Usadata.object.email_idper l’ID dell’email, edata.object.email.rcpt_toedata.object.email.metaper il destinatario e i tuoi valorimeta. - Mailjet non firma le sue richieste. Emailit le firma tutte: verifica
X-Emailit-Signaturerispetto aX-Emailit-Timestampe al tuo secretwhsec_, e, se vuoi, togli dall’URL le credenziali di autenticazione basic. 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
Mailjet non ha un’unica lista di soppressione, quindi raccogli gli indirizzi da più punti:
-
Raccogli gli indirizzi che Mailjet blocca:
Mailjet Come esportarli Tipo in Emailit Exclusion list Il download dell’exclusion list nel pannello, oppure GET /v3/REST/contact?IsExcludedFromCampaigns=trueunsubscribe, che ferma le campagne ma lascia passare le email transazionali, come l’exclusion list di MailjetContatti che hanno segnalato spam I contatti con IsSpamComplainingimpostato, daGET /v3/REST/contactrecipientHard bounce Gli eventi bouncesalvati dai tuoi webhook, oppure i report delle tue campagnerecipient -
Crea un unico CSV con le colonne
email,type,reason:email,type,reason excluded@example.com,unsubscribe,mailjet exclusion list angry@example.com,recipient,mailjet spam complaintIl tipo
recipientblocca gli invii via API, SMTP e campagne. -
In Email APISuppressions, 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.
Se usavi più API key di Mailjet, ripeti la procedura per ciascuna. Vedi Gestisci le soppressioni.
Sposta i contatti
Esporta ogni lista di contatti da Contacts in Mailjet, oppure con GET /v3/REST/listrecipient?ContactsList={id}, che include il flag IsUnsubscribed di ogni membro. Le proprietà dei contatti si ottengono con GET /v3/REST/contactdata.
-
Prepara Emailit. Crea un campo personalizzato per ogni proprietà dei contatti che usi, e una lista per ogni lista di contatti.
-
Importa i membri iscritti. In Email MarketingContacts, seleziona Import, mappa le colonne e scegli la lista corrispondente. Dividi i file in parti di massimo 2500 righe. Vedi Importa ed esporta i contatti.
-
Sopprimi gli altri. L’importazione aggiunge come iscritte tutte le persone nel file, quindi lascia fuori dal file i membri disiscritti. Aggiungili invece al file delle soppressioni con il tipo
unsubscribe, ed escludi i contatti con l’opt-in ancora in sospeso. Una soppressioneunsubscribeferma tutte le campagne, quindi non aggiungerla per le persone ancora iscritte a un’altra lista che stai spostando.
Ricrea campagne e automazioni in Email MarketingCampaigns e Automations, partendo dai template importati.
Sposta i template
Recupera l’HTML di ogni template con GET /v3/REST/template/{id}/detailcontent, che restituisce Html-part e Text-part, oppure copialo dall’editor di Mailjet. Importalo in Email MarketingTemplates o crealo con l’API dei template, e assegnagli un alias, come receipt.
Converti il linguaggio di template di Mailjet in Temple:
| Mailjet | Emailit (Temple) |
|---|---|
{{var:name}}, {{var:order.total}} |
{{name}}, {{order.total}} |
{{var:name:"there"}} |
{{name|"there"}} |
{{data:firstname}} (una proprietà del contatto) |
{{first_name}} o {{cf.<key>}} nelle campagne. Negli invii via API, passa il valore in variables. |
{% if var:plan %}…{% else %}…{% endif %} |
{{#if plan}}…{{else}}…{{/if}} |
{% if var:plan == "pro" %}, {% elseif %} |
Non supportato. Passa un booleano come is_pro e usa {{#if is_pro}}. |
{% for item in var:items %}…{% endfor %} |
Non supportato. Genera l’elenco nel tuo codice e passalo come un’unica variabile. |
Funzioni come Upper() o FormatNumber() |
Non supportate. Formatta il valore nel tuo codice. |
{{mj:unsub_link}} |
{{unsubscribe_url}} nelle campagne |
Variables |
variables |
Temple non applica mai l’escape all’HTML, quindi esegui l’escape dell’input degli utenti prima di passarlo. Vedi Temple e Importa ed esporta i template.
Cambia i DNS
Aggiungi il dominio in Email APIDomains 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 mailjet._domainkey di Mailjet né con il suo record TXT di verifica della proprietà. Mantieni il record DMARC. Vedi Record DNS.
Se il tuo host di tracciamento personalizzato di Mailjet è già go, scegli un altro nome per quello di Emailit con tracking_key. Vedi Configura un dominio di tracciamento personalizzato.
Dopo il passaggio, rimuovi i record DKIM, di verifica della proprietà, di tracciamento e di return path di Mailjet, e togli include:spf.mailjet.com dal record SPF. Se ricevi posta con la Parse API sul tuo dominio, spostala prima su un sottodominio di ricezione di Emailit.
Passaggi successivi
- Checklist per andare in produzione
- Configura un webhook
- Migrazione prioritaria: lascia che i tecnici di Emailit facciano la migrazione insieme a te