# Migra da Elastic Email

> Passa da Elastic Email a Emailit. Fai corrispondere chiamate API v4 e v2, credenziali SMTP e notifiche, converti i merge field e sposta soppressioni, contatti e campagne.

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

| Elastic Email | Emailit |
| --- | --- |
| Account e subaccount | Account e [workspace](/it/docs/workspaces/). Ogni workspace ha i propri domini, chiavi, membri e crediti. |
| API key con livelli di accesso | [Chiavi API](/it/docs/developers/api-keys/): **Full Access**, oppure **Sending Only** facoltativamente limitata a un dominio |
| Credenziali SMTP | La tua chiave API, usata come password SMTP |
| Domini verificati e indirizzi mittente verificati | [Domini di invio](/it/docs/domains/). Gli indirizzi mittente singoli non sono disponibili. |
| Channel e valori di postback | `meta` |
| Template, identificati per nome | [Template](/it/docs/templates/) con un alias e versioni |
| Merge field e template scripting | [Temple](/it/docs/templates/temple/): variabili, valori predefiniti e condizioni |
| Notifiche web HTTP | [Webhook](/it/docs/webhooks/) |
| Inbound routes | [Email in entrata](/it/docs/inbound/) |
| Suppressions e stati dei contatti che bloccano gli invii | [Soppressioni](/it/docs/suppressions/) |
| Contatti e liste | [Contatti](/it/docs/contacts/) e [liste](/it/docs/audiences/) |
| 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) |
| Moduli | [Moduli](/it/docs/forms/) (accesso anticipato), oppure l’[URL di iscrizione](/it/docs/audiences/subscribe-url/) di una lista |
| Email verification | [Verifica email](/it/docs/email-verification/) |
| Private IPs e IP pools | [IP dedicati](/it/docs/deliverability/dedicated-ips/) su richiesta |

Elastic Email aggiunge un link di disiscrizione a ogni email, compresi gli invii via API e SMTP. Emailit aggiunge gli header `List-Unsubscribe` solo alle [campagne](/it/docs/campaigns/) e alle email di marketing delle automazioni, e il link visibile lo aggiungi tu con `{{unsubscribe_url}}`. Se invii newsletter o altra posta massiva tramite l’API o SMTP, aggiungi un tuo link e gli header `List-Unsubscribe`. Vedi [Header e metadati](/it/docs/email-api/headers-and-metadata/#add-list-unsubscribe-to-bulk-mail).

## Aggiorna le chiamate API

`POST /v4/emails/transactional` di Elastic Email diventa `POST /v2/emails`. Il corpo è piatto, i nomi dei campi sono in minuscolo e la chiave passa a un header `Authorization`:

```bash title="Prima: Elastic Email"
curl https://api.elasticemail.com/v4/emails/transactional \
  -H "X-ElasticEmail-ApiKey: $ELASTICEMAIL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "Recipients": { "To": ["ada@example.com"] },
    "Content": {
      "From": "Acme <hello@acme.com>",
      "Subject": "Your receipt",
      "Body": [
        { "ContentType": "HTML", "Content": "<p>Thanks for your order.</p>" },
        { "ContentType": "PlainText", "Content": "Thanks for your order." }
      ]
    }
  }'
```

```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>"
  }'
```

| Elastic Email (API v4) | Emailit |
| --- | --- |
| Header `X-ElasticEmail-ApiKey` | `Authorization: Bearer secret_…` |
| `Content.From` | `from` |
| `Recipients.To`, `CC`, `BCC` | `to`, `cc`, `bcc`, fino a 50 ciascuno |
| `Content.ReplyTo` | `reply_to` |
| `Content.Subject` | `subject` |
| `Content.Body[]` con `ContentType` `HTML` e `PlainText` | `html` e `text` |
| `Content.Headers` | `headers` |
| `Content.Attachments[]` con `BinaryContent`, `Name`, `ContentType` | `attachments[]` con `content`, `filename`, `content_type` |
| `Content.AttachFiles` (file caricati in precedenza) | `attachments[]` con un `url` che Emailit scarica |
| `Content.TemplateName` | `template`, l’alias o l’ID di un template |
| `Content.Merge` | `variables` |
| `Options.ChannelName`, `Content.Postback` | `meta`, restituito negli eventi webhook |
| `Options.TrackOpens`, `Options.TrackClicks` | `tracking: { "loads": true, "clicks": true }` |
| `Options.TimeOffset` (minuti) | `scheduled_at` (ISO 8601 o inglese semplice) |
| `Options.PoolName` | Non serve. Un IP dedicato invia tutte le email del suo workspace. |
| `Content.Utm` | Aggiungi i parametri UTM ai tuoi link. Le campagne li aggiungono per te. |
| `POST /v4/emails` con `Recipients[].Fields` (unione in blocco) | Una richiesta per destinatario, ciascuna con le proprie `variables` |
| Header `Idempotency-Key` | Header `Idempotency-Key`, conservato per 24 ore |
| Risposta con `TransactionID` e `MessageID` | `200` con `id` (`em_…`), `status: "accepted"` e, con più destinatari, `ids` con un ID per ciascuno |

Se usi ancora l’API v2 (`/v2/email/send` con un parametro `apikey`), fai corrispondere i suoi campi del modulo allo stesso modo: `from` e `fromName` diventano `from`, `bodyHtml` e `bodyText` diventano `html` e `text`, i campi `merge_*` diventano `variables`, e `template` diventa `template`. Nella v2, ogni indirizzo in `to` riceve un messaggio separato, come con Bcc. In Emailit, i destinatari in `to` si vedono a vicenda nell’header `To`, quindi invia una richiesta per destinatario per tenerli separati. Vedi [Invia un’email](/it/docs/email-api/send-email/).

## Cambia le impostazioni SMTP

| Impostazione | Elastic Email | Emailit |
| --- | --- | --- |
| Host | `smtp.elasticemail.com` | `smtp.emailit.com` |
| Porta | `2525`, `587` o `25` (STARTTLS), `465` (TLS) | `587`, `2587`, `2525` o `25` (STARTTLS), `465` (TLS) |
| Nome utente | Il nome della credenziale SMTP, un indirizzo email | `emailit` |
| Password | Il token della credenziale SMTP | La tua chiave API di Emailit |

Emailit non legge gli header di controllo di Elastic Email, come `X-ElasticEmail-Channel`, `X-ElasticEmail-Postback`, `IsTransactional`, `trackopens` o `trackclicks`. Rimuovili e imposta invece il tracciamento sul dominio. Vedi [Impostazioni SMTP](/it/docs/smtp/settings/).

## Fai corrispondere gli eventi webhook

| Notifica di Elastic Email | Evento Emailit |
| --- | --- |
| `Sent` (il server del destinatario ha accettato il messaggio) | `email.delivered` |
| `Opened` | `email.loaded` |
| `Clicked` | `email.clicked` |
| `Error` | `email.bounced` per gli errori permanenti. Per gli errori temporanei viene inviato `email.attempted` mentre Emailit ritenta. |
| `AbuseReport` | `email.complained` |
| `Unsubscribed` | `email.unsubscribed`, solo per le email delle campagne |
| Inbound route che notifica un URL | `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, ed `email.suppressed` quando una soppressione `recipient` blocca un indirizzo. Vedi [Tipi di evento](/it/docs/webhooks/event-types/).

Cambia il formato della richiesta:

- Elastic Email invia un evento per richiesta, nella query string o come oggetto JSON piatto. Emailit invia un array JSON di massimo 100 eventi, quindi esegui un ciclo sul corpo.
- Il nome dell’evento passa da `status` 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`, e `data.object.to` al posto di `to`. I tuoi valori `meta`, che sostituiscono `channel` e `postback`, 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`.
- Emailit firma ogni richiesta. Verifica `X-Emailit-Signature`, l’HMAC-SHA256 in esadecimale di `<timestamp>.<raw body>`, rispetto a `X-Emailit-Timestamp` e al tuo secret `whsec_`. Anche la firma facoltativa di Elastic Email usa secret `whsec_`, ma firma una stringa diversa, quindi aggiorna il codice di verifica. 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 gli indirizzi che Elastic Email blocca, da **Suppressions** nel pannello o con l’API (`/v4/suppressions/bounces`, `/complaints` e `/unsubscribes`).

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

   | Stato in Elastic Email | Tipo in Emailit |
   | --- | --- |
   | Invalid (`Bounced`) | `recipient` |
   | Complaint (`Abuse`) | `recipient` |
   | Unsubscribed | `unsubscribe`, che ferma le campagne ma lascia passare le email transazionali. Usa `recipient` per bloccare tutte le email. |

```csv
email,type,reason
old-address@example.com,recipient,elastic email bounced
left@example.com,unsubscribe,elastic email unsubscribed
```

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](/it/docs/suppressions/manage/).

## Sposta contatti e campagne

Esporta i contatti da **Contacts** (selezionali, poi **More actions > Export**) o con `POST /v4/contacts/export`, ed esporta ogni lista a cui invii campagne. Poi spostali in base allo stato:

| Stato in Elastic Email | Dove va |
| --- | --- |
| Engaged, Active | Importali nella lista corrispondente in **Email Marketing → Contacts** con **Import**. |
| Transactional | Lasciali fuori dalle liste. Non si sono mai iscritti alle tue email di marketing. |
| Invalid, Complaint, Unsubscribed | Nella lista di soppressione, come sopra. |
| Inactive, Stale, Not Confirmed | Lasciali fuori. |

Prima dell’importazione crea i [campi personalizzati](/it/docs/contacts/custom-fields/) per i campi dei tuoi contatti, e dividi i file in parti di massimo 2500 righe. L’importazione aggiunge come iscritte tutte le persone nel file, quindi importa solo chi deve ricevere le tue campagne. Vedi [Importa ed esporta i contatti](/it/docs/contacts/import-export/).

Ricrea campagne e automazioni in **Email Marketing → Campaigns** e **Automations**, partendo dai template importati.

## Sposta i template

Copia l’HTML di ogni template con **Edit as HTML** in Elastic Email, oppure recuperalo con `GET /v4/templates/{name}`, che lo restituisce in `Body`. Importalo in **Email Marketing → Templates** o crealo con l’[API dei template](/it/docs/api-reference/templates/create/), e usa il nome del template come alias se rispetta il formato degli alias: lettere minuscole, numeri, `-` e `_`.

I merge field di Elastic Email usano parentesi graffe singole, Temple usa le doppie. I campi con parentesi singole rimasti in un template vengono inviati come testo semplice, quindi convertili tutti:

| Elastic Email | Emailit (Temple) |
| --- | --- |
| `{firstname}`, `{lastname}`, `{email}` | `{{first_name}}`, `{{last_name}}`, `{{email}}` nelle campagne. Negli invii via API, i nomi che passi in `variables`. |
| `{firstname:friend}` | `{{first_name\|"friend"}}` |
| `{company}` o un altro campo personalizzato | `{{cf.company}}` nelle campagne |
| `{unsubscribe}` | `{{unsubscribe_url}}` nelle campagne |
| `{contactprofile}` | `{{manage_subscriptions_url}}` nelle campagne |
| `{view}` | `{{webview_url}}` nelle campagne |
| `{accountaddress}` e gli altri campi dell’account | Scrivili nel template, oppure tienili nei [valori globali](/it/docs/contacts/global-values/) |
| Template scripting in `{{ … }}` | Non supportato. Calcola i valori nel tuo codice e usa `{{#if}}` per i contenuti condizionali. |

Vedi [Tag di unione](/it/docs/campaigns/merge-tags/) e [Temple](/it/docs/templates/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 `api._domainkey` di Elastic Email, con il suo CNAME `tracking` né con un dominio di bounce personalizzato. Mantieni il record DMARC. Vedi [Record DNS](/it/docs/domains/dns-records/).

Dopo il passaggio, rimuovi i record DKIM e di tracciamento di Elastic Email e togli `include:_spf.elasticemail.com` dal record SPF. Se ricevi posta con le inbound routes di Elastic Email, spostala prima su un [sottodominio di ricezione](/it/docs/inbound/set-up/) di Emailit. Emailit riceve su un sottodominio, come `inbound.acme.com`, quindi gli indirizzi di ricezione cambiano.

## 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/elastic-email/
