Mobile SDK

Mobile SDK vous permet d'intégrer CXone Mpower le chat numérique dans votre téléphone mobile d'entreprise applications. Cela permet aux utilisateurs de application de communiquer avec les agents et robots de votre centre de contact par l’intermédiaire des canaux de chat numériques Tout canal, contact ou compétence associé à Digital Experience.. Le SDK simplifie le processus d’implémentation du chat numérique ; les développeurs ne doivent pas nécessairement traiter l’implémentation de la logique métier. La tâche principale de vos développeurs est d'afficher et de gérer visuellement les fonctionnalités que vous configurez dans CXone Mpower, comme les notifications push ou les messages enrichis Éléments de messagerie numérique, tels que des boutons, des images, des menus et des sélecteurs d’options..

Le SDK prend en charge iOS et Android applications. iOS applications doit être écrit en Swift et Android applications doit être écrit en Kotlin . De plus, le SDK nécessite une version minimale Android de 7.0 et une version minimale iOS de 15.0.

Avec Mobile SDK :

• Vous pouvez mettre en œuvre à la fois des canaux de chat en direct et de messagerie instantanée. Le SDK ne prend pas en charge le chat via Guide.
  • Le chat en direct est une messagerie en temps réel.
  • La messagerie instantanée est une messagerie asynchrone, comme les messages directs (DM).
• Les contacts peuvent avoir plusieurs interactions avec votre centre de contact en même temps au moyen de la messagerie multi-fils Dans une application multithread, les contacts peuvent créer autant de fils de discussion qu'ils le souhaitent pour discuter de nouveaux sujets. Ces fils peuvent être actifs en même temps.. Vous pouvez également le configurer pour mettre en place une messagerie à un seul fil Dans une application à fil unique, chaque contact à un fil de discussion qui traite toutes les interactions qu’il peut avoir avec votre organisation..
• Vous pouvez utiliser les médias enrichis pour ajouter des messages interactifs tels que des réponses rapides, des listes ou des liens à votre chat intégré dans l’application.
• Les contacts et les agents peuvent partager des pièces jointes, telles que des vidéos et des documents.
• Afin de conserver l’attention des contacts et des agents, il est possible de voir si l’autre partie est en train de saisir du texte.
• Vous pouvez déclencher des notifications intégrées dans l’application et push en fonction d'événements, tels que l'arrivée d'un nouveau message.
• Vous pouvez créer des règles proactives pour afficher du contenu dans l'application en fonction d'événements ou de conditions.
• Vous pouvez lancer les interactions avec des messages de bienvenue et des formulaires de collecte d'informations préliminaires.

Ressources du SDK

Téléchargez les packages du SDK depuis les référentiels GitHub publics (Android iOS ). Ces deux référentiels contiennent un fichier README pour en faciliter les premières étapes du développement. Ils incluent également des cas d’utilisation et des exemples de code dans /docs. Vous pouvez utiliser cela comme modèle pour développer votre solution de chat. Les deux référentiels incluent également des journaux de modification.

Vous pouvez accéder aux références de l’API dans votre navigateur (Android iOS ).

Vos développeurs peuvent également consulter des exemples Applications pour les Android et iOS plateforme. Cela permet aux développeurs de disposer d’exemples de fonctionnalités implémentées.

Mobile SDKGestion des versions

Les versions du SDK sont généralement mises à jour avec les CXone Mpower principales versions marketing, telles que 25.3, 25.4, etc. Dans GitHub, chaque version de publication est étiquetée selon le contrôle de version sémantique expliqué ci-dessous.

Vous êtes responsable de maintenir votre application à jour car le SDK est également mis à jour. La section Ressources du SDK ci-dessus comporte des liens vers les ressources les plus à jour. Dans les référentiels du SDK, vous pouvez utiliser les balises pour trouver les versions précédentes du SDK. Sachez également que le SDK est rétrocompatible avec les deux dernières versions majeures.

Modifications de version

Lorsque la version du SDK change d'une version à l'autre, le numéro de version indique le type de modification :

• 2.0,0 : le premier chiffre indique le changement majeur de l'API.

• 2.1.0 : Le deuxième chiffre indique un changement ininterrompu. Souvent, de nouvelles fonctionnalités sont ajoutées sous forme de modifications non-ruptures.

• 2.0.1 : Le troisième numéro indique une correction de bogue. Ceux-ci sont toujours rétrocompatibles.

Corrections de bugs

NiCE Les services professionnels travaillent avec vous sur la correction des bugs. Vous pouvez leur soumettre des bugs (ou via le partenaire d'implémentation), et ils vous communiquent les correctifs en plus du journal des modifications du SDK.

De plus, tous les bugs sont corrigés dans les versions actuellement prises en charge. Par exemple, si la version actuelle est 3.0, les deux versions prises en charge sont 3.0 et 2.3 (la dernière version à partir de 2.x). Si vous avez trouvé un bug dans la version 2.1, NiCE le corrigera pour les versions 2.3 et 3.0, mais pas pour les versions 2.1 ou 2.2.

Comment le Mobile SDKs'intègre dans Digital Experience

Le Mobile SDK est un moyen d'étendre Digital Experience et de fournir numérique un chat sur mobile applications. Digital Experience est la partie de CXone Mpower qui prend en charge les canaux numériques. Les exemples de canaux numériques sont WhatsApp, les publications sur Facebook ou le chat numérique. Pour ajouter le chat numérique CXone Mpower à votre applications, vous devez configurer certaines fonctionnalités dans la section Digital Experience de l'interface CXone Mpower. Ensuite, avec le SDK, vous accédez aux fonctionnalités que vous avez configurées dans CXone Mpower et pouvez les utiliser.

Par exemple, une partie du processus de prise en main consiste à configurer un canal de chat numérique dans CXone Mpower. Ensuite, votre application doit créer une connexion WebSocket avec le canal de discussion numérique que vous avez créé. Vous pouvez également configurer des fonctionnalités avancées, telles que les messages de bienvenue ou les sondages de préparation au chat. Ces derniers comportent plusieurs options permettant d’optimiser votre expérience utilisateur application. Les utilisateurs peuvent fournir des informations de base sur leur problème ou demande, saisir les données personnelles nécessaires, etc. Ces fonctionnalités sont d’abord configurées dans CXone Mpower, puis peuvent être utilisées dans le SDK.

Création de l’interface utilisateur de chat

Le Mobile SDK est livré avec un module UI/UX par défaut. Vous pouvez choisir de l’implémenter dans le cadre du package d’implémentation standard. Cela réduit considérablement le temps de mise en œuvre. Le module par défaut gère automatiquement toutes les fonctionnalités de chat, ce qui réduit le besoin de développement supplémentaire de votre part, comme :

• Messages riches Éléments de messagerie numérique, tels que des boutons, des images, des menus et des sélecteurs d’options.

• Pièces jointes

• Travailler avec des fichiers

• Messages d'erreur

• Comportement des émojis

Vous souhaiterez peut-être toutefois effectuer certaines configurations supplémentaires, telles que la localisation, les notifications push et l'authentification OAuth. Si vous souhaitez prendre en charge une langue autre que English, vous devez fournir des traductions pour les chaînes de texte. Si vous implémentez un langage non English, assurez-vous de tester toutes les zones de l'interface utilisateur pour garantir que l'affichage est géré de manière appropriée.

L'exemple Mobile SDK application présente l'interface utilisateur/UX par défaut. La documentation du module UI/UX se trouve dans le module lui-même, pour que vos développeurs puissent la consulter.

Enfin, vous pouvez également choisir d’utiliser ou de développer votre propre interface utilisateur ; vous n’êtes pas obligé d’utiliser l’interface utilisateur/UX par défaut. Si vous utilisez votre propre interface utilisateur (ou un package d'interface utilisateur tiers), NiCE ne fournit pas de support pour celle-ci.

Mobile SDK Limitations

• Pour vous aider à démarrer l'implémentation du Mobile SDK, vous devez acheter le package d'implémentation de base auprès de NiCE. Un partenaire de NiCE vous accompagne tout au long de la mise en œuvre.

• Vous souhaiterez peut-être acheter des heures de services professionnels auprès de NiCE pour des questions concernant la configuration en dehors du Mobile SDK.

• Le SDK ne peut pas être utilisé sans une application mobile existante. Vous devez avoir votre propre application écrite nativement en Kotlin ou Swift.

• Les frameworks non natifs ou hybrides ne sont pas pris en charge, tels que React Native.

• Ce SDK fonctionne avec un chat autonome Digital, pas avec un chat via Guide.

Avant de procéder au développement

Tenez compte des éléments suivants avant d'utiliser le SDK mobile :

• Disposez-vous à la fois d’un compte administrateur et d’un compte agent dans CXone Mpower ? Un administrateur peut-il vous aider à configurer les fonctionnalités requises dans CXone Mpowerplateforme ?
• Votre application mobile est-elle disponible pour iOS (Apple), Android ou les deux ? Vos développeurs connaissent-ils les langages Swift et Kotlin ?
• Disposez-vous de canaux de messagerie instantanée ou voulez-vous en créer un ?
• Utiliserez-vous OAuth pour authentifier vos utilisateurs application ? Si oui, quel fournisseur OAuth utiliserez-vous ?
• Voulez-vous proposer des conversations à fil unique ou à fils multiples ?
• Allez-vous utiliser des actions dynamiques, telles que des fenêtres contextuelles ou des messages de bienvenue ?
• Voulez-vous utiliser des notifications push ? Disposez-vous d’un compte Firebase ou Apple Developer ?
• Quels types de messages enrichis voulez-vous configurer ? Quels sont les cas d’utilisation où vous pouvez exploiter ces messages interactifs ?
• Voulez-vous suivre les données utilisateur ? Comment pouvez-vous utiliser les événements relatifs au visiteur pour produire des analyses ?

Mots-clés

Terme	Détails
Fil	Une conversation dans le chat application. Le premier message envoyé par l’agent ou le contact La personne interagissant avec un agent, un serveur vocal interactif (SVI), ou robot dans votre centre de contact. commence un fil. Chaque message consécutif de la conversation est ajouté au fil. Les fils sont des objets qui contiennent chaque message. Les messages sont structurés par l’auteur du message. Un threadId identifie l’ensemble d’une conversation, et tous les messages appartenant à une conversation ont un ID de message. Un fil se termine lorsque la conversation se termine.
Fil unique	Une conception application où le contact ne peut avoir qu'une seule conversation à la fois.
Multi-fil	Une conception application où le contact peut avoir plusieurs conversations à la fois.
Canal	Dans le contexte de Digital Experience, canal fait référence au type de messagerie ou au plateforme utilisé pour la communication. Par exemple, vous pouvez avoir un canal WhatsApp de messagerie en temps réel. Le SDK mobile permet d’ajouter un canal de messagerie instantanée à votre application mobile. Un canal est créé dans CXone Mpowerplateforme. Cela détermine les paramètres du canal, ainsi que l’ID de canal. Vous utilisez cet ID pour initier le canal de chat lorsqu’un utilisateur application ouvre le chat.
Identifiant de canal	L'ID du canal de discussion numérique créé dans la section Digital de CXone Mpower. Vous trouverez cela dans les paramètres du canal de chat dans CXone Mpower (ACD > Digital > Points de contact numériques > Chat > Initialisation et test).
Identifiant de la marque	Il s'agit d'un identifiant de locataire Regroupement organisationnel de haut niveau utilisé pour gérer le support technique, la facturation et les paramètres globaux de votre système CXone Mpower. pour Digital Experience. Cela est utilisé pour initialiser le chat. Vous trouverez cela dans les paramètres du canal de chat dans CXone Mpower (ACD > Digital > Points de contact numériques > Chat > Initialisation et test).
ID client	L'ID unique de l'utilisateur final du chat. Le SDK crée cet ID lorsque le chat est initialisé. Si vous avez configuré OAuth, cet ID reste tel quel pour chaque contact sur tous ses périphériques. Si vous n’avez pas configuré OAuth, cet ID est différent pour chaque périphérique ; l’ID se comporte comme un identifiant d’invité.
Région ou environnement	La partie du monde où votre déploiement CXone Mpower est hébergé. Cela peut être : Australie (AU1), Canada (CA1), Europe (EU1), Japon (JP1), Amérique du Nord (NA1) ou Royaume-Uni (UK1). Le développeur doit utiliser la région où votre système CXone Mpower est hébergé, sinon la connexion de chat est rejetée.
Contact, client et utilisateur	Ces termes font tous référence à l’utilisateur final du mobile application. L’aide en ligne utilise généralement le terme contact. Dans la documentation du SDK et les commentaires du code, vous verrez généralement les termes client et utilisateur.
CXone Mpower	Le cœur plateforme où vous gérez et accédez à tous les outils d'expérience client proposés par CXone Mpower. Selon les fonctionnalités de chat que vous souhaitez offrir dans votre application mobile, un administrateur disposant des autorisations de compte utilisateur nécessaires doit compléter plusieurs tâches dans CXone Mpower.
Digital Experience	La section de CXone Mpower où vous pouvez gérer tout ce qui concerne les chaînes numériques.