Guida all'infrastruttura email

Come inviare email tramite API

Un approccio passo passo all'invio di email autenticate tramite API, ai test e alla sicurezza in produzione.

Una richiesta email di produzione richiede più di un destinatario e un oggetto. Servono un mittente verificato, un template adatto allo scopo, autenticazione, gestione degli errori e un modo per osservare l'esito.

Cosa significa in pratica

  • Un dominio From verificato
  • Una chiave API limitata al workspace corretto
  • Contenuto strutturato in HTML e testo
  • Una strategia di nuovi tentativi che eviti consegne duplicate

Checklist di implementazione

  1. Crea un dominio verificato e scegli un indirizzo mittente.
  2. Conserva la chiave API in variabili d'ambiente lato server.
  3. Invia un messaggio di test a una inbox controllata.
  4. Registra l'ID di risposta del provider e gestisci le risposte non riuscite.
  5. Aggiungi una chiave di idempotenza o un ID evento per i job ritentati.

Le domande dei team

Si può usare una chiave API nel codice del browser?

No. Tieni le credenziali di invio su un server, un worker o un backend attendibile.

Come evito invii email duplicati?

Usa un identificatore di evento stabile o una chiave di idempotenza e salva l'ID del messaggio del provider prima di ritentare i job non riusciti.