Requisitos para la integración de acciones de datos

Nota: Este artículo se aplica a las integraciones de acciones de datos de AWS Lambda, Function, Genesys Cloud, Google, Microsoft Dynamics 365, Salesforce, servicios web y Zendesk.

Este artículo enumera todos los requisitos de terceros y de Genesys Cloud para ejecutar una integración de acciones de datos.

Cuenta de AWS

  • Una función de AWS Lambda con las siguientes características:
    • Eso admite entradas y salidas basadas en JSON.
    • Eso se ejecuta en menos de 20 segundos.
  • Un rol de IAM que tiene acceso a una o más políticas de AWS o funciones de AWS Lambda. Para más información, ver Cree recursos de IAM para invocar funciones de AWS Lambda

Nube de Genesys

  • Una organización de Genesys Cloud.
  • Los siguientes permisos (como mínimo) seleccionados para el administrador de la integración y las acciones:
    Notas:
    • Dependiendo de dónde acceda a los permisos en Genesys Cloud, los nombres de los permisos aparecen en diferentes formatos.
    • En lugar de seleccionar permisos individuales Integraciones > Acción, puede seleccionar Integraciones > Acción > Todos los permisos. Este permiso concede a los administradores acceso a todos los permisos actuales y futuros asociados a las acciones.
    • Integraciones > Integración > Editar y Vista

      Estos permisos permiten a los administradores editar y ver integraciones.

    • Integraciones > Acción > Agregar, Borrar, Editar, Ejecutar, y Vista
      Estos permisos permiten a los administradores agregar, eliminar, editar, probar y ver acciones personalizadas.
  • Una o más integraciones de acciones de datos de AWS Lambda instaladas. Para más información, ver Agregar una integración de acciones de datos.
  • Se agregó un rol de IAM a las credenciales de integración en Genesys Cloud.

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

Nube de Genesys

  • Una organización de Genesys Cloud con licencia de Genesys Cloud CX 1, Genesys Cloud CX 2 o Genesys Cloud CX 3.
  • Los siguientes permisos (como mínimo) seleccionados para el administrador de la integración y las acciones:
    Notas:
    • Dependiendo de dónde acceda a los permisos en Genesys Cloud, los nombres de los permisos aparecen en diferentes formatos.
    • En lugar de seleccionar permisos individuales Integraciones > Acción, puede seleccionar Integraciones > Acción > Todos los permisos. Este permiso concede a los administradores acceso a todos los permisos actuales y futuros asociados a las acciones.
    • Integraciones > Integración > Editar y Vista

      Estos permisos permiten a los administradores editar y ver integraciones.

    • Integraciones > Acción > Agregar, Borrar, Editar, Ejecutar, y Vista

      Estos permisos permiten a los administradores agregar, eliminar, editar, probar y ver acciones personalizadas.

    • Integraciones > actionFunction > Editar y Ver

      Estos permisos permiten a los administradores editar y ver la integración de acciones de datos de función.

  • Una o más integraciones de acción de datos de Genesys Cloud Function instaladas. Para obtener más información, consulte Añadir una integración de acciones de datos.

Soporte en tiempo real

Las versiones actuales de tiempo de ejecución de Node.js son compatibles con las acciones de datos de Genesys Cloud Function. Para obtener más información sobre las versiones de tiempo de ejecución actualmente compatibles, consulte Release Notes. Genesys Cloud introducirá periódicamente compatibilidad con versiones más recientes del tiempo de ejecución de Node.js y dejará obsoletas las anteriores para garantizar la compatibilidad con las tecnologías en evolución y las mejores prácticas de seguridad. Genesys Cloud alerta a las organizaciones a través de notificaciones de la consola operativa de las acciones de datos de funciones que utilizan versiones de tiempo de ejecución obsoletas.

Para obtener más información sobre las notificaciones de la consola operativa, consulte Resolución de problemas mediante la consola operativa de Genesys Cloud.

Política de obsoletos para las versiones en tiempo de ejecución

Una versión en tiempo de ejecución se anuncia como obsoleta tres meses antes de que AWS inicie su Fase 1 de obsoletos. Para obtener más información, consulte AWS Lambda runtime deprecation policy. Cuando la versión en tiempo de ejecución está marcada como obsoleta:

  • Las acciones de datos de Genesys Cloud Function existentes pueden funcionar hasta que AWS Lambda haga que la versión en tiempo de ejecución no esté disponible. Puede realizar cambios en la configuración y en el código personalizado hasta que la versión quede obsoleta.
  • No se pueden utilizar versiones de tiempo de ejecución obsoletas para crear o actualizar las acciones de datos.
  • Puede modificar las acciones de datos de Genesys Cloud Function para utilizar un nuevo tiempo de ejecución.
  • El único cambio que puedes realizar en una acción de datos que utiliza un tiempo de ejecución no disponible es utilizar una versión de tiempo de ejecución disponible.
Nota: Cualquier cambio de versión en tiempo de ejecución puede requerir cambios en el código.

Nube de Genesys

  • Una organización de Genesys Cloud.
  • Un cliente de Genesys Cloud OAuth para autorizar el acceso a la API de la plataforma.

    Cuando agrega una integración de acciones de datos de Genesys Cloud, debe agregar credenciales OAuth a la configuración de integración. Para más información, ver Crea un cliente OAuth y Autorización (Centro de desarrolladores de Genesys Cloud). 

  • Los siguientes permisos (como mínimo) seleccionados para el administrador de la integración y las acciones:
    Notas:
    • Dependiendo de dónde acceda a los permisos en Genesys Cloud, los nombres de los permisos aparecen en diferentes formatos.
    • En lugar de seleccionar permisos individuales Integraciones > Acción, puede seleccionar Integraciones > Acción > Todos los permisos. Este permiso concede a los administradores acceso a todos los permisos actuales y futuros asociados a las acciones.
    • Integraciones > Integración > Editar y Vista

      Estos permisos permiten a los administradores editar y ver integraciones.

    • Integraciones > Acción > Agregar, Borrar, Editar, Ejecutar, y Vista

      Estos permisos permiten a los administradores agregar, eliminar, editar, probar y ver acciones personalizadas.

  • Una o más integraciones de acciones de datos de Genesys Cloud. Para más información, ver Agregar una integración de acciones de datos.
  • Acciones que acceden a la API de la plataforma con los métodos HTTP GET, PUT, POST o PATCH.

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

Google

  • Una cuenta de Google Cloud Platform o G Suite. 
  • Un proyecto que otorga acceso de API a sus API de Google Cloud Platform o G Suite.
  • Configuración de Google Cloud Platform.

    Para más información, ver Configurar Google Cloud Platform.

Nube de Genesys

  • Una organización de Genesys Cloud. 
  • Los siguientes permisos (como mínimo) seleccionados para el administrador de la integración y las acciones: 
    Notas:
    • Dependiendo de dónde acceda a los permisos en Genesys Cloud, los nombres de los permisos aparecen en diferentes formatos.
    • En lugar de seleccionar permisos individuales Integraciones > Acción, puede seleccionar Integraciones > Acción > Todos los permisos. Este permiso concede a los administradores acceso a todos los permisos actuales y futuros asociados a las acciones.
    • Integraciones > Integración > Editar y Vista

      Estos permisos permiten a los administradores editar y ver integraciones.

    • Integraciones > Acción > Agregar, Borrar, Editar, Ejecutar, y Vista

      Estos permisos permiten a los administradores agregar, eliminar, editar, probar y ver acciones personalizadas.

  • Una o más integraciones de acciones de datos de Google instaladas. Para más información, ver Agregar una integración de acciones de datos.

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

Microsoft Dynamics 365

  • Un usuario capaz de acceder a cualquier dato que desee poner a disposición de la integración de acciones de datos de Microsoft Dynamics 365.

    Utilice las credenciales de este usuario para las credenciales de Microsoft Dynamics 365 cuando agregue la integración a su organización Genesys Cloud. Para más información, ver Agregar una integración de acción de datos.

  • La integración registrada en Azure Active Directory.

    Utilice el ID de la aplicación que se crea cuando agrega la integración a su organización Genesys Cloud. Para más información, ver Registrar la integración y Agregar una integración de acciones de datos.

Nube de Genesys

  • Una organización de Genesys Cloud. 
  • Los siguientes permisos (como mínimo) seleccionados para el administrador de la integración y las acciones: 
    Notas:
    • Dependiendo de dónde acceda a los permisos en Genesys Cloud, los nombres de los permisos aparecen en diferentes formatos.
    • En lugar de seleccionar permisos individuales Integraciones > Acción, puede seleccionar Integraciones > Acción > Todos los permisos. Este permiso concede a los administradores acceso a todos los permisos actuales y futuros asociados a las acciones.
    • Integraciones > Integración > Editar y Vista

      Estos permisos permiten a los administradores editar y ver integraciones.

    • Integraciones > Acción > Agregar, Borrar, Editar, Ejecutar, y Vista

      Estos permisos permiten a los administradores agregar, eliminar, editar, probar y ver acciones personalizadas.

  • Una o más integraciones de acciones de datos de Microsoft Dynamics 365 instaladas. Para más información, ver Agregar una integración de acciones 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.

Salesforce

Nota: Si no selecciona esta configuración en Salesforce, todas las acciones de datos asociadas con la integración fallarán.
  • Un usuario (preferiblemente un administrador del sistema) capaz de acceder a cualquier campo estándar y personalizado que se utilice en Genesys Cloud.

    Asocie este usuario con un perfil en Salesforce que tenga la siguiente configuración seleccionada:

    • Habilitar API 
    • Ver todo (para cuentas, casos y contactos) 

    Cuando agregue la integración en Genesys Cloud, use las credenciales de este usuario para las credenciales de Salesforce. Para más información, ver Agregar una integración de acciones de datos.

  • Habilitar Permitir flujos OAuth nombre de usuario-contraseña ajustes en OAuth y OpenID Connect Configuración. Para obtener más información, consulte Salesforce Release Notes.

Nube de Genesys

  • Una organización de Genesys Cloud. 
  • Los siguientes permisos (como mínimo) seleccionados para el administrador de la integración y las acciones: 
    Notas:
    • Dependiendo de dónde acceda a los permisos en Genesys Cloud, los nombres de los permisos aparecen en diferentes formatos.
    • En lugar de seleccionar permisos individuales Integraciones > Acción, puede seleccionar Integraciones > Acción > Todos los permisos. Este permiso concede a los administradores acceso a todos los permisos actuales y futuros asociados a las acciones.
    • Integraciones > Integración > Editar y Vista

      Estos permisos permiten a los administradores editar y ver integraciones.

    • Integraciones > Acción > Agregar, Borrar, Editar, Ejecutar, y Vista

      Estos permisos permiten a los administradores agregar, eliminar, editar, probar y ver acciones personalizadas.

  • Una o más integraciones de acciones de datos de Salesforce instaladas. Para más información, ver Agregar una integración de acciones de datos.

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

servicio web

  • Un servicio web que admite los siguientes elementos:
    • Llamadas a servicios web basadas en JSON.
    • Sin autenticación, autenticación básica, autenticación definida por el usuario o autenticación definida por el usuario (OAuth). Para más información, ver Tipos de credenciales.
    • Métodos HTTP GET, PUT, POST, PATCH o DELETE.
    • Un punto final HTTPS en el puerto 443. 
      Nota: La integración no admite otros puertos. Para más información, ver ¿Podemos llamar a un servicio web que se ejecuta en un puerto que no sea 443?.
    • Protocolo de cifrado TLS 1.2 o TLS 1.3.
    • Presenta un certificado de confianza pública de una de las autoridades de certificación públicas en las que confía Programa de certificación CA de Mozilla.
    • Proporciona todos los certificados intermedios durante la negociación de TLS.

Nube de Genesys

  • Una organización de Genesys Cloud.
  • Los siguientes permisos (como mínimo) seleccionados para el administrador de la integración y las acciones:
    Notas:
    • Dependiendo de dónde acceda a los permisos en Genesys Cloud, los nombres de los permisos aparecen en diferentes formatos.
    • En lugar de seleccionar permisos individuales Integraciones > Acción, puede seleccionar Integraciones > Acción > Todos los permisos. Este permiso concede a los administradores acceso a todos los permisos actuales y futuros asociados a las acciones.
    • Integraciones > Integración > Editar y Vista

      Estos permisos permiten a los administradores editar y ver integraciones.

    • Integraciones > Acción > Agregar, Borrar, Editar, Ejecutar, y Vista

      Estos permisos permiten a los administradores agregar, eliminar, editar, probar y ver acciones personalizadas.

  • Una o más integraciones de acciones de datos de servicios web instaladas. Para más información, ver Agregar una integración de acciones de datos.
  • Credenciales de autenticación agregadas a la configuración de integración en Genesys Cloud, si es necesario para el servicio web.

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

Zendesk

  • Un usuario verificado en Zendesk (preferiblemente un administrador para fines de control de acceso).

    Utilice este ID de usuario para las credenciales de Zendesk cuando agregue la integración a su organización Genesys Cloud. Para más información, ver Agregar una integración de acciones de datos.

  • Un token de API.

Nube de Genesys

  • Una organización de Genesys Cloud. 
  • Los siguientes permisos (como mínimo) seleccionados para el administrador de la integración y las acciones: 
    Notas:
    • Dependiendo de dónde acceda a los permisos en Genesys Cloud, los nombres de los permisos aparecen en diferentes formatos.
    • En lugar de seleccionar permisos individuales Integraciones > Acción, puede seleccionar Integraciones > Acción > Todos los permisos. Este permiso concede a los administradores acceso a todos los permisos actuales y futuros asociados a las acciones.
    • Integraciones > Integración > Editar y Vista

      Estos permisos permiten a los administradores editar y ver integraciones.

    • Integraciones > Acción > Agregar, Borrar, Editar, Ejecutar, y Vista

      Estos permisos permiten a los administradores agregar, eliminar, editar, probar y ver acciones personalizadas.

  • Una o más integraciones de acciones de datos de Zendesk instaladas. Para más información, ver Agregar una integración de acciones de datos.

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