Guida
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 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:
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>"
}'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
eventatype, e l’email si trova indata.object. Usadata.object.id, l’IDem_della risposta all’invio, al posto dimessage-id, edata.object.toal posto diemail. I tuoi valorimeta, che sostituisconotagseX-Mailin-custom, sono indata.object.meta. - Per
email.loadededemail.clicked,data.objectè il caricamento o il clic. Usadata.object.email_idper l’ID dell’email, edata.object.email.rcpt_toedata.object.email.metaper il destinatario e i tuoi valorimeta. - Brevo non firma i webhook: li proteggi con credenziali o con un token. Emailit firma ogni richiesta: verifica
X-Emailit-Signaturerispetto aX-Emailit-Timestampe al tuo secretwhsec_. Vedi Verifica le firme dei webhook.
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:
-
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 tiporecipientper tutti. Brevo blocca un indirizzo per un solo mittente, mentre Emailit lo blocca per l’intero workspace. -
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 tiporecipientper hard bounce e segnalazioni di spam, eunsubscribeper le disiscrizioni. Il tipounsubscribeferma 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. -
Crea un unico CSV con le colonne
email,type,reason:email,type,reason old-address@example.com,recipient,brevo hard bounce left@example.com,unsubscribe,brevo unsubscribed -
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
-
Crea i campi personalizzati. Per ogni attributo dei contatti di Brevo che usi, tranne
EMAIL,FIRSTNAMEeLASTNAME, crea un campo personalizzato in Emailit. Le chiavi sono in minuscolo, quindiCOMPANYdiventacompany. -
Crea le liste, una per ogni lista di Brevo a cui invii campagne.
-
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.
-
Importala. In Email MarketingContacts, seleziona Import, mappa
EMAIL,FIRSTNAME,LASTNAMEe 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
- Checklist per andare in produzione
- Crea una campagna
- Migrazione prioritaria: lascia che i tecnici di Emailit facciano la migrazione insieme a te