Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 14 Next »

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:

Nome Campo

Descrizione

Esempio

Widget ID

Identificativo univoco del Widget al fine di renderlo facilmente referenziabile da altri Widget per consentire l’invio di notifiche e messaggi all'interno di AgentDesktop.

AGENTDESKTOP_MY_WIDGET

Widget Title

Titolo del Widget che verrà visualizzato in AgentDesktop nella barra laterale o nel tooltip in caso di configurazione di un Widget Multi-Contatto.

My Widget

Widget URI

URL della propria web-app da caricare. Può essere di tipo relativo nel caso l'applicazione venga ospitata sullo stesso server dove è presente AgentDesktop, oppure, grazie al supporto della funzionalità Post Message da parte della libreria SDK, può essere un indirizzo appartenente ad un dominio differente rispetto ad AgentDektop.

https://www.myapp.com

Widget Icon

Icona del Widget che verrà visualizzata in AgentDesktop. E' possibile utilizzare la collezione di icone di Font Awesome già disponibile in AgentDesktop. Fare riferimento al seguente link per disporre di una anteprima. https://fontawesome.com/v4.7.0/icons/

fa fa-lightbulb-o fa-2x

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 di un Widget

Per consentire la comunicazione bidirezionale della propria Web-App 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).

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.

  • No labels