Mobile SDK

Mobile SDK vous permet d'intégrer CXone Mpower le clavardage numérique dans votre téléphone mobile d'entreprise applications. Cela permet aux utilisateurs de l’application de clavarder avec les agents de votre centre d’appels et les robots par l’intermédiaire des canaux de clavardage numériques Tout canal, contact ou compétence associé à Digital Experience.. Le SDK simplifie le processus d’implémentation du clavardage numérique; les développeurs n’ont pas besoin de s’occuper de l’implémentation de la logique commerciale. 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 la messagerie numérique tels que les boutons, les images, les menus et les sélecteurs d’options..

Le SDK supporte 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 clavardage en direct et de messagerie instantanée. Le SDK ne prend pas en charge le clavardage via Guide.
  • Le clavardage 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 d’appels en même temps grâce à la messagerie multi-fils Dans une application multi-fils, 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 utiliser une configuration à fil unique Dans une application à fil unique, chaque contact dispose d’un fil de clavardage qui gère toutes les interactions qu’il a avec votre organisation..
• Vous pouvez utiliser des médias enrichis pour ajouter des messages interactifs tels que des réponses rapides, des listes ou des liens à votre clavardage au sein de l’application.
• Les contacts et les agents peuvent partager entre eux des pièces jointes, comme des vidéos et des documents.
• Les contacts et les agents restent engagés en voyant quand l’autre est en train de taper.
• Vous pouvez déclencher des notifications au sein de l’application et des notifications poussées en fonction d’événements, tels que l’arrivée d’un nouveau message.
• Vous pouvez créer des règles proactives pour faire apparaître du contenu dans l’application en fonction d’événements ou de conditions.
• Vous pouvez démarrer les interactions avec des messages de bienvenue et des formulaires de préalables au clavardage pour recueillir les premières informations d’un contact.

Ressources SDK

Téléchargez les trousses SDK à partir des référentiels GitHub publics (Android iOS ). Les deux référentiels contiennent un fichier LISEZ-MOI pour vous aider à commencer à développer. Ils proposent également des cas d’utilisation avec des exemples de code dans /docs. Inspirez-vous-en pour développer votre clavardage. Les deux référentiels comprennent également des journaux des modifications.

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

Vos développeurs peuvent aussi consulter des exemples applications pour les Android et iOS plateforme. Ils offrent aux développeurs des exemples de fonctionnalités mises en œuvre.

Mobile SDKGestion des versions

Les versions du SDK sont généralement mises à jour avec les CXone Mpower principales versions marketing, comme 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 SDK ci-dessus fournit des liens vers les ressources les plus récentes. Dans les référentiels 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 clavardage sur mobile applications. Digital Experience est la partie de CXone Mpower qui prend en charge les canaux numériques. Les canaux numériques sont WhatsApp, les publications sur Facebook ou le clavardage 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 vous les utilisez.

Par exemple, une partie du processus de démarrage consiste à configurer un canal de clavardage 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, comme des messages de bienvenue ou des sondages préalables au clavardage. Vous disposez ainsi d’un large éventail d’options pour rationaliser l’expérience des utilisateurs de votre application. Les utilisateurs peuvent fournir des informations initiales sur leur problème ou leur demande, saisir des données personnelles de base, etc. Ces fonctionnalités sont initialement configurées dans CXone Mpower, que vous pouvez ensuite utiliser avec le SDK.

Construction de votre interface utilisateur de clavardage

Le Mobile SDK est livré avec un module UI/UX par défaut. Vous pouvez choisir de l'implémenter dans le cadre du paquet 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 clavardage, ce qui réduit le besoin de développement supplémentaire de votre part, comme :

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

• Pièces jointes

• Travailler avec des fichiers

• Messages d'erreur

• Comportement des émojis

Vous voudrez peut-être toutefois effectuer certaines configurations supplémentaires, comme la localisation, les notifications poussées et l'authentification OAuth. Si vous voulez 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 vous assurer 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 aussi 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 paquet d'interface utilisateur tiers), NiCE ne fournit pas de soutien pour celle-ci.

Mobile SDK Limites

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

• Vous voudrez 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 cadres non natifs ou hybrides ne sont pas pris en charge, comme React Native.

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

Avant de commencer à développer

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

• Disposez-vous d’un compte d’administrateur et d’un compte d’agent dans CXone Mpower? Un administrateur peut-il vous aider à configurer les fonctionnalités nécessaires dans la plateforme CXone Mpower?
• 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 par clavardage ou souhaitez-vous en créer un nouveau?
• Comptez-vous utiliser OAuth pour authentifier vos utilisateurs application? Si oui, quel fournisseur OAuth comptez-vous utiliser?
• Souhaitez-vous proposer des conversations à fil unique ou multi-fils?
• Utiliserez-vous des actions proactives comme des fenêtres contextuelles ou des messages de bienvenue?
• Voulez-vous utiliser les notifications poussées? Disposez-vous déjà d’un compte Firebase ou Apple Developer?
• Quels types de messages enrichis souhaitez-vous configurer? Quels sont les cas d’utilisation où vous pouvez tirer parti de ces messages interactifs?
• Souhaitez-vous suivre les données des utilisateurs? Comment pouvez-vous utiliser les événements de visiteur pour produire des analyses?

Termes clés

Terme	Détails
Fil	Une conversation dans le clavardage application. Le premier message envoyé par l’agent ou le contact La personne qui interagit avec un agent, un IVR ou un robot dans votre centre d’appels. commence un fil de discussion. 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 une conversation entière, et tous les messages d’une conversation ont un ID de message. Un fil se termine lorsque la conversation prend fin.
Fil unique	Une conception application où le contact ne peut avoir qu'une seule conversation à la fois.
Multi-fils	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 courriel ou au plateforme utilisé pour la communication. Par exemple, vous pourriez avoir un canal de messagerie en temps réel WhatsApp. Le SDK mobile vous permet d’ajouter un canal de messagerie par clavardage à votre application mobile. Un canal est créé dans la plateforme CXone Mpower. Cela détermine les paramètres du canal ainsi que l’ID du canal. Vous utilisez cet ID pour lancer le canal de clavardage lorsqu’un utilisateur de application ouvre le clavardage.
Identifiant de canal	L'ID du canal de discussion numérique créé dans la section Digital de CXone Mpower. Vous trouverez ces informations dans les paramètres du canal de clavardage dans CXone Mpower (ACD > Digital > Points d’accès numériques > Clavardage > Initialisation et test).
Identifiant de marque	Il s'agit d'un identificateur de locataire pour Digital Experience. Il est utilisé pour initialiser le clavardage. Vous trouverez ces informations dans les paramètres du canal de clavardage dans CXone Mpower (ACD > Digital > Points d’accès numériques > Clavardage > Initialisation et test).
ID client	L'identifiant unique de l'utilisateur final du chat. Le SDK crée cet ID lors de l’initialisation du clavardage. Si vous avez configuré OAuth, cet ID reste le même pour chaque contact sur tous ses appareils. Si vous n’avez pas configuré OAuth, cet ID est différent pour chaque appareil; l’ID devient similaire à un identifiant d’invité.
Région ou environnement	L’endroit dans le monde où votre déploiement CXone Mpower est hébergé. Les options sont : Australie (AU1), Canada (CA1), Europe (EU1), Japon (JP1), Amérique du Nord (NA1) ou Royaume-Uni (UK1). Le développeur doit utiliser la même région que celle où votre système CXone Mpower est hébergé, sans quoi la connexion au clavardage 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 dans les commentaires de code, vous verrez probablement 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 offerts par CXone Mpower. En fonction des fonctions de clavardage que vous souhaitez proposer dans votre application mobile, un administrateur disposant des autorisations nécessaires pour le compte d’utilisateur doit effectuer plusieurs tâches de configuration dans CXone Mpower.
Digital Experience	La section de CXone Mpower où vous pouvez gérer tout ce qui concerne les chaînes numériques.