Vai al contenuto
Docs

Guida

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.

Aggiornato il 23 ott 2026

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 per l’ordine generale e per sapere come usare entrambi i provider in parallelo.

Concetti

Brevo Emailit
Account e sub-account Account e workspace. Ogni workspace ha i propri domini, chiavi, membri e crediti.
API key Chiavi API: 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. Gli indirizzi mittente singoli non sono disponibili.
Header X-Sib-Sandbox Nessuna modalità di test. I nuovi workspace sono in modalità sandbox e consegnano solo ai membri del workspace.
Template e linguaggio di template di Brevo Template con un alias e versioni, elaborati con Temple
Webhook transazionali, di marketing e per la posta in entrata Webhook
Inbound parsing Email in entrata
Contatti bloccati (transazionali) e contatti in blocklist (campagne) Soppressioni
Contatti, attributi e liste Contatti, campi personalizzati e liste
Segmenti Scegli ed escludi le liste in ogni campagna. I segmenti sono in alpha e aperti solo al team di Emailit.
Campagne email Campagne
Automazioni Automazioni (beta)
Moduli Moduli (accesso anticipato), oppure l’URL di iscrizione di una lista
tags e l’header X-Mailin-custom meta
IP dedicati IP dedicati 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:

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>"
  }'
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 <email>"
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.

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.

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}

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.
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 APISuppressions, 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.

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 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 MarketingContacts, 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.

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 MarketingTemplates o crealo con l’API dei template, 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 e Tag di unione.

Ricrea campagne e automazioni

Crea le campagne in Email MarketingCampaigns a partire dai template importati. Ricrea ogni automazione di Brevo come automazione 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 (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 APIDomains 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.

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 di Emailit.

Passaggi successivi

Questa pagina ti è stata utile?

Grazie del feedback.

Grazie, leggiamo ogni messaggio.