Add voicemail configuration

docs/administrator-manual/configuration/applications/index.md

@@ -19,3 +19,4 @@ The following applications are available in the *Applications* section:
 - **Video Sources**: Configure IP cameras and video sources for integration with NethVoice.
 - **Bulk actions**: Manage and modify multiple extensions and phones simultaneously.
 - **Google TTS/STT**: Integrate Google's Text-To-Speech and Speech-To-Text services for dynamic voice announcements and custom speech recognition.
+- **Voicemail**: Configure voicemail email notifications.

docs/administrator-manual/configuration/applications/voicemail.md

@@ -0,0 +1,92 @@
+---
+title: Voicemail
+---
+
+# Voicemail
+
+NethVoice can send voicemail notifications by email.
+
+By default, NethVoice inherits the SMTP configuration from the cluster-wide **Email notifications** settings of NethServer 8.
+
+## Configure email delivery (recommended) {#configure-email-delivery}
+
+Configure the SMTP server from the NS8 UI:
+
+- Go to **Settings**
+- Open the **Email notifications** card
+- Enable **Send notifications with an SMTP server**
+- Choose one of the available options:
+   - **Use Mail app instance** (if the Mail application is installed in the cluster), or
+   - **Manual configuration** to enter the SMTP parameters (host, port, encryption, TLS verification, credentials)
+
+See the official NethServer 8 documentation for the full description of the available fields and validation behavior:
+
+- https://docs.nethserver.org/projects/ns8/en/latest/email_notifications.html
+
+After saving the settings, restart NethVoice services and verify email delivery by leaving a voicemail message.
+
+## Configure the sender address (From) {#configure-sender-address}
+
+Some SMTP providers refuse messages if the `From:` address (or envelope sender) does not match the authenticated sender domain.
+
+NethVoice determines the `From:` address for voicemail emails with the following priority:
+
+1. `SMTP_FROM_ADDRESS`, if set (see the advanced section below)
+2. the `-f` option configured in the NethVoice advanced interface voicemail email settings
+3. an auto-generated address based on `BRAND_NAME` and a domain derived from:
+    - the domain part of `SMTP_USERNAME` (when it contains an `@`), or
+    - `NETHVOICE_HOST` (when available and it is a valid host name), or
+    - the domain of `SMTP_HOST`
+
+### Option 1: set `SMTP_FROM_ADDRESS` (advanced)
+
+Set `SMTP_FROM_ADDRESS` to a mailbox address, optionally including a display name:
+
+- `nethvoice@example.com`
+- `NethVoice <nethvoice@example.com>`
+
+After changing module environment variables, restart the NethVoice service for the change to take effect.
+
+### Option 2: set the `-f` parameter in NethVoice
+
+If you can’t (or don’t want to) set `SMTP_FROM_ADDRESS`, you can force the sender envelope by adding the `-f` option in the NethVoice advanced interface:
+
+- Go to **Advanced > Settings > Voicemail Admin > Email**
+- Add `-f user@example.com`
+
+## Advanced: override SMTP settings for voicemail {#advanced-smtp-override}
+
+In most installations you should configure email delivery only from **Settings > Email notifications**.
+
+For troubleshooting or special setups, you can override the SMTP smarthost used for voicemail email delivery by setting module environment variables for the NethVoice service.
+
+The supported variables are:
+
+- `SMTP_ENABLED`: enable SMTP smarthost (`1` to enable, empty to disable)
+- `SMTP_HOST`: smarthost hostname (example: `smtp.example.com`)
+- `SMTP_PORT`: smarthost port
+- `SMTP_USERNAME`: smarthost username (example: `foo@example.com`)
+- `SMTP_PASSWORD`: smarthost password
+- `SMTP_ENCRYPTION`: encryption type (`starttls` or `tls`)
+- `SMTP_TLSVERIFY`: verify smarthost TLS certificate (`1` to enable, empty to disable)
+- `SMTP_FROM_ADDRESS`: from address for voicemail emails (`nethvoice@example.com` or `NethVoice <nethvoice@example.com>`) 
+
+Add environment variables by editing the module environment file:
+
+```bash
+runagent -m nethvoiceX vi environment
+```
+If you edit the environment, you need to restart the NethVoice service for the changes to take effect.
+
+### Verify current values
+
+From the NS8 node, identify your module instance (for example `nethvoice1`) and run:
+
+```bash
+runagent -m nethvoiceX podman exec freepbx env | grep '^SMTP_'
+```
+
+## Notes
+
+- If emails are still rejected, verify that the sender address you selected is allowed by the SMTP provider (SPF/DMARC policies can apply).
+- If you change only voicemail settings inside the NethVoice advanced interface, you don’t need to restart services.

i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/configuration/applications/index.md

@@ -19,3 +19,4 @@ Le seguenti applicazioni sono disponibili nella sezione *Applicazioni*:
 - **Sorgenti Video**: Configura telecamere IP e sorgenti video per l'integrazione con NethVoice.
 - **Gestione massiva**: Gestisci e modifica simultaneamente più interni e telefoni.
 - **Google TTS/STT**: Integra i servizi di sintesi vocale e riconoscimento vocale di Google per annunci vocali dinamici e riconoscimento vocale personalizzato.
+- **Casella vocale**: Configura le notifiche email della casella vocale.

i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/configuration/applications/voicemail.md

@@ -0,0 +1,95 @@
+---
+title: Casella vocale
+---
+
+# Casella vocale
+
+NethVoice può inviare notifiche della casella vocale via email.
+
+Per impostazione predefinita, NethVoice eredita la configurazione SMTP dalle impostazioni globali di **Notifiche email** di NethServer 8.
+
+## Configurare l’invio email (consigliato) {#configurare-invio-email}
+
+Configura il server SMTP dalla UI di NS8:
+
+- Vai in **Impostazioni**
+- Apri la scheda **Notifiche email**
+- Abilita **Invia notifiche con un server SMTP**
+- Scegli una delle opzioni disponibili:
+  - **Usa istanza dell’app Mail** (se l’applicazione Mail è installata nel cluster), oppure
+  - **Configurazione manuale** per inserire i parametri SMTP (host, porta, cifratura, verifica TLS, credenziali)
+
+Consulta la documentazione ufficiale di NethServer 8 per la descrizione completa dei campi disponibili e del comportamento di validazione:
+
+- https://docs.nethserver.org/projects/ns8/it/latest/email_notifications.html
+
+Dopo aver salvato le impostazioni, riavvia i servizi NethVoice e verifica l’invio email lasciando un messaggio in casella vocale.
+
+## Configurare l’indirizzo mittente (From) {#configurare-mittente}
+
+Alcuni provider SMTP rifiutano i messaggi se l’indirizzo `From:` (o il mittente della busta/envelope sender) non corrisponde al dominio del mittente autenticato.
+
+NethVoice determina l’indirizzo `From:` delle email della casella vocale con questa priorità:
+
+1. `SMTP_FROM_ADDRESS`, se impostata (vedi la sezione avanzata)
+2. l’opzione `-f` configurata nelle impostazioni email della casella vocale nell’interfaccia avanzata di NethVoice
+3. un indirizzo generato automaticamente in base a `BRAND_NAME` e a un dominio derivato da:
+   - la parte di dominio di `SMTP_USERNAME` (quando contiene `@`), oppure
+   - `NETHVOICE_HOST` (se disponibile e se è un nome host valido), oppure
+   - il dominio di `SMTP_HOST`
+
+### Opzione 1: impostare `SMTP_FROM_ADDRESS` (avanzato)
+
+Imposta `SMTP_FROM_ADDRESS` su un indirizzo email, opzionalmente includendo il nome visualizzato:
+
+- `nethvoice@example.com`
+- `NethVoice <nethvoice@example.com>`
+
+Dopo aver modificato le variabili d’ambiente del modulo, riavvia il servizio NethVoice affinché le modifiche abbiano effetto.
+
+### Opzione 2: impostare il parametro `-f` in NethVoice
+
+Se non puoi (o non vuoi) impostare `SMTP_FROM_ADDRESS`, puoi forzare il mittente aggiungendo l’opzione `-f` dall’interfaccia avanzata di NethVoice:
+
+- Vai in **Avanzate > Impostazioni > Amministrazione Casella Vocale > Email**
+- Aggiungi `-f user@example.com`
+
+In questo modo NethVoice passerà il parametro `-f` al comando di invio usato per le notifiche della casella vocale.
+
+## Avanzato: override SMTP per la casella vocale {#avanzato-override-smtp}
+
+Nella maggior parte dei casi è sufficiente configurare l’invio email solo da **Impostazioni > Notifiche email**.
+
+Per attività di troubleshooting o scenari particolari, è possibile forzare lo smarthost SMTP usato per l’invio delle email della casella vocale impostando variabili d’ambiente del modulo per il servizio NethVoice.
+
+Le variabili supportate sono:
+
+- `SMTP_ENABLED`: abilita lo smarthost SMTP (`1` per abilitare, vuoto per disabilitare)
+- `SMTP_HOST`: hostname dello smarthost (esempio: `smtp.example.com`)
+- `SMTP_PORT`: porta dello smarthost
+- `SMTP_USERNAME`: username dello smarthost (esempio: `foo@example.com`)
+- `SMTP_PASSWORD`: password dello smarthost
+- `SMTP_ENCRYPTION`: tipo di cifratura (`starttls` o `tls`)
+- `SMTP_TLSVERIFY`: verifica il certificato TLS dello smarthost (`1` per abilitare, vuoto per disabilitare)
+- `SMTP_FROM_ADDRESS`: indirizzo mittente per le email della casella vocale (`nethvoice@example.com` oppure `NethVoice <nethvoice@example.com>`)
+
+### Verificare i valori correnti
+
+Per aggiungere variabili d’ambiente, modifica il file `environment` del modulo:
+
+```bash
+runagent -m nethvoiceX vi environment
+```
+
+Se modifichi `environment`, devi riavviare il servizio NethVoice affinché le modifiche abbiano effetto.
+
+Dal nodo NS8, identifica l’istanza del modulo (ad esempio `nethvoice1`) ed esegui:
+
+```bash
+runagent -m nethvoiceX podman exec freepbx env | grep '^SMTP_'
+```
+
+## Note
+
+- Se le email vengono ancora rifiutate, verifica che l’indirizzo mittente scelto sia consentito dal provider SMTP (possono applicarsi policy SPF/DMARC).
+- Se modifichi solo le impostazioni della casella vocale dentro NethVoice, non è necessario riavviare i servizi.