- Inicio
- /
- Artículo
Gracias por sus comentarios.
En este artículo
¿Comentarios?Cree y configure un activo digital de Chat en Control Hub para Webex Connect, Webex Contact Center o Webex Contact Center Enterprise.
Descripción general
Utilice los canales digitales en Control Hub para crear y configurar un recurso de chat para Web (chat en vivo), móvil (mensajería en la aplicación) y notificaciones push. Los ajustes disponibles para la configuración dependen del servicio seleccionado en Asignar a y de si selecciona Web, Móvil o ambos.
Este artículo describe el proceso completo de configuración de activos, incluidas las capacidades admitidas, la mensajería, las credenciales del proveedor push, la autorización JSON Web Token (JWT), las claves web JSON (JWK), los protocolos de transporte, el registro multiusuario y la configuración específica del servicio después de crear el activo.
Capacidades soportadas
| Capacidad | Webex Connect | Centro de contacto de Webex | Centro de contacto de Webex Enterprise |
|---|---|---|---|
| Chat en vivo en la web | Soportado | Soportado | Soportado |
| Mensajería móvil en la aplicación | Soportado | Soportado | Soportado |
| Web y móvil en un solo activo | Soportado | No soportado | No soportado |
| Móvil - Notificaciones push de Android | Soportado | Soportado | Soportado |
| Móvil - Notificaciones push de iOS | Soportado | Soportado | Soportado |
| Notificaciones Web Push | Soportado (Chrome y Firefox) | No soportado | No soportado |
| JWT - Móvil | Soportado | Soportado y requerido | Soportado y requerido |
| JWT - Web | Soportado | No soportado | No soportado |
| Registros multiusuario | Soportado | Soportado | Soportado |
| Bandeja de entrada del lado del servidor | Soportado | No aplicable | No aplicable |
| Flujo de datos | Soportado | No aplicable | No aplicable |
Antes de comenzar
- Inicie sesión en Control Hub como administrador completo o administrador del centro de contacto que puede administrar activos digitales.
- Asegúrese de que los servicios Webex Connect digitales, Webex Contact Center o Contact Center Enterprise estén aprovisionados para la organización. Sin el derecho, los activos digitales no están disponibles.
- Identifique el punto de entrada y el flujo del centro de contacto que recibirá nuevas conversaciones de chat.
- Si la implementación utiliza notificaciones push móviles, prepare las credenciales de Firebase, Huawei o Apple requeridas por la plataforma seleccionada.
- Si planea usar la autorización JWT, prepare el JWK público utilizado para verificar los tokens emitidos por su backend de confianza.
Configurar el recurso de chat
Para configurar un recurso de chat:
| 1 |
Inicie sesión en Control Hub. |
| 2 |
Vaya a Servicios > Activos digitales. |
| 3 |
Seleccione Crear activo. |
| 4 |
En Configurar detalles de activos, introduzca los siguientes valores:
|
| 5 |
En Mensajería, seleccione la plataforma y configure el chat en vivo/Mensajería en la aplicación y cualquier notificación push requerida. Las opciones mostradas dependen de la plataforma seleccionada. La configuración de notificaciones de Android e iOS está disponible cuando se selecciona Móvil. Web Push está disponible cuando se selecciona Web para un activo asignado aWebex Connect. |
Configurar mensajería
En Mensajería, seleccione la plataforma y configure las capacidades de mensajería para el activo.
Para configurar la mensajería:
Los protocolos de transporte primario y secundario deben ser diferentes. Si el SDK no puede establecer una conexión mediante el protocolo primario, utiliza el protocolo secundario como alternativa.
| 1 |
Plataforma: ParaWebex Connect, seleccione Web, Móvil o ambos. Para Móvil, seleccione Android, iOS o ambos. Para Webex Contact Center o Webex Contact Center Enterprise, seleccione Web o Móvil. |
| 2 |
Chat en vivo/Mensajería en la aplicación: ParaWebex Connect, está disponible para Web y móvil. Para Webex Contact Center o Webex Contact Center Enterprise, Web proporciona chat en vivo y Mobile proporciona mensajería en la aplicación. |
| 3 |
Protocolo de transporte primario: Seleccione MQTT o Web Socket. |
| 4 |
Protocolo de transporte secundario: Seleccione el protocolo no seleccionado como primario. |
Configurar notificaciones push
Habilitar Permitir notificaciones push cuando la aplicación debe recibir notificaciones a través de un proveedor push configurado. Las secciones de notificación que se muestran dependen de la plataforma seleccionada.
Las siguientes opciones de proveedores push están disponibles:
- Android: Firebase Cloud Messaging (FCM), Huawei o ambos. Se aplica a Webex Connect Webex Contact Center y Webex Contact Center Enterprise.
- iOS: FCM, Apple Push Notification Service (APNS) o autenticación basada en tokens para APNS. Se aplica a Webex Connect Webex Contact Center y Webex Contact Center Enterprise.
- Web: Mensajería en la nube de Firebase. Se aplica Webex Connect solo a.
Seleccione la plataforma y configure el proveedor correspondiente en el tema correspondiente.
Obtenga el JSON de la cuenta de servicio de Firebase
Webex utiliza un archivo JSON de la cuenta de servicio de Firebase para autenticar las solicitudes del servidor en Firebase Cloud Messaging. Utilice el proyecto Firebase asociado con su aplicación.
Para obtener y subir el JSON de la cuenta de servicio de Firebase:
Seguridad: La cuenta de servicio de Firebase JSON contiene credenciales confidenciales. Almacenarlo de forma segura y cargar solo el archivo para el proyecto de Firebase previsto.
Para obtener instrucciones de configuración de Firebase Cloud Messaging, consulte Enviar un mensaje mediante la API HTTP v1 de FCM.
| 1 |
Abra Firebase Console y seleccione el proyecto de Firebase utilizado por su aplicación. |
| 2 |
Abra Configuración del proyecto > Cuentas de servicio. |
| 3 |
Seleccione Generar nueva clave privada y confirme la descarga. |
| 4 |
Almacene el archivo JSON descargado de forma segura. El archivo contiene credenciales de clave privada. |
| 5 |
En Control Hub, cargue el archivo JSON en Upload Firebase Service Account JSON para la configuración de notificación de Android, iOS o Web correspondiente. |
Configurar notificaciones push de Android
La sección Notificación de Android aparece cuando se seleccionan Móviles, Android y Permitir notificaciones push. Seleccione al menos un proveedor; Firebase y Huawei se pueden configurar individualmente o juntos. Esta configuración está disponible para los Webex Connect activos Webex Contact Center y Webex Contact Center Enterprise Mobile.
Documentación del proveedor: Huawei - Configuración y pruebas del Push Kit
| 1 |
Seleccione Móvil, Android y Permitir notificaciones push. Se muestra la sección Notificación de Android. |
| 2 |
Seleccione Firebase Cloud Messaging y cargue el archivo JSON de Firebase Service Account requerido desde el proyecto de Firebase. |
| 3 |
Si la aplicación admite dispositivos que usan Huawei Mobile Services, seleccione Huawei e ingrese el ID de la aplicación y el secreto de la aplicación desde AppGallery Connect. Excepción de Huawei: la configuración de Huawei se puede omitir cuando la aplicación no es compatible con dispositivos sin Google Play Services. La Webex Connect guía actual admite EMUI 10.x y versiones posteriores. |
Configurar notificaciones push de iOS
La sección Notificación de iOS se muestra cuando se seleccionan Móviles, iOS y Permitir notificaciones push. Seleccione un proveedor de servicios push. Esta configuración está disponible para los Webex Connect activos Webex Contact Center y Webex Contact Center Enterprise Mobile.
Para obtener instrucciones de configuración de APN basadas en certificados, consulte Establecimiento de una conexión basada en certificados a APN.
Para obtener instrucciones de configuración de APN basadas en símbolos, consulte Establecimiento de una conexión basada en símbolos a APNs.
| 1 |
Seleccione Móvil, iOS y Permitir notificaciones push. Se muestra la sección de notificaciones de iOS. |
| 2 |
Seleccione un proveedor de servicios push. |
| 3 |
Para Firebase Cloud Messaging, cargue el archivo JSON de Firebase Service Account descargado del proyecto de Firebase. |
| 4 |
Para Apple Push Notification Service (APNS), introduzca la contraseña del certificado, seleccione Sandbox o Producción, cargue el certificado APNS, escriba un nombre y valide la configuración. Sólo se admite el formato de certificado.p12. |
| 5 |
Para la autenticación APNS basada en tokens, ingrese el ID de clave, el ID del equipo y el ID del paquete o paquete de aplicaciones, seleccione Sandbox o Producción y cargue el archivo de clave privada APNS. Selección de puerta de enlace: use Sandbox para una aplicación de desarrollo y Producción para una aplicación lista para producción. Almacene la clave privada de APNS de forma segura; Apple permite que el archivo de clave .p8 descargado se recupere una sola vez. |
| 6 |
Reemplace el certificado de proveedor de Apple antes de que caduque para evitar la interrupción de la entrega. |
Configurar notificaciones Web Push
Las notificaciones Web Push están disponibles solo para los activos asignados Webex Connect con Web seleccionado. Chrome y Firefox son compatibles. Safari Web Push no es compatible actualmente.
Las notificaciones Web Push no son compatibles con los activos asignados a Webex Contact Center o Webex Contact Center Enterprise.
Para configurar las notificaciones Web Push:
| 1 |
Confirme que el activo está asignado Webex Connect y que se selecciona Web. |
| 2 |
Utilice Chrome o Firefox para acceder al sitio web y recibir notificaciones Web Push. |
| 3 |
URL del sitio web (requerido): Introduzca la URL del sitio web que recibirá las notificaciones Web Push. |
| 4 |
Icono de notificación (obligatorio): Introduzca la ruta al icono de notificación. El icono debe ser de 80 x 80 píxeles. |
| 5 |
Configure Firebase Cloud Messaging (FCM) para su aplicación web siguiendo la documentación de Firebase. |
| 6 |
Cuenta de servicio de Firebase JSON (obligatorio): Cargue el archivo JSON de la cuenta de servicio de Firebase que contiene la clave privada necesaria para usar la API HTTP v1 de Firebase Cloud Messaging. |
Configurar la autorización de JSON Web Token
La autorización de JWT requiere que la comunicación del SDK se autorice mediante un token web JSON válido. Para los activos nuevos, el tipo de cifrado es asimétrico.
El soporte de JWT es el siguiente:
- Webex Connect: Compatible con dispositivos móviles y web en el mismo activo.
- Webex Contact Center y Webex Contact Center Enterprise - Web: No soportado.
- Webex Contact Center y Webex Contact Center Enterprise - Móvil: soportado y requerido para la configuración de activos móviles.
Configure los siguientes parámetros:
- Tipo de cifrado: Asimétrico para nuevos activos.
- Caducidad del token (requerido): Introduzca durante cuánto tiempo el JWT permanece válido antes de que se requiera un nuevo token de identidad de usuario. Rango válido: 5-360 minutos. Predeterminado: 60 minutos.
- Claves web JSON (requerido): Cargue el JWK público utilizado para verificar los tokens. Puede agregar una segunda llave para la rotación. Máximo: dos llaves.
Agregue y prepare la clave web JSON pública como se describe en los temas secundarios.
Prepare el JWK público
El archivo cargado debe contener la clave pública de verificación RSA. Webex valida las siguientes propiedades de JWK.
Las propiedades de JWK se definen en RFC 7517, Sección 4. Las propiedades específicas del algoritmo se definen en RFC 7518.
| Nombre de la propiedad | Descripción |
|---|---|
| alg | Identifica el algoritmo criptográfico utilizado con la clave. El valor requerido es RS256, que especifica RSASSA-PKCS1- usando SHA-256. v1_5 |
| e | El exponente de la clave pública RSA, representado como un valor codificado en Base64Urluint. |
| key_ops | Especifica la operación para la que está destinada la llave. El valor admitido es verificar, lo que indica que la clave se utiliza para verificar las firmas digitales. Consulte RFC 7517, Sección 4.3. |
| kty | Identifica la familia de algoritmos criptográficos utilizada con la clave. El valor debe ser RSA. Consulte RFC 7517, Sección 4.1. |
| n | El módulo de la clave pública RSA, representado como un valor codificado en Base64Urluint. |
| utilizar | Especifica el uso previsto de la clave pública. El valor debe ser sig, lo que indica que la clave está destinada a la verificación de la firma. Consulte RFC 7517, Sección 4.2. |
| niño | Identifica la clave y se utiliza para que coincida con una clave específica, como durante la rotación de teclas. Consulte RFC 7517, Sección 4.5. |
Agregar una clave web JSON
Para agregar una clave web JSON pública:
| 1 |
Seleccione Agregar clave. |
| 2 |
Introduzca un nombre de clave web JSON. |
| 3 |
Introduzca el emisor de clave web JSON. Este valor debe coincidir con el emisor utilizado por el backend de confianza cuando genera el JWT. |
| 4 |
Cargue el archivo público JWK. |
| 5 |
Seleccione Guardar. |
Configurar registros multiusuario
Habilitar Permitir registros de varios usuarios en el mismo dispositivo cuando varios usuarios pueden registrarse en el mismo dispositivo físico.
- Las notificaciones push se entregan tanto para usuarios registrados activos como inactivos.
- El chat en vivo o la mensajería en la aplicación se entrega al usuario activo actualmente. Los mensajes para usuarios inactivos se ponen en cola hasta que el usuario vuelve a activarse.
Configurar Webex Connect ajustes adicionales
- Dispositivo único por usuario: Restringe a un usuario a un dispositivo registrado. Al registrarse en un nuevo dispositivo, se detiene la entrega al dispositivo anterior.
- Bandeja de entrada del lado del servidor: Almacena una copia del lado del servidor de los datos de la bandeja de entrada para su posterior recuperación.
- Flujo de datos: envía los datos de eventos aplicables a la Webex Connect integración seleccionada para los mensajes enviados a través de la API de mensajería.
Ahorre para crear el activo
Después de configurar la mensajería, la autorización JWT, el registro multiusuario y los Webex Connect ajustes correspondientes, guarde la configuración para crear el recurso de chat.
|
Seleccione Guardar para crear el activo. Espere la confirmación de que el activo se creó correctamente.
|
Integración completa del servicio
Después de crear el recurso Chat, complete la integración para el servicio seleccionado en Asignar a. Siga el procedimiento aplicable para Webex Connect Webex Contact Center o Webex Contact Center Enterprise.
Webex ConnectIntegración completa
Para un activo asignado aWebex Connect, complete el mapeo del servicio y la configuración de flujo enWebex Connect. No se requiere autorización de nodo.
Puede usar un nodo de inicio, un evento personalizado o un webhook personalizado para capturar eventos entrantes y activar un flujo. Para obtener más información, consulte Nodo de inicio, Evento personalizado y Webhook personalizado.
| 1 |
Inicie sesión enWebex Connect. |
| 2 |
Complete la asignación de servicios y la configuración de flujo aplicables para el recurso de Chat. |
| 3 |
Registre el ID de aplicación y la clave de cliente generados. |
| 4 |
Descargue el archivo de configuración del SDK para cada plataforma seleccionada. |
Integración completa del centro de contacto de Webex
Para un activo asignado al Centro de contacto de Webex, asigne el activo a un punto de entrada del Centro de contacto y, a continuación, complete la autorización del nodo de Webex Contact Center.
| 1 |
Abra la configuración del centro de contacto en Control Hub. |
| 2 |
Cree o abra el punto de entrada que recibe conversaciones de chat. |
| 3 |
En Flow Mapping, seleccione el recurso Chat y el flujo de entrada de clientes requerido. |
| 4 |
Guarde el punto de entrada y verifique el mapeo de activos y flujos. |
| 5 |
Completar la autorización del nodo del centro de contacto de Webex enWebex Connect. Para obtener instrucciones, consulte Nodos de integración de tareas y autorizaciones de nodos de Webex CC. |
| 6 |
Para una implementación web, configure el widget de chat en vivo y obtenga el código de inserción del sitio web en Control Hub. |
Integración completa de Webex Contact Center Enterprise
Para un activo asignado a Webex Contact Center Enterprise, complete la autorización del nodo CCE Webex Connect antes de configurar el flujo de enrutamiento.
| 1 |
Inicie sesión enWebex Connect. |
| 2 |
Autorización completa del nodo CCE. Para obtener instrucciones, consulte Nodos de integración CCE y autorizaciones de nodos. |
| 3 |
Configure los nodos de integración CCE y el flujo de enrutamiento aplicables para el activo de Chat. Para obtener ejemplos de flujo, consulte Configuraciones de flujo. |
| 4 |
Guarde y pruebe el flujo. |
Para obtener orientación adicional sobre la configuración, consulte Prácticas recomendadas y directrices y preguntas frecuentes.
Excepciones y limitaciones
Tenga en cuenta las siguientes excepciones y limitaciones:
- Confirme el canal, la plataforma, la asignación y la elección de enrutamiento antes de crear el activo. El canal no se puede cambiar después de la creación y los cambios de plataforma están restringidos por la carga de trabajo.
- Para Webex Contact Center y Webex Contact Center Enterprise, un solo activo no puede usar Web y Mobile juntos. Cree activos separados cuando ambos sean necesarios.
- Las notificaciones Web Push están disponibles solo paraWebex Connect. Safari Web Push, Webex Contact Center Web Push y Webex Contact Center Enterprise Web Push no son compatibles.
- La autorización JWT no es compatible con los activos web asignados a Webex Contact Center o Webex Contact Center Enterprise.
- Para Webex Contact Center y Webex Contact Center Enterprise, realice la configuración de punto de entrada, flujo, widget y código incrustado en la sección Centro de contacto de Control Hub.
- ParaWebex Connect, complete el servicio y la configuración del flujo enWebex Connect.
- No elimine un recurso de Chat después de que se haya asignado a un servicio sin antes eliminar o actualizar la asignación descendente. Un activo eliminado no se puede restaurar y puede dejar un mapeo existente inutilizable.
- Después de la creación, conserve el ID de aplicación, la clave de cliente y los archivos de configuración del SDK generados necesarios para inicializar el SDK adecuado.
