# Migra da Mailtrap

> Passa da Mailtrap Email Sending a Emailit. Fai corrispondere stream, token e sub-account, converti le chiamate API e i template Handlebars, cambia le impostazioni SMTP e sposta webhook, soppressioni e contatti.

Questa guida fa corrispondere concetti, chiamate API, webhook, soppressioni, template e contatti di Mailtrap Email Sending 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

| Mailtrap | Emailit |
| --- | --- |
| Organizzazione e sub-account | Account e [workspace](/it/docs/workspaces/). Ogni workspace ha i propri domini, chiavi, membri e crediti. |
| Sending domains | [Domini di invio](/it/docs/domains/) |
| Transactional stream | L’[API email](/it/docs/email-api/) e l’[SMTP relay](/it/docs/smtp/) |
| Bulk stream | [Campagne](/it/docs/campaigns/), oppure l’API con i tuoi header `List-Unsubscribe` |
| API token con permessi per risorsa | [Chiavi API](/it/docs/developers/api-keys/): **Full Access**, oppure **Sending Only** facoltativamente limitata a un dominio |
| Demo domain | I nuovi workspace sono in [modalità sandbox](/it/docs/workspaces/production-access/) e possono inviare ai membri del workspace dal tuo dominio verificato. |
| Email Sandbox (test) | Non disponibile. Mantieni la sandbox di Mailtrap per i test, oppure invia ai membri del workspace durante lo sviluppo. |
| Templates | [Template](/it/docs/templates/) con un alias e versioni, elaborati con [Temple](/it/docs/templates/temple/) |
| Webhook per stream | [Webhook](/it/docs/webhooks/) per workspace |
| Suppressions per dominio e per stream | Una [lista di soppressione](/it/docs/suppressions/) per workspace |
| Email logs | **Email API → Emails** e **Email API → Logs** |
| `category` e `custom_variables` | `meta` |
| Email Marketing: contatti, liste, campagne, automazioni | [Contatti](/it/docs/contacts/), [liste](/it/docs/audiences/), [campagne](/it/docs/campaigns/) e [automazioni](/it/docs/automations/) (beta) |
| Inbound email | [Email in entrata](/it/docs/inbound/) |

Per tenere separate la reputazione transazionale e quella di marketing, come fanno i due stream di Mailtrap, 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 /api/send` di Mailtrap diventa `POST /v2/emails`. Entrambi accettano un bearer token e JSON, ma in Emailit gli indirizzi sono semplici stringhe anziché oggetti:

```bash title="Prima: Mailtrap"
curl https://send.api.mailtrap.io/api/send \
  -H "Authorization: Bearer $MAILTRAP_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "from": { "email": "hello@acme.com", "name": "Acme" },
    "to": [{ "email": "ada@example.com" }],
    "subject": "Your receipt",
    "text": "Thanks for your order.",
    "html": "<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>"
  }'
```

| Mailtrap | Emailit |
| --- | --- |
| `Authorization: Bearer <token>` o `Api-Token: <token>` | `Authorization: Bearer secret_…` |
| `send.api.mailtrap.io` e `bulk.api.mailtrap.io` | Un solo host, `api.emailit.com` |
| `from: { email, name }` | `from: "Name "` |
| `to[]`, `cc[]`, `bcc[]` con `email` e `name` | `to`, `cc`, `bcc` come stringa o array di massimo 50 ciascuno |
| `reply_to: { email, name }` | `reply_to` |
| `subject`, `text`, `html`, `headers` | Uguali |
| `attachments[]` con `content`, `filename`, `type`, `disposition` e `content_id` | `attachments[]` con `content`, `filename`, `content_type` e `content_id`, oppure un `url` al posto di `content` |
| `category` | `meta`, ad esempio `meta: { "category": "password-reset" }` |
| `custom_variables` | `meta`, restituito negli eventi webhook |
| `template_uuid` e `template_variables` | `template` (un alias o un ID) e `variables` |
| Tracciamento impostato per dominio | Tracciamento impostato per dominio, oppure per singola email con `tracking: { "loads": true, "clicks": true }` |
| `POST /api/batch` (fino a 500 messaggi) | Non disponibile. Invia una richiesta per messaggio. |
| Risposta con `message_ids`, uno per destinatario | `200` con `id` (`em_…`), `status: "accepted"` e, con più destinatari, `ids` con un ID per ciascuno |

Emailit supporta anche la programmazione con `scheduled_at` e i nuovi tentativi sicuri con un header `Idempotency-Key`, che l’API di invio di Mailtrap non offre. Vedi [Invia un’email](/it/docs/email-api/send-email/).

## Cambia le impostazioni SMTP

| Impostazione | Mailtrap | Emailit |
| --- | --- | --- |
| Host | `live.smtp.mailtrap.io`, oppure `bulk.smtp.mailtrap.io` per il bulk stream | `smtp.emailit.com` |
| Porta | `587`, `2525` o `25` (STARTTLS), `465` (TLS) | `587`, `2587`, `2525` o `25` (STARTTLS), `465` (TLS) |
| Nome utente | `api` | `emailit` |
| Password | Il tuo API token di Mailtrap | La tua chiave API di Emailit |

Emailit non legge gli header `X-MT-Category` e `X-MT-Custom-Variables`. Rimuovili e usa l’API quando ti servono i metadati. Vedi [Impostazioni SMTP](/it/docs/smtp/settings/).

## Fai corrispondere gli eventi webhook

| Evento Mailtrap | Evento Emailit |
| --- | --- |
| `delivery` | `email.delivered` |
| `soft bounce` | `email.attempted` mentre Emailit ritenta, poi `email.bounced` se tutti i nuovi tentativi non riescono |
| `bounce` | `email.bounced` |
| `reject` | `email.suppressed` quando l’indirizzo ha una soppressione `recipient` |
| `suspension` | `email.held` |
| `spam` | `email.complained` |
| `open` | `email.loaded` |
| `click` | `email.clicked` |
| `unsubscribe` | `email.unsubscribed`, solo per le email delle campagne |
| `inbound.message_received` | `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:

- Mailtrap invia un elenco `events` di massimo 500 eventi, oppure JSON Lines. Emailit invia come corpo della richiesta un array JSON di massimo 100 eventi.
- Il nome dell’evento è in `type`, e l’email si trova in `data.object`. Usa `data.object.id`, l’ID `em_` della risposta all’invio, al posto di `message_id`, e `data.object.to` al posto di `email`. I tuoi valori `meta`, che sostituiscono `category` e `custom_variables`, 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`.
- L’header `Mailtrap-Signature` di Mailtrap è un HMAC-SHA256 del corpo grezzo. L’header `X-Emailit-Signature` di Emailit è un HMAC-SHA256 di `<timestamp>.<raw body>`, calcolato con il tuo secret `whsec_`, quindi leggi anche `X-Emailit-Timestamp`. 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

1. Esporta le soppressioni da **Suppressions** in Mailtrap, oppure scorri le pagine di `GET https://mailtrap.io/api/suppressions`, che restituisce fino a 1000 voci per chiamata.

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

   | Tipo in Mailtrap | Tipo in Emailit |
   | --- | --- |
   | `hard bounce`, `spam complaint`, `manual import` | `recipient`, che blocca gli invii via API, SMTP e campagne |
   | `unsubscription` | `unsubscribe`, che ferma le campagne ma lascia passare le email transazionali. Usa `recipient` per le disiscrizioni dal transactional stream. |

```csv
email,type,reason
old-address@example.com,recipient,mailtrap hard bounce
left@example.com,unsubscribe,mailtrap unsubscription
```

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, quindi gli indirizzi soppressi per più domini o stream di Mailtrap vengono aggiunti una sola volta.

Vedi [Gestisci le soppressioni](/it/docs/suppressions/manage/).

## Sposta i contatti

Se usi Mailtrap Email Marketing, esporta i contatti da **Contacts** con **More Actions > Export**, oppure con `POST https://mailtrap.io/api/contacts/exports` filtrato su `subscription_status` e `list_id`. Prima crea in Emailit i [campi personalizzati](/it/docs/contacts/custom-fields/) e le [liste](/it/docs/audiences/) corrispondenti.

Importa solo i contatti iscritti, una lista alla volta, in **Email Marketing → Contacts** con **Import**. L’importazione aggiunge come iscritte tutte le persone nel file, quindi aggiungi invece i contatti disiscritti al file delle soppressioni con il tipo `unsubscribe`. Dividi i file in parti di massimo 2500 righe. Vedi [Importa ed esporta i contatti](/it/docs/contacts/import-export/).

## Sposta i template

Recupera l’HTML dei template con `GET https://mailtrap.io/api/email_templates`, che restituisce `body_html`, `body_text` e `subject` di ogni template. Importali uno per uno in **Email Marketing → Templates** o creali con l’[API dei template](/it/docs/api-reference/templates/create/), e assegna a ciascuno un alias, come `receipt`.

I template di Mailtrap usano Handlebars. Temple copre le parti più comuni:

| Mailtrap (Handlebars) | Emailit (Temple) |
| --- | --- |
| `{{name}}`, `{{user.name}}` | Uguale |
| `{{{html_block}}}` | `{{html_block}}`. Temple non applica mai l’escape all’HTML, quindi esegui tu l’escape dell’input degli utenti. |
| `{{#if plan}}…{{else}}…{{/if}}` | Uguale |
| `{{#unless plan}}…{{/unless}}` | `{{#if plan}}{{else}}…{{/if}}` |
| `{{#if name}}{{name}}{{else}}Customer{{/if}}` | `{{name\|"Customer"}}` |
| `{{#each items}}…{{/each}}`, `{{#with}}` | Non supportati. Genera l’elenco nel tuo codice e passalo come un’unica variabile. |
| `template_variables` | `variables` |

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 i record DKIM `rwmt1._domainkey` e `rwmt2._domainkey` di Mailtrap, con il suo CNAME di verifica né con il suo CNAME di tracciamento `mt-link`. Mantieni il record DMARC. Vedi [Record DNS](/it/docs/domains/dns-records/).

Dopo il passaggio, rimuovi i record DKIM, di verifica e di tracciamento di Mailtrap, e togli `include:_spf.mailtrap.io` dal record SPF, se lo contiene ancora. Le email in entrata di Mailtrap arrivano tramite il record MX del dominio principale, quelle di Emailit su un sottodominio come `inbound.acme.com`, quindi sposta la posta in entrata e aggiorna gli indirizzi di ricezione prima di cambiare il record MX. Vedi [Configura le email in entrata](/it/docs/inbound/set-up/).

## 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/mailtrap/
