Guida
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 per l’ordine generale e per sapere come usare entrambi i provider in parallelo.
Concetti
| SMTP2GO | Emailit |
|---|---|
| Master account e subaccount | Account e workspace. 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: 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 |
| 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 e consegnano solo ai membri del workspace. |
| Impostazioni di tracciamento e del footer di disiscrizione per utente SMTP o API key | Tracciamento per dominio di invio. Emailit non aggiunge un footer di disiscrizione alle email inviate via API o SMTP. |
| Templates | Template con un alias e versioni, elaborati con Temple |
| Webhooks | Webhook |
| Suppressions di indirizzi e di domini | Soppressioni di indirizzi |
| Report e attività | Email APIEmails e Email APILogs |
| IP dedicati e pool di IP | IP dedicati 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 di Emailit, che aggiungono gli header per te. Nelle campagne, aggiungi il link visibile con {{unsubscribe_url}}. Vedi Header SMTP.
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 e Header e risposte SMTP.
Aggiorna le chiamate API
POST /v3/email/send di SMTP2GO diventa POST /v2/emails. Gli indirizzi restano stringhe, ma i nomi dei campi cambiano:
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>"
}'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 |
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.
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
eventatype, e l’email si trova indata.object. Usadata.object.id, l’IDem_della risposta all’invio o della risposta SMTP, al posto diemail_id, edata.object.toal posto dircpt. I valori che hai passato inmetasono 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. - SMTP2GO non firma i webhook. 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
-
Esporta le soppressioni da Reports > Suppressions con Export, oppure scorri le pagine di
POST /v3/suppression/view. Se non impostistart_date, l’API restituisce circa gli ultimi 30 giorni, quindi impostalo in modo da coprire tutto lo storico. -
Crea un unico CSV con le colonne
email,type,reason:Motivo in SMTP2GO Tipo in Emailit bounce,spam,manualrecipient, che blocca gli invii via API, SMTP e campagneunsubscribeunsubscribe, che ferma le campagne ma lascia passare le email transazionali. Usarecipientse la persona ha rinunciato a tutto ciò che invii.email,type,reason old-address@example.com,recipient,smtp2go bounce left@example.com,unsubscribe,smtp2go unsubscribe -
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.
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.
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 MarketingTemplates o crealo con l’API dei template, 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 e Importa ed esporta i template.
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 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.
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
- Risoluzione dei problemi SMTP
- Migrazione prioritaria: lascia che i tecnici di Emailit facciano la migrazione insieme a te