E-mail via API o via SMTP: quando scegliere che cosa?

Scegli SMTP quando è un pacchetto esistente a inviare la posta e puoi soltanto cambiare le impostazioni: un e-commerce, un gestionale contabile, un CRM, uno scanner. Scegli l'API quando sviluppi software tuo e vuoi sapere per ogni messaggio che cosa è successo, quando vuoi subito un errore invece di un bounce ore dopo, o quando presenti grandi quantità in una volta sola. Le due cose non si escludono: la maggior parte delle aziende usa entrambe, ciascuna con un accesso proprio.

Che cosa hanno in comune

Entrambe consegnano il tuo messaggio alla stessa infrastruttura d'invio, con la stessa autenticazione per il tuo dominio, la stessa reputazione e lo stesso registro. La differenza sta nella strada per arrivarci: SMTP è il protocollo che ogni programma di posta e ogni pacchetto parla da trent'anni; una e-mail API è un collegamento web a cui il tuo codice presenta un messaggio come dati strutturati e da cui riceve subito una risposta.

Quando SMTP è la scelta giusta

• Non puoi programmare, solo impostare. WordPress, WooCommerce, Odoo, PrestaShop, Magento, Microsoft 365, uno scanner: hanno tutti un campo per nome del server, porta e accesso. Lo compili e funziona.
• Il pacchetto è di un fornitore. Chi non controlla il codice non può aggiungere una chiamata API, ma può cambiare le impostazioni SMTP.
• Il tuo framework ha già uno strato di posta. Laravel, Symfony e la maggior parte degli altri framework inviano tramite un trasporto SMTP integrato. Basta una riga nella configurazione dell'ambiente.
• Il volume è modesto e i messaggi sono semplici. Un ripristino password, una conferma, una notifica: SMTP li gestisce benissimo.

Lo svantaggio di SMTP è che la risposta è limitata. Il server dice "accettato" e il resto lo scopri dopo, dal registro o da un bounce. Inoltre una connessione SMTP è relativamente lenta quando ci vuoi far passare migliaia di messaggi: ogni messaggio apre un dialogo con il server.

Quando l'API è la scelta giusta

• Vuoi sapere subito se è riuscito. L'API risponde immediatamente con un identificativo unico per messaggio, oppure con un errore chiaro: indirizzo non valido, campo mancante, quota raggiunta. Il tuo codice può reagire invece di aspettare ore un bounce.
• Invii molto in una volta sola. Una chiamata con mille destinatari è più rapida e affidabile di mille dialoghi SMTP, e la tua applicazione non deve tenere una coda.
• Vuoi allegare metadati a ogni messaggio. Un numero cliente, una campagna, un numero d'ordine, così in caso di bounce o reclamo sai subito di quale cliente si tratta.
• Vuoi indietro gli eventi. Consegna, bounce, apertura, reclamo: arrivano nel tuo sistema tramite webhook firmati, collegati all'identificativo ricevuto all'invio.
• Vuoi separare l'invio dal server applicativo. Nessuna coda di posta sul tuo server, nessuna porta aperta, solo una chiamata web.

Lo svantaggio dell'API è che serve del codice. Per uno sviluppatore è un pomeriggio di lavoro, ma non è un'impostazione che un amministratore cambia al volo.

Tre esempi dalla pratica

Un e-commerce su WooCommerce invia le conferme d'ordine via SMTP, perché quell'invio è dentro il pacchetto. La newsletter passa dalla gestione campagne della piattaforma. Nessun codice necessario.

Un'applicazione SaaS manda migliaia di notifiche al giorno, vuole sapere per ogni cliente se sono arrivate e in caso di hard bounce vuole avvisare subito il cliente nell'interfaccia. Questa è l'API, con webhook di ritorno verso l'applicazione.

Uno studio di commercialisti usa un pacchetto che invia via SMTP, e ha inoltre un portale proprio che tramite l'API presenta documenti e mostra lo stato di consegna al gestore della pratica. Due accessi, un dominio, un pannello.

Che cosa sistemare in entrambi i casi

Un accesso o una chiave separata per applicazione, così puoi revocarne una senza toccare il resto. SPF e DKIM per il tuo dominio. Un indirizzo mittente fisso per applicazione. E un'occhiata al registro nella prima settimana dopo il collegamento. La scelta tra API e SMTP è una scelta tecnica; la consegna dipende dalla stessa base di deliverability.

Domande frequenti

Con l'API la consegna è più rapida che con SMTP?

La consegna presso il destinatario è identica. L'API è più rapida nel presentare grandi quantità e nel restituire una risposta.

Posso passare più avanti da SMTP all'API?

Sì. Entrambe usano lo stesso dominio e la stessa autenticazione; aggiungi una chiave e adatti il codice quando sei pronto.

Per l'API mi serve uno sviluppatore?

Sì, anche se il collegamento è semplice: una chiamata web con una chiave e il contenuto del messaggio. Per i pacchetti senza codice proprio la strada resta SMTP.