SMTP e template email

Dove nell'admin: System › Settings › Email (/settings/email) — tab SMTP e Email templates. Registro di consegna: Overview › Support › Sent emails (/support/emails).

Descrizione

NexCMP invia email per la verifica della registrazione, il reset della password, "VM ready" (con la password iniziale), fatture, credito in esaurimento, rinnovi, ricariche, risposte del supporto e altro ancora. Tutte passano attraverso un account SMTP fornito da te. I messaggi e i template sono disponibili in 16 lingue; viene utilizzata la lingua del cliente.

Requisiti

Elemento	Requisito
Server SMTP	Host, porta e credenziali di qualsiasi provider (il tuo server, Brevo, Amazon SES, Mailgun, Google Workspace …)
Rete	TCP in uscita dal server NexCMP verso l'host e la porta SMTP (587 STARTTLS, 465 TLS o 25)
Dominio mittente	Un dominio di tua proprietà, con SPF e DKIM pubblicati per il provider e un record DMARC
Permesso	L'account SMTP deve essere autorizzato a inviare come indirizzo From

Divergenza di consegna

Le email come "VM ready" contengono password. Se SPF/DKIM/DMARC del dominio mittente non corrispondono al provider SMTP, finiscono nello spam. La pagina te lo ricorda.

Prepara il provider email

1. Nel pannello del tuo provider aggiungi e verifica il tuo dominio di invio (ad esempio example.com).
2. Pubblica i record DNS SPF, DKIM e DMARC indicati dal provider.
3. Crea un utente SMTP (o una chiave API-SMTP) e annota host, porta, nome utente e password.

Collega in NexCMP

1. Apri System › Settings › Email, tab SMTP.
2. Compila il modulo:

Campo	Esempio	Note
Host	smtp.example.net	Server SMTP
Porta	587
Sicurezza	STARTTLS (587)	Scegli la modalità richiesta dal tuo provider
Username	smtp-user
Password	(nascosto)	Sola scrittura: la pagina mostra solo se ne è impostato uno
From email	no-reply@example.com	Deve essere autorizzato presso il provider
From name	Example Cloud	Utilizza come predefinito il nome del tuo brand
Reply-To (facoltativo)	support@example.com	Dove arrivano le risposte dei clienti

3. Fai clic su Save, quindi su Send test e inserisci il tuo indirizzo.

Le impostazioni sono salvate in un file ad accesso limitato (smtp.json, modalità 0600) e solo il worker in background nexcmp-vmd invia la posta; il servizio web si limita ad accodarla.

Verifica

• Il messaggio di test arriva nella casella di posta (controlla anche lo spam). Nel codice sorgente del messaggio, conferma dkim=pass e spf=pass.
• Apri Support › Sent emails: ogni messaggio ha uno stato (accodato, inviato, fallito) e il risultato della consegna. Per i messaggi falliti vengono effettuati fino a 3 tentativi.
• Registra un cliente di prova nel portale e conferma che l'e-mail di verifica arrivi.

Modifica i modelli di e-mail

La scheda Email templates elenca ogni modello per chiave, indicando le lingue in cui è disponibile (ad esempio verify_email, reset_password, vm_ready, invoice_paid, low_balance, topup_received, ticket_reply, scale_up …).

1. Fai clic su un modello e scegli una lingua.
2. Modifica l'oggetto e il corpo. I segnaposto vengono compilati quando un messaggio viene accodato.
3. Salva. La modifica si applica immediatamente ai messaggi accodati successivamente.

Limiti e note

• Un account SMTP per installazione. I clienti dei rivenditori ricevono le e-mail tramite lo stesso account, a meno che il rivenditore non sia configurato diversamente.
• Si applicano i limiti di invio del provider; NexCMP non effettua limitazioni oltre ai nuovi tentativi.
• Senza SMTP il pannello funziona, ma la verifica della registrazione e il ripristino della password non possono essere completati dai clienti.

Troubleshooting

Sintomo	Causa	Soluzione
L'e-mail di test non arriva mai	Credenziali errate, porta bloccata, mittente non autorizzato	Controlla journalctl -u nexcmp-vmd per l'errore SMTP; prova la porta 587 con STARTTLS; verifica l'indirizzo From presso il provider.
I messaggi finiscono nello spam	SPF/DKIM/DMARC mancanti o non allineati	Pubblica i record del provider e invia da quel dominio.
"failed" in Email inviate	Il provider ha rifiutato il messaggio	Apri la riga per visualizzare la risposta del provider.
Il campo della password sembra vuoto dopo il salvataggio	Per scelta progettuale (sola scrittura)	L'etichetta mostra "current: set" una volta memorizzata una password.