---
title: SMTP e template email
description: Configura l'invio di email (SMTP), invia un messaggio di test, modifica i template email in ogni lingua e leggi il registro di consegna.
url: https://nexcmp.com/it/docs/administration/smtp-and-emails/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# SMTP e template email {#smtp-and-e-mail-templates}

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

## Descrizione {#what-it-does}

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 {#requirements}

| 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** |

::: warning 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 {#prepare-the-e-mail-provider}

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 {#connect-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 |

![La tab SMTP di Settings, Email con host, porta, sicurezza, nome utente, campi mittente e il pulsante Send test](https://nexcmp.com/it/docs/images/administration/smtp-and-emails-01-smtp.webp)

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 {#verify}

- 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 {#edit-e-mail-templates}

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.

![La schermata dei modelli di e-mail con l'elenco delle chiavi e delle relative lingue](https://nexcmp.com/it/docs/images/administration/smtp-and-emails-02-templates.webp)

## Limiti e note {#limits-and-notes}

- 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 {#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. |