# 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](/it/docs/migrate/) 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](/it/docs/workspaces/). Ogni workspace ha i propri domini, chiavi, membri e crediti. |
| Coppia di API key (chiave pubblica e chiave segreta) | [Chiave API](/it/docs/developers/api-keys/): **Full Access**, oppure **Sending Only** facoltativamente limitata a un dominio |
| Mittenti: singoli indirizzi e interi domini | [Domini di invio](/it/docs/domains/). Gli indirizzi mittente singoli non sono disponibili. |
| `SandboxMode` | Nessuna modalità di test. I nuovi workspace sono in [modalità sandbox](/it/docs/workspaces/production-access/) e consegnano solo ai membri del workspace. |
| Template e linguaggio di template di Mailjet | [Template](/it/docs/templates/) con un alias e versioni, elaborati con [Temple](/it/docs/templates/temple/) |
| Event API, un URL per tipo di evento | [Webhook](/it/docs/webhooks/): un endpoint può ricevere tutti i tipi di evento |
| Parse API | [Email in entrata](/it/docs/inbound/) |
| Exclusion list, contatti che hanno segnalato spam e indirizzi bloccati | [Soppressioni](/it/docs/suppressions/) |
| Contatti, liste di contatti e proprietà dei contatti | [Contatti](/it/docs/contacts/), [liste](/it/docs/audiences/) e [campi personalizzati](/it/docs/contacts/custom-fields/) |
| Segmenti | Scegli ed escludi le liste in ogni campagna. I [segmenti](/it/docs/segments/) sono in alpha e aperti solo al team di Emailit. |
| Campagne e automazioni | [Campagne](/it/docs/campaigns/) e [automazioni](/it/docs/automations/) (beta) |
| `CustomID`, `EventPayload`, `CustomCampaign` | `meta` |
| Statistiche e cronologia dei messaggi | **Email API → Emails**, **Email API → Logs** e [report delle campagne](/it/docs/campaigns/reports/) |

## 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:

```bash title="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>"
    }]
  }'
```

```bash title="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 "` |
| `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](/it/docs/email-api/send-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](/it/docs/smtp/settings/).

## 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}`](/it/docs/api-reference/emails/get/) |

Emailit invia anche `email.accepted` quando l’API accetta un’email. Vedi [Tipi di evento](/it/docs/webhooks/event-types/).

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](/it/docs/webhooks/request-signature/).

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

Se usavi più API key di Mailjet, ripeti la procedura per ciascuna. Vedi [Gestisci le soppressioni](/it/docs/suppressions/manage/).

## 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](/it/docs/contacts/custom-fields/) per ogni proprietà dei contatti che usi, e una [lista](/it/docs/audiences/) per ogni lista di contatti.

2. **Importa i membri iscritti.** In **Email Marketing → Contacts**, 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](/it/docs/contacts/import-export/).

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 Marketing → Campaigns** 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 Marketing → Templates** o crealo con l’[API dei template](/it/docs/api-reference/templates/create/), 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](/it/docs/templates/temple/) e [Importa ed esporta i template](/it/docs/templates/import-export/).

## 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 `mailjet._domainkey` di Mailjet né con il suo record TXT di verifica della proprietà. Mantieni il record DMARC. Vedi [Record DNS](/it/docs/domains/dns-records/).

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](/it/docs/tracking/custom-tracking-domain/).

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](/it/docs/inbound/set-up/) di Emailit.

## Passaggi successivi

- [Checklist per andare in produzione](/it/docs/get-started/go-live/)
- [Configura un webhook](/it/docs/webhooks/set-up/)
- [Migrazione prioritaria](/it/docs/programs/priority-migration/): lascia che i tecnici di Emailit facciano la migrazione insieme a te

---
Fonte: https://emailit.com/it/docs/migrate/mailjet/
