Agregar una integración de acciones de datos

Para utilizar la integración, agregue una o más integraciones de acciones de datos de Genesys Cloud a su organización de Genesys Cloud. Varias integraciones le permiten utilizar diferentes configuraciones y acciones de datos para actuar sobre los datos de la API de la plataforma.

1. Agrega una integración. 

   La integración se abre en la pestaña Detalles. Sobre el Detalles pestaña, puede cambiar el nombre de la integración y agregar notas sobre la integración. 

   Nota: Si cambia el nombre de la integración, asegúrese de utilizar nombres únicos para diferenciar las integraciones y las acciones asociadas en las aplicaciones de Genesys Cloud que hacen referencia a ellas..

2. Agrega credenciales.

   Las credenciales utilizan las credenciales del cliente Genesys Cloud OAuth. 

   1. Haga clic en el Configuración pestaña. 
   2. Haga clic en el Cartas credenciales pestaña.
   3. Hacer clic Configurar.

      Aparece el cuadro de diálogo Configurar credenciales.

   4. Ingrese la siguiente informacion:
      • Identificación del cliente: El ID generado cuando crea un cliente Genesys Cloud OAuth.
      • Secreto del cliente: El secreto generado cuando crea un cliente Genesys Cloud OAuth.
   5. Hacer clic OK.
   6. Hacer clic Ahorrar.

      Aparece una lista de todas las integraciones que ha instalado.

3. Activar la integración.
   Nota: Si no activa la integración, no podrá probar ninguna acción de datos asociada con la integración y las acciones de datos no aparecerán en las aplicaciones de Genesys Cloud.
   1. Debajo de la integración que acaba de agregar, haga clic en el Estado alternar para cambiarlo de Inactivo para Activo.

      Aparece un cuadro de diálogo Cambiar estado.

   2. Hacer clic sí.

La integración ahora está activa. Puede editar, desactivar o eliminar una integración instalada. Para más información, ver Editar, desactivar o eliminar una integración.

Próximo, crear una acción personalizada o usar una acción de datos.

Para obtener más información sobre la integración, consulte Acerca de la integración de acciones de datos de Genesys Cloud.

Para utilizar la integración, agregue una o más integraciones de acciones de datos de Google a su organización Genesys Cloud. Múltiples integraciones le permiten usar diferentes configuraciones y acciones de datos para actuar sobre los datos en diferentes cuentas de Google.

1. Agrega una integración. 

   La integración se abre en la pestaña Detalles. Sobre el Detalles pestaña, puede cambiar el nombre de la integración y agregar notas sobre la integración. 

   Nota: Si cambia el nombre de la integración, asegúrese de utilizar nombres únicos para diferenciar las integraciones y las acciones asociadas en las aplicaciones de Genesys Cloud que hacen referencia a ellas..

2. Agrega credenciales. 
   1. Haga clic en el Configuración pestaña. 
   2. Haga clic en el Cartas credenciales pestaña.
   3. Hacer clic Configurar.

      Aparece el cuadro de diálogo Configurar credenciales.

   4. Selecciona el Tipo de credencial para la aplicación de Google que utilizará con esta integración de acciones de datos.
      • Para Google Cloud Platform, seleccione googleCloudPlatformServiceAccount.
      • Para G Suite, seleccione googleGSuiteServiceAccount.
   5. Ingrese la siguiente información basada en el Tipo de credencial seleccionado:

      googleCloudPlatformServiceAccount

      • Identificación del cliente: El ID único de su cuenta de servicio de Google. También client_id en el archivo de claves JSON que genera su cuenta.
      • Correo electrónico del cliente: El correo electrónico de su cuenta de servicio de Google. También client_email en el archivo de claves JSON que genera su cuenta. 
      • ID de clave privada: private_key_id en el archivo de clave JSON que genera su cuenta de servicio de Google.
      • Llave privada: llave privada en el archivo de clave JSON que genera su cuenta de servicio de Google.
        Propina: Para evitar errores en el valor, copie todo el contenido entre las comillas, pero sin incluir las comillas. El servicio de acciones procesa correctamente los caracteres adicionales.

      googleGSuiteServiceAccount

      • Correo electrónico de la cuenta de servicio: El correo electrónico de su cuenta de servicio de Google. También correo_cliente en el archivo de claves JSON que genera su cuenta.
      • ID de clave privada: private_key_id en el archivo de clave JSON que genera su cuenta de servicio de Google. 
      • Llave privada: llave privada en el archivo de clave JSON que genera su cuenta de servicio de Google.
      • Ámbitos de autorización: La lista delimitada por comas de ámbitos a los que se debe conceder acceso a la integración, por ejemplo, "https://www.googleapis.com/auth/admin.reports.usage.readonly, https://www.googleapis.com/auth/admin.reports.usage.readonly."

        Consulte la documentación individual de la API de Google para conocer los alcances necesarios, por ejemplo, CustomerUsageReports: obtener y UserUsageReports: obtener en la documentación de Google.

      • Suplantar el correo electrónico del usuario (opcional): La dirección de correo electrónico del usuario para el que la integración solicita acceso delegado.
        Nota: Algunas API que hacen referencia a usuarios requieren suplantación de identidad. Para más información, ver La acción de datos devuelve un error 403.

   6. Hacer clic OK.
   7. Hacer clic Ahorrar.

      Aparece una lista de todas las integraciones que ha instalado.

3. Activar la integración.
   Nota: Si no activa la integración, no podrá probar ninguna acción de datos asociada con la integración y las acciones de datos no aparecerán en las aplicaciones de Genesys Cloud.
   1. Debajo de la integración que acaba de agregar, haga clic en el Estado alternar para cambiarlo de Inactivo para Activo.

      Aparece un cuadro de diálogo Cambiar estado.

   2. Hacer clic sí.

La integración ahora está activa. Puede editar, desactivar o eliminar una integración instalada. Para más información, ver Editar, desactivar o eliminar una integración.

Próximo, crear una acción personalizada.

Para obtener más información, consulte Acerca de la integración de las acciones de datos de Google.

Para usar la integración, agregue una o más integraciones de acciones de datos de Microsoft Dynamics 365 a su organización de Genesys Cloud. Múltiples integraciones le permiten usar diferentes configuraciones y acciones de datos para actuar sobre los datos en diferentes cuentas de Microsoft Dynamics 365. 

1. Agrega una integración. 

   La integración se abre en la pestaña Detalles. Sobre el Detalles pestaña, puede cambiar el nombre de la integración y agregar notas sobre la integración. 

   Nota: Si cambia el nombre de la integración, asegúrese de utilizar nombres únicos para diferenciar las integraciones y las acciones asociadas en las aplicaciones de Genesys Cloud que hacen referencia a ellas..

2. Agrega credenciales. 
   1. Haga clic en el Configuración pestaña. 
   2. Haga clic en el Cartas credenciales pestaña.
   3. Hacer clic Configurar.

      Aparece el cuadro de diálogo Configurar credenciales.

   4. Ingrese la siguiente informacion:
      • Nombre de usuario: Su ID de inicio de sesión de Microsoft Dynamics 365.

        El usuario debe poder acceder a los datos que desee que estén disponibles para la integración de acciones de datos de Microsoft Dynamics 365.

      • Contraseña: Contraseña para su ID de inicio de sesión de Microsoft Dynamics 365. 
      • Dirección web de la organización raíz: La URL de su organización de Microsoft Dynamics 365, por ejemplo, https://contoso.crm.dynamics.com.
      • ID de aplicación: El ID de su organización de Microsoft Dynamics 365.

        El ID de la aplicación se crea mediante el registro de la aplicación en Microsoft Entra ID. Para más información, consulte Registrar la integración.

   5. Hacer clic OK.
   6. Hacer clic Ahorrar.

      Aparece una lista de todas las integraciones que ha instalado.

3. Activar la integración.
   Nota: Si no activa la integración, no podrá probar ninguna acción de datos asociada con la integración y las acciones de datos no aparecerán en las aplicaciones de Genesys Cloud.
   1. Debajo de la integración que acaba de agregar, haga clic en el Estado alternar para cambiarlo de Inactivo para Activo.

      Aparece un cuadro de diálogo Cambiar estado.

   2. Hacer clic sí.

La integración ahora está activa. Puede editar, desactivar o eliminar una integración instalada. Para más información, ver Editar, desactivar o eliminar una integración.

Próximo, crear una acción personalizada o usar una acción de datos.

Para obtener más información sobre la integración, consulte Acerca de la integración de acciones de datos de Microsoft Dynamics 365.

Para utilizar la integración, agregue una o más integraciones de acciones de datos de Salesforce a su organización de Genesys Cloud. Múltiples integraciones le permiten usar diferentes configuraciones y acciones de datos para actuar sobre los datos en diferentes cuentas de Salesforce. 

1. Agrega una integración. 

   La integración se abre en la pestaña Detalles. Sobre el Detalles pestaña, puede cambiar el nombre de la integración y agregar notas sobre la integración. 

   Nota: Si cambia el nombre de la integración, asegúrese de utilizar nombres únicos para diferenciar las integraciones y las acciones asociadas en las aplicaciones de Genesys Cloud que hacen referencia a ellas..

2. Agrega credenciales. 
   1. Haga clic en el Configuración pestaña. 
   2. Haga clic en el Cartas credenciales pestaña.
   3. Hacer clic Configurar.

      Aparece el cuadro de diálogo Configurar credenciales.

   4. Ingrese la siguiente informacion:
      • Nombre de usuario: Su ID de inicio de sesión de Salesforce.

        Utilice un perfil de Salesforce que tenga API habilitada seleccionada y Ver todo seleccionado para cuentas, casos y contactos. Este usuario (preferiblemente un administrador del sistema) debe poder acceder a cualquier campo estándar y personalizado que se utilice en las aplicaciones de Genesys Cloud.

      • Contraseña: Contraseña para su ID de inicio de sesión de Salesforce. 
      • Token de seguridad: El token de API generado para la organización de Salesforce.

        El token es una cadena alfanumérica como AS4DFA9SasdJas2HIasd1asdf.

      • URL de inicio de sesión: La URL de Salesforce utilizada para conectarse a la API.

        El servicio predeterminado es https://login.salesforce.com. Para una organización de prueba, seleccione https://test.salesforce.com.

        Nota: En Salesforce, active Allow OAuth Username-Password Flows settings in OAuth and OpenID Connect Settings. Para obtener más información, consulte Salesforce Release Notes.
   5. Hacer clic OK.
   6. Hacer clic Ahorrar.

      Aparece una lista de todas las integraciones que ha instalado.

3. Activar la integración.
   Nota: Si no activa la integración, no podrá probar ninguna acción de datos asociada con la integración y las acciones de datos no aparecerán en las aplicaciones de Genesys Cloud.
   1. Debajo de la integración que acaba de agregar, haga clic en el Estado alternar para cambiarlo de Inactivo para Activo.

      Aparece un cuadro de diálogo Cambiar estado.

   2. Hacer clic sí.

La integración ahora está activa. Puede editar, desactivar o eliminar una integración instalada. Para más información, ver Editar, desactivar o eliminar una integración.

Próximo, crear una acción personalizada o usar una acción de datos.

Para obtener más información sobre la integración, consulte Acerca de la integración de acciones de datos de Salesforce.

Para utilizar la integración, agregue una o más integraciones de acciones de datos de servicios web a su organización Genesys Cloud. Múltiples integraciones le permiten utilizar diferentes configuraciones y acciones personalizadas para actuar sobre los datos a través de diferentes servicios web. 

1. Agrega una integración. 

   La integración se abre en la pestaña Detalles. Sobre el Detalles pestaña, puede cambiar el nombre de la integración y agregar notas sobre la integración. 

   Nota: Si cambia el nombre de la integración, asegúrese de utilizar nombres únicos para diferenciar las integraciones y las acciones asociadas en las aplicaciones de Genesys Cloud que hacen referencia a ellas..

2. Configure un certificado TLS mutuo (si es necesario para el servicio web).
   1. En la pestaña Configuración, seleccione Propiedades.
   2. Select the value for Mutual TLS Client Certificate Authority.
      The default signing authority of the client certificate is Genesys Cloud. You can also select DigiCert as the Certificate Authority (CA). Using the GET /api/v2/integrations/actions/certificates public API, you can download the available certificates in use.
      Notas:

      • Si utiliza certificados de confianza DigiCert, debe gestionar la rotación anual de certificados para garantizar una conexión segura y sin problemas. Para obtener más información, consulte ¿Es de confianza pública el certificado TLS mutuo (mTLS)?.
      • Si utiliza certificados de Genesys Cloud, Genesys Cloud recomienda establecer una relación de confianza con la CA raíz, que renueva y actualiza los certificados automáticamente. El establecimiento de la relación de confianza con la CA garantiza que no se produzcan interrupciones cuando haya nuevos certificados disponibles. Para más información, ver Soporte mTLS para acciones de datos.
3. Agregue credenciales (si es necesario para el servicio web).
   1. Haga clic en el Configuración pestaña. 
   2. Haga clic en el Cartas credenciales pestaña.
   3. Hacer clic Configurar.

      Aparece el cuadro de diálogo Configurar credenciales.

   4. Seleccione un Tipo de credencial e ingrese la información de la credencial. Para más información, ver Tipos de credenciales.
      Advertencia: No cambie un tipo de credencial después de configurar las acciones de integración y publicación. Cambiar el tipo de credencial podría interrumpir cualquier acción que esté en uso. Para migrar una integración activa a un nuevo tipo de credencial, comuníquese con Atención al cliente de Genesys Cloud. 
      • Autenticación básica
        1. Ingrese información para los siguientes elementos:
           • Nombre de usuario: Su ID de inicio de sesión del servicio web.
           • Contraseña (Opcional): Contraseña para su ID de inicio de sesión del servicio web. 
      • Usuario definido
        1. Hacer clic Agregar campo de credencial.
        2. Agregar Nombre del campo y Valor.
        3. Repita los pasos i y ii para obtener más nombres y valores de campo definidos por el usuario.

        Para más información, ver Cómo utilizar el tipo de credencial definido por el usuario.

      • Definido por el usuario (OAuth)
        1. Hacer clic Agregar campo de credencial.
        2. Agregar Nombre del campo y Valor.
        3. Repita los pasos i y ii para obtener más nombres y valores de campo definidos por el usuario.

        Para más información, ver Cómo utilizar el tipo de credencial definida por el usuario (OAuth) y Flujo de trabajo para el tipo de credencial definido por el usuario (OAuth).

   5. Hacer clic OK.
   6. Hacer clic Ahorrar.

      Aparece una lista de todas las integraciones que ha instalado.

4. Activar la integración.
   Nota: Si no activa la integración, no podrá probar ninguna acción de datos asociada con la integración y las acciones de datos no aparecerán en las aplicaciones de Genesys Cloud.
   1. Debajo de la integración que acaba de agregar, haga clic en el Estado alternar para cambiarlo de Inactivo para Activo.

      Aparece un cuadro de diálogo Cambiar estado.

   2. Hacer clic sí.

La integración ahora está activa. Puede editar, desactivar o eliminar una integración instalada. Para más información, ver Editar, desactivar o eliminar una integración.

Próximo, crear una acción personalizada.

Para obtener más información sobre la integración, consulte Acerca de la integración de acciones de datos de servicios web.

Para usar la integración, agregue una o más integraciones de acciones de datos de Zendesk a su organización de Genesys Cloud. Múltiples integraciones le permiten usar diferentes configuraciones y acciones de datos para actuar sobre los datos en diferentes cuentas de Zendesk. 

1. Agrega una integración. 

   La integración se abre en la pestaña Detalles. Sobre el Detalles pestaña, puede cambiar el nombre de la integración y agregar notas sobre la integración. 

   Nota: Si cambia el nombre de la integración, asegúrese de utilizar nombres únicos para diferenciar las integraciones y las acciones asociadas en las aplicaciones de Genesys Cloud que hacen referencia a ellas..

2. Agrega credenciales. 
   1. Haga clic en el Configuración pestaña. 
   2. Haga clic en el Cartas credenciales pestaña.
   3. Hacer clic Configurar.

      Aparece el cuadro de diálogo Configurar credenciales.

   4. Ingrese la siguiente informacion:
      • Correo electrónico: Su ID de inicio de sesión de Zendesk.
      • URL de servicio base: La URL del servicio de Zendesk que se utiliza para conectarse a la API, con el formato https: // {subdominio} .zendesk.com.
      • Token de API: El token de API generado para su organización de Zendesk.
   5. Hacer clic OK.
   6. Hacer clic Ahorrar.

      Aparece una lista de todas las integraciones que ha instalado.

3. Activar la integración.
   Nota: Si no activa la integración, no podrá probar ninguna acción de datos asociada con la integración y las acciones de datos no aparecerán en las aplicaciones de Genesys Cloud.
   1. Debajo de la integración que acaba de agregar, haga clic en el Estado alternar para cambiarlo de Inactivo para Activo.

      Aparece un cuadro de diálogo Cambiar estado.

   2. Hacer clic sí.

La integración ahora está activa. Puede editar, desactivar o eliminar una integración instalada. Para más información, ver Editar, desactivar o eliminar una integración.

Próximo, crear una acción personalizada o usar una acción de datos.

Para obtener más información sobre la integración, consulte Acerca de la integración de acciones de datos de Zendesk.