Invia la tua prima email con Inbixio in 5 minuti

Inbixio trasforma l’account email che hai già in un’API HTTPS pulita e protetta da chiave. Invece di aprire connessioni SMTP da ogni servizio che gestisci, il tuo codice esegue una sola richiesta POST e Inbixio si occupa del dialogo con il tuo server di posta.

Questa guida ti accompagna da un account nuovo a un’email recapitata. Ti servono circa cinque minuti, un account email che supporti SMTP (vanno bene caselle Google Workspace, Microsoft 365, Zoho o del provider di hosting) e un terminale.

Come si inserisce Inbixio nel tuo stack

Prima dei passaggi, è utile vedere i vari componenti:

1. La tua app invia una richiesta JSON all’API di Inbixio con una chiave API.
2. Inbixio verifica la chiave, i suoi permessi e il limite mensile del tuo piano, poi mette il messaggio in coda.
3. Il tuo server SMTP (quello che colleghi al passo 2) lo recapita. Inbixio esegue l’accesso, porta la connessione a TLS e consegna il messaggio.
4. La tua dashboard mostra quante email sono partite, quale quota non è riuscita e quanto tempo ha impiegato il tuo server ad accettarle.

Poiché il messaggio parte dal tuo server di posta, viene inviato dal tuo indirizzo e dal tuo dominio, e la reputazione che hai costruito presso i provider di posta resta tua.

Passo 1: crea l’account e scegli un piano

Vai su app.inbixio.com/create-account e inserisci nome, indirizzo email, nome dell’azienda, numero di telefono e indirizzo aziendale, poi scegli una password.

Inbixio invia un link di verifica all’indirizzo che hai usato. Aprilo, poi accedi. Al primo accesso ti verrà chiesto di scegliere un piano; il pagamento è gestito in modo sicuro da Stripe. I piani si differenziano soprattutto per il volume mensile. Se non sai quale ti serve, leggi come stimare il volume delle tue email.

Passo 2: collega il tuo server SMTP

Nella dashboard apri Email Servers (server email) e scegli Add Server (aggiungi server). Vedrai quattro campi e due interruttori:

Due dettagli ti risparmieranno molto debug in seguito:

• Il nome utente è anche il mittente. Inbixio invia dall’indirizzo con cui esegue l’accesso, quindi usa una vera casella sul tuo dominio, come hello@ o notifications@, invece di una inbox personale.
• Molti provider richiedono una password per le app. Google, ad esempio, richiede la verifica in due passaggi e una password per le app di 16 caratteri per SMTP. La tua password normale verrà rifiutata.

Non sai cosa inserire? Impostazioni SMTP spiegate illustra host, porte e TLS per i provider più comuni.

Passo 3: genera una chiave API

Apri API Keys (chiavi API) e scegli Create Api Key (crea chiave API). Assegnale un nome che indichi dove verrà usata, ad esempio production-backend o staging-signup-service, poi imposta:

• Server Access (accesso ai server): All Server (tutti i server) invia tramite il primo server email che hai collegato. Selected Server (server selezionato) associa la chiave a un solo server. Se hai più indirizzi di invio, assegna a ogni servizio una chiave associata al suo server: è così che controlli da quale indirizzo invia.
• Permissions (permessi): seleziona Send (invio) perché la chiave possa inviare email. Concedi a una chiave solo i permessi di cui ha bisogno.

Scegli Generate API Key (genera chiave API), poi copia la chiave. Le chiavi Inbixio iniziano con ibx_. Conservala come una password: nel tuo secrets manager o in una variabile d’ambiente, mai nel codice frontend o in un repository pubblico. Sicurezza delle chiavi API approfondisce rotazione e permessi.

Passo 4: invia la tua prima email

Esporta la chiave, poi invia una richiesta con curl:

export INBIXIO_API_KEY="ibx_your_key_here"

curl -X POST https://backend.inbixio.com/api/send-email/ \
  -H "X-API-Key: $INBIXIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to_email": "you@example.com",
    "subject": "Hello from Inbixio",
    "message": "<h1>It works!</h1><p>My first email sent through the Inbixio API.</p>"
  }'

Una richiesta riuscita restituisce HTTP 200:

{ "message": "Email queued successfully." }

Controlla la tua inbox. L’email arriva dall’indirizzo che hai usato come nome utente SMTP.

Mantieni la barra finale. L’endpoint è /api/send-email/. Senza la / finale il server risponde con un redirect, e molti client HTTP non inviano di nuovo il corpo della richiesta dopo un redirect.

Il corpo della richiesta ha tre campi obbligatori:

Passo 5: verifica il recapito nella dashboard

“In coda” significa che Inbixio ha accettato la richiesta e ha avviato il recapito in background. Il recapito SMTP avviene un attimo dopo, e i risultati si accumulano nella tua Dashboard:

• Email Sent (email inviate) conta gli invii riusciti negli ultimi 7 giorni.
• Failed Deliveries (recapiti non riusciti) mostra la quota di email rifiutate dal tuo server SMTP negli stessi 7 giorni.
• Avg Latency (latenza media) mostra quanto tempo impiega il tuo server SMTP ad accettare i messaggi.
• La tabella dei logs (log) elenca ogni chiamata API con ID evento, endpoint, codice di stato e tempo di risposta.

Se l’email di prova non arriva e la percentuale di errori sale, la causa è quasi sempre nelle impostazioni del server: una password errata, un provider che richiede una password per le app, oppure host o porta sbagliati. Controllali in Email Servers e invia un’altra prova.

Errori comuni alla prima richiesta

Per retry, limiti mensili e una gestione degli errori adatta alla produzione, leggi come gestire errori e limiti dell’API email.

Prossimi passi

Ora hai un flusso funzionante dal tuo codice alle inbox dei tuoi utenti. Da qui:

• Invia dal tuo stack reale con gli esempi per Node.js, Python e cURL.
• Assicurati che i tuoi messaggi arrivino in inbox con la checklist SPF, DKIM e DMARC.
• Crea le email che gli utenti aspettano: codici OTP e di verifica e reimpostazione della password.