APIs integracion

1 Webservice CreateClicktoCall

Versión 1.0

1.1 Introducción

A través de este webservice, se podrán añadir contactos a las listas “llamame” del cliente. Estas listas serán gestionadas para la generación de campañas utilizadas en el marcador.

1.2 Invocación y párametros

Para poder invocar a dicho webservice, se deberá hacer una petición http a la siguiente url:

http://xxx.xxx.xxx.xxx:xxxx/ClicktoCall/CreateClicktoCall

siendo xxx.xxx.xxx.xxx:xxxx la ip y el puerto donde haya sido desplegado el webservice

Se deberán pasar los parámetros a través de post.

Un ejemplo de invocación sería la siguiente

http://10.1.10.10:8180/ClicktoCall/CreateClicktoCall?idLista=11&nombre=pruebaWorldLine&msisdn=0658841177&lang=1

Los distintos parámetros que podemos indicar en dicha invocación son los siguientes:

Nombre	Tipo	Obligatorio	Descripción
date	String	No	Fecha en la que se realizará la llamada, si el parámetro no se indica, se fija fecha actual.El formato del string que se debe enviar es yyyy-MM-dd HH:mm:ss
idLista	Integer	Si	Identificador de la lísta “llamame” en la que el contacto será insertado
codCliente	String	No	Código del cliente
nombre	String	Si	Nombre del cliente
apellido1	String	No	Primer apellido del cliente
apellido2	String	No	Segundo apellido del cliente
empresa	String	No	Empresa del cliente
direccion1	String	No	Campo de dirección del cliente
direccion2	String	No	Campo de dirección del cliente
cp	String	No	Código postal del cliente
localidad	String	No	Localidad del cliente
provincia	String	No	Provincia del cliente
idpais	Integer	No	Identificador del país, si no se indica, será España
email	String	No	E-mail del cliente
msisdn	String	Si	Número de teléfono del cliente
gender	Integer	No	Indicador del género del cliente, si no se indica, sera masculino
lang	Integer	Sí	Indicador del lenguaje a utilizar, si no se indica, será lenguaje español
treatment	Integer	No	Indicador del tipo de tratamiento del cliente.
op1int	Integer	No	Parámetro opcional 1
op2int	Integer	No	Parámetro opcional 2
op3int	Integer	No	Parámetro opcional 3
op4int	Integer	No	Parámetro opcional 4
op1	String	No	Parámetro opcional 1
op2	String	No	Parámetro opcional 2
op3	String	No	Parámetro opcional 3
op4	String	No	Parámetro opcional 4

1.3 Resultado y códigos de error

Si el webservice se ejecuta correctamente enviará el código de respuesta 200.

Si el webservice no se ejecuta de forma correcta, puede devolver los siguientes códigos de error:

Error	Código	Descripción
SC_NOT_FOUND	404
SC_BAD_REQUEST	400	Not enough parameters
SC_CONFLICT	409	Internal process error
SC_INTERNAL_SERVER_ERROR	500	e.getMessage()

2 Webservice CreateClicktoCustomer

Versión 1.0

2.1 Introducción

A través de este webservice, se podrán añadir contactos a cualquiera de las campañas que se tenga definidas.

2.2 Invocación y párametros

Para poder invocar a dicho webservice, se deberá hacer una petición http a la siguiente url:

http://xxx.xxx.xxx.xxx:xxxx/ClicktoCustomer/CreateClicktoCustomer

siendo xxx.xxx.xxx.xxx:xxxx la ip y el puerto donde haya sido desplegado el webservice

Se deberán pasar los parámetros a través de post.

Un ejemplo de invocación sería la siguiente http://172.25.128.248:8180//ClicktoCustomer/CreateClicktoCustomer?date=2015-11-11 10:12:15&idLista=11&idCampana=23&nombre=pruebaTelecor&valFijo_1=0658841177&valMovil_1=0658841177&op3=TECI&op4=3321347

Los distintos parámetros que podemos indicar en dicha invocación son los siguientes:

Nombre	Descripción	Obligatorio	Tipo
date	Fecha en la que se realizará la llamada, si el parámetro no se indica, se fija fecha actual. El formato del string que se debe enviar es yyyy-MM-dd HH:mm:ss	No	Date
obsoletos	Si vale 1, marcar como obsoletos los contactos anteriores, el valor por defecto es 0	No	Integer
diasCaducidad	Número de días a partir de los cuales caducarán los contactos	No	Integer
idCampanna	Identificador de la campaña en la que se insertará el contacto	Si	Integer
idLista	Identificador de lista asociada a la campaña	Si	Integer
prioridad	El valor es de 0 a 99. A mayor número menor prioridad (se le llamará más tarde)	No	Integer
tipoTarea	Los posibles valores de la columna son: A: Alta M: Modificación B: Baja Por defecto el valor es A	No	String
codCli	Identificador del código del cliente	No	String
nombreCon	Nombre del cliente	No	String
apellido1	Primer apellido	No	String
apellido2	Segundo apellido	No	String
empresa	Empresa	No	String
direccion1	Dirección 1	No	String
direccion1	Dirección 1	No	String
direccion2	Dirección 2	No	String
codPostal	Código postal	No	String
localidad	Localidad	No	String
provin	Provincia	No	String
email	Email	No	String
valFijo_1	Primer número fijo del contacto.	Si	Integer
valFijo_2	Segundo número fijo del contacto.	No	Integer
valFijo_3	Tercer número fijo del contacto.	No	Integer
valFijo_4	Cuarto número fijo del contacto.	No	Integer
valMovil_1	Primer número móvil del contacto.	Si	Integer
valMovil_2	Segundo número móvil del contacto.	No	Integer
valMovil_3	Tercer número móvil del contacto.	No	Integer
valMovil_4	Cuarto número móvil del contacto.	No	Integer
edad	Edad.	No	Integer
nOpc1	Dato	numérico opcional	No	Integer

nOpc2 Dato numérico opcional No Integer nOpc3 Dato numérico opcional No Integer nOpc4 Dato numérico opcional No Integer nOpc5 Dato numérico opcional No Integer nOpc6 Dato numérico opcional No Integer nOpc7 Dato numérico opcional No Integer nOpc8 Dato numérico opcional No Integer cOpc1 Cadena opcional No String cOpc2 Cadena opcional No String cOpc3 Cadena opcional No String cOpc4 Cadena opcional No String cOpc5 Cadena opcional No String cOpc6 Cadena opcional No String cOpc7 Cadena opcional No String cOpc8 Cadena opcional No String