Resend: guida completa per configurare API, dominio e invio email
Resend è il servizio per inviare email transazionali dalle tue applicazioni. Configurazione API, verifica del dominio e primo invio in pochi minuti.
👁 114 letture
Resend è un servizio per inviare email dalle applicazioni: registrazioni, reset password, conferme ordini, notifiche. Invierai la prima email in cinque minuti, e il tempo maggiore non lo richiede il codice, ma la verifica del dominio. Questa guida ti accompagna attraverso l’intero processo seguendo la documentazione ufficiale di Resend.
Prima di iniziare: accesso al DNS
L’ostacolo più comune quando si inizia con Resend non è il codice, ma la mancanza di accesso alle impostazioni DNS del dominio. Prima di iniziare, verifica dove è gestito il dominio e se hai i permessi per aggiungere record. Se il dominio è gestito da qualcun altro, ad esempio un’agenzia o il reparto IT, richiedi l’accesso oppure preparati a trasmettere loro l’elenco dei record dal pannello Resend.
Stabilisci subito anche da quale indirizzo partiranno le email, ad esempio notifiche@ su un sottodominio dedicato all’invio.
Passo 1. Chiave API
Dopo aver creato l’account, generi una chiave API nel pannello. La chiave va salvata in una variabile d’ambiente sul server, ad esempio nel file di configurazione dell’applicazione, non nel codice. La documentazione e le guide lo sottolineano con forza: una chiave nel codice del browser è pubblica, e chiunque la legga può inviare email a nome del tuo dominio.
Passo 2. Libreria e prima email
Installi la libreria ufficiale per il tuo linguaggio, ad esempio per Node.js tramite npm. La prima email la invii con una singola chiamata specificando mittente, destinatario, oggetto e contenuto HTML. Per i test puoi inviare dall’indirizzo di test di Resend, senza configurare il dominio.
Qui c’è una trappola in cui cadono molte persone: dall’indirizzo di test l’email arriverà solo all’indirizzo del tuo account. L’invio a chiunque altro prima della verifica del dominio termina con un errore che il primo giorno sembra misterioso.
Passo 3. Verifica del dominio
Per inviare dal tuo indirizzo, aggiungi il dominio nel pannello Resend. Nella scheda dei record ottieni le voci da aggiungere presso il provider DNS: record SPF e DKIM e il record di risposta. Copiali con precisione, meglio con copia-incolla, perché un solo errore di battitura blocca la verifica.
Tre note pratiche dalla documentazione:
- Resend consiglia un sottodominio separato per l’invio, ad esempio send, invece del dominio principale,
- con Cloudflare disattiva il proxy per i record CNAME, altrimenti la verifica non si completerà,
- la propagazione può richiedere fino a un giorno, e gli avvisi sui record mancanti in questo periodo sono normali.
DMARC non è richiesto per la verifica, ma vale la pena aggiungerlo perché migliora la credibilità delle tue email.
Passo 4. Template in React Email
Resend è stato creato dallo stesso team che ha creato React Email, quindi è il modo consigliato per costruire i template. Scrivi l’email come un componente, con parametri, ad esempio il nome del cliente e il nome del prodotto, e lo passi nella chiamata di invio. Resend lo converte automaticamente in HTML.
Passo 5. Anteprima degli invii
Nel pannello vedi ogni messaggio inviato e il suo stato: consegnata, rifiutata, contrassegnata come spam. In caso di problemi di consegna è il primo posto dove guardare. La deliverability dipende anche dalla configurazione del dominio e dalle regole del server ricevente, quindi i record DNS corretti sono fondamentali.
Esempio: email di benvenuto nell’applicazione
L’applicazione deve inviare un’email di benvenuto dopo la registrazione. Crei la chiave, la salvi in una variabile sul server, testi l’invio dall’indirizzo di test al tuo indirizzo. Aggiungi il sottodominio send nel pannello, incolli i record presso il provider DNS e attendi la verifica. Scrivi il template di benvenuto in React Email con il nome dell’utente e il link ai primi passi. Dopo la verifica cambi il mittente con il tuo indirizzo.
In questo esempio l’ordine è importante. Prima il test dall’indirizzo di test alla tua casella, poi la verifica del dominio, infine il cambio del mittente. In questo modo puoi scrivere e testare il codice prima che i record DNS si propaghino, e il passaggio al tuo indirizzo è una singola modifica nella configurazione. Vale anche la pena inviare subito l’email di benvenuto a diverse caselle e verificare che appaia bene anche su telefono.
Errori più comuni
- Chiave API nel codice del browser.
- Test di invio ad altre persone prima della verifica del dominio.
- Errori di battitura nei record DNS.
- Proxy Cloudflare attivo per i record di verifica.
Come verificare che tutto funzioni
Dopo la verifica del dominio invia email di test a diverse caselle: Gmail, Outlook, casella aziendale. Verifica che arrivino nella posta in arrivo e non nello spam, e che appaiano bene su telefono. Nel pannello Resend vedrai lo stato di ogni messaggio.
Nei primi giorni dopo l’implementazione controlla il pannello quotidianamente. Le email rifiutate e le segnalazioni di spam individuate presto sono facili da correggere, mentre se ignorate danneggiano la reputazione del dominio.
Quando le email di base funzionano, vale la pena aggiungere un template separato per ogni tipo di messaggio, invece di uno universale. L’email di reset password e la conferma d’ordine hanno scopi diversi, e template separati sono più facili da correggere e testare.
More on this from NITIDO
magazine·Controlla chi è connesso al tuo WhatsApp in 3 minutiWhatsApp permette di vedere tutti i dispositivi collegati al tuo account e disconnetterli con un tap. Guida completa per proteggere il tuo account.