Perché SendGrid è importante
Immagina che un utente si registri alla tua app. Si aspetta un’email di conferma in pochi secondi. Se quell’email non arriva, la prima esperienza è già compromessa. Lo stesso vale per il reset della password o per le notifiche: senza un servizio email affidabile, la tua app sembra poco professionale. È esattamente ciò che risolve SendGrid. È una piattaforma professionale di consegna email che aiuta i tuoi messaggi ad arrivare in posta in arrivo invece che finire nello spam. Collegando SendGrid, stai dando alla tua app un “postino” verificato che consegna in modo costante e puntuale. Per funzionare, la tua app ha bisogno di due cose:- Una API Key → è il modo sicuro con cui la tua app si autentica su SendGrid automaticamente.
- Un’email mittente → è l’indirizzo “Da” che gli utenti vedranno nella loro posta, e deve essere professionale.
Passaggio 1: Aprire il CMS e andare su SendGrid
Inizia effettuando l’accesso al tuo CMS. Nel menu a sinistra, fai clic su Integrations e poi seleziona SendGrid. Vedrai due campi:api_key e sender_email.
Pensa a questi due elementi come a un lucchetto e a un’etichetta:
- La API Key è il sistema chiave-serratura che dà alla tua app accesso a SendGrid.
- L’email mittente è l’etichetta che dice agli utenti “questa email arriva da noi”.
Passaggio 2: Creare la tua API Key in SendGrid
Ora creiamo la chiave che sblocca SendGrid per la tua app:- Accedi a
https://app.sendgrid.com. - Vai su Settings > API Keys.
- Fai clic su Create API Key. Assegna un nome chiaro, ad esempio “App Integration”.
- Scegli i permessi. Se non sei sicuro, seleziona Full Access, ma come minimo serve Mail Send.
- Copia la API Key.
SG.YOUR_API_KEY_EXAMPLE
Questa chiave è necessaria ogni volta che la tua app invia un’email. Se la chiave è errata, ogni email fallirà. Trattala come una password: sicura e riservata.
Passaggio 3: Aggiungere la API Key nel CMS
Torna nel CMS, nella sezione SendGrid:- Fai clic su Add API Key.
- Lascia Key Name come
api_key(non modificarlo). - Incolla la tua chiave SendGrid in Key Value.
- Aggiungi una descrizione, ad esempio “Main SendGrid Key”.
- Imposta su Active e fai clic su Save Key.
Passaggio 4: Impostare l’email mittente
La domanda successiva è: “Quando la mia app invia un’email, da chi risulta inviata?” Qui impostisender_email. Deve essere professionale e coerente con il tuo brand. Esempi:
support@yourcompany.comnotifications@yourcompany.com
- Key Name:
sender_email(lascia questo valore) - Key Value: l’indirizzo email scelto
- Description: ad esempio “Support Email Address”
- Imposta su Active e salva
support@yourcompany.com, devi prima autenticare yourcompany.com dentro SendGrid. In caso contrario, le email potrebbero finire nello spam o non essere consegnate correttamente.
Passaggio 5: Testare la configurazione
Non fidarti solo delle impostazioni: testa. Prova a registrarti con un nuovo account di test nella tua app oppure richiedi un reset della password. Entro pochi secondi dovresti vedere l’email nella posta in arrivo. Se non arriva:- controlla prima la cartella spam
- poi verifica che il dominio del mittente sia effettivamente verificato in SendGrid
Errori comuni
- Chiavi lasciate inattive: se l’opzione Active non è abilitata, la tua app non proverà a inviare.
- Modifica dei nomi delle chiavi: il sistema riconosce solo
api_keyesender_email. - Uso di domini non verificati: autentica sempre il dominio mittente in SendGrid.
- Copiare la chiave sbagliata: SendGrid mostra la API Key completa una sola volta. Se la perdi, devi generarne una nuova.

