Vai al contenuto
Docs

Guida

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.

Aggiornato il 23 ott 2026

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:

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

Questa pagina ti è stata utile?

Grazie del feedback.

Grazie, leggiamo ogni messaggio.