Centro Comunicazioni¶
Il Centro Comunicazioni unifica tutti i messaggi verso clienti e utenti: email (SMTP), PEC, WhatsApp e SMS. Ogni canale si configura per azienda (multi-tenant): non servono credenziali nel file di ambiente del server.
Tutti gli invii — manuali da fattura/preventivo o automatici da regole — passano dallo stesso motore: coda, log e template condivisi.
Dove trovarlo¶
- Vada in Sistema → Impostazioni
- Apra Centro Comunicazioni (
/settings/communication)
Dalla home del Centro Comunicazioni accede a:
| Sezione | Contenuto |
|---|---|
| Email SMTP | Casella commerciale per PDF e solleciti |
| PEC aziendale | Invio copie documento via PEC |
| Messaggi con link al documento | |
| SMS | Notifiche brevi con link |
| Template | Testi per caso d'uso (invio, sollecito, ultimo avviso…) |
| Regole | Invii automatici su eventi di sistema |
| Log | Storico tentativi e esiti |
| Impostazioni | Canali abilitati, retry e timeout |
Percorsi precedenti
Le voci Email SMTP e PEC aziendale nel menu reindirizzano al Centro Comunicazioni.
Configurare i canali¶
Email SMTP¶
- Centro Comunicazioni → Configura email SMTP
- Inserisca server, porta, crittografia (SSL/TLS), utente e password
- Imposti mittente (indirizzo e nome visualizzato)
- Abiliti l'invio ed esegua un test
PEC aziendale¶
- Centro Comunicazioni → Configura PEC aziendale
- Inserisca i parametri SMTP della casella PEC (forniti dal provider)
- Abiliti l'invio ed esegua un test
La PEC resta obbligatoria per la fatturazione elettronica B2B verso SDI; nel Centro Comunicazioni la usa anche per copie documento e solleciti al cliente, se consentito dalle preferenze.
WhatsApp e SMS¶
- Centro Comunicazioni → Configura WhatsApp o SMS
- Inserisca token/chiavi del provider (Meta Cloud API, OVH SMS, ecc.)
- Abiliti il canale a livello azienda in Impostazioni → Canali abilitati
Per WhatsApp e SMS il messaggio è in genere breve e include un link temporaneo al PDF ({{document_link}}).
Template per caso d'uso¶
I template definiscono oggetto e corpo del messaggio in base allo scenario, non al singolo documento.
| Caso d'uso | Quando si usa |
|---|---|
| Invio documento | Copia fattura o documento generico |
| Invio preventivo | Invio preventivo al cliente |
| Sollecito pagamento | Promemoria scadenza |
| Sollecito formale | Sollecito con tono più formale |
| Avviso sospensione servizi | Mancato pagamento — sospensione |
| Ultimo avviso / messa in mora | Escalation crediti |
| Invito utente | Nuovo utente invitato in piattaforma |
| Messaggio generico | Fallback |
Variabili disponibili¶
Nel testo del template può usare:
| Variabile | Significato |
|---|---|
{{customer_name}} |
Nome cliente |
{{company_name}} |
Ragione sociale azienda |
{{invoice_number}} |
Numero fattura |
{{invoice_total}} |
Totale fattura |
{{quote_number}} |
Numero preventivo |
{{order_number}} |
Numero ordine |
{{ddt_number}} |
Numero DDT |
{{tracking_code}} |
Tracking spedizione |
{{payment_due}} |
Scadenza pagamento |
{{document_link}} |
Link pubblico temporaneo al PDF |
Alla prima visita al Centro Comunicazioni vengono creati template predefiniti se mancanti.
Regole automatiche¶
Le regole inviano messaggi quando accade un evento, senza intervento manuale.
- Vada in Centro Comunicazioni → Regole
- Scelga l'evento (es. Fattura creata, DDT consegnato, Fattura scaduta)
- Selezioni canale (email, PEC, WhatsApp, SMS)
- Colleghi un template (o lasci il default)
- Indichi se allegare PDF e/o inviare link
- Attivi la regola
Gli eventi sono mostrati in italiano nel form (es. invoice.created → Fattura creata).
Attenzione
Verifichi che il canale scelto sia configurato e che il cliente abbia il recapito corretto (email, PEC, telefono).
Invio manuale da documento¶
Da fattura, preventivo o modali di sollecito:
- Apra il documento
- Clicchi Invia o Sollecito pagamento
- Se disponibile, scelga il tipo comunicazione (caso d'uso)
- Selezioni canale (email e/o PEC, secondo configurazione)
- Confermi
Il testo proviene dal template del Centro Comunicazioni per quel caso d'uso.
Preferenze cliente¶
Nella scheda Cliente (anagrafica) può indicare quali canali sono consentiti per quel contatto, ad esempio:
- Consenti email
- Consenti PEC
- Consenti WhatsApp / SMS
Se un canale non è consentito, il Centro Comunicazioni non lo userà per quel cliente anche se la regola lo prevede.
Log e monitoraggio¶
Centro Comunicazioni → Log mostra storico invii: canale, destinatario, esito, errori. Utile per diagnosticare messaggi non recapitati o credenziali scadute.
Impostazioni avanzate (azienda)¶
In Impostazioni del Centro Comunicazioni:
- Canali abilitati — attiva/disattiva email, PEC, WhatsApp, SMS per l'azienda
- Retry — tentativi in caso di errore temporaneo
- Timeout job — limite elaborazione coda invii
Centro Comunicazioni vs invio SDI¶
| Centro Comunicazioni | SDI | |
|---|---|---|
| Scopo | Copia leggibile, solleciti, notifiche | Obbligo fiscale fattura elettronica |
| Canali | Email, PEC, WhatsApp, SMS | Solo canale SDI |
| Sostituisce SDI? | No | — |
L'invio email o PEC al cliente non sostituisce l'invio fattura elettronica allo SDI. Veda Invio allo SDI e Invio al cliente.
Messaggi di errore comuni¶
| Messaggio | Causa probabile | Azione |
|---|---|---|
| Canale non configurato | SMTP/PEC/WhatsApp/SMS assente | Completi la config nel Centro Comunicazioni |
| Destinatario mancante | Cliente senza email/PEC/telefono | Aggiorni anagrafica cliente |
| Canale non consentito | Preferenze cliente | Abiliti il canale sulla scheda cliente |
| Invio fallito | Credenziali o provider | Controlli Log e dati con il provider posta/API |
Cosa succede dopo: con canali e template configurati, può automatizzare i solleciti con le regole e inviare manualmente documenti con testi coerenti e tracciati nel log.