Configurazione di un  Widget

Per poter essere caricato in AgentDesktop, il Widget deve prima essere configurato in AgentDesktop Manager. Esistono due sezioni distinte dove configurare un nuovo Widget sulla base che si voglia creare un Widget di primo livello o si voglia averlo a disposizione singolarmente su ciascun contatto in gestione all’interno del Widgetdi sistema Multi-Contatto.

Figura 1 - Il menu di accesso alla configurazione di un Widget in AgentDesktop Manager

I campi da compilare sono i seguenti:

Figura 2 - La maschera di configurazione di un Widget in AgentDesktop Manager

Una volta configurato è necessario abilitarlo andando ad indicare quali Widget caricare e rendere quindi disponibili alla login dell’operatore su AgentDesktop. Nella sezione Profiles, scegliere il profilo a cui associare la visualizzazione del widget creato e nella parte relativa ai Widgets o MultiContact cliccare sul suo nome per portarlo nella colonna di quelli abilitati.

Figura 3 - La abilitazione di un Widget

Integrazione della libreria SDK all’interno del Widget

Per consentire la comunicazione bidirezionale della propria web-application con AgentDesktop è necessario caricare la libreria di sviluppo AgentDesktop SDK:

    <!-- AgentDesktop SDK Widget -->
    <script type="text/javascript" src="/AD/widget/agentdesktop_widget.js"></script>

In questo modo si avrà a disposizione un namespace AGENTDESKTOP.
Con il namespace AGENTDESKTOP si potrà accedere ad una serie di oggetti e metodi che consentono di controllare le seguenti funzionalità:

• Gestione dei Tab/Schede dei singoli Widget di AgentDesktop (AGENTDESKTOP.TAB),

• Visualizzazione di finestre/pannelli informativi custom (AGENTDESKTOP.ALERT),

• Controllo dei Widget, registrazione di proprie callback per la notifica di eventi (AGENTDESKTOP.WIDGET),

• Gestione dei Contatti, effettuare chiamate, eseguire trasferimenti (AGENTDESKTOP.CONTACT),

• Gestione dello stato e della schedulabilità di un operatore (AGENTDESKTOP.AGENT),

• Gestione di un contatto di tipologia chat, invio di un messaggio testuale (AGENTDESKTOP.CHAT),

• Gestione e notifica degli eventi relativi all'apertura/chiusura delle finestre di dialogo in AgentDesktop (AGENTDESKTOP.UI).

Eventi e notifiche

Gli eventi notificati da AgentDesktop verso l'SDK hanno una struttura JSON, in cui la proprietà "event" descrive l'evento stesso. Nel corso della gestione di un contatto telefonico, chat o multimediale la integrazione dovrà aspettarsi una sequenza di notifiche di eventi che identificheranno le fasi di vita del contatto stesso.

Gli eventi si distinguono tra eventi legati al media telefonico/chat ed eventi legati alla schedulabilità o stato logico dell’operatore loggato.

Eventi sul media

Eventi ACD

L’evento “POPUP”

L’evento POPUP non corrisponde a nessuna segnalazione SIP/CTI relativa al Contatto e a nessun cambio di stato logico dell’Operatore bensì è evento «artificiale» generato da AgentDesktop.
POPUP è generato internamente da AgentDesktop ed identifica con certezza l'ingresso e quindi la presa in gestione di un contatto sulla postazione comunicando di conseguenza ad una integrazione da quale istante temporale è possibile eseguire alcune operazioni come la contestualizzazione del contenuto del proprio Widget.

Eventi Operatore

Struttura JSON dell’evento

L’oggetto che descrive l’evento notificato verso le integrazioni dispone di una serie di proprietà che descrivono la natura dell’evento stesso ed i dati significativi del contatto:

Requisiti per l’integrazione di un Widget

La possibilità di integrazione di un applicazione web all'interno di AgentDesktop utilizzando i Widget è soggetta ad alcune requisiti.

X-Frame-Options

Molti amministratori di sistema impostano alcune protezioni di sicurezza all’interno della pagine che costituiscono la loro web-application o CRM con l’intento che le loro pagine web non possano essere utilizzate da altre applicazioni e caricate in elementi come frames/iframes al fine di essere servite da pagine provenienti da altri domini non autorizzati. Questa tecnica solitamente è denominata "framesniffing".
A titolo di esempio viene riportata una configurazione relativa ad IIS per la abilitazione del'header "X-Frame-Options" e consentire il caricamento della propria web-app all’interno di un Widget di AgentDesktop:

<configuration>
  <system.webServer>
    <httpProtocol>
      <customHeaders>
        <add name="X-Frame-Options" value="ALLOW-FROM <CONTACT7_AGENTDESKTOP_DOMAIN>" />
      </customHeaders>
    </httpProtocol>
  </system.webServer>
</configuration>

Le altre due opzioni di configurazione possono essere: SAMEORIGIN o DENY.

Controllo della TOP window

Alcune applicazioni web verificano se sono incluse in un iframe, in qual caso cercano di ricaricarsi sostituendo la pagina principale.
Un esempio di questo codice è come segue:

<script type="text/javascript">
if (top.frames.length !== 0) { top.location=self.document.location; }
</script>

In questo caso, si dovrà modificare il codice per permettere l'inclusione in un iframe se la finestra padre della propria web-app appartiene al domino applicativo di ContaCT7.

Passaggio di credenziali ad AgentDesktop con SingleSignOn personalizzata

E' possibile indicare per mezzo di un querystring specificato nell’indirizzo della Toolbar le eventuali credenziali di accesso ad AgentDesktop nel caso si utilizzi un sistema di Single Sing On personalizzato. La validazione dello username verrà eseguita dalla applicazione custom definita in EasyCIM.

http://<contact_ecas_server>/AD/AD.html?username=agent1&token=xyz