# Migra da Brevo

> Passa da Brevo (in passato Sendinblue) a Emailit. Converti le chiamate API smtp/email e il linguaggio di template, sostituisci le chiavi SMTP e sposta webhook, blocklist, contatti, campagne e automazioni.

Questa guida fa corrispondere concetti, chiamate API, webhook, blocklist, template, contatti e automazioni di Brevo ai loro equivalenti in Emailit. Fino al 2023 Brevo si chiamava Sendinblue, e alcuni dei suoi host e header usano ancora quel nome. Leggi prima [Passa a Emailit](/it/docs/migrate/) per l’ordine generale e per sapere come usare entrambi i provider in parallelo.

## Concetti

| Brevo | Emailit |
| --- | --- |
| Account e sub-account | Account e [workspace](/it/docs/workspaces/). Ogni workspace ha i propri domini, chiavi, membri e crediti. |
| API key | [Chiavi API](/it/docs/developers/api-keys/): **Full Access**, oppure **Sending Only** facoltativamente limitata a un dominio |
| Login SMTP e chiavi SMTP | La tua chiave API, usata come password SMTP |
| Mittenti, verificati uno per uno o tramite un dominio autenticato | [Domini di invio](/it/docs/domains/). Gli indirizzi mittente singoli non sono disponibili. |
| Header `X-Sib-Sandbox` | 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 Brevo | [Template](/it/docs/templates/) con un alias e versioni, elaborati con [Temple](/it/docs/templates/temple/) |
| Webhook transazionali, di marketing e per la posta in entrata | [Webhook](/it/docs/webhooks/) |
| Inbound parsing | [Email in entrata](/it/docs/inbound/) |
| Contatti bloccati (transazionali) e contatti in blocklist (campagne) | [Soppressioni](/it/docs/suppressions/) |
| Contatti, attributi e liste | [Contatti](/it/docs/contacts/), [campi personalizzati](/it/docs/contacts/custom-fields/) 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 email | [Campagne](/it/docs/campaigns/) |
| Automazioni | [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 |
| `tags` e l’header `X-Mailin-custom` | `meta` |
| IP dedicati | [IP dedicati](/it/docs/deliverability/dedicated-ips/) su richiesta |

## Aggiorna le chiamate API

`POST /v3/smtp/email` di Brevo diventa `POST /v2/emails`. La chiave passa dall’header `api-key` ad `Authorization`, e i nomi dei campi diventano più brevi:

```bash title="Prima: Brevo"
curl https://api.brevo.com/v3/smtp/email \
  -H "api-key: $BREVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sender": { "email": "hello@acme.com", "name": "Acme" },
    "to": [{ "email": "ada@example.com" }],
    "subject": "Your receipt",
    "textContent": "Thanks for your order.",
    "htmlContent": "<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>"
  }'
```

| Brevo | Emailit |
| --- | --- |
| Header `api-key: xkeysib-…` | `Authorization: Bearer secret_…` |
| `sender: { email, name }` o `sender: { id }` | `from: "Name "` |
| `to`, `cc`, `bcc` con `email` e `name` | `to`, `cc`, `bcc` come stringa o array di massimo 50 ciascuno |
| `replyTo: { email, name }` | `reply_to` |
| `subject`, `htmlContent`, `textContent` | `subject`, `html`, `text` |
| `headers` | `headers` |
| `attachment[]` con `content` e `name`, oppure `url` | `attachments[]` con `content`, `filename` e `content_type`, oppure `url` |
| `templateId` e `params` | `template` (un alias o un ID) e `variables` |
| `tags`, `headers["X-Mailin-custom"]` | `meta`, restituito negli eventi webhook |
| `scheduledAt` (fino a 72 ore in anticipo) | `scheduled_at` (ISO 8601 o inglese semplice) |
| `headers.idempotencyKey` (conservato per 30 minuti) | Un header HTTP `Idempotency-Key`, conservato per 24 ore |
| `messageVersions[]` | Non disponibile. Invia una richiesta per destinatario, ciascuna con le proprie `variables`. |
| `headers["X-Sib-Sandbox"]` | Non disponibile |
| `201` con `messageId` | `200` con `id` (`em_…`), `status: "accepted"` e, con più destinatari, `ids` con un ID per ciascuno |

Brevo non ha un’impostazione di tracciamento per singola email. In Emailit, `tracking: { "loads": true, "clicks": true }` sostituisce il tracciamento del dominio per una singola email. Vedi [Invia un’email](/it/docs/email-api/send-email/).

## Cambia le impostazioni SMTP

| Impostazione | Brevo | Emailit |
| --- | --- | --- |
| Host | `smtp-relay.brevo.com` | `smtp.emailit.com` |
| Porta | `587` o `2525` (STARTTLS), `465` (TLS) | `587`, `2587`, `2525` o `25` (STARTTLS), `465` (TLS) |
| Nome utente | Il tuo login SMTP, come `…@smtp-brevo.com` o l’email del tuo account | `emailit` |
| Password | Una chiave SMTP | La tua chiave API di Emailit |

Emailit non legge gli header di Brevo, come `X-Mailin-custom` o `X-Mailin-Tag`. Rimuovili e usa l’API quando ti servono i metadati. Vedi [Impostazioni SMTP](/it/docs/smtp/settings/).

## Fai corrispondere gli eventi webhook

| Evento Brevo | Evento Emailit |
| --- | --- |
| `request` (inviata) | `email.accepted` (solo API) |
| `delivered` | `email.delivered` |
| `deferred` | `email.attempted` |
| `soft_bounce` | `email.attempted` mentre Emailit ritenta, poi `email.bounced` se tutti i nuovi tentativi non riescono |
| `hard_bounce` | `email.bounced` |
| `invalid_email` | Un errore nella risposta dell’API per un indirizzo formalmente non valido, oppure `email.bounced` se l’indirizzo non esiste |
| `blocked` | `email.suppressed` |
| `error` | `email.failed` |
| `spam` | `email.complained` |
| `opened`, `unique_opened`, `proxy_open` | `email.loaded`, inviato per ogni caricamento |
| `click` | `email.clicked` |
| `unsubscribed`, `unsubscribe` | `email.unsubscribed`, solo per le email delle campagne |
| `list_addition` | `subscriber.created` |
| `contact_updated`, `contact_deleted` | `contact.updated`, `contact.deleted` |
| `inboundEmailProcessed` | `email.received`, poi recupera il contenuto con [`GET /emails/{id}`](/it/docs/api-reference/emails/get/) |

Cambia il formato della richiesta:

- Brevo invia un evento per richiesta, oppure batch di massimo 500 eventi quando l’invio in batch è attivo. 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, al posto di `message-id`, e `data.object.to` al posto di `email`. I tuoi valori `meta`, che sostituiscono `tags` e `X-Mailin-custom`, 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`.
- Brevo non firma i webhook: li proteggi con credenziali o con un token. 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

Brevo ha due blocklist. Spostale entrambe:

1. **Contatti bloccati delle email transazionali.** Esportali da **Settings > Transactional emails > Blocked or Unsubscribed contacts**, oppure scorri le pagine di `GET /v3/smtp/blockedContacts`. Usa il tipo `recipient` per tutti. Brevo blocca un indirizzo per un solo mittente, mentre Emailit lo blocca per l’intero workspace.

2. **Contatti delle campagne in blocklist.** In **CRM > Contacts**, filtra le iscrizioni alle campagne email su **Blocklisted** ed esporta, oppure usa `POST /v3/contacts/export`. Usa il tipo `recipient` per hard bounce e segnalazioni di spam, e `unsubscribe` per le disiscrizioni. Il tipo `unsubscribe` ferma tutte le campagne ma lascia passare le email transazionali, quindi non usarlo per le persone che hanno lasciato solo una lista e sono ancora iscritte a un’altra.

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

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

4. **Importalo.** 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.

I domini bloccati non hanno un equivalente, perché Emailit sopprime indirizzi esatti. Vedi [Gestisci le soppressioni](/it/docs/suppressions/manage/).

## Sposta i contatti

1. **Crea i campi personalizzati.** Per ogni attributo dei contatti di Brevo che usi, tranne `EMAIL`, `FIRSTNAME` e `LASTNAME`, crea un [campo personalizzato](/it/docs/contacts/custom-fields/) in Emailit. Le chiavi sono in minuscolo, quindi `COMPANY` diventa `company`.

2. **Crea le liste**, una per ogni lista di Brevo a cui invii campagne.

3. **Esporta ogni lista** da **CRM > Contacts** con **More actions > Export**, includendo gli attributi e lo stato dell’iscrizione. Escludi i contatti in blocklist e le persone che si sono disiscritte dalla lista.

4. **Importala.** In **Email Marketing → Contacts**, seleziona **Import**, mappa `EMAIL`, `FIRSTNAME`, `LASTNAME` e i tuoi attributi, 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/).

L’importazione aggiunge come iscritte tutte le persone nel file, quindi controlla che il file non contenga opt-out prima di importarlo.

## Sposta i template

Recupera l’HTML di ogni template con `GET /v3/smtp/templates/{templateId}` per i template transazionali, oppure con `GET /v3/emailCampaigns/{campaignId}` per le campagne. Entrambi lo restituiscono in `htmlContent`. 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 Brevo in Temple:

| Brevo | Emailit (Temple) |
| --- | --- |
| `{{ params.name }}`, `{{ params.order.total }}` | `{{name}}`, `{{order.total}}` |
| `{{ contact.FIRSTNAME }}`, `{{ contact.LASTNAME }}` | `{{first_name}}`, `{{last_name}}` nelle campagne |
| `{{ contact.COMPANY }}` | `{{cf.company}}` nelle campagne |
| `{{ params.name\|default:"there" }}` | `{{name\|"there"}}` |
| `{% if params.plan %}…{% else %}…{% endif %}` | `{{#if plan}}…{{else}}…{{/if}}` |
| `{% if params.plan == "pro" %}`, `{% elif %}` | Non supportato. Passa un booleano come `is_pro` e usa `{{#if is_pro}}`. |
| `{% for item in params.items %}…{% endfor %}` | Non supportato. Genera l’elenco nel tuo codice e passalo come un’unica variabile. |
| Filtri come `upper` o `date` | Non supportati. Formatta il valore nel tuo codice. |
| `{{ unsubscribe }}` | `{{unsubscribe_url}}` nelle campagne |
| `{{ update_profile }}` | `{{manage_subscriptions_url}}` nelle campagne |
| `{{ mirror }}` | `{{webview_url}}` nelle campagne |

Brevo applica l’escape all’HTML, a meno che tu non aggiunga `safe`. 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 [Tag di unione](/it/docs/campaigns/merge-tags/).

## Ricrea campagne e automazioni

Crea le campagne in **Email Marketing → Campaigns** a partire dai template importati. Ricrea ogni automazione di Brevo come [automazione](/it/docs/automations/) di Emailit nel contesto **Contact**:

| Trigger di Brevo | Trigger di Emailit |
| --- | --- |
| Contatto aggiunto a una lista, rimosso da una lista | **Added to audience**, **Removed from audience** |
| Anniversario, o un attributo di data | **Date anniversary**, **Date in contact field** |
| Modulo inviato | **Form submitted**, per i [moduli di Emailit](/it/docs/forms/) (accesso anticipato) |
| Email aperta, link cliccato | **Email opened**, **Link clicked** |
| Disiscrizione dalla lista email | **Unsubscribed** |
| Evento personalizzato | **Custom event**, nei piani Business e Custom |

Avvia ogni automazione prima di spostare i moduli di iscrizione, così i nuovi contatti ricevono le loro email fin dal primo giorno.

## 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 TXT `brevo-code` di Brevo né con i suoi record DKIM (`brevo1._domainkey` e `brevo2._domainkey`, oppure `mail._domainkey` nelle configurazioni meno recenti). Mantieni il record DMARC. Vedi [Record DNS](/it/docs/domains/dns-records/).

Dopo il passaggio, rimuovi i record di Brevo per il codice, il DKIM e il sottodominio personalizzato, e togli `include:spf.brevo.com` o `include:spf.sendinblue.com` dal record SPF, se lo contiene. Se ricevi posta con l’inbound parsing di Brevo, 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/)
- [Crea una campagna](/it/docs/campaigns/create/)
- [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/brevo/
