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/web/resend-email.md (or send Accept: text/markdown).
Aggiungi l'email con Resend
Crea un account Resend gratuito, verifica un dominio di invio e cambia EMAIL_PROVIDER perché codici e ricevute arrivino in caselle di posta reali.
Procedura dettagliata per principianti
Prerequisiti: l'app in esecuzione in locale (Online in 5 minuti). Inizia gratis — niente carta, e il piano gratuito di Resend copre i volumi di sviluppo.
Terminologia rapida: EMAIL_PROVIDER=local è il predefinito — i messaggi vengono scritti nella pagina incorporata /mail-preview e non lasciano mai la tua macchina, il che è perfetto mentre costruisci. Resend è l'adattatore che consegna a caselle di posta reali. EMAIL_FROM è l'identità del mittente che usano i template; il suo indirizzo deve stare su un dominio che Resend ha verificato. I record DNS sono le righe che incolli dal tuo registrar o su Cloudflare perché le caselle riceventi si fidino del tuo mittente.
Cosa crei: un account Resend, un dominio di invio verificato e una chiave API — il passaggio del dominio è l'unica parte d'attesa, dato che la propagazione DNS va da minuti a ore.
Creare l'account Resend
1. Apri resend.com → Sign up, conferma la tua email e arrivi sulla dashboard.
2. Inizia con il piano gratuito — puoi persino inviare mail di prova dal mittente condiviso di Resend prima di avere un dominio, cosa che copre la sezione successiva.
Verificare il tuo dominio di invio
Prova rapida senza dominio: l'indirizzo [email protected] funziona subito come EMAIL_FROM — ma consegna solo all'email con cui ti sei registrato, mai agli utenti. Usalo per vedere la pipeline funzionare, poi fai la configurazione vera.
1. Apri Domains → Add Domain e inserisci il dominio da cui invii (per esempio yourdomain.com; un sottodominio come mail.yourdomain.com funziona ugualmente e tiene i record in ordine).
2. Resend elenca i record DNS da creare — record TXT DKIM più voci MX/SPF o CNAME a seconda dell'età dell'account. Aggiungine uno per uno presso il tuo host DNS: la pagina DNS del tuo registrar, oppure Cloudflare se hai spostato i nameserver. Su Cloudflare tieni la nuvola del proxy grigia (DNS only) per i record di posta — i record proxied non si verificano mai.
3. Di nuovo in Resend fai clic su Verify. Atteso: il dominio passa a Verified. La propagazione varia da minuti a un giorno; la pagina del dominio nomina il record esatto che ancora non risolve.
Una volta verificato, qualsiasi indirizzo del dominio funziona come mittente — hello@, no-reply@, quello che usa EMAIL_FROM — senza registrazione per singolo indirizzo.
Creare la chiave API
1. Apri API Keys → Create API Key.
2. Permission: Sending access basta — il kit invia soltanto. Nomina la chiave per il suo ambiente (production, local) così una chiave di dev trapelata può essere revocata senza toccare la produzione.
3. Copia la chiave re_… adesso — viene mostrata una volta sola. Perderla significa solo crearne un'altra.
Aggiungere i valori all'app
Inserisci le righe qui sotto in apps/web/.env.local. RESEND_API_KEY resta lato server — mai NEXT_PUBLIC_/EXPO_PUBLIC_, mai committata; EMAIL_PROVIDER e EMAIL_FROM sono semplice configurazione. Riavvia il server di sviluppo dopo le modifiche.
EMAIL_FROM deve stare sul dominio verificato: [email protected] raggiunge solo il tuo indirizzo di registrazione, e un dominio non verificato riceve un rifiuto 403 da Resend.
# apps/web/.env.local
EMAIL_PROVIDER=resend
EMAIL_FROM="Your Product <[email protected]>"
RESEND_API_KEY=re_…Verificare e risolvere i problemi
Riavvia, apri /auth e richiedi un codice di accesso verso una casella reale che controlli. Atteso: il messaggio arriva, e Resend → Emails mostra la consegna con stato verde — quel registro è anche dove vivono i motivi di bounce ed errore.
Niente inviato? Controlla che EMAIL_PROVIDER=resend si sia davvero salvato in apps/web/.env.local e riavvia. Un 403 nel log del server significa che EMAIL_FROM non è sul dominio verificato — o che [email protected] è stato mandato a qualcuno che non sei tu.
Un provider diverso in seguito? EMAIL_PROVIDER accetta anche ses (con le chiavi AWS) e i transport postmark, sendgrid, mailgun, smtp, brevo — stesso contratto EMAIL_FROM, nomi env diversi, tutti elencati in .env.example. La guida email li confronta.
Per continuare la configurazione, leggi Configurare le email di Amazon SES.