Vea las diferentes posibilidades que le brinda nuestra API para integrar a uContact con sistemas externos.
Servicio getUserToken
https://dominio.ucontactcloud.com/Integra/resources/auth/getUserToken Método: POST content-type:application/x-www-form-urlencoded; charset=UTF-8 Parámetros: user password Resultado: JSON
Supervisor sin teléfono
Al final de la lista
[ ... "QWRtaW46OTgzNWM1MjUtMzU2Ny00YjgyLWEwYWYtY2NkMjNlMDhjNzA3" ] Si es Error Respuesta 0
Código de ejemplo para jQuery
$.ajax({ type: 'POST', url: 'https://dominio.ucontactcloud.com/Integra/resources/auth/getUserToken', contentType: 'application/x-www-form-urlencoded; charset=UTF-8', dataType: 'text', data: { user: 'ExampleUsername', password: 'ExamplePassword' }, success: (resp) => {}, error: (resp) => {} });
Ejemplo de configuración de jQuery
$.ajaxSetup({ headers: { 'Authorization': "Basic " + APIKey } });
Ejemplo de token en headers de peticiones
$.ajax({ type: 'POST', url: 'https://dominio.ucontactcloud.com/Integra/resources/any/request', contentType: 'application/x-www-form-urlencoded; charset=UTF-8', dataType: 'text', headers:{ 'Authorization': 'Basic <APIKey>' }, data: { param1: 'exampleParam1', param2: 'exampleParam2' }, success: (resp) => {}, error: (resp) => {} });
Método
https://dominio.ucontactcloud.com/Integra/resources/auth/EndSession Method: POST content-type:application/x-www-form-urlencoded; charset=UTF-8 Params: user token Result: 1 OK 0 ERROR
Código de ejemplo para jQuery
$.ajax({ type: 'POST', url: 'https://dominio.ucontactcloud.com/Integra/resources/auth/EndSession', contentType: 'application/x-www-form-urlencoded; charset=UTF-8', dataType: 'text', headers:{ 'Authorization': 'Basic <APIKey>' }, data: { user: 'ExampleUser', token: '<token>' }, success: (resp) => {}, error: (resp) => {} });
Información relevante
Todos los WebServices son de tipo REST
uContact usa https por defecto (http2)
Conexión CrossDomain
Con el Windows proxy podemos manejar eventos de un iframe insertado en un formulario, para poder por ejemplo hacer tipificaciones, colgar la llamada, cerrar el formulario o cualquier cosa que se desee.
Para realizar esto no se necesita ningún plugin.
Pasos previos
En el formulario se debe poner:
window.addEventListener('message', event => { if (event.data.action === 'CLOSE_TAB') { parent.closeActiveTab(); } else if (event.data.action === 'DISPOSITION_CALL') { let dataDisp = event.data.disposition; UC_DispositionCall(dataDisp.campaign, dataDisp.callerid, dataDisp.guid, dataDisp.l1, dataDisp.l2, dataDisp.l3, dataDisp.d1, dataDisp.d2, dataDisp.comment, dataDisp.schedule, callbackDiposition, errorDiposition); } });
event.data se puede usar para identificar de qué tipo es la acción.
Y el atributo disposition se usa como un objeto para mandar más información.
¿Cómo invocarlo?
La manera de invocarlo es:
let dataDisp = { campaign: 'CampañaTest', callerid: '123456Test', guid:'3123-3123-3123-312-3123', l1:'nivel1', l2:'nivel2', l3:'nivel3', d1:'data1', d2:'data2', comment:'ComentarioTest', schedule:'2019-05-04 15:55:55' }; window.parent.postMessage({ action: 'DISPOSITION_CALL', disposition:dataDisp}, '*');
Creación de tokens
Los usuarios con rol "SuperUsuario" en uContact tienen la funcionalidad de crear tokens para ser utilizados fuera de la aplicación. Para crear un token seguir los siguientes pasos:
Acceder al menú de usuario.
Seleccionar la opción de "API tokens" en el menu desplegado y se abrirá un modal para su creación.
Ingresar el nombre con el que quiere identificar el token y haga clic en el botón "Agregar" para crear un nuevo token.
Una vez que se ha creado un token en uContact, los “SuperUsuario” tienen la posibilidad de compartirlo con otros usuarios. Para hacerlo, es necesario hacer clic en el icono de. De esta manera, el token se copiará automáticamente en el portapapeles y podrá ser enviado a cualquier persona con la que se desee compartir.