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 5 Next »

Convenzioni

Di seguito le convenzioni utilizzate nella descrizione delle funzioni.

  • nome_parametro: descrizione breve del parametro obbligatorio
  • <nome_parametro>: descrizione breve del parametro opzionale
  • ContactID: ID del contatto (telefonico/chat/multimediale). Identifica in modo univoco ciascun contatto in gestione sulla postazione operatore.

Gestione Contatto

Funzione

Descrizione

AGENTDESKTOP.CONTACT.MakeCall

String DestinationNumber, String <ResourceType>, String <ServiceID>, String <CallProfileID>, String <CallData>

Effettua una chiamata telefonica.

AGENTDESKTOP.CONTACT.Hangup

String <ContactID>

Conclude la fase online di un contatto telefonico o chat.

AGENTDESKTOP.CONTACT.HangupByContactID

String ContactID

Conclude la fase online del contatto avente come identificativo il valore del parametro "ContactID"

AGENTDESKTOP.CONTACT.Hold

String ContactID

Mette o riprende dallo stato di attesa una chiamata telefonica.

AGENTDESKTOP.CONTACT.Answer

String ContactID

Risponde ad un contatto in ingresso/fase di accettazione sulla postazione operatore.

AGENTDESKTOP.CONTACT.OfflineEnd

String ContactID

Esce dallo stato offline (After Call Work) di un contatto e termina la fase di gestione del contatto stesso.

AGENTDESKTOP.CONTACT.OfflineEnable

String ContactID, Boolean Active

Abilita/Disabilita pulsante di offline presente sulla toolbar principale.

AGENTDESKTOP.CONTACT.SetCallData

String ContactID, String CallData

Imposta una variabile di CallData associata al contatto. Le variabili di CallData consentono di memorizzare sul singolo contatto dei dati personalizzati nel formato chiave=valore.

AGENTDESKTOP.CONTACT.SetCallData("2d-5e5fbc28@B2BUAEP.enghouse.com", "CUSTOMERID=12345");

AGENTDESKTOP.CONTACT.StartRecording

String ContactID, String <CallRecorders>, String <CallData>

Richiede la registrazione della  chiamata telefonica. E' possibile specificare l'identificativo di un Registratore configurato sul sistema CTI.

AGENTDESKTOP.CONTACT.StopRecording

String ContactID, String <CallRecorders>

Interrompe la registrazione in corso della chiamata telefonica.

AGENTDESKTOP.CONTACT.PlayDTMF

String DTMF

Riproduce uno o più toni DTMF sulla chiamata in corso.

AGENTDESKTOP.CONTACT.PlayDTMF("1#");

AGENTDESKTOP.CONTACT.Transfer_Direct

String ContactID, String Destination, String ResourceType

Richiede il trasferimento diretto di una telefonata. Come destinazione del trasferimento è possibile specificare una delle seguenti tipologie di risorsa:

ResourceType:

  • "" (stringa vuota oppure parametro omesso): il parametro Destination conterrà un numero di telefono:
    AGENTDESKTOP.CONTACT.Transfer_Direct("2d-5e5fbc28@B2BUAEP.enghouse.com", "0227070001");
  • 1.3.6 (Agent) : il parametro Destination conterrà un identificativo di un operatore:
    AGENTDESKTOP.CONTACT.Transfer_Direct("2d-5e5fbc28@B2BUAEP.enghouse.com", "agent1@acd.enghouse.com", "1.3.6")
  • 1.3.1 (Interni) : il parametro Destination conterrà l'identificativo di un interno in uso da parte di un operatore:
    AGENTDESKTOP.CONTACT.Transfer_Direct("2d-5e5fbc28@B2BUAEP.enghouse.com", "80102@B2BUAEP.enghouse.com", "1.3.1")
  • 1.3.10 (Servizi): il parametro Destination conterrà l'identificativo di un servizo configurato sul sistema Contact:
    AGENTDESKTOP.CONTACT.Transfer_Direct("2d-5e5fbc28@B2BUAEP.enghouse.com", "SURVEY@sm.enghouse.com", "1.3.10")

AGENTDESKTOP.CONTACT.Transfer_Consultation

String ContactID, String DestinationNumber, String ResourceType, String CallProfileID, String CallData

Richiede il trasferimento con consultazione di una telefonata. La telefonata del cliente in linea verrà messa in attesa e l'operatore verrà automaticamente rediretto verso la chiamata di consultazione con la numerazione specificata nel parametro DestinationNumber.

AGENTDESKTOP.CONTACT.Transfer_Complete

String ResourceType, String <CallData>

Viene richiesto il completamento della chiamata di consultazione ed il trasferimento della telefonata verso il destinatario della consultazione.

AGENTDESKTOP.CONTACT.Transfer_Complete_Conference

String ResourceType

Viene richiesto il completamento della chiamata di consultazione mediante la instaurazione di una conference a tre partecipanti: cliente in linea, operatore che ha gestito la telefonata e destinatario della consultazione.

Gestione WIDGET

Funzione

Descrizione

AGENTDESKTOP.WIDGET.getToken

Restituisce il token ottenuto dalla login Single Sign On di EasyCIM

AGENTDESKTOP.WIDGET.getTokenOneShot

Restituisce il token OneShot ottenuto dalla login Single Sign On di EasyCIM

AGENTDESKTOP.WIDGET.getContainerID

Restituisce l'identificativo del WIDGET

AGENTDESKTOP.WIDGET.bindContactCallback(javascript function)

Effettua la bind di una propria funzione javascript al fine di ricevere le notifiche sui contatti in gestione.

AGENTDESKTOP.WIDGET.unbindContactCallback(javascript function)

Effettua la unbind della vostra funzione

AGENTDESKTOP.WIDGET.bindWidgetDataCallback(function function)

Effettua la bind di una propria funzione javascript al fine di ricevere le notifiche relative alla ricezione di dati custom da un altro Widget

AGENTDESKTOP.WIDGET.unbindWidgetDataCallback(function callback)

Effettua la unbind della vostra funzione

AGENTDESKTOP.WIDGET.sendDataToWidget

String destinationWidgetID, String data

Invia dei dati custom ad un altro WIDGET identificato nel parametro destinationWidgetID (o paradossalmente anche a se stessi se si specifica il proprio ID)

E' possibile inviare anche dati strutturati come array ed oggetti anche se è fortemente raccomandato convertirli in formato stringa mediante l'utilizzo dell'istruzione JSON.stringify.

AGENTDESKTOP.WIDGET.addCustomMenu(JSON String menu)

Inserisce un menu contestuale sul TAB di selezione del proprio WIDGET. Vedi sintassi JSON (vedi 9.4.1)

AGENTDESKTOP.WIDGET.enableCustomMenuItem(String ItemID, boolean [true/false])

Abilita/Disabilita una singola voce di menu nel TAB di selezione del WIDGET

AGENTDESKTOP.WIDGET.LOG(String testo)

LOG: Scrive una propria stringa nel log applicativo di AgentDesktop situato in %appdata%\Reitek\Contact\BrowserPlugin

AGENTDESKTOP.WIDGET.bindWidgetFocusCallback(function callback)

Effettua la bind di una vostra funzione al fine di notificare al Widget la selezione dell'utente e la conseguente ricezione del Focus sul proprio Tab.

AGENTDESKTOP.WIDGET.unbindWidgetFocusCallback (function callback)

Effettua la unbind della vostra funzione

AGENTDESKTOP.WIDGET.Reload(String < JumpToWidget>)

Ricarica Widget

AGENTDESKTOP.WIDGET.triggerContactCallback( String param)

Scatena la vostra funzione di cui avete fatto la bind con bindContactCallback()

AGENTDESKTOP.WIDGET.triggerWidgetDataCallback (String param)

Scatena la vostra funzione di cui avete fatto la bind con bindWidgetDataCallback()

AGENTDESKTOP.WIDGET. triggerWidgetFocusCallback(String param)

Scatena la vostra funzione di cui avete fatto la bind con bindWidgetFocusCallback()

AGENTDESKTOP.WIDGET.receiveDataFromWidget (String senderWidgetID, String data)

Riceve dei dati custom ad un altro WIDGET

AGENTDESKTOP.WIDGET.GetTimeStamp()

Restituisce stringa contenente data e ora attuale nel formato:
dd/mm/yyyy – hh:mm:ss

AGENTDESKTOP.WIDGET.getLanguage

Restituisce la lingua utilizzata in AgentDesktop. Esempio: "it", "en".

AGENTDESKTOP.WIDGET.activateCustomMenuItem(String itemID, param)

Permette di attivare la voce del menu contestuale con id itemID sul TAB di selezione del proprio WIDGET

Gestione TAB

Funzione

Descrizione

AGENTDESKTOP.TAB.Badge(String Badge)

Imposta il Badge all'interno del Tab di selezione del Widget. Se il parametro stringa è vuoto il Badge viene cancellato

AGENTDESKTOP.TAB.Focus()

Sposta la selezione sul TAB del proprio Widget

AGENTDESKTOP.TAB.Home()

Sposta la selezione sul TAB di HOME di AgentDesktop

AGENTDESKTOP.TAB.Add(String ID, String Title, String URL, String Icon)

Aggiunge dinamicamente da codice un nuovo Widget di primo livello.

AGENTDESKTOP.TAB.Remove(String ID)

Rimuove il Widget il cui ID è specificato dal parametro stringa.

AGENTDESKTOP.TAB.GoTo(String ID)

Sposta la selezione sul TAB del Widget con l'ID specificato

Finestre Informative

Funzione

Descrizione

AGENTDESKTOP.ALERT.Notify(String Title, String  Text, String Icon, Integer Timeout)

Visualizza una finestra informativa specificando anche un tempo di visualizzazione.

  • Title: titolo della finestra
  • Testo: contenuto della finestra (formato HTML)
  • Icon: Icona di Font Awesome nel formato fa fa-XXX fa-2x
  • Timeout: numero di secondi di visualizzazione. 0 per tenerlo fisso sullo schermo, liberamente chiudibile dall'utente.

AGENTDESKTOP.ALERT.CustomDialog(String URL, Integer width, Integer heigth)

Apre una finestra di dialogo custom ridimensionabile e trascinabile a piacere all'interno di AD. La finestra non può essere chiusa tramite interfaccia ma mediante API dedicata.

  • URL: percorso della pagina da visualizzare come contenuto della dialog
  • width: larghezza in pixel della dialog
  • heigth: altezza in pixel della dialog

AGENTDESKTOP.ALERT.CustomDialogClose()

Chiude la finestra di dialogo custom aperta

Gestione dello Stato dell'Operatore

Funzione

Descrizione

AGENTDESKTOP.AGENT.PauseSubStateFilter(String filter)

Permette di aggiungere un filtro alla visualizzazione dei sottostati di pausa riservati all'operatore. Il filtro è rappresentato mediante regular expression.

AGENTDESKTOP.AGENT.PauseSubState(String SubStateCode)

Richiede il sottostato di pausa indicato dal codice SubStateCode

AGENTDESKTOP.AGENT.Login

Richiede la login (disponibile) per l'operatore

AGENTDESKTOP.AGENT.Pause

Richiede stato di pausa per l'operatore

AGENTDESKTOP.AGENT.getAgentID

Restituisce l'identificativo completo dell' operatore (esempio: agent1@acd.engouse.com)

AGENTDESKTOP.AGENT.getMediaID

Restituisce l'identificativo completo del media attestato sull'operatore (esempio: 80400@B2BUAEP.enghouse.com)

AGENTDESKTOP.AGENT.getAgentState

Restituisce lo stato in cui si trova l'operatore. Possono essere restituiti i seguenti valori:

  • LOGGEDIN : operatore in stato disponibile
  • PAUSED: operatore in generico stato di pausa
  • SUBSTATEPAUSED:<codice_sottostato>: operatore in sottostati di pausa. Viene specificato il codice identificativo del sottostato di pausa
  • FORCEDPAUSE: operatore in pausa forzata a seguito di un mancata risposta su di un contatto
AGENTDESKTOP.AGENT.getGroups

Restituisce un array di tutti i Gruppi di lavoro visibili all'operatore. Ciascun elemento dell'array ha le seguenti proprietà:

  • ID: identificativo completo del Gruppo di lavoro (Q2001@acd.enghouse.com)
  • Device: device name del Gruppo di lavoro (Q2001)
  • Description: descrizione del Gruppo di lavoro
AGENTDESKTOP.AGENT.getAgentGroupsRestituisce un array di tutti i Gruppi di lavoro dove risulta loggato l'operatore. Il formato dell'array è identico a quello del metodo AGENTDESKTOP.AGENT.getGroups.
AGENTDESKTOP.AGENT.getAgentNameRestituisce il nome dell'operatore come da configurazione sul sistema ContaCT7
AGENTDESKTOP.AGENT.getAgentSurnameRestituisce il cognome dell'operatore come da configurazione sul sistema ContaCT7
AGENTDESKTOP.AGENT.setAgentGroups(String Groups)
Modifica i Gruppi di lavoro associati all'operatore. Il parametro Groups è una stringa contenente la lista di tutti gli identificativi separati da ";"

Gestione Chat CTLive

Funzione

Descrizione

AGENTDESKTOP.CHAT.SendText

String Text

Invia un messaggio testuale verso la chat in gestione all'interno del Tab/Scheda corrente del Widget MultiContatto

AGENTDESKTOP.CHAT.GetEvents

String ContactID

Restituisce un array contenente lista di eventi intercorsi per l'identificativo della chat specificato dal parametro ContactID

Finestre di Dialogo/Informative

Funzione

Descrizione

AGENTDESKTOP.UI.bindModalCallback(function javascript)

Effettua la bind di una propria funzione al fine di essere notificati sugli eventi relativi all'apertura/chiusura di finestre di dialogo in AgentDesktop

AGENTDESKTOP.UI.unbindModalCallback(function javascript)

Effettua la unbind della vostra funzione



  • No labels