# Configurazione del Popup

Creazione e gestione delle configurazioni del popup TeamsPhone Plugin: campi mostrati, azioni rapide e assegnazione a ciascun ruolo aziendale.

# Dove si Trova

La gestione delle configurazioni del popup si trova, come il Connettore Teams, all'interno del menu **Impostazioni** di vtenext.  
Da qui è possibile accedere alla sezione **Configurazioni Popup Teams**, cercandola nella barra di ricerca di Impostazioni.

[![image-1783678410190.png](https://manual.vtenext.ch/uploads/images/gallery/2026-07/scaled-1680-/j8VXZvACLueMZ5Gu-image-1783678410190.png)](https://manual.vtenext.ch/uploads/images/gallery/2026-07/j8VXZvACLueMZ5Gu-image-1783678410190.png)

In questa sezione sono elencate tutte le configurazioni create fino a quel momento.  
Per ciascuna configurazione, l'elenco mostra:

<div id="bkmrk-numero-configurazion" style="text-align: justify;"><div><div><div><div><div><div><div><div><div><div><div><div><div><div><div><div><div>- **Numero Configurazione Teams**: nome identificativo assegnato alla configurazione (es. "TEAMS1").
- **Visibilità per Ruolo**: indica quali ruoli aziendali vedranno il popup impostato in quella configurazione (ad esempio "Tutti", oppure un ruolo specifico).
- **Assegnato a**: l'utente che ha creato la configurazione.

</div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div>Da questa schermata è possibile:

<div id="bkmrk-creare-una-nuova-con" style="text-align: justify;"><div><div><div><div><div><div><div><div><div><div><div><div><div><div><div><div><div>- **Creare** una nuova configurazione, tramite il pulsante **+ Crea**.
- **Modificare** una configurazione esistente, tramite l'icona a forma di matita.
- **Eliminare** una configurazione, tramite l'icona X.

</div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div>Ogni configurazione è indipendente dalle altre: è possibile creare più configurazioni diverse, ciascuna pensata per un ruolo specifico, così da mostrare a ogni utente solo i campi e le azioni rapide realmente utili al proprio lavoro.

# Crea Nuova Configurazione

Per creare una nuova configurazione, cliccare sul pulsante **+ Crea** nella schermata Configurazioni Popup. Si apre così il modulo **Creazione Configurazione Popup Teams**, suddiviso in quattro sezioni.

[![image-1783681337968.JPG](https://manual.vtenext.ch/uploads/images/gallery/2026-07/scaled-1680-/k1XG5BMojbuQVlXg-image-1783681337968.JPG)](https://manual.vtenext.ch/uploads/images/gallery/2026-07/k1XG5BMojbuQVlXg-image-1783681337968.JPG)

[![image-1783681379406.png](https://manual.vtenext.ch/uploads/images/gallery/2026-07/scaled-1680-/YalpJodBZZzxDBTX-image-1783681379406.png)](https://manual.vtenext.ch/uploads/images/gallery/2026-07/YalpJodBZZzxDBTX-image-1783681379406.png)

**Informazioni Configurazione Popup Teams:**

<div id="bkmrk-numero-configurazion" style="text-align: justify;"><div><div><div><div><div><div><div><div><div><div><div><div><div><div><div><div><div>- **Numero Configurazione Teams**: campo non modificabile, generato automaticamente dal sistema al salvataggio ("Autogenerato al salvataggio").
- **Assegnato a**: utente a cui viene attribuita la configurazione (di norma l'amministratore che la crea).
- **Attivo**: stato della configurazione (Attivo/Non attivo); solo le configurazioni attive vengono considerate dal plugin durante una chiamata.
- **Visibilità per Ruolo**: elenco a selezione multipla dei ruoli a cui questa configurazione sarà visibile (es. Tutti, Agent, Manager, Organisation). È possibile selezionare uno o più ruoli.

</div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div>**Configurazione Campi Popup Teams** Questa sezione definisce quali campi verranno mostrati nel popup una volta trovato un record. Per ogni riga si specifica:

<div id="bkmrk-modulo%3A-il-modulo-de" style="text-align: justify;"><div><div><div><div><div><div><div><div><div><div><div><div><div><div><div><div><div>- **Modulo**: il modulo del CRM di riferimento (es. Aziende).
- **Campi**: i campi di quel modulo da mostrare nel popup.

</div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div>È possibile aggiungere più righe con il pulsante **Aggiungi riga**, riordinarle tramite la maniglia di trascinamento a sinistra, oppure eliminarle con l'icona rossa a X.

**Configurazione Menzioni Teams** Questa sezione definisce la ricerca secondaria nei moduli collegati (le "menzioni" descritte nel Capitolo 1): impostando un **Modulo** e i relativi **Campi**, si indica al plugin in quale modulo collegato cercare ulteriori riferimenti al record trovato (ad esempio, cercare nei Preventivi le aziende individuate). Anche qui è possibile aggiungere più righe con **Aggiungi riga**.

**Informazioni Descrittive** Campo libero di testo per inserire una **Descrizione** della configurazione, utile come nota interna per l'amministratore (non visibile agli utenti nel popup).

Una volta completati i campi necessari, si conferma la creazione con il pulsante **Salva**, oppure si annulla con **Annulla**.

> ⚠️ In questa fase di creazione **non è ancora possibile configurare i bottoni delle azioni rapide**: questa opzione compare solo successivamente, nella scheda di Dettaglio della configurazione appena creata (vedi pagina "Dettaglio Pagina Configurazione").

# Dettaglio Pagina Configurazione

Cliccando su una configurazione esistente dall'elenco (es. "TEAMS1"), si accede alla sua **scheda di dettaglio**, suddivisa in diversi blocchi informativi.

[![image-1783680761189.JPG](https://manual.vtenext.ch/uploads/images/gallery/2026-07/scaled-1680-/yRM9H2RKvohfCzy1-image-1783680761189.JPG)](https://manual.vtenext.ch/uploads/images/gallery/2026-07/yRM9H2RKvohfCzy1-image-1783680761189.JPG)

**[![image-1783680812072.png](https://manual.vtenext.ch/uploads/images/gallery/2026-07/scaled-1680-/6kH0FW9HiqlEo4tp-image-1783680812072.png)](https://manual.vtenext.ch/uploads/images/gallery/2026-07/6kH0FW9HiqlEo4tp-image-1783680812072.png)Configurazione Bottoni** Questo blocco mostra i bottoni delle azioni rapide già impostati per questa configurazione, così come compariranno nel popup durante una chiamata. Nell'esempio sono presenti due bottoni: **"Crea Preventivo"** e **"Apri Record"**, ciascuno con la propria icona e il proprio colore. Da qui è anche possibile aggiungere un nuovo bottone tramite il pulsante **Aggiungi Bottone**.

Si apre così una finestra modale con i parametri del bottone, insieme a un'anteprima in tempo reale.

[![image-1783681946157.png](https://manual.vtenext.ch/uploads/images/gallery/2026-07/scaled-1680-/4ZySr3PRRliuSyEA-image-1783681946157.png)](https://manual.vtenext.ch/uploads/images/gallery/2026-07/4ZySr3PRRliuSyEA-image-1783681946157.png)

**Campi disponibili**

- **Titolo**: il testo che comparirà sul bottone nel popup (es. "Apri Record").
- **Colore**: stile cromatico del bottone, selezionabile da un menu a tendina (es. "Primary").
- **Icona**: icona da abbinare al bottone, selezionabile dalla libreria icone disponibile.
- **Azione**: l'operazione che il bottone esegue al clic durante la chiamata (ad esempio **Apri Record**, per aprire la scheda del record trovato, oppure **Crea Record**, per generare un nuovo record collegato — es. un preventivo).

Sulla destra della finestra è visibile un **riquadro di Anteprima**, che mostra in tempo reale come apparirà il bottone nel popup, aggiornandosi automaticamente man mano che si modificano titolo, colore e icona.

**Ordinamento dei bottoni:** Quando sono presenti più bottoni, è possibile **riordinarli semplicemente trascinandoli** all'interno della sezione Configurazione Bottoni. L'ordine impostato determina la sequenza con cui i bottoni compariranno nel popup durante la chiamata.

Al termine della configurazione, si conferma con il pulsante **SALVA**, oppure si elimina il bottone con il pulsante **ELIMINA**.

> 💡 **Modifica di un bottone esistente**: per modificare un bottone già creato, è sufficiente **cliccare direttamente sul bottone** nella sezione Configurazione Bottoni. Si apre la stessa finestra modale, già precompilata con i valori attuali, dalla quale è possibile modificare i parametri o eliminare il bottone.

 **Informazioni Configurazione Popup Teams** Questo blocco riassume i dati anagrafici della configurazione:

- **Numero Configurazione Teams**: nome identificativo della configurazione (es. "TEAMS1").
- **Assegnato a**: l'utente che ha creato la configurazione.
- **Orario modifica**: data e ora dell'ultima modifica apportata.
- **Visibilità per Ruolo**: il ruolo (o i ruoli) a cui questa configurazione è destinata (es. "Tutti").
- **Orario creazione**: data e ora di creazione della configurazione.
- **Attivo**: stato della configurazione (Attivo/Non attivo).

**Configurazione Campi Popup Teams** Questo blocco elenca i campi che verranno mostrati nel popup una volta trovato il record corrispondente. Nell'esempio, per il modulo **Aziende**, vengono mostrati due campi: **Numero Azienda** e **Nome Azienda**.

**Configurazione Menzioni Teams** Questo blocco definisce la ricerca secondaria nei moduli collegati (le "menzioni" già descritte nel Capitolo 1): a partire dal modulo principale **Aziende**, il sistema cerca anche nel modulo **Preventivi**, mostrando il campo **Nome Azienda** come corrispondenza.

**Informazioni Descrittive** Blocco libero con una **Descrizione** testuale della configurazione, utile per annotare a cosa serve o a chi è destinata (nota interna, non visibile nel popup).

# Modifica Di Una Configurazione

Per modificare una configurazione esistente, aprire la relativa scheda di dettaglio e cliccare sul pulsante **Modifica** in alto a destra. Si accede così al modulo **Modifica Configurazione Popup Teams**, identico nella struttura al modulo di creazione ma con i campi già precompilati con i valori attuali.

[![image-1783681037668.JPG](https://manual.vtenext.ch/uploads/images/gallery/2026-07/scaled-1680-/yBi8pQOWff2hdslX-image-1783681037668.JPG)](https://manual.vtenext.ch/uploads/images/gallery/2026-07/yBi8pQOWff2hdslX-image-1783681037668.JPG)

[![image-1783681086527.png](https://manual.vtenext.ch/uploads/images/gallery/2026-07/scaled-1680-/wI9ZXOCXdR2GW2w7-image-1783681086527.png)](https://manual.vtenext.ch/uploads/images/gallery/2026-07/wI9ZXOCXdR2GW2w7-image-1783681086527.png)

Le sezioni disponibili sono le stesse per la creazione:

- **Informazioni Configurazione Popup Teams**: qui è possibile modificare l'utente **Assegnato a**, lo stato **Attivo/Non attivo** e la **Visibilità per Ruolo** (il ruolo o i ruoli selezionati sono evidenziati in grigio). Il campo **Numero Configurazione Teams** non è modificabile.
- **Configurazione Campi Popup Teams**: è possibile aggiungere, modificare, riordinare o eliminare i moduli e i relativi campi mostrati nel popup, con le stesse modalità viste in fase di creazione (maniglia di trascinamento, icona di eliminazione, pulsante **Aggiungi riga**).
- **Configurazione Menzioni Teams**: allo stesso modo, è possibile gestire più righe di ricerca collegata. Nell'esempio, oltre al modulo Aziende, è presente anche il modulo **Preventivi**, entrambi con il campo **Nome Azienda**.
- **Informazioni Descrittive**: campo libero per aggiornare la descrizione interna della configurazione.

Al termine delle modifiche, si conferma con il pulsante **Salva**, oppure si annulla con **Annulla**, tornando alla scheda di dettaglio senza salvare le modifiche.