Configurar la integración de Genesys Digital Bot Connector
- Integración > BotConnector > Ver permiso
- Integración > BotConnector > Enviar permiso
Puede utilizar su propia fuente de bot de terceros en los flujos de mensajes de Architect. Configure su fuente de bot desde la página de integraciones de Genesys Cloud. A continuación, utilice la acción de Architect Call Digital Bot Connector para integrar el flujo de mensajería con cualquier origen de bot para procesarlo antes de que devuelva entidades, o ranuras, e intents a Architect. Cuando utilice esta acción, proporcione una lista de robots. Architect utiliza esta lista para rellenar campos como el nombre, la versión y las intenciones del bot y, a continuación, proporciona la información de la llamada al bot del cliente para su procesamiento.
- Antes de obtener la integración de Genesys Digital Bot Connector, debe ponerse en contacto con Genesys Cloud Sales para actualizar su suscripción.
- Trabaje con un ingeniero de software para desarrollar una capa de traducción. Esta capa permite que los bots de terceros se comuniquen con las API de Genesys Cloud. Para obtener más información, consulte la especificación de la API del cliente del conector de bots digitales en el Centro de desarrollo.
- Puedes añadir un máximo de cinco integraciones de Digital Bot Connector.
- Para más información sobre precios, consulte Modelo de servicios "Traiga su propia tecnología" (tarifas por turno/minuto).
- Cuando los agentes inician una conversación en directo con un cliente, pueden ver las conversaciones de mensajería anteriores que el cliente ha mantenido con el bot externo que utiliza la integración Genesys Digital Bot Connector.
- Puedes obtener el rango de direcciones IP para Digital Bot Connector y añadirlas a tu lista de permitidos. El proceso para obtener el rango de direcciones IP tanto para Digital Bot Connector como para Bot Connector (legacy) es el mismo. Para más información, consulta ¿Cómo puedo obtener el rango de direcciones IP de mi región desde donde podrían originarse las peticiones del protocolo Bot Connector para añadirlo a mi lista de permitidos?
Para configurar y activar la integración de Genesys Digital Bot Connector, siga estos pasos:
- Hacer clic Administración.
- Debajo Integraciones, haga clic en Integraciones.
- Haga clic en Menú > TI e integraciones > Integraciones.
- Hacer clic Integraciones.
- Busque o navegue hasta el mosaico Genesys Digital Bot Connector.
- Hacer clic Instalar en pc. La integración se abre al Detalles pestaña.
- (Opcional) Cambie el nombre de la integración y agregue notas sobre la integración. Nota: Si cambia el nombre de la integración, asegúrese de usar nombres únicos para diferenciar las integraciones y las acciones asociadas en las aplicaciones de Genesys Cloud que hacen referencia a ellas.
- Haga clic en el Configuración pestaña.
- En Propiedades, introduzca los siguientes valores:
Nombre de la propiedad Valor Permitir adjuntar archivos Indique si la integración debe admitir transferencias de archivos desde el bot de terceros a los participantes.
Para restablecer este parámetro, haga clic en Default.
Perfil de contenido admitido Seleccione el perfil de contenido compatible con Genesys para definir los tipos de archivo que pueden enviar los bots. Sólo es aplicable cuando Enable Attachment of files está configurado como True.
Para restablecer este parámetro, haga clic en Default.
Bot Conector URI Introduzca el URI que Genesys utiliza para retransmitir una expresión de un chat al bot Digital Bot Connector.
Por ejemplo,
https://mycustomserver:443/botconnector/
.Proveedor de bot Introduzca el nombre del proveedor de bots de terceros como referencia. Este parámetro opcional le ayuda a obtener información de los informes. Activar TLS mutuo Indique si la integración debe admitir o no la seguridad mutua de la capa de transporte (MTLS).
Para restablecer este parámetro, haga clic en Default.
Autoridad de certificación cliente TLS mutua Seleccione la autoridad de firma MTLS del certificado de cliente utilizado por la integración. Esta opción sólo es aplicable cuando se establece Enable Mutual TLS en True.
Para obtener más información sobre los certificados de confianza para MTLS, consulte Compatibilidad de MTLS con la integración de Genesys Digital Bot Connector.
- Haga clic en el Cartas credenciales pestaña y agregue credenciales de acceso para el bot de terceros. Nota: Estas credenciales le permiten proporcionar un token autorizado para el acceso de bot y aparecen en el encabezado de la llamada REST.
- Hacer clic Configurar. Se abre el cuadro de diálogo Configurar credenciales.
- Hacer clic Agregar campo de credencial.
- En el Nombre del campo y Valor campos, ingrese el token de acceso apropiado para el bot.
- Hacer clic OK.
- Activar la integración.
- Junto a la integración del conector de bot, haga clic en el Estado alternar para cambiarlo de Inactivo para Activo. Aparece un cuadro de diálogo Cambiar estado.
- Hacer clic sí. La integración ahora está activa.
- Repite los pasos 3-11 para añadir hasta cuatro integraciones de conectores de bots digitales más.
Validar la integración
Cuando realice y guarde los cambios en la pestaña Configuration, valide los cambios para asegurarse de que ha configurado la integración correctamente.
- Establezca el interruptor Estado en Inactivo y haga clic en Sí.
- Vuelva a poner el interruptor Estado en Activo y haga clic en Sí. Si la configuración es correcta y Genesys Cloud no encuentra errores durante el proceso de activación, el estado de la integración cambia a Active.
Al activar una nueva integración o guardar una integración activa, el sistema valida los cambios de integración. Si la validación falla, aparece un mensaje que indica la causa del error. Independientemente de si una integración está activa o no, Genesys Cloud publica estos mensajes, junto con los detalles de la integración, en eventos operativos.
- "Error de validación: Valor no válido para Bot Connector URI: Debe seguir a <scheme>://<network location>/<path> (por ejemplo, https://mycustomserver:443/botconnector/)"
- "Error de validación: Valor no válido para Bot Connector URI: La integración tiene un esquema URI de Bot Connector no válido. Debe ser https"