Get Docy
Aggiornato Agosto 5, 2026

Popup scheda contatto

Estimated reading: 5 minutes 121 views
Sezione OCC

Gestione > Script > Popup Manager

All’arrivo di un’interazione apri automaticamente la scheda contatto del tuo crm in modo da fornire all’operatore di contact center tutte le informazioni utili alla gestione della richiesta, ottimizzando la produttività del Customer Care.

Questo è l’obiettivo che puoi realizzare in modo molto semplice grazie all’utilizzo del Popup Manager di TVox.

Puoi sfruttare la funzionalità durante la gestione di un’interazione in tutti i canali del contact center che hai abilitato in licenza (telefono, web chat, WhatsApp, video, eventuali canali custom).

È possibile configurare l’apertura automatica in diversi momenti dell’interazione:

  • In fase di ring

  • All’atto della risposta

  • Alla chiusura della gestione

  • On demand, su azione dell’agente

Il popup può essere generato in due modalità:

  • Generazione URL su Server (raccomandata): è la modalità più comune, esegue uno script JS ed è compatibile con TVox Web Client e WinWeb Client

  • Modalità Legacy (Windows BAT): mantenuta per compatibilità con versioni precedenti di TVox, richiede la compilazione di uno script batch che viene eseguito solo da TVox WinWeb Client.

Generazione URL su Server

L’URL viene generato da TVox e può essere aperto:

  • In iframe all’interno del client

  • In una nuova scheda/finestra del browser

La generazione dell’URL avviene tramite la definizione di una funzione javascript che restituisca un oggetto JSON di questo tipo:

				
					{
  "onRing": null,
  "onAnswer": null,
  "onHangup": null,
  "onDemand": null,
  "webClientOpenNewTab": false,
  "webClientTabName": null
}

Parametri disponibili

CampoTipoDescrizione
onRingstringURL da aprire al ring
onAnswerstringURL da aprire alla risposta
onHangupstringURL da aprire alla chiusura
onDemandstringURL attivabile manualmente dall’agente
webClientOpenNewTabboolean

Se true il link verrà aperto in un una nuova tab, altrimenti in iframe.
Se aperto in iframe sarà disponibile una tab all’interno dell’interazione selezionata di fianco alla tab ‘Task’.

webClientTabNamestring

Nome della tab da riutilizzare.
Presa in considerazione se webClientOpenNewTab è true. Se diverso da null verrà utilizzata sempre la stessa tab, altrimenti verrà aperta una nuova tab ogni volta.

Variabili di chiamata

Le variabili possono essere utilizzate nella funzione JavaScript per costruire dinamicamente l’URL del popup. Il formato da utilizzare è: NOME_VARIABILE.

  • CALL_SERVIZIO – Codice del servizio dove applicare la logica di popup

  • CALL_CLI – Numero del chiamante

  • CALL_DNIS – Numero del chiamato

  • CALL_POPUPINFO[] – Informazioni opzionali da aggiungere al popup

  • CALL_SKILLSET – Skillset associato al servizio

  • CALL_TIPOCHIAMATA – Tipo di chiamata: inbound, outbound, etc.

  • CALL_IDLASTCALL – ID dell’ultima chiamata ricevuta

  • CALL_SITOORIGINE – Identificativo del sito TVOX dove la chiamata è stata ricevuta (sito remoto)

  • CALL_SITODISTRIBUZIONE – Identificativo del sito TVOX dove la chiamata è distribuita agli agenti (sito locale)

  • CALL_CHANNELID – Identificativo del canale su cui si riceve la chiamata

  • CALL_CHANNELSESSIONID – ID della sessione della chiamata nel canale

  • CALL_CHANNELDATA – Informazioni aggiuntive da presentare nella chiamata del canale

  • CALL_CHANNELDESCRIPTION – Descrizione del canale da mostrare

Variabili di agente

Nel corpo dell’URL o dell’oggetto JSON, le variabili agente vanno indicate nel formato {$NOME_VARIABILE}:

  • USERNAME – Username dell’utente che riceve la chiamata

  • SYSTEM_USERNAME – Username del sistema operativo

  • USER_PASSWORD – Password dell’utente

  • ACCESS_TOKEN – Token della sessione utente autenticata su TVOX

Popup Manager - Esempio di script per la generazione URL su server

Una volta definito lo script JavaScript per la generazione dell’URL, è possibile verificarne il corretto funzionamento prima della messa in produzione utilizzando la funzione di test integrata.

Per eseguire il test:

  1. Clicca sul pulsante Prova script, disponibile sotto all’editor dello script.

  2. Compila i campi richiesti in base alle variabili utilizzate nel codice.

  3. Esegui il test per visualizzare:

    • Il valore delle variabili calcolato in base agli input inseriti

    • Un messaggio di errore, nel caso in cui lo script presenti problemi di sintassi o logica

Popup Manager - Form per esecuzione della prova dello script
Popup Manager - Esito della prova dello script

Modalità Legacy (Windows BAT)

La modalità Legacy (windows BAT) viene erogata dallo script winpopup.bat direttamente dalla postazione utente che gestisce la chiamata:

  • questa modalità consente al sistema di essere compatibile con installazioni passate che implementavano questo unico metodo;
  • è l’unica modalità che consente di invocare eseguibili esterni WIN32 per interagire con applicativi che non supportano i comandi via URL.

Variabili di chiamata

Le seguenti variabili sono disponibili nello script winpopup.bat, da utilizzare nel formato %NOME_VARIABILE%:

  • PIN – Codice utilizzato per il login al servizio telefonico

  • USERNAME – Codice utente dell’agente

  • IDCALL – Identificativo univoco della chiamata

  • CALLTYPE – Tipo di chiamata: I = inbound, O = outbound

  • SKILLSET – Codice skillset dell’agente

  • SERVICE – Codice del servizio assegnato alla chiamata

  • CLI – Caller ID (numero del chiamante)

  • DNIS – Numero chiamato (Dialed Number Identification Service)

  • RECEIVING_SITE NCC – ID del sito dove è iniziata la chiamata

  • DISTRIBUTION_SITE NCC – ID del sito dove si trova l’agente che ha risposto

  • EVENT – Momento di attivazione del popup (ring, answer, hangup, UNK)

Di seguito un esempio pratico di utilizzo dello script winpopup.bat con gestione differenziata per servizio:

				
					
if "%SERVICE%" == "servizio_1" GOTO REQ1
if "%SERVICE%" == "servizio_2" GOTO REQ2

:REQ1
start "" "http://mycrm.net/call.php?pin=%PIN%&idcall=%IDCALL%&number=%CLI%"
GOTO ESCI

:REQ2
start "" "http://crm.it/popup.php?pin=%PIN%&info=%POPUPINFO_2%&caller=%CLI%"
GOTO ESCI

:ESCI

Associa il popup manager ai servizi

Per attivare la funzionalità di screen popup su uno o più servizi:

  1. Accedi alla sezione Servizi associati all’interno della configurazione del Popup Manager.

  2. Per ogni servizio elencato, abilita il popup sui canali desiderati (es. telefonico, web chat, WhatsApp, ecc.) selezionando le relative opzioni.

Popup Manager - Associazione ai servizi
Popup scheda contatto - PreviousPorta il CRM sul contatto TVOXNext - Popup scheda contattoNotification service: memorizza le interazioni sul tuo CRM
Condividi documento

Popup scheda contatto

Oppure copia il link

Contenuti

Prenota la tua demo!

Compila il form

Prenota la tua demo!

Compila il form

Prenota la tua demo!​

Compila il form

Subscribe

×
Cancel