# 18 Altre impostazioni di vtenext # 18 Altre impostazioni di vtenext E’ possibile definire ulteriori impostazioni all’interno di vtenext: - **Webforms** - **Webform con campi GDPR** - **Customer Portal** - **Come abilitare il Customer portal a un utente** - **Interfaccia del Customer Portal** - **Impostazioni modulo GDPR** - **Dettagli Società** - **Server SoftPhone** - **LDAP** - **Valute** - **Calcolo delle Tasse** - **Server Proxy** - **Internal REST Webservice Methods** # 18.1 Template Email Proprio come il modulo delle newsletter, l'utente amministratore sarà in grado di accedere all'editor dei template di email. Un template di email può essere utilizzato per messaggi o per la newsletter e può essere salvato in una cartella pubblica o privata. All'interno del template è possibile selezionare ed aggiungere delle variabili. # 18.2 Webforms Attraverso lo strumento Webforms di vtenext è possibile creare un form web da inserire all’interno del proprio sito, per esempio il classico form “contattaci”. I dati inseriti nel webform saranno automaticamente inviati al CRM nel modulo Leads. Per creare un nuovo webform, da Impostazioni > Webform cliccare sul pulsante![](https://usermanual.vtenext.com/uploads/images/gallery/2019-04-Apr/scaled-840-0/image-1555486610813.png) [![18.2 [1].png](https://usermanual.vtenext.com/uploads/images/gallery/2022-06/scaled-1680-/18-2-1.png)](https://usermanual.vtenext.com/uploads/images/gallery/2022-06/18-2-1.png) Una volta creato scegliendo tutti i campi desiderati, determinando quali sono obbligatori, è possibile cliccare su VISUALIZZA FORM in alto a destra, per accedere ad una finestra che svelerà l'html da copiare ed incollare sulla pagina del sito desiderata (o landing page). Tale codice html, non è formattato ed andrà gestito con dei fogli css direttamente dal vostro webmaster. **ATTENZIONE:** ogni modifica che viene apportata ai campi del webform da crm, implica che il codice html venga nuovamente caricato nel sito. **COME RICEVERE NOTIFICHE ALLA RICEZIONE DI NUOVI LEADS.** Durante la creazione del form, è necessario scegliere il campo FONTE LEAD e determinare la fonte desiderata di default (per esempio WebSite). Tale campo dovrà essere impostato come nascosto. In questo modo, è possibile creare un filtro nel modulo dei lead, che come Fonte Lead avrà quelli provenienti da WebSite ed impostare la campanellina delle notifiche su quel filtro. A questo punto, ogni volta che una persona scrive nel form del sito, si creerà automaticamente un nuovo Lead ed il crm vi avviserà con una notifica. # 18.2.1 Webform con campi GDPR All’interno dei webform, dalla versione 18.12 in poi, sono stati abilitati i campi GDPR. Ad esempio è possibile richiedere il consenso Marketing, il Consenso terze parti, il Consenso Profilazione, etc e salvare all’interno della scheda del lead la scelta effettuata con IP e data-ora. **Di seguito i dettagli della configurazione:** i campi gdpr sono raggruppati in blocchi da tre (visione, data-ora, IP). Pertanto, occorre settare i campi visione informativa come obbligatori, per visualizzare il campo nel webform come picklist (SI/NO) e costringere quindi l’utente ad una scelta. I campi data e IP dovranno essere campi nascosti (quindi settare il flag nascosto a si nella configurazione del webform). Nel campo data come valore di default dovrà essere inserito **“$(general : (\_\_VteMeta\_\_) date\_Y\_m\_d) $(general : (\_\_VteMeta\_\_) time”** Nel campo IP come valore di default dovrà essere inserito **“$(general : (\_\_VteMeta\_\_) clientip”.** Così facendo, si ottiene nel blocco del gdpr il settaggio del consenso + data-ora e IP della richiesta. [![18.2.1 [1].PNG](https://usermanual.vtenext.com/uploads/images/gallery/2022-06/scaled-1680-/18-2-1-1.PNG)](https://usermanual.vtenext.com/uploads/images/gallery/2022-06/18-2-1-1.PNG)
**Assegnato a** Assegnatario del Lead
**URL di ritorno** Alla pressione del pulsante di conferma del webform, l’utente verrà reindirizzato all’indirizzo qui indicato (ad. Esempio la pagina di ringraziamento)
Una volta creato il webform, clicca sul pulsante “Visualizza Form” per visualizzare il codice html da includere all’interno della propria pagina web. # 18.3 Customer Portal - Business Portal E’ possibile configurare le funzioni del proprio portale clienti attraverso la voce Customer Portal presente nelle impostazioni. Nelle versioni di vtenext aggiornate (ovvero quando si passa da un vecchia release alla attuale), si potrà scegliere tramite un menù a tendina, quale versione del portale far utilizzare ai propri clienti. [![image-1689086961695.png](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/scaled-1680-/image-1689086961695.png)](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/image-1689086961695.png) Mentre per le versioni, installate ex-novo, non ci sarà possibilità di scelta e si potrà utilizzare solamente il nuovo Portale (ovvero la Versione 2). --- **PORTALE CLIENTI VERSIONE 1** **Nelle Impostazioni di Base è possibile:** 1. scegliere quali voci (moduli) devono essere attivi lato portale 2. definire l’ordinamento delle voci **Nelle Impostazioni Avanzate è invece possibile definire:** la visibilità dei dati attraverso l’opzione Visualizza tutti i record. [![18.3 [1].png](https://usermanual.vtenext.com/uploads/images/gallery/2022-06/scaled-1680-/37m18-3-1.png)](https://usermanual.vtenext.com/uploads/images/gallery/2022-06/37m18-3-1.png) - **Si:** il cliente visualizza sia i dati relazionati alla propria anagrafica contatto (ticket,documenti, ecc), sia i dati relazionati all’anagrafica azienda a cui è collegato - **No:** il cliente visualizza solo i dati relazionati alla propria anagrafica contatto e non quelli relazionati all’azienda a cui è collegato. Attraverso l’opzione **Seleziona l’utente (può essere scelto anche un utente disattivo)** è possibile selezionare un utente del crm, anche disattivo, con una configurazione specifica di voci per i campi standard. Il portale visualizzerà esattamente quelle voci nei menu a tendina disponibili. Quando un Ticket viene creato dal Portale Clienti, viene assegnato a questo utente. E’ possibile, comunque, assegnare il Ticket ad un altro utente CRM. L’utente assegnatario riceverà un’immediata email di notifica. Questa funzione risulta molto utile per la gestione dei Ticket attivi. Attraverso l’opzione Seleziona il template email è possibile decidere quale template email deve utilizzare il sistema per comunicare i dati di accesso al portale. [![18.3 [2].png](https://usermanual.vtenext.com/uploads/images/gallery/2022-06/scaled-1680-/ZlW18-3-2.png)](https://usermanual.vtenext.com/uploads/images/gallery/2022-06/ZlW18-3-2.png) --- **BUSINESS PORTAL: PORTALE CLIENTI VERSIONE 2 (alcune funzioni sono a pagamento)** La nuova versione del Portale Clienti, offre un'esperienza tutta nuova al cliente che vi accede e permette di settare le visualizzazioni dell'interfaccia, grazie alla creazione di Profili dedicati affidandoli direttamente ai singoli Contatti, direttamente dal blocco INFORMAZIONI PORTALE CLIENTI. [![image-1689086533645.png](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/scaled-1680-/image-1689086533645.png)](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/image-1689086533645.png) Ma vediamo ora come dalle Impostazioni del Portale Clienti, sia possibile creare nuovi Profili **(questa funzione è a pagamento)**. Selezionando la versione 2 del Portale (ove questa opzione sia applicabile), comparirà la pagina di configurazione nuovi profili o gestione degli esistenti. [![image-1689087747004.png](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/scaled-1680-/image-1689087747004.png)](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/image-1689087747004.png) A standard, troviamo solamente il profilo denominato DEFAULT che permette di partire subito con una configurazione di base. Ma vediamo come creare un nuovo profilo a doc. Cliccando su **NUOVO PROFILO** sulla destra, si accederà alla pagina di creazione come da immagine seguente: [![image-1689087982248.png](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/scaled-1680-/image-1689087982248.png)](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/image-1689087982248.png) La pagina ricorda molto quella di creazione profili standard per gli utenti, fondamentalmente ci dovremmo comportare allo stesso modo, scegliendo un nome, una descrizione e da quale profilo partire per la nuova configurazione. Cliccare infine su PROSSIMO in basso a destra. [![image.png](https://usermanual.vtenext.com/uploads/images/gallery/2024-10/scaled-1680-/yOgimage.png)](https://usermanual.vtenext.com/uploads/images/gallery/2024-10/yOgimage.png) In questa pagina è possibile settare un po' di funzioni, che riassumeremo nella seguente tabella:
**Assegnatario** E' possibile selezionare l'utente crm al quale tutti i record che saranno creati da portale verranno direttamente assegnati
**Notifiche** Offre la possibilità di selezionare i Template email, personalizzabili tramite la creazione o modifica tramite l'apposita sezione TEMPLATE EMAIL presente in IMPOSTAZIONI, per lo scambio di informazioni con l'utente portale. Le opzioni sono: - Template utilizzato per la mail di iscrizione al portale - Template utilizzato per la mail di avvenuta modifica password - Template utilizzato per la mail di recupero password - Template utilizzato per notificare al cliente la creazione di un ticket - Template utilizzato per notificare al cliente la risposta al ticket
**Home** Permette di configurare i pulsanti per le azioni rapide presenti nella home del portale. Cliccando infatti su AGGIUNGI PULSANTE sulla destra, sarà possibile abilitare una finestra dalla quale impostare: - Titolo del pulsante - Descrizione del pulsante - Colore del pulsante - Icona che rappresenta la funzione del pulsante - Azione che permette di scegliere linkare un modulo oppure richiamare la creazione di un record su un modulo specifico [![image-1689091040155.png](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/scaled-1680-/image-1689091040155.png)](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/image-1689091040155.png) *Schermata di creazione pulsante* [![image-1689091284418.png](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/scaled-1680-/image-1689091284418.png)](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/image-1689091284418.png) *Schermata di visualizzazione della lista dei pulsanti creati* **N.B.: l'ordine dei pulsanti si può cambiare per trascinamento.**
**Campi Condizionali** E' possibile impostare dei campi condizionali anche per il Portale Clienti, in modo che funzionino esattamente come per l'interfaccia di vte. Nel momento in cui vengono attivati, anche lato portale le condizioni saranno funzionanti. Ci sono tre modi per configurarle: - **Importa da altro profilo portale** - **Importa da ruoli e gruppi** - **Creando una nuova regola direttamente sul portale (pulsante Aggiungi)** [![image.png](https://usermanual.vtenext.com/uploads/images/gallery/2024-10/scaled-1680-/vT7image.png)](https://usermanual.vtenext.com/uploads/images/gallery/2024-10/vT7image.png) [![image.png](https://usermanual.vtenext.com/uploads/images/gallery/2024-10/scaled-1680-/O3eimage.png)](https://usermanual.vtenext.com/uploads/images/gallery/2024-10/O3eimage.png) Cliccando su **Importa da altro profilo portale**, si aprirà una popup che ci permetterà di selezionare altri profili esistenti e quindi di cliccare infine su Importa in basso a destra di quella stessa finestra. [![image.png](https://usermanual.vtenext.com/uploads/images/gallery/2024-10/scaled-1680-/PmSimage.png)](https://usermanual.vtenext.com/uploads/images/gallery/2024-10/PmSimage.png) Cliccando su **Importa da ruoli e gruppi**, si aprirà una popup che ci permetterà di scegliere invece delle regole già preimpostate per il crm, direttamente nei Campi Condizionali *(per approfondire l'argomento, vedere Cap. 17.4 Campi Condizionali).* [![image.png](https://usermanual.vtenext.com/uploads/images/gallery/2024-10/scaled-1680-/JOnimage.png)](https://usermanual.vtenext.com/uploads/images/gallery/2024-10/JOnimage.png) Cliccando invece su **Aggiungi**, sarà possibile creare una nuova regola per i campi condizionali del portale, esclusiva per il portale stesso (non si rifletterà nel crm), facendo la classica configurazione spiegata nel Cap. 17.4. Nell'esempio presentato nell'immagine sottostante, si vede una regola per cui l'anagrafica dell'azienda, diventa completamente in sola lettura, quando il campo Stato assume il valore Bloccato. [![image.png](https://usermanual.vtenext.com/uploads/images/gallery/2024-10/scaled-1680-/DVWimage.png)](https://usermanual.vtenext.com/uploads/images/gallery/2024-10/DVWimage.png)
**Privilegi Globali** Offre la possibilità di configurare tutti i privilegi per ogni singolo profilo utente, cosa può o non può fare o vedere attraverso il portale clienti. E' possibile agire su tutti i moduli di vtenext
--- **Sbloccare un utente portale** Come per gli utenti del CRM, anche un utente portale, dopo cinque tentativi, viene bloccato per motivi di sicurezza. E' dunque possibile sbloccarlo tramite le impostazioni di vtenext, agendo dalla voce **Controllo Login Business Portal**. In questa pagina sarà possibile visualizzare tutti gli utenti bloccati e rimetterli in whitelist, esattamente come si farebbe con un utente standard. [![image.png](https://usermanual.vtenext.com/uploads/images/gallery/2024-09/scaled-1680-/DzQimage.png)](https://usermanual.vtenext.com/uploads/images/gallery/2024-09/DzQimage.png) # 18.3.1 Come abilitare il Customer portal a un utente Possono essere abilitati al Customer Portal solamente i contatti presenti in vtenext. All’interno della singola scheda contatto, è necessario flaggare il box di controllo presente nel blocco UTENTE PORTALE ed inserire una data di inizio supporto e una di fine. All’abilitazione del flag, il sistema manda in autonomia un messaggio all’indirizzo indicato nel campo email del Contatto, con le credenziali per accedere al Portale Clienti. Le date ne determinano l’effettivo periodo di accesso. [![image-1689085975325.png](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/scaled-1680-/image-1689085975325.png)](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/image-1689085975325.png) Sarà inoltre necessario scegliere il Profilo che quel determinato Utente Portale avrà a disposizione per il suo utilizzo e visualizzazione. Il Profilo, determina appunto come ogni utenza portale vede i propri dati ed in che modo può interagire con i moduli presenti. [![image-1689086533645.png](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/scaled-1680-/image-1689086533645.png)](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/image-1689086533645.png) # 18.3.2 Interfaccia del Customer Portal **INTERFACCIA VERSIONE 1** Una volta inserite le proprie credenziali di accesso, il vostro cliente potrà innanzitutto inserire una nuova richiesta di assistenza e poi potrà accedere dalle voci del menù a sinistra, alle entità che avrete relazionato alla sua scheda contatto (solo dei moduli abilitati). Le richieste di assistenza prevedo di default un invio di una mail all’indirizzo del contatto, con il riepilogo e l’id identificativo del ticket. Ogni commento successivo verrà sempre notificato via email. Una volta gestita la richiesta del contatto, potrà (se soddisfatto del risultato) chiudere il ticket. --- [![customer_portal_login.png](https://usermanual.vtenext.com/uploads/images/gallery/2019-12-Dec/scaled-840-0/customer_portal_login.png)](https://usermanual.vtenext.com/uploads/images/gallery/2019-12-Dec/customer_portal_login.png) --- [![customer_portal_home.png](https://usermanual.vtenext.com/uploads/images/gallery/2019-12-Dec/scaled-840-0/customer_portal_home.png)](https://usermanual.vtenext.com/uploads/images/gallery/2019-12-Dec/customer_portal_home.png) --- **INTERFACCIA VERSIONE 2** In base alle configurazioni fatte nel capitolo 18.3 e 18.3.1, il Portale Clienti, può presentarsi in maniera differente per ogni utente che lo utilizza. Questo appunto, dipende dal profilo affidato a quello specifico utente. **N.B.: la versione 2 del portale è responsive.** [![image-1689159217808.png](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/scaled-1680-/image-1689159217808.png)](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/image-1689159217808.png) *Questa immagine rappresenta la pagina di Login al Customer Portal* [![image-1689159636452.png](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/scaled-1680-/image-1689159636452.png)](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/image-1689159636452.png) *Al primo accesso, il Portale Clienti vi fa cambiare la Password, in modo da inserirne subito una diversa da quella generata automaticamente dal sistema* [![image-1689163420778.png](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/scaled-1680-/image-1689163420778.png)](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/image-1689163420778.png) *Il crm invia subito un'email di conferma per la password modificata* [![image-1689164781405.png](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/scaled-1680-/image-1689164781405.png)](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/image-1689164781405.png) Come si presenta l'interfaccia del portale una volta entrati: - Sulla sinistra vi sono tutti i moduli che il profilo utente permette di visualizzare. Per ogni modulo c'è la possibilità, da parte dell'utente portale, di cercare tra i suoi record, creare nuovi record, consultare i record esistenti - Al centro si trovano tutti i pulsanti che sono stati configurati nelle impostazioni. Questi pulsanti permettono una più facile fruizione del Portale stesso. - Sulla destra, oltre al pulsante ESCI che permette di effettuare rapidamente il logout dalla piattaforma, c'è anche un piccolo pulsantino che attiva la visualizzazione a schermo intero [![image-1689165034553.png](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/scaled-1680-/image-1689165034553.png)](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/image-1689165034553.png) *Ecco come si presenta la schermata per l'inserimento di un nuovo Ticket* [![image-1689165166935.png](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/scaled-1680-/image-1689165166935.png)](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/image-1689165166935.png) *Questa invece l'interfaccia per la consultazione di un ticket esistente. Notare sulla sinistra il bottone RITORNA ALLA LISTA, che permette di ritornare alla vista per lista di tutte le segnalazioni del cliente. L'area commenti è stata posta in alto per essere immediatamente fruibile, mentre l'area per il caricamento di nuovi Documenti, si trova a destra con possibilità di caricarli per trascinamento. Col pulsante OK RISOLTO, l'utente portale può chiudere autonomamente il ticket. Questo tipo di visualizzazione si ripete anche per gli altri moduli, cambiando chiaramente la tipologia di campi.* [![image-1689166067871.png](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/scaled-1680-/image-1689166067871.png)](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/image-1689166067871.png) *All'apertura di un nuovo Ticket, arriva un'email al cliente che lo avvisa con la possibilità di cliccare sul pulsante per accedere direttamente alle proprie segnalazioni* [![image-1689166394785.png](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/scaled-1680-/image-1689166394785.png)](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/image-1689166394785.png) *Ecco come si presenta l'area Commenti, al centro il botta e risposta da parte dell'utente Portale e dell'Assistenza Clienti, in alto a destra, il piccolo numerino a sfondo blu (3), rappresenta il numero di Commenti presenti* [![image-1689166572709.png](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/scaled-1680-/image-1689166572709.png)](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/image-1689166572709.png) *In questa schermata invece si può vedere la lista di tutti i ticket presenti a Portale. Con questa vista è possibile ricercare qualsiasi dei campi presenti, matchando tra loro più colonne, oppure è possibile cercare in generale, utilizzando la box in alto a destra. Questo tipo di visualizzazione si ripete anche per gli altri moduli, cambiando chiaramente la tipologia di campi.* # 18.3.3 Impostazioni modulo GDPR Per la gestione della privacy, tramite le funzionalità del modulo GDPR, possono essere personalizzate determinate configurazioni, i template proposti per la comunicazione tramite campagne GDPR e l’informativa privacy della vostra azienda. [![18.3.3 [1].png](https://usermanual.vtenext.com/uploads/images/gallery/2022-06/scaled-1680-/18-3-3-1.png)](https://usermanual.vtenext.com/uploads/images/gallery/2022-06/18-3-3-1.png) [![18.3.3 [2].png](https://usermanual.vtenext.com/uploads/images/gallery/2022-06/scaled-1680-/18-3-3-2.png)](https://usermanual.vtenext.com/uploads/images/gallery/2022-06/18-3-3-2.png) # 18.4 Dettagli società In Dettagli Società potete specificare i dati della vostra azienda. [![18.4 [1].png](https://usermanual.vtenext.com/uploads/images/gallery/2022-06/scaled-1680-/18-4-1.png)](https://usermanual.vtenext.com/uploads/images/gallery/2022-06/18-4-1.png)Tali informazioni possono poi essere richiamate all’interno dei template PDFMaker o Email o Newsletter perfatture, preventivi, ordini, ecc. Assicuratevi che la dimensione del logo della vostra azienda rientri nello spazio disponibile per essi. **N.B.:** La dimensione raccomandata è di 150x60 pixel. Il logo deve essere caricato in formato .png o .jpg. # 18.4.1 Loghi e Sfondi In Impostazioni, troviamo anche la voce LOGHI che ci permette di cambiare sia i loghi della pagina di Accesso e Login, compreso il suo sfondo ed anche il logo presente internamente al crm, presente in alto a sinistra. Non appena si effettua l'accesso a quest'area, sarà possibile: [![image-1688735768236.png](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/scaled-1680-/image-1688735768236.png)](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/image-1688735768236.png) **Cambiare il Logo della pagina di Login, dimensioni consigliate 200 x 77 pixels** --- [![image-1688735886782.png](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/scaled-1680-/image-1688735886782.png)](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/image-1688735886782.png) **Cambiare il Logo (TEMA CHIARO), all'interno del crm, quando il menù di sinistra è in modalità chiusa, dimensioni consigliate 32 x 32 pixels** --- [![image-1688736018913.png](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/scaled-1680-/image-1688736018913.png)](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/image-1688736018913.png) **Cambiare il Logo (TEMA SCURO), all'interno del crm, quando il menù di sinistra è in modalità chiusa, dimensioni consigliate 32 x 32 pixels** --- [![image-1688736201109.png](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/scaled-1680-/image-1688736201109.png)](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/image-1688736201109.png) **Cambiare il Logo (TEMA CHIARO), all'interno del crm, quando il menù di sinistra è in modalità aperta, dimensioni consigliate 129 x 50 pixels** --- [![image-1688736319935.png](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/scaled-1680-/image-1688736319935.png)](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/image-1688736319935.png) **Cambiare il Logo della pagina di Login del Portale Clienti, dimensioni consigliate 200 x 77 pixels** --- [![image-1688736470386.png](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/scaled-1680-/image-1688736470386.png)](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/image-1688736470386.png) **Cambiare il Logo all'interno del Portale Clienti, quando il menù di sinistra è in modalità chiusa, dimensioni consigliate 32 x 32 pixels** --- [![image-1688736604432.png](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/scaled-1680-/image-1688736604432.png)](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/image-1688736604432.png) **Cambiare il Logo all'interno del Portale Clienti, quando il menù di sinistra è in modalità aperta, dimensioni consigliate 129 x 50 pixels** --- [![image-1688737389121.png](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/scaled-1680-/image-1688737389121.png)](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/image-1688737389121.png) **E' inoltre possibile scegliere un'immagine di sfondo per la pagina di Login, tra quelle disponibili a sistema oppure caricata direttamente dall'utente admin. Dimensione consigliata 1920 x 1200 pixels. E' possibile cambiare l'ordine della sequenza immagini semplicemente per trascinamento.** --- Per gli sfondi della pagina della Login, è possibile scegliere la modalità di scelta dello sfondo, che può essere; - **Sequenziale**: visualizza le immagini nello stesso ordine in cui sono state caricate - **Random**: visualizza le immagini caricate in quest'area con ordine totalmente casuale [![image-1688737694228.png](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/scaled-1680-/image-1688737694228.png)](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/image-1688737694228.png) --- # 18.5 Impostazioni Server SoftPhone vtenext è integrabile con Asterisk, un’applicazione PBX telefonica open source che permette di veicolare le telefonate. Asterisk è un’implementazione libera di un software PBX che offre le stesse funzioni di altri sistemi proprietari con una spesa decisamente inferiore e una maggiore flessibilità. Oggi è un punto di riferimento nel settore, la completezza dei suoi contenuti e la sua affidabilità lo rendono una piattaforma ideale per una vasta gamma di applicazioni: è utilizzato come elemento portante per realizzare mediatori RTG/IP (centralini in grado cioè di utilizzare sia le linee telefoniche tradizionali sia i canali IP), sistemi Centrex (PBX “Virtuali” e centralizzati), applicazioni per la gestione di Call Center ed altro ancora. **Caratteristiche e obiettivi:** 1. Effettuare telefonate cliccando sui numeri di telefono direttamente da vtenext. 2. Ricevere notifiche all’interno di vtenext con le informazioni sul chiamante quando una telefonata arriva all’utente. Le notifiche appaiono nell’angolo in basso a destra dello schermo. 3. Visualizzare lo storico delle chiamate nel modulo PBX Manager Module (modulo Gestione Chiamate) 4. Associare le telefonate con il Contatto/ Azienda/ Lead nello Storico Attività. 5. Impostare le estensioni utente attraverso la scheda Preferenze utente. 6. Formato numeri di telefono: è possibile salvare il numero in vtenext in ogni formato, con o senza prefissi e anche con prefissi tipo SIP, PSTN se si usa il carattere: per separare tale prefisso dal numero stesso. **Note:** Si raccomanda di non usare caratteri speciali o trattini nel campo telefono/cellulare. --- **Requisiti e configurazione:** - vtenext installato sul sistema - Asterisk installato sul sistema. - Il server contenente Asterisk e quello contenente vtenext devono potersi vedere in rete. - È necessario avere un’estensione utente di Asterisk valida e un telefono voip configurato con tale estensione. Quando il server di Asterisk è configurato per funzionare con vtenext, dovete configurare le impostazioni di vtenext affinché si possa connettere ad Asterisk. Per inserire le impostazioni del server Asterisk, da ![](https://usermanual.vtenext.com/uploads/images/gallery/2019-04-Apr/scaled-840-0/image-1555487032823.png) scegliere Impostazioni Server SoftPhone: [![18.5 [1].png](https://usermanual.vtenext.com/uploads/images/gallery/2022-06/scaled-1680-/18-5-1.png)](https://usermanual.vtenext.com/uploads/images/gallery/2022-06/18-5-1.png) All’interno delle Preferenze utente, punto 6. Configurazione Asterisk, è possibile associare l’estensione (interno) per l’utente: [![18.5 [2].png](https://usermanual.vtenext.com/uploads/images/gallery/2022-06/scaled-1680-/18-5-2.png)](https://usermanual.vtenext.com/uploads/images/gallery/2022-06/18-5-2.png) Receive Incoming Calls abilita il riconoscimento del chiamante per le chiamate in ingresso. Questa opzione permette, una volta risposto alla chiamata in ingresso, di visualizzare a video sulla schermata del CRM un pop-up, che compare in basso a destra, con indicazione del chiamante e il link per accedere all’anagrafica di dettaglio. Se il numero del chiamante non è presente in vtenext, nel popup viene proposta la creazione di un lead, di un contatto o di un’azienda. **Attenzione!** Impostazioni Server SoftPhone è disponibile soltanto nelle soluzioni on premise di vtenext. **Attenzione!** Affinché il riconoscimento del chiamante sia attivo, è inoltre necessario attivare il relativo CRON sul server di installazione di vtenext. Si veda a tal proposito il capitolo CRONJOB – Processi da pianificare. # 18.6 LDAP E’ possibile configurare i dati del server LDAP in vtenext per la sincronizzazione delle password utente. Per la configurazione da Impostazioni scegliere Server LDAP. Compilare quindi le informazioni del server LDAP come da indicazioni di figura: [![18.6 [1].png](https://usermanual.vtenext.com/uploads/images/gallery/2022-06/scaled-1680-/18-6-1.png)](https://usermanual.vtenext.com/uploads/images/gallery/2022-06/18-6-1.png) In fase di creazione di un utente, una volta configurati i dati del server LDAP, è possibile ricercare l’utente: [![18.6 [2].png](https://usermanual.vtenext.com/uploads/images/gallery/2022-06/scaled-1680-/Pw218-6-2.png)](https://usermanual.vtenext.com/uploads/images/gallery/2022-06/Pw218-6-2.png) Il collegamento con LDAP consente: - la precompilazione di alcune informazioni dell’utente (nome, cognome, email) - la sincronizzazione delle password di accesso dell’utente # 18.7 Valute E’ possibile gestire diversi tipi di valute nel caso vi siano utenti che devono redigere offerte con una valuta diversa da quella proposta per default dal sistema (Euro). Da Impostazioni > Valute è possibile visualizzare le valute configurate nel sistema e aggiungerne nuove. [![18.7 [1].png](https://usermanual.vtenext.com/uploads/images/gallery/2022-06/scaled-1680-/18-7-1.png)](https://usermanual.vtenext.com/uploads/images/gallery/2022-06/18-7-1.png) Per creare una nuova valuta sono richieste le seguenti informazioni:
**Nome della Valuta** il nome della valuta che si vuole gestire, per esempio “USA, Dollars (USD)”.
**Tasso Conversione** Il tasso di conversione deve essere sempre collegato alla valuta base di vtenext
**Stato** Attivo/Inattivo
[![18.7 [2].png](https://usermanual.vtenext.com/uploads/images/gallery/2022-06/scaled-1680-/18-7-2.png)](https://usermanual.vtenext.com/uploads/images/gallery/2022-06/18-7-2.png) Una volta configurate la valute, è possibile: - creare preventivi, ordini di vendita, fatture, ddt, ordini di acquisto con le nuove valute. - associare a ogni utente, tramite scheda Preferenze, la valuta di default. Questa impostazione consentirà all’utente di visualizzare tutti i campi di tipo valuta (ad esempio il campo Fatturato in anagrafica Azienda) nella valuta scelta di default, secondo il tasso di conversione indicato nelle impostazioni. # 18.8 Calcolo delle tasse E’ possibile impostare le voci di tassa da utilizzare su Preventivi, Ordini, Fatture e Ddt. [![18.8 [1].png](https://usermanual.vtenext.com/uploads/images/gallery/2022-06/scaled-1680-/18-8-1.png)](https://usermanual.vtenext.com/uploads/images/gallery/2022-06/18-8-1.png) Si possono gestire anche dei valori di tassa negativi, ad esempio per la gestione dell’Enasarco o della ritenuta d’acconto. Il calcolo delle tasse in Preventivi, Ordini, Fatture e Ddt può essere calcolato per riga oppure per gruppo, a seconda dell’impostazione scelta dall’utente in fase di creazione del documento: [![18.8 [2].PNG](https://usermanual.vtenext.com/uploads/images/gallery/2022-06/scaled-1680-/18-8-2.PNG)](https://usermanual.vtenext.com/uploads/images/gallery/2022-06/18-8-2.PNG) # 18.9 Server Proxy Se la vostra azienda sta usando un server proxy per accedere ad Internet, potrete usare il menù Impostazioni del Server Proxy, come mostrato nella figura. [![18.9 [1].png](https://usermanual.vtenext.com/uploads/images/gallery/2022-06/scaled-1680-/18-9-1.png)](https://usermanual.vtenext.com/uploads/images/gallery/2022-06/18-9-1.png) # 18.10 Internal REST Webservice Methods These Web services allow you to do HTTP requests to the specified endpoints (VTE\_URL/restapi/v1/vtews/METHOD\_NAME). The requests need POST method, basic authentication (you must set ‘Authentication basic’ into the header which is calculated through a function based on username\* and password\*) and their relative parameters. Each one method will give a JSON response with a status and the data or in case of error an error code and its relative message. **Notes:** • The “id” parameter is always specified as ‘moduleid\* x recordid’ (ex: 2x313) \*: You can get the the moduleid from webservice ‘describe’ method (idPrefix) **Headers:** • Authorization: Basic base64\_encode("username\*:password\*") • Content-Type : application/json username\* (VTE) password\* (User preferences’ Webservice Access Key) Authorization Example: ‘Basic ZmVkZXJpY28ucGVybGluOjB5cm5MRjNhS2RhMDZ2c3E=‘ **Requirements for Apache2:** • Activate apache rewrite module • Set AllowOverride All into the virtualhost file to the vte path folder. Example: ``` Options -Indexes +FollowSymLinks +MultiViews AllowOverride All Require all granted ``` **Requirements for Nginx + PHP FPM** As Nginx does not handle htaccess file, some special rewrites are needed in order to handle WS requests. Below an example of nginx conf file: ``` server { listen 80; root /var/www/vtenext/; autoindex off; index index.php index.html index.htm; # Make site accessible from http://localhost/ server_name localhost; location / { # First attempt to serve request as file, then # as directory, then fall back to index.html try_files $uri $uri/ index.html; } # deny access to .htaccess files, if Apache's document root # concurs with nginx's one location ~ /\.ht { deny all; } # special folder handling, since .htaccess files are not supported # REST API location /restapi/v1 { rewrite ^(.+)/vtews/(.*)$ /restapi/v1/index.php/vtews/$2; } # PORTAL location ~ /portal/v2/(?!public) { rewrite ^/portal/v2/(.*)$ /portal/v2/public/$1; } # STORAGE location /storage { deny all; location /storage/uploads_emails_ { allow all; } location /storage/images_uploaded/ { allow all; } location ~* /storage/logo/.+\.(jpg|jpeg|png|gif)$ { allow all; } rewrite ^/storage/(.*)$ /getStorage.php?file=$1; } # PROTECTED FOLDERS location /logs { deny all; } location /plugins/dataimporter { deny all; } location /cache/sys { deny all; } location /cache/pdfmaker { deny all; } location /cache/import { deny all; } location /cache/session { deny all; } location /cache/pdf { deny all; } location /dataimport { deny all; } location /modules/VteSync/VteSyncLib/storage { deny all; } location /modules/Messages/src/attachment_tnef/plugins/attachment_tnef/class/ { deny all; } # SMARTOPTIMIZER # disabled by default, enable it if needed #location ~* \.(gif|jpe?g|png|swf|css|js|html?|xml|txt|ico)$ { # rewrite ^(.*)$ /smartoptimizer/?$1; #} # pass the PHP scripts to FastCGI server listening on 127.0.0.1:9000 location ~ [^/]\.php(/|$) { include snippets/fastcgi-php.conf; # With php cgi alone: #fastcgi_pass 127.0.0.1:9000; # With php fpm: fastcgi_pass unix:/var/run/php/php7.0-fpm.sock; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; } } ``` **Web Service Methods:**
**Name****Description****Parameters****Response**
**create**Create a record of the specified moduleelementType (String)element (Encoded)Return all fields and values of the created record
Ex: **Url**: VTE\_URL/restapi/v1/vtews/create **Parameters**: {"elementType":"Accounts", "element":"{\\"accountname\\":\\"account1\\", \\"assigned\_user\_id\\":\\"19x1\\"}"}
**update**Update the specified recordid (String)columns (Encoded)Return all fields and values of the updated record
Ex: **Url**: VTE\_URL/restapi/v1/vtews/update **Parameters**: {"id":"3x310", "columns":"{\\"accountname\\":\\"test fede postman\\"}"}
**revise**Update the specified record. It’s different only for parameters, the result is the sameelement (Encoded)Return all fields and updated values
Ex: **Url**: VTE\_URL/restapi/v1/vtews/revise **Parameters**: {"element":"{\\"id\\":\\"3x27\\",\\"employees\\":\\"5\\",\\"industry\\":\\"Banking\\"}"}
**retrieve**Illustrate the fields of the specified record and their relative valuesid (String)Return all fields and values of the specified record
Ex: **Url**: VTE\_URL/restapi/v1/vtews/retrieve **Parameters**: {"id":"3x310"}
**retrieveinventory**Illustrate the fields of the specified inventory record, their relative values and the product block’s informationid (String)Return all fields and values of the specified record and product’s block information
Ex: **Url**: VTE\_URL/restapi/v1/vtews/retrieveinventory **Parameters**: {"id":"16x104"}
**delete**Delete the specified recordid (String)Return the request status (successful or not)
Ex: **Url**: VTE\_URL/restapi/v1/vtews/delete **Parameters**: {"id":"3x306"}
**query**Execute a query and return the result’s rowsquery (String)Return all rows of the executed query
Ex: **Url**: VTE\_URL/restapi/v1/vtews/query **Parameters**: {"query":"SELECT \* FROM Accounts WHERE accountname like '%vte%';"}
**listtypes**Describe each one module which contains uitype of the specified formatfieldTypeList (Encoded)Return module information of the specified fieldtypes
Ex: **Url**: VTE\_URL/restapi/v1/vtews/listtypes **Parameters**: {"fieldTypeList":"\[\\"integer\\",\\"file\\"\]"}
**describe**Describe the specified module and their relative fieldselementType (String)Return all module information and its fields properties(no hidden fields)
Ex: **Url**: VTE\_URL/restapi/v1/vtews/describe **Parameters**: {"elementType":"Accounts"}
**describeall**The describeall method is different from describe one because it shows hidden fields tooElementType (Encoded)Return all module information and its fields properties(hidden fields too)
Ex: **Url**: VTE\_URL/restapi/v1/vtews/describeall **Parameters**: {"elementType":"Accounts"}
**getlabels**Return all labels and translated ones of the specified module,languageusername (String)language (String)module (String)Return labels and translated ones of the specified module, language
Ex:**Url**: VTE\_URL/restapi/v1/vtews/getlabels **Parameters**: {"username":"admin", "language":"it\_it", "module":"Accounts"}
**getlangs**Return all languages installed into the CRM Return all CRM languages
**loginpwd**Return user webservice access key if username and password are validusername (String)password (String)Return user webservice access key
Ex:**Url**: VTE\_URL/restapi/v1/vtews/loginpwd **Parameters**: {"username":"admin","password":"123456789"}
**getmenulist**Return all modules information (visibility, tabid, name, sequence, ...) Return modules information and properties
**oldoquery**Return records that contain the searched value into specified module’s fieldsmodule (String)search\_fields (Encoded)search\_value (String)Return some record basic information where searched value is contained into the specified module’s fields
Ex: **Url**: VTE\_URL/restapi/v1/vtews/oldoquery **Parameters**: {"module":"Accounts", "search\_fields":"\[\\"accountname\\", \\"website\\"\]", "search\_value":"vtenext"}
Is possibile to register a new custom method with this SDK call: **SDK::setRestOperation($rest\_name, $handler\_path, $function\_name, $parameters,$perm);** *$rest\_name: method name called by REST webservice* *$handler\_path: file path where the funtion is defined* *$function\_name: defined function name* *$parameters: associative array with parameterName and parameterType $perm: (only from vtenext 23.08) one of “read”, “write” or “readwrite”, describing the kind of operation of this webservice. Used with additional accesskey for the users.* Example ```PHP SDK::setRestOperation('check_exists','modules/SDK/examples/RestApi/CustomRestApi.php','vtws_check_exists', array('id'=>'string'),'read'); ```