For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /it/docs/modules/email.md (or send Accept: text/markdown).
Email transazionale
Consegna per auth e flussi di prodotto.
Leggi il tuo primo messaggio locale, quindi abilita la consegna
Per email transazionale si intende un messaggio attivato da un'azione dell'app, ad esempio un codice di accesso o il risultato di un'attività. Con il server Web in esecuzione, mantieni EMAIL_PROVIDER=local in apps/web/.env.local. Completa la configurazione del database, richiedi un codice di accesso a /auth, quindi apri /mail-preview e controlla l'ultimo messaggio. Un messaggio locale visualizzato qui non è un'e-mail recapitata alla tua casella di posta esterna.
Per inviare messaggi reali, scegli un provider di posta elettronica, crea il suo account, verifica un dominio che controlli e segui la sua guida dedicata. Inserisci la chiave denominata API e l'indirizzo del mittente in apps/web/.env.local, salva e riavvia il server Web. Richiedi un nuovo codice di accesso, quindi controlla sia il registro di consegna del provider che la casella di posta di destinazione, incluso lo spam. La verifica del dominio e l'approvazione del mittente possono richiedere tempo.
Se il messaggio non riesce, controlla l'errore di consegna e la verifica del mittente prima di richiedere ripetutamente. Il percorso /mail-preview è solo per lo sviluppo e restituisce 404 in produzione. Mantieni la comunicazione di marketing separata da questo mittente transazionale in modo che una campagna di newsletter non possa interrompere la posta di verifica dell'account.
Mantieni la consegna transazionale separata
Il modulo email gestisce i messaggi transazionali di prodotto, inclusi auth e avvisi di completamento attività. L'outreach appartiene al flusso proprio del prodotto consumatore e deve restare separato da questo percorso transazionale.
Configura l'adattatore di consegna
Usa l'adattatore locale per i test deterministici. Configura l'adattatore di produzione scelto e le sue credenziali server prima di attivare la consegna esterna. Non mettere mai i segreti del provider email nella configurazione client o nei log.
Registra la consegna indipendentemente
Un risultato generato e la sua email di completamento hanno esiti separati. Ispeziona i record di consegna prima di affermare che un messaggio è stato inviato. Testa una consegna fallita senza trattarla come una generazione fallita né inviare lavoro di modello duplicato.