Integration Hub
El contenido de esta página es para un producto o función en versión controlada (CR). Si no forma parte del grupo CR y desea obtener más información, comuníquese con su Representante de cuenta CXone.
Integration Hub le permite automatizar los procesos ofreciendo un origen centralizado para construir, gestionar y ejecutar integraciones desde CXone hacia plataformas de terceros. Puede crear plantillas conectadas que pueden usarse para diversas integraciones en la misma aplicación. Puede recuperar conectores de la biblioteca de conexiones y, después, personalizarlos según sus necesidades. Puede crear sus propias plantillas o puede usar una plantilla de la biblioteca de conexiones y agregarla a Mis conexiones. Agregarla a Mis conexiones le permitirá configurar la integración de acuerdo con sus necesidades específicas.
Inicie Integration Hub en CXone
-
En CXone, haga clic en el selector de aplicaciones
y seleccione Automatización e IA.
-
Haga clic en Integration Hub para abrirlo.
Inicie Integration Hub en Desktop Studio
-
Lanzamiento Desktop Studio
-
En la pestaña Herramientas, haga clic en Automatización e IA.
-
Haga clic y arrastre la acción Connect Auth a un script.
-
Haga doble clic en Connect Auth en el script para abrir Integration Hub.
Inicie Integration Hub en CXone Studio
-
En CXone, haga clic en el selector de aplicaciones
y vaya a Enrutamiento omnicanal > Studio.
-
Haga clic en Nuevo script y seleccione Genérico.
-
Haga clic en Acciones
.
-
En la barra de búsqueda, ingrese Connect Auth.
-
Haga clic y arrastre la acción Connect Auth al script.
-
Haga clic en Abrir editor.
Crear una plantilla conectada
Una plantilla conectada es un esquema general de una integración que contiene las descripciones y requisitos necesarios para la integración con una aplicación de terceros.
-
Inicie Integration Hub y haga clic en + Agregar plantilla.
-
En la pestaña Detalles, ingrese Nombre, Aplicación, Método de integración, Tipo de autenticación y Descripción.
Obtenga más información sobre los campos en este paso
Campo Detalles Nombre El nombre otorgado a la plantilla. Este nombre es el que aparecerá en la biblioteca de conexiones. Aplicación
El nombre de la aplicación con la que esta plantilla se integra.
Método de integración REST es el único método de integración admitido actualmente. Tipo de autenticación OAuth 2.0 y No Auth son los únicos tipos de autenticación que se admiten actualmente. Si selecciona No Auth, creará una integración sin autenticación. Descripción Puede escribir una descripción. Esta descripción la verán otros usuarios si seleccionan la plantilla desde la biblioteca de conexiones. - Adjunte un icono arrastrando y soltando una imagen o haciendo clic en Examinar archivos. Este icono será la imagen de la plantilla en la biblioteca de conexiones.
- En la pestaña Configuración, seleccione los métodos admitidos para la aplicación que está intentando integrar. Los verbos de REST enumerados dependerán de la aplicación de terceros con la que esté intentando integrarse.
-
Haga clic en + Agregar encabezados de autorización para definir los encabezados.
Puede configurar el encabezado para que sea obligatorio activando ¿Solicitado?. Puede hacer clic en X si desea eliminar el encabezado. Deje este campo en blanco si no desea agregar encabezados.
-
Haga clic en Guardar para agregarlo a la biblioteca de conexiones. Haga clic en Guardar + Mis conexiones para agregarlo a la biblioteca de conexiones y a Mis conexiones.
Gestionar conectores
Un conector es una plantilla guardada que puede configurarse de acuerdo con sus necesidades específicas.
-
Inicie Integration Hub y seleccione la plantilla que quiere usar en la biblioteca de conexiones, a la izquierda, y haga clic en + Mi conexión.
-
En el campo Ingrese el nombre del conector, asigne un nombre a su conector. Este nombre es el que aparecerá en la ventana Mis conexiones.
-
Haga clic en Guardar.
-
Vaya al conector en Mis conexiones.
-
En la pestaña Autenticación, ingrese la URL, el Método y los Encabezados. Si seleccionó No Auth como su Tipo de autenticación, no tendrá una pestaña Autenticación.
Obtenga más información sobre los campos en este paso
Campo Detalles URL La URL utilizada para la solicitud de autenticación. Método El método REST específico utilizado en la solicitud de autenticación. Encabezados Hace referencia a los encabezados que se definieron cuando se creó la plantilla. Si no se definió un encabezado al momento de crear la plantilla, entonces no está previsto que se autentique un encabezado con la aplicación. A medida que se definan los encabezados, aparecerán nuevos campos. -
En la pestaña Cuerpo y Parámetros, haga clic en +Agregar parámetro de consulta e ingrese el Nombre del parámetro de consulta y el Valor del parámetro de consulta. Son una serie de pares de clave/valor que se envían con la solicitud de autenticación. Si seleccionó No Auth como su Tipo de autenticación, no tendrá una pestaña Cuerpo y Parámetros.
-
Cuando introduzca el contenido Cuerpo, elija un Tipo de medio en la lista desplegable.
Obtenga más información sobre los campos en este paso
Campo Detalles ApplicationJson
Desde el menú desplegable, seleccione ApplicationJson e ingrese el texto del Cuerpo. El texto del cuerpo se envía con la solicitud de autenticación.
ApplicationJsonPatch Desde el menú desplegable, seleccione ApplicationJsonPatch e ingrese el texto del Cuerpo. El texto del cuerpo se envía con la solicitud de autenticación. FormURLEncoded Desde el menú desplegable, seleccione FormURLEncoded y haga clic en +Agregar parámetro de formulario. Ingrese el Nombre de parámetro de formulario y el Valor del parámetro de formulario. Son conjuntos de pares de clave-valor que se envían con la solicitud de autenticación. Este tipo de medio envía solicitudes utilizando notaciones de URL comunes. TextHtml Desde el menú desplegable, seleccione TextHtml e ingrese el texto del Cuerpo en HTML. El texto del cuerpo se envía con la solicitud de autenticación. TextPlain Desde el menú desplegable, seleccione TextPlain e ingrese el texto del Cuerpo. El texto del cuerpo se envía con la solicitud de autenticación. TextXml Desde el menú desplegable, seleccione TextXml e ingrese el texto del Cuerpo en XML. El texto del cuerpo se envía con la solicitud de autenticación. -
En la pestaña Configuración, rellene el campo Tiempo límite (MS)*. Este campo representa el tiempo que espera el producto antes de ofrecer un mensaje de error por tiempo límite. El tiempo se calcula en milisegundos.
-
En la pestaña Secretos, haga clic en + Agregar secreto e ingrese el Nombre del secreto y el Valor del secreto. Esta es una serie de pares de clave/valor que estén encriptados y a los que puede hacerse referencia desde de otras partes del conector, como los parámetros, los encabezados o el cuerpo de las consultas. Hacer referencia a los secretos usando llaves dobles.
-
En la pestaña Solicitudes, puede buscar solicitudes existentes usando el campo Buscar solicitudes. Seleccione la casilla junto a la solicitud para usarla con el conector. Haga clic en OK. Una vez seleccionada, rellena de forma automática las propiedades de esa acción CONNECTREQUEST de Studio. Si no tiene ninguna solicitud existente, deberá crear solicitudes.
-
Haga clic en Guardar.
-
Puede hacer clic en Prueba para probar la autenticación de un conector con una aplicación de terceros.
Crear solicitudes
Las solicitudes son conjuntos de llamadas de servicio web configurados para fines específicos. Se crean bajo el Conector. Un conector admite 20 solicitudes en total: 10 activas y 10 inactivas. Si ya creó solicitudes y no necesita crear más, puede omitir estos pasos.
-
Inicie Integration Hub y seleccione una conexión en Mis conexiones, a la izquierda.
-
Vaya a la pestaña Solicitudes y haga clic en en + Agregar solicitud.
-
Escriba un Nombre de solicitud.
-
Seleccione un tipo de Activador:
-
Manual: un activador manual se prueba directamente mediante la aplicación Integration Hub y posee un conjunto uniforme de datos que no cambia. Este tipo de activador puede probarse haciendo clic en Prueba en la aplicación Integration Hub.
-
Studio: Se prueba un activador de Studio mediante la aplicación Studio usando la acción CONNECTREQUEST. Este activador posee un conjunto dinámico de datos porque recibe entradas de CXone ACD y de IVR
Menú telefónico automatizado que permite a las personas que llaman interactuar a través de comandos de voz, entradas de teclas o ambos, para obtener información, enrutar una llamada de voz entrante o ambos.. Este tipo de activador solo puede probarse en Studio.
-
-
Configure la solicitud dependiendo de qué tipo de Activador seleccione.
-
Para Manual, Para Manual, indique la URL, Método, Encabezados, Parámetros de consulta, y Tipo de medio.
Obtenga más información sobre los campos en este paso
Campo Detalles URL La URL utilizada para la solicitud de autenticación. Método El método REST específico utilizado en la solicitud de autenticación. Encabezados Haga clic en + Añadir cabecera e ingrese el Nombre de encabezado y el Valor de encabezado. Parámetros de consulta Haga clic en +Agregar parámetro de consulta e ingrese el Nombre del parámetro de consulta y el Valor del parámetro de consulta. Son una serie de pares de clave/valor que se envían con la solicitud de autenticación. Tipo de medio
ApplicationJson: Desde el menú desplegable, seleccione ApplicationJson e ingrese el texto del Cuerpo. El texto del cuerpo se envía con la solicitud de autenticación.
ApplicationJsonPatch: Desde el menú desplegable, seleccione ApplicationJsonPatch e ingrese el texto del Cuerpo. El texto del cuerpo se envía con la solicitud de autenticación.
FormURLEncoded: Desde el menú desplegable, seleccione FormURLEncoded y haga clic en +Agregar parámetro de formulario. Ingrese el Nombre de parámetro de formulario y el Valor del parámetro de formulario. Son una serie de pares de clave/valor que se envían con la solicitud de autenticación. Este Tipo de medio envía solicitudes utilizando notaciones de URL comunes. También permite hacer referencia a los Secretos y está disponible en las solicitudes manuales y las activadas por Studio.
TextHtml: Desde el menú desplegable, seleccione TextHtml e ingrese el texto del Cuerpo en HTML. El texto del cuerpo se envía con la solicitud de autenticación.
TextPlain: Desde el menú desplegable, seleccione TextPlain e ingrese el texto del Cuerpo. El texto del cuerpo se envía con la solicitud de autenticación.
TextXml:Desde el menú desplegable, seleccione TextXml e ingrese el texto del Cuerpo en XML. El texto del cuerpo se envía con la solicitud de autenticación.
-
Para Studio, es necesario crear un paquete JSON para esbozar los datos necesarios para hacer la solicitud.
Ver un ejemplo de una carga útil de solicitud
{
"URL": "[[INSTANCEURI]]/INCONTACTAPI/SERBICES/V26.0/AGENTS",
"HTTPMETHOD": "POST",
"HEADERS": [
{
"CONTENT-TYPE": "APPLICATION/X-WWW-FORM-URL-ENCODED",
"AUTHORIZATION": "BEARER[[BEARERTOKEN]]"
}
],
"QUERYPARAMETERS": [
{
"ANI": "[[ANI]]",
"ACCOUNTID": "123456"
}
],
"BODY": [
{
"ANI": "[[ANI]]",
"ACCOUNTID": "123456",
"ACCOUNTNAME": "TESTACCOUNT"
}
]
}
-
-
En la esquina superior derecha, seleccione si la solicitud está Activa o Inactiva.
-
Haga clic enConfirmar.
Después de configurar la integración, haga clic en la marca de verificación junto a ella desde la lista Mis conexiones. Después, seleccione No o Sí para usar con la acción de Studio.