Con nuestra API puede interactuar mediante diversos canales para que su contact center esté siempre conectado.
Recordar que para poder usar la API se necesita.
Autenticarse y obtener un token para la sesión
Usar el token en el Header Authorization
Finalizar sesión
SMS
Dentro de esta categoría podremos realizar las siguientes acciones:
Envío de SMS
https://dominio.ucontactcloud.com/Integra/resources/SMS/SendSMS Método: POST content-type:application/x-www-form-urlencoded; charset=UTF-8 Parámetros: destination (Número destino para sms) message (Mensaje de texto) campaign (Campaña) agent (Agente que lo enviía) source (Callerid o Puerto) Result: TEXTO OK ERROR
Envío de SMS version 2
https://dominio.ucontactcloud.com/Integra/resources/SMS/SendSMSv2 Método: POST content-type:application/x-www-form-urlencoded; charset=UTF-8 Parámetros: destination (Número destino para sms) message (Mensaje de texto) campaign (Campaña) agent (Agente que lo enviía) source (Callerid o Puerto) Result: TEXTO OK:"smsId" ERROR:""
Envío vía proxy
<script type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/porthole/1.0.0/porthole.js"></script> <script type="text/javascript"> function SMS () { var windowProxy; windowProxy = new Porthole.WindowProxy(window.location.protocol + window.location.hostname); windowProxy.post({'action': 'sms', 'campaign' : '<CAMPAIGN>', 'message' : '<MESSAGE>', 'destination' : '<NUMBER>'}); } </script>
Recibir SMS
https://dominio.ucontactcloud.com/Integra/resources/InboundSMS/ReceiveURLSMS Método: GET content-type:application/x-www-form-urlencoded; charset=UTF-8 Parámetros: phone (Número origen del sms) message (Mensaje de texto) Result: TEXTO OK ERROR
Agendar SMS
El scheduler de marcadores de SMS es para poder Agendar SMS y que el marcador las realice en el momento adecuado, para esto existe un WebService de Tipo REST que permite agendar las mismas. y es posible hacerlo desde Forms, Workflows o desde sistemas externos.
Básicamente el proceso es que existe una tabla donde están las llamadas que están agendadas con toda su información pertinente.
sms_scheduler
calldate | campaña | teléfono destino | data |
---|---|---|---|
fecha y hora de cuando tiene que ejecutar | prueba1 | 098344484 | El mensaje |
El scheduler ubica en el sms_spool con prioridad 1 a los mensajes que tienen que ejecutar en ese minuto, lo cual va a hacer que los marcadores lo tomen lo antes posible para enviar el mensaje.
El nombre de base es Schedule + Fecha, y de esta forma conocer cuales son los sms que se agendaron y cuando se deben enviar para poder comparar con el dateprocessed del sms_repo.
https://dominio.ucontactcloud.com/Integra/resources/SMS/ScheduleDialerSMS Método: POST content-type:application/x-www-form-urlencoded; charset=UTF-8 Parámetros: sms (JSON Object) Resultado: 1
Json Object
{ "calldate" : "2015-10-11 15:00:00", // Fecha del sms a enviar "campaign" : "Ventas->", // Campaña marcador "destination" : "098344484", // Destino sms "data" : "Mensaje" // Texto sms }
Example:
POST http://<IP-INTEGRASERVER>/Integra/resources/SMS/ScheduleDialerSMS param: @FormParam("sms") (json con formato sms_scheduler) { "calldate" : "2015-10-11 15:00:00", "campaign" : "Ventas->", "destination" : "098344484", "data" : "Mensaje" }
Subir base SMS
https://dominio.ucontactcloud.com/Integra/resources/SMS/uploadbase Método: POST content-type:application/x-www-form-urlencoded; charset=UTF-8 Parámetros: filename (Nombre archivo) fileb64 (Contenido del archivo en base64) campaign (Nombre de la campaña) Resultado: 1 (Asincrónico)
Formato de archivo
prueba1;098344484;Hola Mundo!;9999 campaña;número;texto;prioridad
El marcador debe estar en fecha y habilitado para poder procesar mensajes, de lo contrario una vez vuelva a estar activo son los primeros en salir.
Email
Para email podremos cargar las bases de los Marcadores.
Subir base de Email
https://dominio.ucontactcloud.com/IntegraChannels/resources/DialersResources/uploadDialerBase Método: POST content-type:application/x-www-form-urlencoded; charset=UTF-8 Parámetros: filename (Nombre archivo) fileb64 (Contenido del archivo csv en base64) channel 'email' (el valor de este parametro siempre será el mismo) user nombre de usuario Resultado: 1 (Asincrónico)
Formato de archivo
NombreCampana;ejemplo@gmail.com;Este es un mensaje de ejemplo;;"Var1":"value","Var2":"value";9999
Enviar email
https://dominio.ucontactcloud.com/IntegraChannels/resources/Forms/SendMailv2 Método: POST content-type:application/x-www-form-urlencoded; charset=UTF-8 Parámetros: body agent
body: string en formato JSON con la información que se muestra en Integra Framework en el metodo UC_sendMailCampaignv2_async
agent: nombre de agente para guardar en la base de datos
Formato de archivo
NombreCampana;ejemplo@gmail.com;Este es un mensaje de ejemplo;;"Var1":"value","Var2":"value";9999
Colección de postman con ejemplo de llamadas a Envío de SMS.