API compatibile · SMTP2GO

API compatibile con SMTP2GO: cambi indirizzo e chiave

SMTP Senpai accetta le richieste di invio nello stesso formato dell’API v3 di SMTP2GO (email). Punti il codice su SMTP Senpai, usi la chiave msp_ e tieni il tuo SDK, i tuoi campi e la tua gestione degli errori.

14 giorni gratis · fino a 100 email al giorno · serve la carta · se non disdici entro 14 giorni parte il piano che hai scelto

  • Stessi percorsi, campi ed errori
  • Server di invio e registro in Europa
  • Prova gratis 14 giorni
Node.js · smtp2go-nodejs 1.0.0 · cosa cambia
  import SMTP2GOApi from 'smtp2go-nodejs';
- const api = SMTP2GOApi(process.env.SMTP2GO_API_KEY);
+ const api = SMTP2GOApi(process.env.SMTP_SENPAI_KEY); // msp_…
  const client = api.client();
+ client.apiUrl = 'https://app.mailsenpai.com/relay/compat/smtp2go/v3/'; // trailing slash
cosa cambia

Cambiano due cose, il resto resta

Stessi percorsi, stessi campi, stesse risposte e stessa forma degli errori dell’API v3 di SMTP2GO (email).

Indirizzo basehttps://app.mailsenpai.com/relay/compat/smtp2go/v3
Oppure l’host dedicatohttps://smtp2go-api.mailsenpai.com/v3
Dove va la chiaveX-Smtp2go-Api-Key: msp_… (o api_key nel corpo)
Percorsi (invariati)POST /email/send, /email/mime

Il mittente deve stare su un dominio verificato nella tua area SMTP Senpai e firmato DKIM: altrimenti la richiesta viene rifiutata con un errore nel formato di SMTP2GO.

il codice

Il tuo codice, puntato su SMTP Senpai

Node.js · smtp2go-nodejs 1.0.0 · dopo
import SMTP2GOApi from 'smtp2go-nodejs';
const api = SMTP2GOApi(process.env.SMTP_SENPAI_KEY); // msp_…
const client = api.client();
client.apiUrl = 'https://app.mailsenpai.com/relay/compat/smtp2go/v3/'; // trailing slash

Provato con smtp2go-nodejs 1.0.0: eseguito con l’SDK ufficiale contro gli endpoint di SMTP Senpai.

Altri linguaggi e framework

Impostazioni lette nel codice sorgente di ogni SDK: seguono la stessa regola (indirizzo base o host, più la tua chiave). Provale con un invio di prova prima di andare in produzione.

SDKImpostazioneStato
PHP smtp2go-oss/smtp2go-phpsubclass ApiClient with API_URL = 'https://smtp2go-api.mailsenpai.com/v3/' and HOST = 'smtp2go-api.mailsenpai.com'Letto nel codice dell’SDK, non ancora provato
Python smtp2gosmtp2go.core.API_ROOT = 'https://smtp2go-api.mailsenpai.com/v3/'Letto nel codice dell’SDK, non ancora provato
campi

Cosa funziona, cosa viene ignorato, cosa viene rifiutato

Funziona

sender, to, cc, bcc, subject, html_body, text_body, custom_headers (anche Reply-To), attachments, inlines; mime_email

Accettato senza effetto

—

Indicato nell’intestazione di risposta X-MailSenpai-Ignored.

Rifiutato con l’errore di SMTP2GO

template_id, schedule, allegati da url

Nell’SDK Node apiUrl vuole la barra finale. La risposta mantiene la forma di SMTP2GO: request_id e data con succeeded, failed, failures ed email_id.

eventi e webhook

Gli esiti delle consegne dall’API di SMTP Senpai

Gli endpoint di SMTP2GO per log, eventi, statistiche e webhook non sono riprodotti. Gli esiti (sent, delivered, bounce, defer, complaint, dropped, open, click) arrivano dall’API di SMTP Senpai con la stessa chiave: GET /relay/v1/eventi, oppure un webhook firmato impostato nella tua area SMTP Senpai.

L’id nella risposta all’invio (email_id) è il message_id di quegli eventi. Ogni risposta porta anche X-MailSenpai-Result (sent, queued, suppressed, failed).

Leggi il riferimento di eventi e webhook

Limiti. Fino a 50 destinatari per messaggio e 500 copie per richiesta (oltre 50 vanno in coda e partono entro circa un minuto), 10 allegati e 10 MB per messaggio. Template e invio programmato non sono supportati: manda il contenuto finale quando vuoi che parta.
Terminale · eventi di SMTP Senpai
curl "https://app.mailsenpai.com/relay/v1/eventi?quanti=50" \
  -H "Authorization: Bearer $SMTP_SENPAI_KEY"

# {"ok": true, "eventi": [{"type": "delivered",
#   "email": "…", "message_id": "…", …}], "prossimo": …}

Domande frequenti

Devo riscrivere il codice che usa SMTP2GO?

No. Cambi l’indirizzo base (o l’host) e la chiave. Percorsi, campi, risposte e formato degli errori restano quelli dell’API v3 di SMTP2GO (email), quindi il tuo SDK e la gestione degli errori continuano a funzionare.

E i template e l’invio programmato?

Non sono supportati: le richieste che li usano vengono rifiutate con l’errore nativo, così non parte nulla per sbaglio. Prepara il contenuto finale nel tuo codice e mandalo quando vuoi che parta.

Come ricevo rimbalzi, aperture e webhook?

Dall’API di SMTP Senpai, con la stessa chiave: GET /relay/v1/eventi oppure un webhook firmato impostato nella tua area SMTP Senpai. Gli endpoint di eventi e webhook di SMTP2GO non sono riprodotti.

Posso continuare a spedire via SMTP?

Sì. Lo stesso account funziona anche via SMTP (relay.mailsenpai.com, porta 2525, STARTTLS) e con l’API REST di SMTP Senpai.

Prova SMTP Senpai con il tuo codice di oggi

14 giorni per cambiare indirizzo base e chiave, mandare le tue email vere e controllare ogni esito nel registro. Poi decidi.

SMTP2GO è un marchio di Sand Dune Mail Ltd. È citato solo per descrivere il formato di richiesta che SMTP Senpai accetta. MailSenpai non è affiliata a SMTP2GO e questa pagina non è approvata da loro. Informazioni verificate il 9 ottobre 2026.

14 giorni gratisProva gratis