CXone Mobile SDK

Versión actual: 2.1
Referencias de API:

CXone Mobile SDK permite integrar el chat digital de CXone en las aplicación móviles de su empresa. Esto permite a los usuarios de la aplicación chatear con los agentes y bots de su centro de contacto a través de canales de chat digitalCerrado Cualquier canal, contacto o habilidad asociados con Digital Experience.. El SDK simplifica el proceso de implementación del chat digital; los desarrolladores no necesitan encargarse de la implementación de la lógica empresarial. La principal tarea de sus desarrolladores es mostrar y gestionar visualmente las funciones que configure en CXone, como las notificaciones push o los mensajes enriquecidos. El SDK es compatible con las aplicacións iOS y Android. Las aplicacións de iOS se deben escribir en Swift Este enlace se abre en una ventana nueva y las aplicacións de Android se deben escribir en Kotlin Este enlace se abre en una ventana nueva.

Con CXone Mobile SDK:

Para una visión general de las ventajas del SDK, puede consultar la hoja de datos de CXone Mobile SDK Este enlace se abre en una ventana nueva. También puede ver un breve video de demostración Este enlace se abre en una ventana nueva.

Recursos del SDK

Descargue los paquetes del SDK de los repositorios GitHub públicos (Android Este enlace se abre en una ventana nueva iOS Este enlace se abre en una ventana nueva). Ambos repositorios contienen un archivo README para ayudarlo a empezar a desarrollar. También ofrecen casos de uso con ejemplos de código en /docs. Úselos como inspiración mientras desarrolla su chat. Ambos repositorios también incluyen registros de cambios.

Puede acceder a las referencias de la API en su navegador (Android Este enlace se abre en una ventana nueva iOS Este enlace se abre en una ventana nueva).

Los desarrolladores también pueden consultar ejemplos de aplicacións para ambas Plataformas de Android Este enlace se abre en una ventana nueva y iOS Este enlace se abre en una ventana nueva. Esto ayuda a los desarrolladores a ver ejemplos de funcionalidad implementada.

Versiones del SDK para móviles

La versión actual del SDK es la 2.0, que se corresponde con la versión principal de CXone 24.2. La sección más arriba de Recursos del SDK proporciona enlaces a los recursos más actualizados.

En los repositorios del SDK, puede utilizar las etiquetas para encontrar versiones anteriores del SDK.

Cómo se integra el SDK para móviles en Digital Experience

El SDK para móviles es una forma de ampliar Digital Experience y proporcionar chat digital en aplicacións móviles. Digital Experience es la parte de CXone que admite canales digitales. Ejemplos de canales digitales son WhatsApp, publicaciones en Facebook, o chat digital. Para agregar el chat digital de CXone en sus aplicacións, debe configurar ciertas funciones en al sección Digital Experience de la interfaz de CXone. Luego, con el SDK, accede y usa las funciones que configuró en CXone.

Por ejemplo, parte del proceso de introducción consiste en configurar un canal de chat digital en CXone. Su aplicación crea una conexión WebSocket con el canal que ha creado. También puede configurar funciones avanzadas como mensajes de bienvenida o encuestas previas al chat. Esto le ofrece una variedad de opciones para agilizar la optimizar la experiencia de los usuarios de la aplicación. Los usuarios pueden proporcionar información inicial sobre su problema o solicitud, ingresar datos personales básicos, etc. Estas funciones se configuran inicialmente en CXone, que luego puede utilizar con el SDK.

Diagrama de infraestructura de SDK para móviles

Crear la interfaz de usuario del chat

Como integrador, es responsable de crear su interfaz de usuario del chat. Esto es necesario para aprovechar ciertas funciones como la mostrar y trabajar con archivos o grabar mensajes de voz. Por ejemplo, tendría que agregar un botón para que los contactos presionen para acceder al micrófono del dispositivo para grabar el mensaje. Puede consultar las aplicacións de ejemplo (Android Este enlace se abre en una ventana nueva iOS Este enlace se abre en una ventana nueva) para ver cómo implementar la interfaz de usuario.

Puede usar un kit de desarrollo de IU de terceros, como MessageKit. Sin embargo, esto podría ser limitante dependiendo de su caso de uso. Además, NICE CXone no posee ni proporciona soporte para ningún paquete de interfaz de usuario de terceros.

Antes de empezar a desarrollar

Considere los siguientes elementos antes de crear usando el SDK móvil:

  • ¿Dispone de una cuenta de administrador y de agente en CXone? ¿Puede un administrador ayudarlo a configurar las funciones necesarias en la CXonePlataforma?
  • ¿Su aplicación móvil está disponible para iOS (Apple), Android, o ambos? ¿Sus desarrolladores están familiarizados con los lenguajes Swift y Kotlin?
  • ¿Dispone de canales de mensajería de chat o quiere crear uno nuevo?
  • ¿Utilizará OAuth para autenticar a los usuarios de la aplicación? En caso afirmativo, ¿qué proveedor de OAuthusará?
  • ¿Desea ofrecer conversaciones de un solo hilo o multihilo?
  • ¿Utilizará acciones proactivas como ventanas emergentes o mensajes de bienvenida?
  • ¿Desea usar notificaciones push? ¿Dispone de cuentas de Firebase o Apple Developer?
  • ¿Qué tipos de mensajes enriquecidos quiere configurar? ¿En qué casos puede aprovechar estos mensajes interactivos?
  • ¿Quiere hacer un seguimiento de los datos de los usuarios? ¿Cómo puede utilizar los eventos de visitante para producir análisis?

Términos clave

  • Hilo: Una conversación dentro de una aplicación de chat. El primer mensaje enviado por el agente o el contactoCerrado La persona que interactúa con un agente, IVR o bot en su centro de contacto. inicia un hilo. Cada mensaje consecutivo de la conversación se agrega al hilo. Los hilos son objetos que contienen cada mensaje. Los mensajes se estructuran según el autor del mensaje. Un threadId identifica una conversación completa, y todos los mensajes dentro de una conversación tienen un ID de mensaje. Un hilo termina cuando finaliza la conversación.

  • Un solo hilo: Un diseño de aplicación donde el contacto sólo puede tener una conversación a la vez.

  • Múltiples hilos: Un diseño de aplicación donde el contacto puede tener múltiples conversaciones a la vez.

  • Canal: En el contexto de Digital Experience, canal se refiere al tipo de mensajería o la Plataforma utilizada para la comunicación. Por ejemplo, puede tener un canal de mensajería de WhatsApp en tiempo real. El SDK para móviles permite agregar un canal de mensajería de chat a su aplicación móvil. Se crea un canal en CXonePlataforma. Esto determina la configuración del canal junto con un ID de canal. Este ID se utiliza para iniciar el canal de chat cuando un usuario de la aplicación abre el chat.

  • ChannelId: El ID del canal de chat digital creado en la sección Digital de CXone. Puede encontrarlo en la configuración del canal de chat en CXone (ACDDigitalPuntos de contacto digitalChatInicialización y prueba).

  • BrandId: Es como un ID de abonadoCerrado Agrupación organizativa de alto nivel utilizado para administrar el soporte técnico, facturación y configuración global para su CXone entorno para Digital Experience. Se utiliza para inicializar el chat. Puede encontrarlo en la configuración del canal de chat en CXone (ACDDigitalPuntos de contacto digitalChatInicialización y prueba).

  • CustomerId: El ID único del usuario final del chat. El SDK crea este ID cuando se inicializa el chat. Si tiene OAuth configurado, este ID permanece igual para cada contacto en todos sus dispositivos. Si no lo ha configurado OAuth, este ID es diferente para cada dispositivo; el ID se convierte en un inicio de sesión de invitado.

  • Región o Entorno: La ubicación en el mundo donde se aloja su implementación de CXone. Puede ser: Australia (AU1), Canadá (CA1), Europa (EU1), Japón (JP1), Norteamérica (NA1) o Reino Unido (UK1). El desarrollador debe utilizar la misma región en la que su sistema CXone está alojado, de lo contrario se rechazará la conexión al chat.

  • Contacto, cliente y usuario: Todos estos términos se refieren al usuario final de la aplicación móvil. La ayuda en línea suele utilizar el término contacto. En la documentación del SDK y en los comentarios de código, es probable que vea cliente y usuario.

  • CXone:La Plataforma principal donde se gestionan y se accede a todas las herramientas de experiencia de cliente que NICE CXone ofrece. Dependiendo de las funciones de chat que desee ofrecer en su aplicación móvil, un administrador con los permisos de cuenta de usuario necesarios debe completar varias tareas de configuración en CXone.

  • Digital Experience: La sección de CXone donde se puede gestionar todo lo relacionado con los canales digitales.