CTIBridgeClient V1.0 DOCUMENTACION DEL PROGRAMADOR

Transcripción

1 DOCUMENTACION DEL PROGRAMADOR DATAVOICE S.A Para preguntas relativas a esta documentación : Dpto. Ingeniería de DATAVOICE S.A. Tlfno : Fax : Está prohibida la copia, divulgación, reproducción total o parcial de este documento tanto en su versión impresa como en soporte informático sin el permiso expreso de DATAVOICE S.A

2 Introducción CTIBridgeClient es un control ActiveX que permite a las aplicaciones desarrolladas en entornos que soportan este tipo de objetos, recibir notificaciones de eventos telefónicos, enviados por el control CTIBridgeServer, incorporado en el PhoneScreen de DataVoice. Distribución del Software La versión actual de CTIBridgeClient necesita tener conexión TCP con la parte servidora CTIBridgeServer. Tanto la parte cliente, como la parte servidora deberán estar en la misma máquina. Se deberá copiar CTICLI.OCX en el directorio de sistema de Windows. Con el archivo copiado en el directorio del sistema, deberemos registrar el OCX con el programa REGSVR32. La línea de comandos a introducir sería la siguiente: REGSVR32 CTICLI.OCX Con esto el OCX queda listo para funcionar. 1

3 CTIBridgeClient Métodos del objeto CTIBridgeClient Initialize LoadPort NotifyDial NotifyDialer NotifyHangup NotifyPickup SavePort 2

4 Initialize Inicializa el control. Prepara las comunicaciones con el servidor. Antes de llamar a cualquier otro método del control, debe haberse producido una llamada exitosa a este método. Formato <objeto>.initialize Donde <objeto> es una referencia a un CTIBridgeClient. Valor de retorno Long Si el método tiene éxito devolverá 0, si no devolverá un código de error del API de Windows. Sub Form_Load() Dim lretval as Long lretval = CTIBridgeClient1.Initialize() If lretval <> 0 Then MsgBox Error: & Str$(lRetVal) 3

5 LoadPort servidor. Carga de la Registry el puerto IP donde debe conectarse para hablarse con el Formato <objeto>.loadport Donde <objeto> es una referencia a un CTIBridgeClient. Valor de retorno Integer En caso de no producirse errores devolverá el nº de puerto almacenado anteriormente en la Registry de Windows. En caso que no lo pueda cargar, devolverá 1. Sub Configure_Click() Dim nport as integer Dim strvalue as string nport = CTIBridgeClient.LoadPort If nport = -1 Then strvalue = InputBox( Introduzca puerto ) If strvalue <> then nport = val(strvalue) CTIBrigeClient.SavePort nport 4

6 NotifyDial Indica al servidor que marque un número, con una información opcional asociada. Formato <objeto>.notifydial Número, Información Donde <objeto> es una referencia a un CTIBridgeClient. Número es el nº de teléfono a marcar. Información es la información opcional asociada al nº de teléfono, este parámetro deberá pasarse vacío ( ) cuando no se quiera información asociada. Valor de retorno Long Si el método tiene éxito devolverá 0, si no, un código de error del API de Windows. Sub LLamar_Click() If CTIBridgeClient1.NotifyDial(Phone1.Text, ) <> 0 Then MsgBox "No se ha podido notificar la llamada" 5

7 NotifyDialer Manda un mensaje al marcador. Formato <objeto>.notifydialer Campaña, Mensaje Donde <objeto> es una referencia a un CTIBridgeClient. Campaña es el nombre de la campaña a la que va dirigida el mensaje. Mensaje es el mensaje que se quiere enviar a la campaña. Valor de retorno Long Si el método tiene éxito devolverá 0, si no, un código de error del API de Windows. Sub Login_Click() If CTIBridgeClient1.NotifyDialer( Actualizacion de nombres, Login puesto 388 ) <> 0 Then MsgBox "No se ha podido notificar al marcador" 6

8 NotifyHangup Este método notifica al servidor que cuelge la llamada que tenga activa. Formato <objeto>.hangup Donde <objeto> es una referencia a un CTIBrigdeClient. Valor de retorno Long. Si el método tiene éxito devolverá 0, si no, un código de error del API de Windows. Sub Colgar_Click() Dim lretval as Long lretval = CTIBridgeClient1.NotifyHangup() If lretval = 0 Then Display1.Text = Libre Else Display1.Text = Error & Str$(lRetVal) & al colgar 7

9 NotifyPickup Notifica al servidor que descuelgue la llamada. Formato <objeto>.notifypickup Donde <objeto> es una referencia a un CTIBridgeClient. Valor de retorno Long Si el método tiene éxito devuelve 0, si no, devolverá un código de error del API de Windows. Sub Pickup_Click() Dim lretval as Long lretval = CTIBridgeClient1.NotifyPickup() If lretval = 0 Then Display.Text = Llamada en curso Else Display.Text = No se puede descolgar la llamada 8

10 SavePort Guarda el puerto pasado en la Registry de Windows. Formato <objeto>.saveport Port Donde <objeto> es una referencia a un CTIBridgeClient. Port es el puerto que queremos salvar en Registry. Valor de retorno Long El valor de retorno será 0 si el método tiene éxito. Un código de error del API de Windows si el método falla. Dim lretval As Long lretval = CTIBridgeClient1.SavePort(3020) MsgBox Error & Str$(lRetVal) & al salvar el puerto 9

11 Eventos del objeto CTIBridgeClient AgentLog CallEntry Connect 10

12 AgentLog Evento que avisa cuando se activa un agente. Sub CTIBridgeClient1_AgentLog(NewAgent As String, NewPosition As String) Display.Text = Agente: & NewAgent 11

13 CallEntry Este evento informa cuando entra una llamada en el puesto. Sub CTIBridgeClient1_CallEntry(ANI As String, Info As String) MsgBox Nueva llamada: & ANI 12

14 Connect servidor. Este evento informa cuando se ha establecido o se ha perdido la conexión con el Sub CTIBridgeClient1_Connect (Connect As Boolean) If Connect = True Then Display1.Text = Conexión con servidor establecida Else Display1.Text = Conexión con servidor perdida 13