Mobile SDK

Version actuelle : 2.2 (corrélation avec la version 24.4 CXone Mpower)
Références API :

Pour vous aider à mettre en œuvre la trousse SDK mobile, vous devez acheter la trousse d’implémentation de base auprès de NICE. Un partenaire de NICE vous accompagne tout au long de la mise en œuvre.

Mobile SDK vous permet d’intégrer le clavardage numérique CXone Mpower dans vos application de téléphones mobiles d’entreprise. 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ériquesFermé 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 avez configurées dans CXone Mpower, comme les notifications poussées ou les messages enrichis. Le SDK prend en charge à la fois iOS et les applications Android. Les applications iOS doivent être écrites en Swift Ce lien s’ouvre dans une nouvelle fenêtre et les application Android doivent être écrites en Kotlin Ce lien s’ouvre dans une nouvelle fenêtre.

Avec Mobile SDK :

Pour un aperçu des avantages du SDK, vous pouvez consulter la fiche technique de Mobile SDK Ce lien s’ouvre dans une nouvelle fenêtre. Vous pouvez également regarder une courte vidéo de démonstration Ce lien s’ouvre dans une nouvelle fenêtre.

Ressources SDK

Téléchargez les trousses SDK à partir des référentiels GitHub publics (Android Ce lien s’ouvre dans une nouvelle fenêtre iOS Ce lien s’ouvre dans une nouvelle fenêtre). 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 Ce lien s’ouvre dans une nouvelle fenêtre iOS Ce lien s’ouvre dans une nouvelle fenêtre).

Vos développeurs peuvent également consulter des exemples d’applications pour les deux plateformes Android Ce lien s’ouvre dans une nouvelle fenêtre et iOS Ce lien s’ouvre dans une nouvelle fenêtre. Ils offrent aux développeurs des exemples de fonctionnalités mises en œuvre.

Version du SDK mobile

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

NICE prend en charge la version majeure actuelle et une version précédente du SDK. Par exemple, si la version actuelle est 2.2, NICE prend en charge les versions 2.2 et 1.3 (la dernière version 1.xx).

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. Ce qui suit explique la dénotation :

  • 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.

Utilisation du SDK mobile avec Digital Experience

Le SDK mobile est un moyen d'étendre Digital Experience et de fournir numérique le chat 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.

Diagramme de l’infrastructure SDK mobile

Construction de votre interface utilisateur de clavardage

En tant qu’intégrateur, vous êtes responsable de la création de votre interface utilisateur de clavardage. Cela est nécessaire pour bénéficier de certaines fonctionnalités telles que l’affichage et le traitement de fichiers ou l’enregistrement de messages vocaux. Par exemple, vous devrez ajouter un bouton sur lequel les contacts pourront appuyer pour accéder au microphone de l’appareil et enregistrer le message. Vous pouvez vous reporter aux exemples d’applications (Android Ce lien s’ouvre dans une nouvelle fenêtre iOS Ce lien s’ouvre dans une nouvelle fenêtre) pour des exemples d’implémentation de l’interface utilisateur.

Vous pouvez utiliser une trousse de développement d’interface utilisateur tiers, comme MessageKit. Toutefois, cela peut s’avérer contraignant en fonction de votre cas d’utilisation. Par ailleurs, CXone Mpower n’est propriétaire d’aucun logiciel d’interface utilisateur tiers et n’en garantit pas la prise en charge.

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

  • Fil : Une conversation dans l’application de clavardage. Le premier message envoyé par l’agent ou le contactFermé 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 d’application selon laquelle le contact ne peut avoir qu’une seule conversation à la fois.

  • Multi-fils : Une conception d’application selon laquelle le contact peut avoir plusieurs conversations en même temps.

  • Canal : Dans le contexte de Digital Experience, le canal désigne le type de messagerie ou la plateforme utilisée 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.

  • ChannelId : L’ID du canal de clavardage 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 (ACDDigitalPoints d’accès numériquesClavardageInitialisation et test).

  • BrandId : Similaire à un ID de locataireFermé Regroupement organisationnel de haut niveau utilisé pour gérer le support technique, la facturation et les paramètres globaux pour votre environnement CXone Mpower 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 (ACDDigitalPoints d’accès numériquesClavardageInitialisation et test).

  • CustomerId : L’ID unique de l’utilisateur final du clavardage. 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 de l’application mobile. 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 : La plateforme principale 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 canaux numériques.