# Migra da SMTP2GO

> Passa da SMTP2GO a Emailit. Sostituisci utenti SMTP e host, converti le chiamate API email/send e i template, e sposta webhook, soppressioni e domini mittente.

Questa guida fa corrispondere concetti, impostazioni SMTP, chiamate API, webhook, soppressioni e template di SMTP2GO 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

| SMTP2GO | Emailit |
| --- | --- |
| Master account e subaccount | Account e [workspace](/it/docs/workspaces/). Ogni workspace ha i propri domini, chiavi, membri e crediti. |
| Utenti SMTP | La tua chiave API, usata come password SMTP. Crea una chiave per ogni app o server. |
| API key con permessi per endpoint | [Chiavi API](/it/docs/developers/api-keys/): **Full Access**, oppure **Sending Only** facoltativamente limitata a un dominio |
| Autenticazione per IP e per indirizzo | Non disponibile. Ogni connessione SMTP si autentica con una chiave API. |
| Sender domains | [Domini di invio](/it/docs/domains/) |
| Single sender emails | Non disponibile. Ogni indirizzo From deve trovarsi su un dominio verificato. |
| Stato sandbox di un utente SMTP o di una API key | I nuovi workspace sono in [modalità sandbox](/it/docs/workspaces/production-access/) e consegnano solo ai membri del workspace. |
| Impostazioni di tracciamento e del footer di disiscrizione per utente SMTP o API key | [Tracciamento](/it/docs/tracking/) per dominio di invio. Emailit non aggiunge un footer di disiscrizione alle email inviate via API o SMTP. |
| Templates | [Template](/it/docs/templates/) con un alias e versioni, elaborati con [Temple](/it/docs/templates/temple/) |
| Webhooks | [Webhook](/it/docs/webhooks/) |
| Suppressions di indirizzi e di domini | [Soppressioni](/it/docs/suppressions/) di indirizzi |
| Report e attività | **Email API → Emails** e **Email API → Logs** |
| IP dedicati e pool di IP | [IP dedicati](/it/docs/deliverability/dedicated-ips/) su richiesta |

Se per le newsletter ti affidi al footer di disiscrizione di SMTP2GO, aggiungi un tuo link di disiscrizione e gli header `List-Unsubscribe`, oppure inviale come [campagne](/it/docs/campaigns/) di Emailit, che aggiungono gli header per te. Nelle campagne, aggiungi il link visibile con `{{unsubscribe_url}}`. Vedi [Header SMTP](/it/docs/smtp/headers/#add-list-unsubscribe-yourself).

## Cambia le impostazioni SMTP

| Impostazione | SMTP2GO | Emailit |
| --- | --- | --- |
| Host | `mail.smtp2go.com`, oppure un host regionale come `mail-eu.smtp2go.com` | `smtp.emailit.com` |
| Porta | `2525`, `587`, `25`, `8025` o `80` (STARTTLS), `465`, `8465` o `443` (TLS) | `587`, `2587`, `2525` o `25` (STARTTLS), `465` (TLS) |
| Nome utente | Il nome utente dell’utente SMTP | `emailit` |
| Password | La password dell’utente SMTP | La tua chiave API di Emailit |

Emailit non è in ascolto sulle porte `80`, `443`, `8025` e `8465`. Se la tua rete blocca le porte `25` e `587`, usa la `2525` o la `2587`. In Emailit ogni destinatario diventa un’email a sé, e la risposta `250` ne elenca gli ID, oppure solo il primo ID quando i destinatari sono molti. Vedi [Impostazioni SMTP](/it/docs/smtp/settings/) e [Header e risposte SMTP](/it/docs/smtp/headers/).

## Aggiorna le chiamate API

`POST /v3/email/send` di SMTP2GO diventa `POST /v2/emails`. Gli indirizzi restano stringhe, ma i nomi dei campi cambiano:

```bash title="Prima: SMTP2GO"
curl https://api.smtp2go.com/v3/email/send \
  -H "X-Smtp2go-Api-Key: $SMTP2GO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sender": "Acme <hello@acme.com>",
    "to": ["ada@example.com"],
    "subject": "Your receipt",
    "text_body": "Thanks for your order.",
    "html_body": "<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>"
  }'
```

| SMTP2GO | Emailit |
| --- | --- |
| Header `X-Smtp2go-Api-Key`, `api_key` nel corpo, oppure `Authorization: Bearer api-…` | `Authorization: Bearer secret_…` |
| `sender` | `from` |
| `to`, `cc`, `bcc` | `to`, `cc`, `bcc`, fino a 50 ciascuno |
| `custom_headers` con `Reply-To` | `reply_to` |
| `custom_headers: [{ "header": "…", "value": "…" }]` | `headers: { "Name": "Value" }` |
| `subject` | `subject` |
| `text_body`, `html_body` | `text`, `html` |
| `attachments[]` con `filename`, `fileblob` o `url`, e `mimetype` | `attachments[]` con `filename`, `content` o `url`, e `content_type` |
| `inlines[]` | `attachments[]` con un `content_id`, a cui fai riferimento come `cid:` nell’HTML |
| `template_id` e `template_data` | `template` (un alias o un ID) e `variables` |
| `schedule` (fino a 3 giorni in anticipo) | `scheduled_at` (ISO 8601 o inglese semplice) |
| `fastaccept` | Non serve. Emailit mette in coda ogni email per la consegna e risponde senza attenderla. |
| `POST /v3/email/batch` (fino a 1000 email) | Non disponibile. Invia una richiesta per messaggio. |
| `POST /v3/email/mime` | Invia il messaggio MIME tramite l’[SMTP relay](/it/docs/smtp/) |
| `200` con `email_id`, `succeeded`, `failed` e `failures` | `200` con `id` (`em_…`), `status: "accepted"` e, con più destinatari, `ids` con un ID per ciascuno. Gli errori usano i codici di stato HTTP. |

SMTP2GO non ha metadati né impostazioni di tracciamento per singola email. In Emailit, aggiungi `meta` per ricevere i tuoi valori negli eventi webhook, e `tracking: { "loads": true, "clicks": true }` per sostituire il tracciamento del dominio. Aggiungi un header `Idempotency-Key` così i nuovi tentativi sono sicuri. Vedi [Invia un’email](/it/docs/email-api/send-email/).

## Fai corrispondere gli eventi webhook

| Evento SMTP2GO | Evento Emailit |
| --- | --- |
| `processed` | `email.accepted` (solo API) |
| `delivered` | `email.delivered` |
| `bounce` con `bounce` `soft` | `email.attempted` mentre Emailit ritenta, poi `email.bounced` se tutti i nuovi tentativi non riescono |
| `bounce` con `bounce` `hard` | `email.bounced` |
| `reject` | `email.suppressed` quando l’indirizzo ha una soppressione `recipient`. Gli altri rifiuti, come un mittente non verificato, sono errori nella risposta dell’API o nella risposta SMTP. |
| `spam` | `email.complained` |
| `open` | `email.loaded` |
| `click` | `email.clicked` |
| `unsubscribe` | `email.unsubscribed`, solo per le email delle campagne |

Cambia il formato della richiesta:

- SMTP2GO invia un evento per richiesta, come campi di un modulo per impostazione predefinita oppure come JSON piatto. Emailit 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 o della risposta SMTP, al posto di `email_id`, e `data.object.to` al posto di `rcpt`. I valori che hai passato in `meta` 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`.
- SMTP2GO non firma i webhook. Emailit firma ogni richiesta: verifica `X-Emailit-Signature` rispetto a `X-Emailit-Timestamp` e al tuo secret `whsec_`. 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 **Reports > Suppressions** con **Export**, oppure scorri le pagine di `POST /v3/suppression/view`. Se non imposti `start_date`, l’API restituisce circa gli ultimi 30 giorni, quindi impostalo in modo da coprire tutto lo storico.

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

   | Motivo in SMTP2GO | Tipo in Emailit |
   | --- | --- |
   | `bounce`, `spam`, `manual` | `recipient`, che blocca gli invii via API, SMTP e campagne |
   | `unsubscribe` | `unsubscribe`, che ferma le campagne ma lascia passare le email transazionali. Usa `recipient` se la persona ha rinunciato a tutto ciò che invii. |

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

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.

Emailit sopprime indirizzi esatti, quindi le soppressioni di dominio non si possono importare. Ripeti l’esportazione per ogni subaccount e importala nel workspace corrispondente. Vedi [Gestisci le soppressioni](/it/docs/suppressions/manage/).

## Sposta i template

Recupera l’HTML di ogni template con `POST /v3/template/view`, che restituisce `html_body`, `text_body` e `subject`, oppure copialo da **Settings > Templates**. Importalo in **Email Marketing → Templates** o crealo con l’[API dei template](/it/docs/api-reference/templates/create/), e usa l’ID del template di SMTP2GO come alias se rispetta il formato degli alias: lettere minuscole, numeri, `-` e `_`.

SMTP2GO ignora `subject` quando invii un template. Emailit usa l’oggetto del template, a meno che la richiesta non ne contenga uno, quindi ometti `subject` per mantenere quello del template.

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

| SMTP2GO (Handlebars) | Emailit (Temple) |
| --- | --- |
| `{{ username }}`, `{{ user.name }}` | `{{username}}`, `{{user.name}}` |
| `{{{ 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 |
| `{{#each items}}…{{/each}}` | Non supportato. Genera l’elenco nel tuo codice e passalo come un’unica variabile. |
| Nessun valore predefinito integrato | `{{username\|"there"}}` aggiunge un valore di riserva |
| `template_data` | `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 il CNAME DKIM `s<number>._domainkey` di SMTP2GO, con il suo CNAME di return path `em<number>` né con il suo CNAME di tracciamento `link`. Mantieni il record DMARC. Vedi [Record DNS](/it/docs/domains/dns-records/).

Dopo il passaggio, rimuovi i CNAME di SMTP2GO, e togli `include:spf.smtp2go.com` dal record SPF, se lo contiene ancora.

## Passaggi successivi

- [Checklist per andare in produzione](/it/docs/get-started/go-live/)
- [Risoluzione dei problemi SMTP](/it/docs/smtp/troubleshooting/)
- [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/smtp2go/
