Iniziare con l'API transazionale

L'API transazionale di Flexmail consente di inviare email one-to-one attivate dall'applicazione — conferme d'ordine, reimpostazioni della password, fatture e qualsiasi altra cosa che si attiva in risposta a un'azione specifica dell'utente. È possibile inviare tramite HTTP (REST API) o SMTP, utilizzando lo stesso account e le stesse credenziali per entrambi.

Il prodotto transazionale funziona indipendentemente dal prodotto marketing di Flexmail. È possibile utilizzarlo da solo senza configurare campagne o liste di contatti.

Attenzione L'API transazionale supporta solo un destinatario per messaggio. Non può essere utilizzata per invii in massa o marketing. Consultare "Email di marketing vs. email transazionale" per la spiegazione completa.

Prerequisiti

Un account Flexmail. È necessario per utilizzare l'API transazionale, anche se si inviano solo email transazionali e non si utilizzano le funzionalità marketing.
Accesso alle impostazioni DNS del dominio per configurare l'autenticazione email.
Accesso sviluppatore all'applicazione o al sistema di invio per integrare l'API o configurare SMTP.

Passo 1: Attivare il prodotto transazionale

Se si dispone già di un account Flexmail, attivare il prodotto transazionale dal widget della dashboard. La prova offre fino a 1.000 invii nell'arco di 30 giorni senza costi. È possibile passare a un abbonamento transazionale a pagamento in qualsiasi momento durante o dopo la prova.

Se non si dispone ancora di un account, registrarsi su flexmail.be/en/signup. Gli abbonamenti marketing e transazionali vengono gestiti dallo stesso account.

Attenzione Non è necessario un abbonamento marketing per utilizzare il prodotto transazionale. Se si desidera solo inviare email transazionali, è possibile attivare il prodotto transazionale e lasciare inutilizzate le funzionalità marketing.

Passo 2: Verificare l'indirizzo mittente

Prima di poter inviare, è necessario verificare l'indirizzo email che si utilizzerà nel campo Da.

Andare su Impostazioni, poi Aggiungi o rimuovi mittenti.
Aggiungere l'indirizzo email da cui si desidera inviare.
Flexmail invia un'email di verifica a quell'indirizzo — cliccare il link per confermare. Questo dimostra che si possiede la casella di posta da cui si invia.

Screenshot dell'email di validazione

Passo 3: Configurare l'autenticazione email

Configurare SPF, DKIM, DMARC e un return-path personalizzato per il dominio dell'indirizzo mittente. Questi record DNS dimostrano che le email provengono genuinamente dal mittente — è così che i provider di posta in arrivo come Gmail decidono se recapitare l'email nella posta in arrivo o rifiutarla.

Le istruzioni dettagliate per la configurazione DNS sono nella documentazione dell'API email Flexmail, nella sezione Autenticazione email.

Attenzione L'autenticazione email non è opzionale per le email transazionali. Senza record SPF e DKIM configurati correttamente, le email transazionali non supereranno i controlli di autenticazione presso i principali provider di posta in arrivo e potrebbero essere rifiutate o inviate allo spam.

Passo 4: Creare un token di accesso personale

L'API transazionale utilizza l'autenticazione HTTP Basic. L'ID account è il nome utente; un token di accesso personale è la password. Queste credenziali sono solo per l'API HTTP — SMTP utilizza credenziali separate fornite da Flexmail su richiesta.

Andare su Impostazioni, poi API, poi Token di accesso personali.
Cliccare su Crea nuovo token e dargli un nome descrittivo.
Copiare il token e conservarlo in modo sicuro. Non verrà mostrato di nuovo.

Passo 5: Scegliere il metodo di invio

Flexmail supporta due modi per inviare email transazionali. Entrambi utilizzano lo stesso ID account e token di accesso personale.

API HTTP

L'API REST offre il massimo controllo. È possibile inviare messaggi, gestire modelli, gestire webhook e recuperare i dati di consegna in modo programmatico. Questo è l'approccio consigliato per integrazioni personalizzate e applicazioni.

La documentazione completa è su email-api.flexmail.eu/documentation. La sezione Per iniziare include un esempio curl che è possibile eseguire immediatamente per verificare la configurazione.

SMTP

Gli invii SMTP sono inclusi nel prodotto transazionale senza costi aggiuntivi. Utilizzare SMTP quando l'applicazione o la piattaforma lo supporta già — ad esempio, un CMS, una piattaforma di e-commerce o un sistema legacy che invia email tramite un relay SMTP.

Consultare "Invii SMTP per email transazionale" per le impostazioni di connessione e le istruzioni di configurazione.

Passo 6: Integrare nell'applicazione

Con un invio di test riuscito confermato, si è pronti a integrare l'API nell'applicazione. La documentazione completa copre:

Invio messaggi: tutti i parametri per l'endpoint di invio
Modelli — creazione e riferimento a modelli email riutilizzabili. Consultare "Modelli transazionali e personalizzazione" per una panoramica pratica.
Webhook — notifiche di eventi in tempo reale per invii, consegne, bounce, aperture e clic. Consultare "Webhook transazionali" per la configurazione e il riferimento agli eventi.

Consiglio del supporto Configurare la gestione dei webhook nelle prime fasi dell'integrazione. Sapere quando un'email transazionale genera un bounce consente di agire immediatamente — contrassegnare l'indirizzo nel sistema, attivare una notifica di follow-up o avvisare il team — piuttosto che scoprire un problema di consegna giorni dopo.

Documentazione API e supporto

La documentazione completa dell'API è disponibile su email-api.flexmail.eu/documentation.

In caso di difficoltà, il team di supporto Flexmail è disponibile all'indirizzo support@flexmail.eu. Le domande sull'API transazionale vengono gestite dallo stesso team che supporta l'interfaccia marketing.

Passi successivi

Consulti "Email di marketing vs. email transazionale" per capire quando utilizzare ogni tipo.
Consulti "Invii SMTP per email transazionale" per inviare tramite SMTP invece dell'API HTTP.
Consulti "Modelli transazionali e personalizzazione" per configurare modelli email riutilizzabili.
Consulti "Webhook transazionali" per ricevere eventi di consegna in tempo reale.
Consulti "Risoluzione dei problemi delle email transazionali" se qualcosa non funziona come previsto.
Esaminare la documentazione completa dell'API su email-api.flexmail.eu/documentation per tutti i parametri degli endpoint.