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 la fuente de su bot desde el menú de administración 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 usa esta acción, proporciona una lista de bots. 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 obtener información sobre precios, consulte Traiga su propio modelo de servicios tecnológicos (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 poder 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.
- 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 usuarios finales.
Haga clic en Default para restablecer este parámetro.
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.
Haga clic en Default para restablecer este parámetro.
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. Se trata de un parámetro opcional que puede ayudarle 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).
Haga clic en Default para restablecer este parámetro.
Autoridad de certificación cliente TLS mutua Seleccione la autoridad de firma MTLS del certificado de cliente utilizado por la integración. Sólo es aplicable cuando Enable Mutual TLS tiene el valor 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. Para ello, siga estos pasos:
- 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.
Cuando activas una nueva integración o guardas una que ya está activa, el sistema valida los cambios de integración. Si la validación falla, se muestra un mensaje de error que indica la causa del error. Independientemente de si una integración está activa o no, estos mensajes de error junto con los detalles de la integración se publican en los 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"