Vai al contenuto
Docs

Guida

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.

Aggiornato il 23 ott 2026

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:

Prima: Mailjet
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>"
    }]
  }'
Dopo: Emailit
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 event a type, e l’email si trova in data.object. Usa data.object.id, l’ID em_ della risposta all’invio, al posto di MessageID o Message_GUID, e data.object.to al posto di email. I tuoi valori meta, che sostituiscono CustomID e Payload, sono in data.object.meta.
  • Per email.loaded ed email.clicked, data.object è il caricamento o il clic. Usa data.object.email_id per l’ID dell’email, e data.object.email.rcpt_to e data.object.email.meta per il destinatario e i tuoi valori meta.
  • Mailjet non firma le sue richieste. Emailit le firma tutte: verifica X-Emailit-Signature rispetto a X-Emailit-Timestamp e al tuo secret whsec_, e, se vuoi, togli dall’URL le credenziali di autenticazione basic. Vedi Verifica le firme dei webhook.
JavaScript
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:

  1. 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=true unsubscribe, che ferma le campagne ma lascia passare le email transazionali, come l’exclusion list di Mailjet
    Contatti che hanno segnalato spam I contatti con IsSpamComplaining impostato, da GET /v3/REST/contact recipient
    Hard bounce Gli eventi bounce salvati dai tuoi webhook, oppure i report delle tue campagne recipient
  2. Crea un unico CSV con le colonne email,type,reason:

    CSV
    email,type,reason
    excluded@example.com,unsubscribe,mailjet exclusion list
    angry@example.com,recipient,mailjet spam complaint

    Il tipo recipient blocca gli invii via API, SMTP e campagne.

  3. 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.

  1. Prepara Emailit. Crea un campo personalizzato per ogni proprietà dei contatti che usi, e una lista per ogni lista di contatti.

  2. 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.

  3. 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 soppressione unsubscribe ferma 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

Questa pagina ti è stata utile?

Grazie del feedback.

Grazie, leggiamo ogni messaggio.