Академический Документы
Профессиональный Документы
Культура Документы
1.
2.
3.
CONTEXTO..............................................................................................................2
PUNTOS DE INTEGRACION.................................................................................2
ANEXOS...................................................................................................................4
A.
Funciones de BarAgentControl.tlb.....................................................................4
1.
Obtencin del ID de la llamada (GetIdCall)...................................................4
2.
Obtener Estado (CurrentIntStateByID)...........................................................5
3.
Colgar la llamada (HangUpByID)..................................................................5
4.
Terminar Interaccin (WrapUpByID :After Call Work):................................6
5.
Generar Grabaciones (RecordAst)..................................................................7
6.
Creacin de llamadas (MakeCallDir)..............................................................7
B.
Funciones de InConcertSDK e InconcertSDKnet..............................................8
1.
Login (Login y LoginFromToken)..................................................................8
2.
Establecer resultado de Gestin (SetDispositionCode).................................10
3.
Reagendar contactos (ReScheduleContact)..................................................11
4.
Reagendar contactos (ReScheduleContactToPhone)....................................12
C.
Funciones de LBATCHVIEW..........................................................................14
1.
Recuperacin de grabaciones (PlayAudio)...................................................14
D.
Ejemplo completo para el procedimiento Guardar...........................................15
E.
Ejemplo completo del procedimiento de Importacin de Contactos a travs de
la API de Inconcert......................................................................................................16
2. PUNTOS DE INTEGRACION
Para el caso de una campaa de discador, se identifican las siguientes etapas:
Imagen 1
1. El cliente genera la lista de contactos que quiere cargar al discador. Esta lista se define
segn sus propios criterios de negocio y la informacin obtenida de los reportes de
clientes contactados y no contactados en fechas previas (obtenidos en el punto 6).
2. Para el caso de carga directa va API, el cliente deber dejar la lista de contactos
disponible en formato CSV en un Path determinado e invocar el mtodo de la API
3. ANEXOS
Se utilizan el API InconcertSDK, BarAgentControl y LBatchView para la ejecucin de cada
accin requerida.
A continuacin se detalla las funciones provistas por aplicacin para ser consumidas por un
cliente:
En caso de requerir la especificacin de mtodos de InconcertSDK que no se encuentran
en este documento debe dirigirse a esta pgina pblica:
http://kbase.inconcerthelpdesk.com/index.php/InConcertSDK
NOTA: En el caso particular de integrarse desde una Pgina Web donde se utilice
JavaScript para el desarrollo de la integracin. Se debe tener en cuenta que los
navegadores Firefox y Chrome cuentan con restricciones de seguridad que imposibilitan la
ejecucin de ste lenguaje.
Si se identifica el uso de alguno de los dos mencionado se revisar previamente la correcta
ejecucin de cdigo JavaScript como el detallado en los ejemplos.
Por lo antes expuesto se recomienda utilizar el navegador Internet Explorer.
a. Funciones de BarAgentControl.tlb
Forma de invocacin: Creando un objeto a partir del COM.
Ej Genrico VB 6.0
Dim objBarAgent As Object
Dim IdLlamada As String
Set objBarAgent = CreateObject("BarAgentControl.BAControl")
IdLlamada = objBarAgent.GetIdCall()
MsgBox (IdLlamada)
Esto se puede ejecutar tanto desde en .CSV como dentro de un proyecto vb 6.0
Ej Genrico C# NET 2.0
Type objBAType;
Object objBA;
objBAType = Type.GetTypeFromProgID("BarAgentControl.BAControl");
objBA = Activator.CreateInstance(objBAType);
object idcallxx = objBAType.InvokeMember("GetIDCall", System.Reflection.BindingFlags.InvokeMethod,
null, objBA, null);
MessageBox.Show(idcallxx.ToString());
Javascript
MyObject = new ActiveXObject( "BarAgentControl.BAControl" );
INTERACTIONID = MyObject.GetIdCall();
Para poder hacer el Wrap-Up es necesario asegurarse que el agente este en estado de
Wrap-Up (con la llamada cortada).
Para obtener dicho estado se utiliza la siguiente invocacin a la interfaz COM del BarAgent:
objBarAgent.CurrentIntStateByID ("IDdellamada de inConcert")
la cual devolver devolver ENDED para que pueda realizarse la invocacin al Wrap-Up.
Si el resutlado es , es que el agente esta libre para obtener una llamada, y si es Taked
es que la llamada esta activa entre el agente y el cliente (para lo cual se debe ejecutar el
HangUpById para pasar al estado WrapUp)
InConcertSDKnet
Definicin:
.Net
Modulo inConcertSDKnet.Session
public APIResult Login(string password, string appName, string server, int port);
Parmetros
Password: password a vlida para el username.
appName: Aplicacin que se va a loguear.
Server: ip del server donde se va a loguear la app. Sitio donde se ubica el Servicio Web Handler de
InConcert.
Port: puerto en el que se realiza la invocacin.
Nota, para crear el objeto Session se requieren los parmetros:
UserName: Usuario que se loguea a la aplicacin.
UserName:
VCC: id del vcc en el que se va a loguear
La definicin del constructor es:
public CSession(string userName, string vcc);
C# NET 2.0 (referenciando InConcertSDKnet)
inConcertSDKnet.CSession session = new inConcertSDKnet.CSession ("admin", "system");
inConcertSDKnet.APIResult lResult = session.Login("xxxx", "administration", "192.168.1.1", 8082);
LoginFromToken
En este caso la aplicacin cliente realiza un Login sobre el Token generado por otra
aplicacin, para este caso la aplicacin cliente que se integra debe recibir los datos
para realizar el login.
InConcertSDK
Definicin:
VB6
Modulo inConcertSDK.Session
Function LoginFromToken(ip As String, port As String, applicationName As String, userAuthToken
As String, userAuthTokenApplication As String) As Boolean
Parmetros
IP: ip del server donde se va a loguear la app. Sitio donde se ubica el Servicio Web Handler de Inconcert.
Port: puerto en el que se realiza la invocacin.
ApplicationName: Aplicacin que se va a loguear.
userAuthToken: guid identificatorio de la aplicacin que ya esta logueada (ej, baragent)
userAuthTokenApplication: Aplicacin que se loguea con el Token (ej: BarAgent)
VB 6.0
La librera inConcertSDKnet esta referenciada en el proyecto
Dim m_session As inConcertSDK.Session
m_session.LoginFromToken(Ip, Port, Application, IndentiyToken,
ApplicationToken)
InConcertSDKnet
Definicin:
.Net
Modulo inConcertSDKnet.Session
public APIResult LoginFromToken(string server, int port, string appName, string authToken);
Parmetros
IP: ip del server donde se va a loguear la app. Sitio donde se ubica el Servicio Web Handler de Inconcert.
Port: puerto en el que se realiza la invocacin.
ApplicationName: Aplicacin que se va a loguear.
userAuthToken: guid identificatorio de la aplicacin que ya esta logueada (ej, baragent)
userAuthTokenApplication: Aplicacin que se loguea con el Token (ej: BarAgent)
C# NET 2.0
inConcertSDKnet.CSession session = new Session("admin", "system");
inConcertSDKnet.APIResult lResult = session.LoginFromToken( "192.168.1.1", 8082, "appname",
"TOKEN");
InConcertSDKnet
Definicin:
OutboundEngineCOMClient
Modulo inConcertSDKnet. OutboundEngineCOMClient Este caso se utilice para instanciar un objeto
del tipo y se ejecuta el mtodo SetDispositionCode de esa instancia. Requiere initClient previo del login.
OEManager
Modulo inConcertSDKnet.OEManager Este caso se utiliza para invocar los mtodos directamente al
ser una clase con mtodos estticos. Se requiere Login, pero no InitClient, ya que se le enva el objeto
login como parmetro.
OutboundEngineCOMClient
Se requiere la ejecucin del mtodo INITClient donde se inicializa el objeto con la sesin creada
anteriormente.
public APIResult SetDispositionCode(string processId, string batchId, string contactId, string interactionId,
int contactCode, string businessCode);
OEManager
public static APIResult SetDispositionCode(CSession session, string processId, string batchId,
string contactId, string interactionId, int contactCode, string businessCode);
Parmetros
10
CSession: es el objeto sesin que se cre en el login. Requerido nicamente si se invoca el mtodo
de la clase OEManager.
processeid: Identificador del proceso de InConcert. Este valor se recibe como parmetro en el CTI POPUP.
batchId: Identificador del Lote al que pertenece el contacto. Este valor se recibe como parmetro en el
CTI POPUP.
contactId: Id nico del contacto que se llama.
interactionId: Id de la llamada para la cual se establece el resultado.
contactCode: Resultado de contactacin. Los valores posibles son:
0-->CONTACTED.
14 --> ANSWERING_MACHINE.
15 --> FAX
16 --> DEAD_CONTACT
17 --> INDIRECT_CONTACT
businessCode: Cdigo de negocio que se desea establecer como resultado de la llamada.
C# NET 2.0
OutboundEngineCOMClient
inConcertSDKnet.OutboundEngineCOMClient m_OutboundEngine = new
inConcertSDKnet.OutboundEngineCOMClient();
inConcertSDKnet.APIResult Resp = m_OutboundEngine.InitClient(m_session);
inConcertSDKnet.APIResult Resp2 = SetDispositionCode(processId, batched, contacted,
interactionId, contactCode, businessCode);
OEManager
inConcertSDKnet.APIResult Resp = inConcertSDKnet.OEManager.SetDispositionCode( m_session,
processed, batched, contacted, interactionId, contactCode, businessCode)
InConcertSDKnet
Definicin:
OutboundEngineCOMClient
Modulo inConcertSDKnet. OutboundEngineCOMClient Este caso se utilice para instanciar un objeto
del tipo y se ejecuta el mtodo ReScheduleContact de esa instancia. Requiere initClient previo del login.
11
OEManager
Modulo inConcertSDKnet.OEManager Este caso se utiliza para invocar los mtodos directamente al
ser una clase con mtodos estticos. Se requiere Login, pero no InitClient, ya que se le enva el objeto
login como parmetro.
OutboundEngineCOMClient
Se requiere la ejecucin del mtodo INIT donde se inicializa el objeto con la sesin creada anteriormente.
public APIResult ReScheduleContact(string processId, string batchId, string contactId, string agentId,
DateTime reScheduleDate, bool allowOutOfBatch);
OEManager
public static APIResult ReScheduleContact(CSession session, string processId, string batchId,
string contactId, string agentId, DateTime reScheduleDate, bool allowOutOfBatch);
Parmetros
CSession: es el objeto sesin que se cre en el login. Requerido nicamente si se invoca el mtodo
de la clase OEManager.
processeid: Identificador del proceso de InConcert. Este valor se recibe como parmetro en el CTI POPUP.
batchId: Identificador del Lote al que pertenece el contacto. Este valor se recibe como parmetro en el
CTI POPUP.
contactId: Id nico del contacto que se llama.
ReschedAgente: Id del agente si se requiere entregar la llamada a un agente particular.
DateByReschContact: Fecha/hora en que se deber realizar la llamada.
IMPORTANTE: La fecha debe estar en UTC
outOfBatchAllowed: Flag para indicar si se debe tener en cuenta la fecha de fin del lote.
C# NET 2.0
OutboundEngineCOMClient
inConcertSDKnet.OutboundEngineCOMClient m_OutboundEngine = new
inConcertSDKnet.OutboundEngineCOMClient();
inConcertSDKnet.APIResult Resp = m_OutboundEngine.InitClient(m_session);
inConcertSDKnet.APIResult Resp2 = = m_OutboundEngine.ReScheduleContact (processed, batched,
contactid, agent, DateResk, allowoutofbatch);
OEManager
inConcertSDKnet.APIResult Resp = inConcertSDKnet.OEManager. ReScheduleContact ( m_session,
(processed, batched, contactid, agent, DateResk, allowoutofbatch);
12
InConcertSDKnet
Definicin:
OutboundEngineCOMClient
Modulo inConcertSDKnet. OutboundEngineCOMClient Este caso se utiliza para instanciar un objeto
del tipo y se ejecuta el mtodo ReScheduleContact de esa instancia. Requiere initClient previo del login.
OEManager
Modulo inConcertSDKnet.OEManager Este caso se utiliza para invocar los mtodos directamente al
ser una clase con mtodos estticos. Se requiere Login, pero no InitClient, ya que se le enva el objeto
login como parmetro.
OutboundEngineCOMClient
Se requiere la ejecucin del mtodo INIT donde se inicializa el objeto con la sesin creada anteriormente.
public APIResult ReScheduleContactToPhone(string processId, string batchId, string contactId,
string agent, string rescheduleDate, string phoneType, string phoneCountry, string phoneArea,
string phoneNumber, string phoneExtension)
OEManager
public static APIResult ReScheduleContactToPhone(CSession session, string processId, string batchId,
string contactId, string agent, DateTime rescheduleDate, PhoneType phoneType, string phoneCountry,
13
c. Funciones de LBATCHVIEW
1. Recuperacin de grabaciones (PlayAudio)
Si en la aplicacin de gestin se almacena el id de llamada de inConcert, se podrn
escuchar las grabaciones correspondientes.
Definicin:
Function Initialize(StremServer As String, RepositoryServer As String) As Boolean
Function PlayAudio(IdPaquete As String, IdSection As String, IdParte As String) As Boolean
Parmetros
Para Initialize:
StremServer: Ip del server de Asterisk
RepositoryServer: Ip del server del repositorio.
Para PlayAudio:
Id de la llamada de InConcert.
Seccion: Id creado de existir transferencia de llamada.
Parte: Parte de la grabacin que se desea escuchar.
VB 6.0
Dim obj
14
15
16
17
18