Sistema Email

Il Carrubo dispone di un servizio mail integrato tramite la libreria nodemailer, progettato per la comunicazione transazionale con gli ospiti (Conferme di prenotazione, Lettere di benvenuto, Reminder check-out).

Configurazione SMTP

Il servizio si basa sul protocollo SMTP ed è agnostico rispetto al provider (puoi usare Gmail, SendGrid, Amazon SES, ecc.).

Le variabili d’ambiente necessarie sono:

  • SMTP_HOST: Il server (es. smtp.gmail.com)
  • SMTP_PORT: La porta (solitamente 465 o 587)
  • SMTP_USER: Indirizzo email o username
  • SMTP_PASS: Password o App Password
  • SMTP_SECURE: true per porta 465, false per le altre
  • SMTP_FROM_EMAIL: L’indirizzo del mittente che l’ospite vedrà
  • SMTP_FROM_NAME: Il nome mittente (Default: "Il Carrubo")

Interfaccia Invio (Admin)

L’amministratore ha a disposizione un’interfaccia dedicata sotto /ad/dashboard/email.html per l’invio di comunicazioni massive o personalizzate.

  1. Selezione Destinatari: Scegli da un elenco pre-compilato degli ospiti attuali o passati.
  2. Oggetto: Inserisci l’oggetto della mail.
  3. Editor HTML: Componi il messaggio con un text editor arricchito (HTML).
  4. Invio: Un click invia il payload all’API /api/send-email.

Il backend si occupa di ciclare l’array di destinatari e gestire la coda per evitare ban dai provider SMTP a causa di invii troppo rapidi.