Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Integre aplicaciones de terceros en el espacio de trabajo del agente
El espacio de trabajo de agentes de Connect Customer brinda a sus agentes las herramientas y la orientación paso a paso para resolver los problemas rápidamente y ofrecer una mejor experiencia a los clientes con menos capacitación. El espacio de trabajo de los agentes incluye aplicaciones nativas y propias, como los perfiles de clientes, los casos y la asistencia a los agentes. También puede integrar aplicaciones de terceros.
nota
Third-party las aplicaciones solo se admiten en el espacio de trabajo de los agentes de Connect Customer; no se admiten en los escritorios de agentes personalizados.
Por ejemplo, puedes integrar un sistema de reservas propio o un panel de control de un sistema de gestión de reclamaciones de terceros en el espacio de trabajo de los agentes.
Los desarrolladores interesados en crear una aplicación de terceros pueden consultar la Guía para desarrolladores de Agent Workspace.
Tipos de integración
Una integración conecta algo externo a Connect Customer con tu instancia. Creas una integración una vez para una AWS cuenta y una región, la asocias a una o más instancias y le concedes permisos. Elige un tipo de integración en la página Agregar integración. El tipo determina lo que configuras y cómo Connect Customer llega a la integración.
-
Aplicación estándar: una aplicación web que Connect Customer renderiza en un iframe en el espacio de trabajo del agente. Los agentes la abren desde el lanzador de aplicaciones. Usted proporciona una URL de acceso, permisos de iframe y un alcance de contacto que se establece cuando la aplicación se actualiza. Usa este tipo para una aplicación en la que trabajen tus agentes, como una herramienta de búsqueda de pedidos o una aplicación de programación.
-
Servicio: una aplicación automática que se crea y que se ejecuta en segundo plano en el espacio de trabajo de los agentes. Un servicio se inicia cuando se carga el espacio de trabajo del agente y permanece activo durante el resto de la sesión. No tiene una interfaz para que un agente la abra. Utilice este tipo para tareas que se ejecutan por sí solas, como reaccionar ante eventos de contacto, como la conexión, la desconexión y el trabajo posterior al contacto, abrir una aplicación cuando se cumple una condición o completar un flujo de autenticación tan pronto como se inicie la sesión. Para obtener más información, consulte Creación de servicios de terceros en la Guía para desarrolladores de Agent Workspace.
-
Servidor MCP: un servidor de Model Context Protocol que proporciona a los agentes de IA de Connect Customer un conjunto de herramientas a las que pueden llamar. Lo conectas a través de una AgentCore puerta de enlace de Bedrock en lugar de una URL de acceso, y cada puerta de enlace sirve a un servidor MCP. Para ver el procedimiento completo, consulte Integre un servidor MCP con Connect Customer.
Los pasos siguientes describen cómo agregar una aplicación estándar.
Permisos de IAM necesarios
Si utilizas políticas de IAM personalizadas para gestionar el acceso a aplicaciones de terceros, tus usuarios necesitan permisos de IAM adicionales. AdemásAmazonConnect_FullAccess, los usuarios necesitan lo siguiente:
Agregue una aplicación de terceros
nota
Para añadir una integración a tus instancias, asegúrate de que la instancia utilice un Service-Linked rol (SLR). Si tu instancia actualmente no usa una SLR pero deseas agregar una integración, tendrás que migrarla a una SLR. La integración solo se puede añadir a las instancias que utilizan una SLR. Para obtener más información, consulte Para las instancias creadas antes de octubre de 2018.
-
Abra la consola Connect Customer
(https://console.aws.amazon.com/connect/). -
En el panel de navegación, elija Integraciones. Si no ves este menú, significa que las aplicaciones 3P no están disponibles en tu AWS región. Para comprobar dónde están disponibles las aplicaciones 3P, consulta. Disponibilidad de Connect Customer características por región
-
En la página de integraciones, seleccione Añadir integración.
-
En la página Agregar integración, complete los campos de información de integración:
-
Nombre para mostrar: un nombre descriptivo para la aplicación 3P. El nombre aparece en los perfiles de seguridad y en la pestaña del espacio de trabajo del agente. Puede cambiarlo más adelante.
-
Descripción (opcional): una descripción de la aplicación 3P. Los agentes no ven la descripción.
-
Tipo de integración: indica si la integración es una aplicación web estándar (aplicación 3P), un servicio (servicio 3P) o un servidor MCP. El tipo determina la forma en que los agentes interactúan con la integración.
-
Identificador de integración: nombre único para las integraciones de tipo aplicación o servicio estándar. Si solo tiene una aplicación por URL de acceso, le recomendamos que utilice el origen de la URL de acceso. No puede cambiar este nombre.
Complete los campos de detalles de la integración:
-
Alcance del contacto: indica si la aplicación web se actualiza para cada contacto o solo para cada nueva sesión de navegador. Esta configuración afecta a la frecuencia con la que la aplicación actualiza sus datos.
-
Tiempo de espera de inicialización: el tiempo máximo, en milisegundos, para establecer una conexión con el espacio de trabajo. Esta configuración ayuda a administrar los problemas de conexión y garantiza el inicio puntual de la aplicación.
Complete los campos de acceso:
-
URL de acceso: la URL en la que está alojada la aplicación. La URL debe empezar por
https, a menos que sea un host local. No todas las URL se pueden utilizar en iframes. Para obtener más información, consulte Comprueba si una URL se puede enmarcar. -
Orígenes aprobados (opcional): se deben permitir otras URL, si son diferentes de la URL de acceso. Cada URL debe empezar por
https, a menos que se trate de un host local.
Añada permisos a los eventos y las solicitudes y defina la configuración del Iframe. Ambos son opcionales.
En Asociación de instancias, elige las instancias que pueden usar la aplicación:
-
Puedes conceder acceso a la aplicación a cualquier instancia de esta AWS cuenta y región.
-
Asociar la integración a una instancia es opcional, pero no puedes usar la aplicación hasta que lo hagas.
nota
En el caso de los servidores MCP, puedes elegir solo la instancia que esté configurada con la URL de detección de la puerta de enlace seleccionada.
-
-
Seleccione Add Integration.
-
Si la integración se crea correctamente, la página de detalles de la integración aparece con un banner de éxito.
Puede editar algunos atributos de una integración existente, como su nombre para mostrar, la URL de acceso y los permisos.
Si se produce un error al crear la integración o al asociarla a una instancia, aparece un mensaje de error. Sigue el mensaje para corregir el problema.
Comprueba si una URL se puede enmarcar
No todas las URL se pueden utilizar en iframes. Hay dos formas de comprobar si una URL se puede enmarcar con iframe:
-
Usa la herramienta de terceros Iframe Tester
para comprobar si una URL puede enmarcarse. -
Si una URL puede estar enmarcada, la página muestra una vista previa.
-
Si una URL no puede enmarcarse, la página mostrará un error en la vista previa. Es posible que el sitio web muestre un error aunque la aplicación aún pueda estar enmarcada en el espacio de trabajo del agente. Un desarrollador de aplicaciones puede restringir su aplicación para que solo se pueda incrustar en el espacio de trabajo del agente. Si recibió la aplicación de un desarrollador de aplicaciones, intente integrarla en el espacio de trabajo del agente.
-
-
Para usuarios técnicos: compruebe el contenido de la política de seguridad de la aplicación que desea integrar.
-
Firefox: abre el menú desplegable y, a continuación, selecciona Más herramientas, Herramientas para desarrolladores web y Red.
-
Chrome: abre el menú de tres puntos y, a continuación, selecciona Más herramientas, Herramientas para desarrolladores y Red.
-
Otros navegadores: busca la configuración de red en las herramientas para desarrolladores.
La
Content-Security-Policy frame-ancestorsdirectiva debería serhttps://. Si la directiva esyour-instance.my.connect.awssame originodeny, Connect Customer no puede crear un iframe en la URL. -
Esto es lo que puedes hacer si la aplicación no puede enmarcarse en forma de iframe:
-
Si controlas la aplicación o la URL, actualiza la política de seguridad del contenido de la aplicación. Para obtener más información, consulte las recomendaciones y prácticas recomendadas en la Guía para desarrolladores de Agent Workspace.
-
Si no controlas la aplicación o la URL, pide al desarrollador de la aplicación que actualice la política de seguridad del contenido de la aplicación.
Ejemplo: agregar una aplicación y asignar permisos
El siguiente ejemplo muestra cómo incorporar una nueva aplicación y asignarle permisos en Consola de administración de AWS. En este ejemplo, se asignan seis permisos a la aplicación.
Información básica y detalles de acceso
Permisos para la integración de datos del espacio de trabajo
Configuración de iframe
Eliminar integraciones
Si ya no necesitas una integración, puedes eliminarla. Para dejar de usar una integración temporalmente, desasociala de la instancia. La desasociación evita tener que volver a añadir la integración. Para eliminar una integración, abra, seleccione la integración y Consola de administración de AWS, a continuación, elija Eliminar.
Resolución de problemas
-
La eliminación falla si la integración sigue asociada a una instancia. Desasocie la integración de todas las instancias y, a continuación, elimínela.
sugerencia
Si creaste una integración antes del 15 de diciembre de 2023, es posible que tengas problemas para actualizar su asociación con las instancias. Primero tienes que actualizar tu política de IAM.
Actualiza tu política de IAM para incluir los siguientes permisos:
-
app-integrations:CreateApplicationAssociation -
app-integrations:DeleteApplicationAssociation