/
Utilizzare Metodi, Proprietà ed Eventi

Utilizzare Metodi, Proprietà ed Eventi

Owned by Felice Griffi
Last updated: 19.07.2021
5 min read

Utilizzare la componente EnghouseToolbarSDK significa connettere la libreria ad una istanza in esecuzione della Toolbar per Contact 7 denominata CTToolbar7.

Connettendo la libreria alla toolbar è possibile richiedere della azioni come la composizione di una chiamata uscente, controllare lo stato dell’operatore oppure cambiare la configurazione dei Gruppi di lavoro.

Per contestualizzare il proprio applicativo sulla base di eventi in corso sulla barra telefonica, come per esempio l’ingresso di un contatto, sarà sufficiente monitorare gli eventi ricevuti.

Inizializzazione della libreria

Per inizializzare la libreria creare una nuova istanza della classe EnghouseToolbarSDK.EnghouseToolbarSDKControl.

'Visual Basic 6 Option Explicit Private WithEvents myDLL As EnghouseToolbarSDK.EnghouseToolbarSDKControl Set myDLL = New EnghouseToolbarSDK.EnghouseToolbarSDKControl 'Visual Basic .NET Private myDLL As EnghouseToolbarSDK.EnghouseToolbarSDK.EnghouseToolbarSDKControl = Nothing myDLL = New EnghouseToolbarSDK.EnghouseToolbarSDK.EnghouseToolbarSDKControl()

Una volta inizializzata è possibile connettersi ad una toolbar in esecuzione mediante il metodo ConnectToolbar. Prima di collegarsi è buona norma registrare tutte le routine personalizzate verso tutti gli Event Handler che si vogliono gestire.

Gli eventi vengono usati dalla componenti binaria per notificare la integrazione delle seguenti informazioni:

  • cambi di stato della linea telefonica

  • cambi di stato logico dell’operatore (Pausa, Login)

  • risposte asincrone ai metodi invocati

  • variazioni dello stato della connessione verso CTToolbar7

'Visual Basic 6 myDLL.ConnectToolbar
'Visual Basic .NET ' Register custom Event Handlers AddHandler myDLL.ToolbarEvent, AddressOf Me.onToolbarEvent AddHandler myDLL.ToolbarEventGetAgentState, AddressOf Me.onGetAgentState AddHandler myDLL.ToolbarEventGetAgentID, AddressOf Me.onGetAgentID AddHandler myDLL.ToolbarEventGetMediaID, AddressOf Me.onGetMediaID AddHandler myDLL.ToolbarEventGetAgentGroups, AddressOf Me.onGetAgentGroups AddHandler myDLL.ToolbarEventGetAgentLoggedInGroups, AddressOf Me.onGetAgentLoggedInGroups AddHandler myDLL.ToolbarConnected, AddressOf Me.onToolbarConnected AddHandler myDLL.ToolbarDisconnected, AddressOf Me.onToolbarDisconnected AddHandler myDLL.ToolbarConnectionError, AddressOf Me.onToolbarError Me.myDLL.ConnectToolbar()

Metodi

EnghouseToolbarSDK mette a disposizione i seguenti metodi:

Nome Metodo

Descrizione

Nome Metodo

Descrizione

ConnectToolbar

hostname As String
username As String
password As String

Esegue la richiesta di connessione verso CTToolbar7 specificando il sistema CTI verso cui connettersi e le credenziali dell’operatore da loggare.

ShowToolbar

Visualizza sullo schermo la interfaccia di CTToolbar7.

HideToolbar

Nasconde la interfaccia di CTToolbar7

QuitToolbar

Esegue la logout dell’operatore e termina la esecuzione di CTToolbar7.

Metodi per controllare lo stato dell’OPERATORE

AgentLogin

Cambia stato all’operatore rendendolo disponibile e schedulabile per ricevere nuovi contatti.

AgentPause

Cambia stato all’operatore richiedendo la Pausa generica.

AgentPauseSubState
SubStateCode As String

Chiede un Sottostato di Pausa per l’operatore specificandone il codice così come configurato in CTManager.

getAgentGroups

Richiede la lista di tutti i Gruppi di lavoro visibili alla utenza operatore. La disponibilità dei dati della risposta verrà notificata dall’evento ToolbarEventGetAgentGroups

getAgentLoggedInGroups

Richiede la lista di tutti i Gruppi di lavoro dove l’operatore risulta loggato. La disponibilità dei dati della risposta verrà notificata dall’evento ToolbarEventGetAgentLoggedInGroups

getAgentID

Richiede l’identificativo completo dell’operatore composto dal dominio applicativo (es. agent1@acd.reitek.com). La risposta verrà notificata dall’evento ToolbarEventGetAgentID

getAgentName

Richiede il Nome della utenza operatore così come configurato in EasyCIM/LDAP. La risposta verrà notificata dall’evento ToolbarEventGetAgentName

getAgentSurname

Richiede il Cognome della utenza operatore così come configurato in EasyCIM/LDAP. La risposta verrà notificata dall’evento ToolbarEventGetAgentSurname

getAgentState

Richiede lo stato dell’operatore. La risposta verrà notificata dall’evento ToolbarEventGetAgentState

getMediaID

Richiede l’identificativo dell’interno telefonico associato all’operatore. La risposta verrà notificata dall’evento ToolbarEventGetMediaID

Metodi per controllare il MEDIA telefonico

MakeCall
DestinationNumber As String
Optional ResourceType As String
Optional ServiceID As String
Optional CallProfileID As String
Optional CallData As String

Effettua una chiamata telefonica verso una numerazione uscente. E' possibile specificare i seguenti parametri aggiuntivi:

  • ServiceID: identificativo del servizio di chiamata da utilizzare.

  • CallProfileID: identificativo del profilo di chiamata da utilizzare.

  • CallData: eventuali variabili di CallData separate da “;”. Esempio “A=1;B=2”

MakeJob
DestinationNumber As String
Optional ResourceType As String
Optional ServiceID As String
Optional CallProfileID As String
Optional CallData As String
Optional ContentDescription As String

Richiede una chiamata verso una numerazione uscente. A differenza della MakeCall il metodo MakeJob fa risultare l’operatorre come schedulato sulla chiamata come se di fatto fosse un Contatto ACD in gestione al sistema.

Hangup
Optional ContactID As String

Conclude la fase online di un contatto telefonico terminando la conversazione in corso.

Answer
ContactID As String

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

Hold
ContactID As String

Mette o riprende dallo stato di attesa una chiamata telefonica.

PlayDTMF
ContactID As String
DTMFs As String

Esegue la riproduzione di uno o più toni DTMF.

SetCallData
ContactID As String
CallData As String

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 ("CUSTOMERID=12345")

StartRecording
ContactID As String
Optional CallRecorders As String
Optional CallData As String
Optional Message As String

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

StopRecording
ContactID As String
Optional CallRecorders As String

Interrompe la registrazione in corso della chiamata telefonica.

Transfer_Direct

ContactID As String
Destination As String
ResourceType As String
Optional CallData As String

Esegue un trasferimento diretto della chiamata telefonica.

Eventi

EnghouseToolbarSDK mette a disposizione i seguenti eventi:

Nome Evento

Descrizione

Nome Evento

Descrizione

ToolbarConnected

La connessione con CTToolbar7 è avvenuta con successo

ToolbarDisconnected

La connessione con CTToolbar7 si è interrotta

ToolbarReconnecting

E' in corso un tentativo di riconnessione a CTToolbar7

ToolbarConnectionError

Errore durante la connessione con CTToolbar7

ToolbarEvent
eventName As String
eventObj As EnghouseToolbarEvent

E' stato ricevuto un evento che descrive il cambio di stato della linea telefonica o dell’operatore.

Il parametro eventName conterrà il nome dell’evento mentre il parametro eventObj è un oggetto che descrive in dettaglio l’evento stesso. Per maggiore dettagli sulla struttura dell’oggetto evento consultare la sezione Eventi e Notifiche .

ToolbarEventGetAgentState
agentState As String

E' stato ricevuto l’evento di risposta alla chiamata al metodo getAgentState. Il parametro AgentState 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 come da configurazione in CTManager

  • FORCEDPAUSE: operatore in pausa forzata a seguito di un mancata risposta su di un contatto

ToolbarEventGetMediaID
mediaID As String

E' stato ricevuto l’evento di risposta alla chiamata al metodo getMediaID. Il parametro mediaID contiene l'identificativo completo del media attestato sull'operatore (esempio: 80400@B2BUAEP.enghouse.com)

ToolbarEventGetAgentID
agentID As String

E' stato ricevuto l’evento di risposta alla chiamata al metodo getAgentID. Il parametro mediaID contiene l'identificativo completo dell’operatore loggato (esempio: agent1@acd.reitek.com)

ToolbarEventGetAgentName
name as String

E' stato ricevuto l’evento di risposta alla chiamata al metodo getAgentName. Il parametro name contiene il nome dell’operatore configurato su EasyCIM/CTManager.

ToolbarEventGetAgentSurname
surname as String

E' stato ricevuto l’evento di risposta alla chiamata al metodo getAgentSurname. Il parametro surname contiene il nome dell’operatore configurato su EasyCIM/CTManager.

ToolbarEventGetAgentGroups

E' stato ricevuto l’evento di risposta alla chiamata al metodo getAgentGroups. La proprietà AgentGroupsrestituirà 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

ToolbarEventGetAgentLoggedInGroups

E' stato ricevuto l’evento di risposta alla chiamata al metodo getAgentLoggedInGroups. La proprietà AgentLoggedInGroups restituirà un Array di tutti i Gruppi di lavoro dove l’operatore risulta correntemente loggato. 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

 

Related content