Mobile SDK

Mobile SDK le permite integrar CXone Mpower el chat digital en su teléfono móvil empresarial aplicaciones. 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 digital 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 tarea principal de sus desarrolladores es mostrar y administrar visualmente las funciones que usted configura en CXone Mpower, como las notificaciones push o los mensajes enriquecidos Elementos de la mensajería digital como botones, imágenes, menús y selectores de opciones..

El SDK admite tanto iOS como Android aplicaciones. iOS aplicaciones debe escribirse en Swift y Android aplicaciones debe escribirse en Kotlin . Además, el SDK requiere una versión mínima Android de 7.0 y una versión mínima iOS de 15.0.

Con Mobile SDK:

• Puede implementar canales de chat en vivo y de mensajería de chat. El SDK no admite el chat a través de Guide.
  • El chat en vivo es mensajería en tiempo real.
  • La mensajería de chat es mensajería asincrónica, como los mensajes directos (DM).
• Los contactos pueden tener múltiples interacciones con su centro de contacto al mismo tiempo a través de la mensajería de múltiples hilos En una aplicación de subprocesos múltiples, los contactos pueden crear tantos subprocesos como deseen para discutir nuevos temas. Estos hilos pueden estar activos al mismo tiempo.. También puede establecer una configuración de un solo hilo En una aplicación de un solo hilo, cada contacto tiene un hilo de chat que maneja cualquier interacción que tenga con su organización..
• Puede usar multimedia enriquecida para agregar mensajes interactivos como respuestas rápidas, listas o enlaces a su chat en la aplicación.
• Los contactos y los agentes pueden compartir archivos adjuntos, como videos y documentos.
• Los contactos y los agentes pueden seguir participando viendo cuándo la otra persona está escribiendo.
• Puede activar notificaciones en la aplicación y notificaciones push en función de eventos, como la llegada de un nuevo mensaje.
• Puede crear reglas proactivas para mostrar contenido en la aplicación según los eventos o condiciones.
• Puede iniciar interacciones con mensajes de bienvenida y formularios previos al chat para recopilar información inicial de un contacto.

Recursos del SDK

Descargue los paquetes del SDK de los repositorios GitHub públicos (Android iOS ). 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 iOS ).

Sus desarrolladores también pueden consultar la muestra aplicaciones tanto para Android como para iOS Plataforma. Esto ayuda a los desarrolladores a ver ejemplos de funcionalidad implementada.

Mobile SDKControl de versiones

Las versiones del SDK generalmente se actualizan junto con las CXone Mpower principales versiones de marketing, como 25.3, 25.4, etc. En GitHub, cada versión de lanzamiento se etiqueta de acuerdo con la versión semántica que se explica a continuación.

Usted es responsable de mantener su aplicación actualizado ya que el SDK también se actualiza. 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. Además, tenga en cuenta que el SDK es compatible con las dos últimas versiones principales.

Cambios de versión

Cuando la versión del SDK cambia de una versión a otra, el número de versión indica el tipo de cambio:

• 2.0.0: El primer número indica el cambio principal de API.

• 2.1.0: El segundo número denota un cambio no disruptivo. A menudo, se agregan nuevas funciones como cambios que no alteran el funcionamiento normal.

• 2.0.1: El tercer número indica una corrección de error. Estos siempre son compatibles con versiones anteriores.

Corrección de errores

NiCE Servicios Profesionales trabaja con usted en la corrección de errores. Puede enviar errores a través de ellos (o del socio de implementación) y ellos le comunicarán las correcciones además del registro de cambios del SDK.

Además, todos los errores se corrigen en las versiones compatibles actualmente. Por ejemplo, si la versión actual es 3.0, entonces las dos versiones compatibles son 3.0 y 2.3 (la última versión de 2.x). Si encontrara un error en la v2.1, NiCE lo solucionaría para la 2.3 y la 3.0, pero no para la 2.1 o la 2.2.

Cómo encaja el Mobile SDKen el Digital Experience

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

Por ejemplo, parte del proceso de introducción consiste en configurar un canal de chat digital en CXone Mpower. Luego, tu aplicación debe crear una conexión WebSocket con el canal de chat digital que creaste. 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 Mpower, que luego puede utilizar con el SDK.

Crear la interfaz de usuario del chat

El Mobile SDK viene con un módulo UI/UX predeterminado. Puede elegir implementarlo como parte del paquete de implementación estándar. Esto reduce sustancialmente el tiempo de implementación. El módulo predeterminado maneja automáticamente todas las funciones de chat, lo que reduce la necesidad de desarrollo adicional de su parte, como por ejemplo:

• Mensajes enriquecidos Elementos de la mensajería digital como botones, imágenes, menús y selectores de opciones.

• Archivos adjuntos

• Trabajar con archivos

• Mensajes de error

• Comportamiento de los emojis

Sin embargo, es posible que desees realizar algunas configuraciones adicionales, como localización, notificaciones push y autenticación OAuth. Si desea admitir cualquier idioma además de English, debe proporcionar traducciones para las cadenas de texto. Si implementa un lenguaje distinto del English, asegúrese de probar todas las áreas de la interfaz de usuario para garantizar que la visualización se gestione de forma adecuada.

El ejemplo Mobile SDK aplicación muestra la UI/UX predeterminada. La documentación del módulo UI/UX está en el propio módulo para que sus desarrolladores la revisen.

Por último, también puedes elegir utilizar o desarrollar tu propia interfaz de usuario; no estás obligado a utilizar la interfaz de usuario/experiencia de usuario predeterminada. Si utiliza su propia interfaz de usuario (o un paquete de interfaz de usuario de terceros), NiCE no proporciona soporte para ella.

Mobile SDK Limitaciones

• Para ayudarlo a comenzar a implementar Mobile SDK, debe comprar el paquete de implementación básico de NiCE. Un socio de NiCE lo guía a través de la implementación.

• Es posible que desee comprar horas de Servicios Profesionales de NiCE para preguntas sobre la configuración fuera de Mobile SDK.

• El SDK no se puede utilizar sin una aplicación móvil existente. Debes tener tu propia aplicación escrita nativamente en Kotlin o Swift.

• No se admiten marcos no nativos o híbridos, como React Native.

• Este SDK funciona con el chat independiente Digital, no con el chat a través de Guide.

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 Mpower? ¿Puede un administrador ayudarlo a configurar las funciones necesarias en la CXone MpowerPlataforma?
• ¿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

Término	Detalles
Hilo	Una conversación dentro del chat aplicación. El primer mensaje enviado por el agente o el contacto 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 aplicación donde el contacto solo puede tener una conversación a la vez.
Múltiples hilos	Un diseño 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 Plataforma utilizado 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 CXone MpowerPlataforma. 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.
ID de canal	El ID del canal de chat digital creado en la sección Digital de CXone Mpower. Puede encontrarlo en la configuración del canal de chat en CXone Mpower (ACD > Digital > Puntos de contacto digital > Chat > Inicialización y prueba).
Identificación de marca	Esto es como un ID de inquilino Agrupación organizativa de alto nivel utilizado para administrar el soporte técnico, facturación y configuración global para su sistema CXone Mpower. para Digital Experience. Se utiliza para inicializar el chat. Puede encontrarlo en la configuración del canal de chat en CXone Mpower (ACD > Digital > Puntos de contacto digital > Chat > Inicialización y prueba).
ID de cliente	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 la implementación de CXone Mpower. 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 Mpower 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 del teléfono móvil aplicación. 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 Mpower	El núcleo Plataforma donde administras y accedes a todas las herramientas de experiencia del cliente que CXone Mpower 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 Mpower.
Digital Experience	La sección de CXone Mpower donde podrás administrar todo sobre los canales digitales.