Documentazione KSIDol > Moduli KSIDol > Invio SMS

Guida del modulo: Invio SMS

Guida d'uso non tecnica: a cosa serve il modulo, come utilizzarlo e come si integra con Dolibarr.

Fornitore SMSOVH SMS (API)

Schede Dolibarr collegate15+ tipi

Variabili di personalizzazione~150

Tracciamento degli invii5 stati + agenda

1. Panoramica del modulo

Il modulo Invio SMS aggiunge a Dolibarr la possibilità di inviare SMS ai vostri clienti, potenziali clienti, contatti e fornitori, direttamente dalle schede che consultate ogni giorno (terzo, preventivo, ordine, fattura, intervento, contratto, spedizione, socio...). Su queste schede compare un pulsante "Invia un SMS": apre un modulo precompilato con il nome e il numero di telefono del destinatario, senza reinserimento. I messaggi partono tramite l'API SMS di OVH, con il vostro nome mittente convalidato. Il modulo si basa interamente sui dati nativi di Dolibarr: riprende i recapiti di terzi e contatti, i riferimenti e gli importi dei documenti e registra ogni invio nell'agenda per conservarne traccia. Propone inoltre modelli di SMS riutilizzabili, variabili che si compilano automaticamente (nome, riferimento, importo, date, link di download...), un tracciamento completo degli invii e una gestione della quota SMS per utente.

Invio di SMS dalle schede Dolibarr (pulsante + finestra integrata) o da un menu dedicato
Numero e nome del destinatario recuperati automaticamente dalla scheda
Modelli di SMS con variabili che si compilano da sole (cliente, riferimento, importo, date, link ai documenti)
Anteprima in tempo reale, contatore di caratteri/segmenti e modalità di prova prima dell'invio reale
Tracciamento di tutti gli invii con stato (inviato, in coda, fallito, prova) e possibilità di reinviare
Quota di SMS per utente e avvisi automatici quando la scorta diventa scarsa
Ogni invio è tracciato nell'agenda di Dolibarr, collegato al cliente e al documento interessato

2. Inviare un SMS da una scheda o dal menu

È la funzione principale. Un pulsante "Invia un SMS" viene aggiunto sulle schede interessate (terzo, preventivo, ordine, fattura, intervento, contratto, spedizione, socio, contatto, nonché ordini, fatture e proposte fornitori). Esiste anche un menu dedicato "Invia SMS" per comporre un messaggio libero.

Da una scheda, il modulo si apre in una finestra spostabile e ridimensionabile, con nome e telefono già compilati
Il numero può essere corretto o inserito a mano (formato internazionale, es. +336...)
Area messaggio con contatore di caratteri e numero di segmenti SMS
Anteprima del messaggio visualizzata in diretta, tenendo conto delle variabili sostituite
Pulsante di invio e visualizzazione immediata di un messaggio di conferma o di errore
Menu "Invia SMS" per un invio senza documento (messaggio occasionale)

3. Modelli di SMS riutilizzabili

Il modulo permette di creare una libreria di modelli di messaggi, per non ridigitare i testi ricorrenti (promemoria appuntamento, informazione di consegna, sollecito, ecc.). I modelli si gestiscono nel menu "Modelli di SMS".

Creare, modificare, attivare/disattivare ed eliminare modelli
Ogni modello ha un codice, un'etichetta, un contenuto e un tipo (generico o legato a un documento: preventivo, ordine, fattura, intervento, fornitore...)
Nel modulo di invio si sceglie un modello da un elenco e lo si applica con un clic
Funzione "Prova": generare un'anteprima del modello a partire da un oggetto reale (indicandone l'identificativo) per verificare il risultato prima di utilizzarlo
Solo i modelli attivi e compatibili con il tipo di scheda vengono proposti per l'invio

4. Personalizzazione automatica (variabili)

I modelli e i messaggi possono contenere variabili che vengono sostituite automaticamente con i dati reali al momento dell'invio. Il modulo mostra l'elenco delle variabili disponibili e il loro valore per la scheda in corso.

Recapiti del destinatario: nome del terzo, nome del contatto, telefono
Informazioni del documento: riferimento, riferimento cliente, etichetta, note, date (creazione, convalida, scadenza, consegna...)
Importi del documento: imponibile, IVA, totale, importo residuo dovuto, in cifre o in lettere
Recapiti della vostra società (nome, indirizzo, identificativi, telefono...) e firma dell'utente
Link pratici: download diretto del documento (preventivo, ordine, fattura, contratto, intervento), link di firma online, link di pagamento online
Possibilità di aggiungere automaticamente la firma della società in fondo al messaggio

5. Opzioni di invio avanzate

Al momento dell'invio sono disponibili diverse impostazioni di dettaglio per adattarsi al tipo di messaggio e alla normativa.

Priorità del messaggio: alta, media o bassa
Tipo di messaggio: transazionale (es. conferma, codice) o marketing
Ritardo prima dell'invio in minuti: l'SMS viene consegnato in differita da OVH
Menzione STOP: per gli SMS marketing la menzione viene aggiunta; può essere disattivata per i messaggi transazionali
Mittente: nome mittente convalidato sul vostro account OVH, proposto per impostazione predefinita

6. Modalità di prova prima dell'invio reale

La modalità di prova permette di preparare e verificare un SMS senza che alcun messaggio venga effettivamente inviato o fatturato. Utile per convalidare un modello o una formattazione.

Interruttore "Modalità di prova" nel modulo di invio (attivabile per impostazione predefinita nella configurazione)
Un banner di avviso ricorda che nessun SMS verrà consegnato
Il messaggio di prova viene registrato nel tracciamento con lo stato "Prova" e non consuma quota
Viene inoltre creato un evento nell'agenda per conservare traccia della prova

7. Tracciamento degli invii (cronologia)

Il menu "Tracciamento degli invii" elenca tutti gli SMS elaborati, con il loro stato e contenuto, per un controllo completo.

Colonne: data, destinatario, mittente, stato, contesto (tipo di scheda), messaggio e azioni
Stati gestiti: Nuovo, In coda, Inviato, Fallito, Prova
Filtri per stato, per contesto (cliente, preventivo, ordine, fattura...) e ricerca libera (contenuto, destinatario, mittente)
In caso di errore, viene visualizzato il messaggio di errore restituito da OVH
Azione "Invia" per riprovare un SMS in coda, fallito o nuovo
Azione "Elimina" per rimuovere una riga dalla cronologia
Promemoria delle opzioni utilizzate (priorità, tipo, ritardo, STOP) sotto ciascun messaggio

8. Quote per utente e avvisi di scorta

Il modulo permette di assegnare una quota di SMS a ciascun utente e di monitorare il credito residuo, sia lato OVH sia lato utente.

Assegnazione di un numero di SMS autorizzati per utente, con tracciamento dell'"utilizzato" e del "disponibile"
Blocco dell'invio quando la quota dell'utente è esaurita, con messaggio di avviso
Badge che mostra gli SMS residui nelle pagine di invio e di configurazione
Avviso visivo (scheda + pallino nel menu in alto) quando la scorta scende sotto una soglia configurabile
Link di ordine di SMS mostrato all'utente per riacquistare credito
Controllo dello scarto tra il credito reale dell'account OVH e il totale delle quote assegnate

9. Configurazione e strumenti di amministrazione

La pagina di configurazione (riservata agli amministratori) centralizza la connessione a OVH e le impostazioni predefinite. Propone anche strumenti di verifica.

Connessione OVH SMS: endpoint, Application Key, Application Secret, Consumer Key e servizio (sms-XXXXX), con un pulsante di aiuto per generare la chiave di accesso OVH
Gestione del prefisso internazionale: rilevamento automatico, aggiunta sistematica del prefisso predefinito o nessuna modifica
Valori predefiniti: modalità di prova, priorità, tipo, ritardo, menzione STOP, mittente predefinito
Visualizzazione del credito SMS disponibile sull'account OVH
URL di riacquisto di SMS e soglia di avviso di scorta
Strumento "Prova la configurazione" (diagnostica endpoint, credenziali, servizio, accesso API, tabelle)
Strumento "Reimposta il modulo" per ripartire da zero sull'entità corrente (dati e parametri)

10. Collegamenti con Dolibarr

Il modulo non funziona in modo isolato: si integra con i blocchi nativi di Dolibarr.

Terzi e contatti : Il modulo legge il nome e il numero di telefono (cellulare in via prioritaria) del terzo o del contatto per precompilare l'invio. Un pulsante SMS viene aggiunto sulle schede terzo e contatto, e il cliente viene collegato all'evento di agenda creato.
Preventivi, ordini e fatture clienti : Un pulsante SMS compare sulle schede proposte commerciali, ordini e fatture. Le variabili riprendono il riferimento, le date e gli importi (imponibile, IVA, totale, residuo dovuto) del documento e possono inserire un link di download diretto, un link di firma online o un link di pagamento online.
Interventi, contratti e spedizioni : Le schede intervento, contratto e spedizione/consegna dispongono anch'esse del pulsante SMS, con recupero del cliente e dei suoi recapiti e link di download del documento quando esiste.
Documenti fornitori : Il modulo si aggiunge anche a ordini, fatture e proposte fornitori, riprendendo il terzo fornitore e i riferimenti corrispondenti.
Agenda (eventi) : Ogni SMS (inviato, fallito o di prova) genera automaticamente un evento nell'agenda di Dolibarr, collegato al cliente, al contatto, al documento di origine e al progetto se del caso, con lo stato, il mittente e un estratto del messaggio.
Soci : Le schede socio sono supportate: invio di SMS a un membro, con collegamento alla sua società collegata se esiste.
Documenti, firma e pagamento online : Le variabili possono inserire link di download diretto dei documenti PDF, nonché i link nativi di firma online e di pagamento online generati da Dolibarr.
Società emittente e utenti : I recapiti della vostra società (informazioni legali, indirizzo, identificativi) e la firma dell'utente connesso alimentano le variabili e la firma aggiunta all'SMS; le quote di invio sono gestite per utente Dolibarr.