Usar Conexiones

En Integration Hub, las conexiones definen los detalles de autenticación y las solicitudes de API. Después de crear y configurar una conexión, puede usarla en NiCE CXone.

Ejecutar Solicitudes desde Integration Hub

Puede ejecutar una solicitud desde la conexión de Integration Hub donde se le define. Solo las solicitudes manuales se pueden ejecutar desde Integration Hub.

1. En NiCE CXone, haga clic en el selector de aplicaciones y seleccione Automation & AI > Integration Hub.

2. Haga clic en la conexión con la que desea trabajar desde mis Conexiones, en el lado izquierdo de la página.

3. En la pestaña de Solicitudes, haga clic en Probar junto a la Solicitud que desee ejecutar. Aparece una página que muestra la respuesta del servicio web conectado.

4. Seleccione y copie el contenido de la respuesta desde la página si desea mantenerlo.

5. Haga clic en Cancelar cuando termine de revisar la respuesta.

Use la Autenticación en un script

Conexiones puede almacenar detalles de autenticación. Puede usarlos en su script donde sea que los necesite. Pueden usarse por sí solos o junto con una solicitud.

1. En NiCE CXone, haga clic en el selector de aplicaciones y seleccione Studio.

2. Abra el script al que desee agregar la solicitud.

3. Agregue una ConnectAuth acción al script.

4. En la propiedad connectName de ConnectAuth, ingrese el nombre de la conexión que desea utilizar. De no saber el nombre de la conexión:

   1. Haga clic en abrir editor en ConnectAuth para abrir Integration Hub.
   2. Debajo de mis Conexiones, haga clic en la marca de verificación junto a la conexión que desea utilizar.
   3. Haga clic en Sí para asignarlo a la acción.

   En lugar de usar el nombre de una conexión específica en la propiedad connectName, puede usar sustitución de variables. Cree una variable para contener el nombre de la conexión y, luego, use la lógica del script para pasar el nombre a ConnectAuth.

5. Guarde sus cambios.

Use una Solicitud Manual en un script

Puede usar una solicitud manual en su script en cualquier lugar donde necesite realizar la Llamada a la API. La solicitud debe estar definida en una conexión de Integration Hub.

El script posiblemente necesite más ediciones para manejar la respuesta devuelta por el recurso al que se conecta la solicitud. Además, es posible que la acción ConnectRequest requiera una configuración adicional.

1. En NiCE CXone, haga clic en el selector de aplicaciones y seleccione Studio.

2. Abra el script donde desee usar la solicitud.

3. Agregue una ConnectRequest acción al script.

4. En las propiedades connectName y requestName, escriba los nombres de la conexión y la solicitud que desea utilizar. De no saber los nombres:

   1. Haga clic en abrir editor en ConnectRequest para abrir Integration Hub.

   2. En mis Conexiones, haga clic en la marca de verificación junto a la conexión que desea usar.

   3. Haga clic en Sí para asignarlo a la acción.

   4. Seleccione la conexión que acaba de asignar a ConnectRequest.

   5. En la pestaña de Solicitudes, haga clic en el recuadro de la Solicitud a la que desee asignar esta acción y haga clic en Aceptar.

   En lugar de usar el nombre de una conexión y solicitud específicas en las propiedades connectName y requestName, puede usar sustitución de variables. Cree variables para almacenar los nombres y, luego, use lógica de script para pasar los nombres a ConnectRequest.

5. Para usar un Variable de la conexión vinculada en el script, encierre el nombre del Variable entre corchetes dobles, de esta manera:[[variableName]].

Use una Studio o Solicitud Híbrido en un script

Para usar una solicitud de Studio, primero agréguela a una conexión de Integration Hub y, luego, a un script mediante la acción ConnectRequest. Para usar una solicitud híbrida, cree una solicitud manual en lugar de una Studio y, luego, conéctela a su script tal como lo haría con una solicitud de Studio.

Los detalles de la solicitud pueden cambiar debido a las entradas de Studio, por lo que esos detalles suelen incluirse en una acción SNIPPET para que puedan transferirse a la acción ConnectRequest.

El script puede necesitar más edición para manejar la respuesta devuelta por el recurso al que se conecta la solicitud. Además, la acción ConnectRequest o la Snippet action pueden requerir configuración adicional.

1. Cree una solicitud de Studio o una solicitud manual en Integration Hub y cree un objeto de solicitud en su script, si todavía no lo ha hecho.

2. En Studio, abra el script que contiene la solicitud que desee usar.
3. Agregue una ConnectRequest acción al script después de la acción Snippet que contiene el objeto de solicitud y conéctelas.

4. En la propiedad connectName de ConnectRequest, escriba los nombres de la conexión que desea utilizar. De no saber los nombres:

   1. Haga doble clic en ConnectRequest para abrir Integration Hub.

   2. En mis Conexiones, haga clic en la marca de verificación junto a la conexión que desea utilizar.

   3. Haga clic en Sí para asignarlo a la acción.

   4. Seleccione la conexión que acaba de asignar a ConnectRequest.

   5. En la pestaña de Solicitudes, haga clic en el recuadro de la Solicitud a la que desee asignar esta acción y haga clic en Aceptar.

   En lugar de usar el nombre de una conexión y una solicitud específicas en las propiedades connectName, puede usar sustitución de variables. Cree una variable para almacenar el nombre y, luego, use la lógica del script para pasar el nombre a ConnectRequest.

5. Seleccione la acción ConnectRequest y configure el campo RequestPayload con el nombre de la variable que contiene la solicitud JSON. Usted definió esta variable en el Snippet.

6. Para usar una Variable de la conexión vinculada en el script, encierre el nombre de la variable entre corchetes dobles, de esta manera:[[variableName]].

7. Si su conexión requiere autorización, agregue y configure la acción ConnectAuth en su script.

Uso de una Solicitud Híbrida en un script

1. Cree una solicitud manual en una conexión Integration Hub.
2.