Mobile SDK

Aktuelle Version: 2.2 (entspricht der Version 24.4 CXone Mpower)
API-Referenzen:

Um mit der Implementierung der mobilen SDK zu beginnen, müssen Sie das Basis-Implementierungspaket von NICE kaufen. Ein Partner von NICE führt Sie durch die Implementierung.

Mit dem Mobile SDK können Sie den CXone Mpower digitalen Chat in die Mobiltelefon-App Ihres Unternehmens integrieren. Auf diese Weise können App-Benutzer über digitaleGeschlossen Alle Kanäle, Kontakte, oder Skills, die mit Digital Experience verknüpft sind. Chatkanäle mit den Agenten und Bots Ihres Contact Centers chatten. Das SDK vereinfacht die Implementierung des digitalen Chats; Entwickler müssen sich nicht um die Implementierung der Geschäftslogik kümmern. Hauptaufgabe Ihrer Entwickler ist es, die Funktionen visuell darzustellen und zu verwalten, die Sie in CXone Mpower einrichten, zum Beispiel Push-Benachrichtigungen oder Rich Messages. Das SDK unterstützt iOS- und Android-Apps. iOS-Apps müssen in Swift Dieser Link wird in einem neuen Fenster geöffnet undAndroid-Apps in Kotlin Dieser Link wird in einem neuen Fenster geöffnet geschrieben werden.

Das Mobile SDK ermöglicht Folgendes:

Im Datenblatt Mobile SDK Dieser Link wird in einem neuen Fenster geöffnet sehen Sie die Vorteile des SDK in einer Übersicht. Sie können sich auch ein kurzes Demo-Video Dieser Link wird in einem neuen Fenster geöffnet ansehen.

SDK-Ressourcen

Laden Sie die SDK-Pakete aus öffentlichen GitHub-Repositorys (Android Dieser Link wird in einem neuen Fenster geöffnet iOS Dieser Link wird in einem neuen Fenster geöffnet) herunter. Beide Repositorys enthalten eine README-Datei, die Ihnen den Einstieg erleichtert. Im Verzeichnis /docs finden Sie auch Anwendungsfälle mit Codebeispielen. Nutzen Sie diese als Inspirationsquelle, wenn Sie Ihren Chat entwickeln. Beide Repositorys enthalten auch Änderungsprotokolle.

Sie können die API-Referenzen in Ihrem Browser (Android Dieser Link wird in einem neuen Fenster geöffnet iOS Dieser Link wird in einem neuen Fenster geöffnet) aufrufen.

Ihre Entwickler können sich auch Beispiel-Anwendungs für Android Dieser Link wird in einem neuen Fenster geöffnet und iOS Dieser Link wird in einem neuen Fenster geöffnet Plattformen ansehen. So können sie Beispiele für die implementierten Funktionen nachvollziehen.

Versionen des mobilen SDK

Die SDK-Versionen werden im Allgemeinen zusammen mit den CXone Mpower wichtigsten Marketing-Releases wie 25.2, 25.3 usw. aktualisiert. In GitHub wird jede Release-Version entsprechend der unten erläuterten semantischen Versionierung gekennzeichnet.

NICE unterstützt die aktuelle und eine vorherige Hauptversion des SDK. Wenn die aktuelle Version beispielsweise 2.2 ist, unterstützt NICE v2.2 und 1.3 (die neueste 1.xx-Version).

Sie sind dafür verantwortlich, Ihr App auf dem neuesten Stand zu halten, da auch das SDK aktualisiert wird. Im Abschnitt weiter oben zu den SDK-Ressourcen finden Sie Links zu den neuesten Ressourcen. In den SDK-Repositorys können Sie Tags nutzen, um frühere Versionen des SDK zu suchen. Beachten Sie außerdem, dass das SDK bis zu den letzten beiden Hauptversionen abwärtskompatibel ist.

Versionsänderungen

Wenn sich die SDK-Version von Release zu Release ändert, gibt die Versionsnummer den Typ der Änderung an. Die Bezeichnung wird im Folgenden erläutert:

  • 2.0,0: Die erste Zahl kennzeichnet die wesentliche API-Änderung.

  • 2.1.0: Die zweite Zahl kennzeichnet eine nicht bahnbrechende Änderung. Häufig werden neue Funktionen als Änderungen hinzugefügt, die keine wesentlichen Auswirkungen haben.

  • 2.0.1: Die dritte Zahl kennzeichnet eine Fehlerbehebung. Diese sind immer abwärtskompatibel.

Fehlerbehebungen

NICE Professional Services arbeitet mit Ihnen an der Fehlerbehebung. Sie können über sie (oder den Implementierungspartner) Fehler melden und sie teilen Ihnen zusätzlich zum SDK-Änderungsprotokoll auch Fehlerbehebungen mit.

Außerdem werden sämtliche Fehler in den aktuell unterstützten Versionen behoben. Wenn die aktuelle Version beispielsweise 3.0 ist, dann sind die beiden unterstützten Versionen 3.0 und 2.3 (die neueste Version von 2.x). Wenn Sie einen Fehler in v2.1 finden, behebt NICE ihn für 2.3 und 3.0, aber nicht für 2.1 oder 2.2.

Wie sich das mobile SDK in Digital Experience einfügt

Das mobile SDK ist eine Möglichkeit, den Digital Experience Chat auf Mobilgeräten zu erweitern und digital bereitzustellen Apps. Digital Experience ist der Teil von CXone Mpower, der digitale Kanäle unterstützt. Beispiele für digitale Kanäle sind WhatsApp, Beiträge auf Facebook oder digitaler Chat. Um den CXone Mpower digitalen Chat zu Ihrem Apps hinzuzufügen, müssen Sie bestimmte Funktionen im Abschnitt Digital Experience der CXone Mpower Benutzeroberfläche konfigurieren. Mit dem SDK können Sie dann auf Funktionen zugreifen, die Sie in CXone Mpower eingerichtet haben, und sie verwenden.

Zu den ersten Schritten gehört es zum Beispiel, einen digitalen Chatkanal in CXone Mpower einzurichten. Anschließend muss Ihr App eine WebSocket Verbindung mit dem von Ihnen erstellten digitalen Chat-Kanal herstellen. Sie könnten auch erweiterte Funktionen wie Begrüßungsnachrichten oder vor dem Chat anzuzeigende Umfragen einrichten. Damit haben Sie verschiedene Möglichkeiten, das Nutzererlebnis in Ihrer App zu verbessern. Benutzer können so zum Beispiel erste Informationen über ihr Anliegen eingeben, Angaben zu ihrer Person machen usw. Diese Funktionen werden anfangs in CXone Mpower eingerichtet, was Sie dann mit dem SDK verwenden können.

Diagramm der Struktur des mobilen SDK

Benutzeroberfläche des Chats entwickeln

Da Sie die Integration vornehmen, sind Sie für die Entwicklung der Chat-Benutzeroberfläche zuständig. Dies ist erforderlich, um bestimmte Funktionen zu nutzen, zum Beispiel die Anzeige von und die Arbeit mit Dateien oder das Aufzeichnen von Sprachnachrichten. Sie müssten zum Beispiel eine Schaltfläche hinzufügen, auf die Kontakte klicken, um das Mikrofon ihres Geräts zu aktivieren, damit sie eine Nachricht aufnehmen können. In den Beispiel-Anwendungen (Android Dieser Link wird in einem neuen Fenster geöffnet iOS Dieser Link wird in einem neuen Fenster geöffnet) sehen Sie, wie die UI implementiert wird.

Sie können ein Drittanbieterpaket für die Entwicklung von Benutzeroberflächen verwenden, zum Beispiel MessageKit. Je nach Anwendungsfall ergeben sich dadurch möglicherweise Einschränkungen. CXone Mpower ist nicht der Eigentümer von Drittanbieter-UI-Paketen und leistet keinen Support dafür.

Bevor Sie mit der Entwicklung beginnen

Berücksichtigen Sie vor der Entwicklung mit dem mobilen SDK die folgenden Punkte:

  • Haben Sie sowohl ein Administrator- als auch ein Agentenkonto in CXone Mpower? Kann ein Administrator Ihnen bei der Einrichtung der nötigen Funktionen in der CXone MpowerPlattform helfen?
  • Ist Ihre mobile App für iOS (Apple), Android oder beide verfügbar? Sind Ihre Entwickler mit den Programmiersprachen Swift und Kotlin vertraut?
  • Haben Sie bestehende Chat-Messaging-Kanäle oder möchten Sie einen neuen erstellen?
  • Möchten Sie OAuth für die Authentifizierung der App-Benutzer verwenden? Falls ja, welchen OAuth-Anbieter verwenden Sie?
  • Möchten Sie Unterhaltungen mit nur einem Thread oder mit mehreren Threads anbieten?
  • Sollen proaktive Aktionen wie Popups oder Begrüßungsnachrichten verwendet werden?
  • Möchten Sie Push-Benachrichtigungen verwenden? Haben Sie vorhandene Firebase- oder Apple-Entwicklerkonten?
  • Welche Arten von Rich Messages möchten Sie einrichten? Gibt es Beispiele für Anwendungsfälle, für die Sie diese interaktiven Nachrichten nutzen können?
  • Sollen Benutzerdaten getrackt werden? Wie können Sie Besucherereignisse verwenden, um Analysen zu produzieren?

Wichtige Begriffe

  • Thread: Eine Unterhaltung innerhalb der Chat-App. Die erste Nachricht, die der Agent oder der KontaktGeschlossen Die Person, die mit einem Agenten, IVR oder Bot in Ihrem Contact Center interagiert. sendet, startet einen Thread. Jede folgende Nachricht in der Unterhaltung wird dem Thread hinzugefügt. Threads sind Objekte, die die einzelnen Nachrichten enthalten. Nachrichten werden vom Verfasser der Nachricht strukturiert. Eine threadId identifiziert eine gesamte Unterhaltung, und alle Nachrichten innerhalb einer Unterhaltung haben eine Nachrichten-ID. Ein Thread endet, wenn die Unterhaltung endet.

  • Single-Thread: Ein App-Design, bei dem der Kontakt jeweils nur eine Unterhaltung führen kann.

  • Multi-Thread: Ein App-Design, bei dem der Kontakt mehrere Unterhaltungen gleichzeitig führen kann.

  • Kanal: Im Zusammenhang mit Digital Experience, bezieht sich Kanal auf die Art des Messaging oder die Plattform, die für die Kommunikation verwendet wird. Sie könnten zum Beispiel einen WhatsApp-Echtzeit-Messaging-Kanal haben. Sie können ihrer mobilen App mit dem SDK einen Chat-Messaging-Kanal hinzufügen. Ein Kanal wird auf der CXone Mpower-Plattform erstellt. Dies bestimmt die Einstellungen des Kanals, zusammen mit einer Kanal-ID. Sie verwenden diese ID, um den Chatkanal zu initiieren, wenn ein App-Benutzer den Chat öffnet.

  • Kanal-ID: Die ID des digitalen Chatkanals, der im Digital-Bereich von CXone Mpower erstellt wird. Sie finden sie in den Einstellungen des Chatkanals in CXone Mpower (ACD > Digital > Kontaktstelle digital > Chat > Initialisierung und Test).

  • Brand-ID: Dies ist wie eine MandantenGeschlossen Eine übergeordnete organisatorische Gruppierung, die Sie für die technische Unterstützung und Abrechnung und außerdem zur Bearbeitung von globalen Einstellungen in Ihrer CXone Mpower Umgebung einsetzen können.-ID für Digital Experience. Sie wird verwendet, um den Chat zu initialisieren. Sie finden sie in den Einstellungen des Chatkanals in CXone Mpower (ACD > Digital > Kontaktstelle digital > Chat > Initialisierung und Test).

  • Kunden-ID: Die eindeutige ID des Chat-Endbenutzers. Das SDK erstellt diese ID, wenn der Chat initialisiert wird. Wenn Sie OAuth eingerichtet haben, bleibt diese ID für die einzelnen Kontakte auf allen Geräten dieselbe. Wenn Sie OAuth nicht eingerichtet haben, ist diese ID auf jedem Gerät unterschiedlich; die ID ist dann eine Art Gastanmeldung.

  • Region oder Umgebung: Der geografische Ort, an dem Ihre CXone Mpower-Bereitstellung gehostet wird. Mögliche Optionen: Australien (AU1), Kanada (CA1), Europa (EU1), Japan (JP1), Nordamerika (NA1) oder Vereinigtes Königreich (UK1). Der Entwickler muss dieselbe Region verwenden, in der Ihr CXone Mpower-System gehostet wird, andernfalls wird die Chatverbindung abgelehnt.

  • Kontakt, Kunde und Benutzer: Diese Begriffe beziehen sich alle auf den Endbenutzer der mobilen App. In der Online-Hilfe wird normalerweise der Begriff Kontakt verwendet. In der SDK-Dokumentation und in den Codekommentaren finden Sie wahrscheinlich eher die Begriffe Kunde und Benutzer.

  • CXone Mpower: Die zentrale Plattform, auf der Sie alle Tools für das Kundenerlebnis verwalten und aufrufen, die CXone Mpower bietet. Je nachdem, welche Chatfunktionen Sie in Ihrer mobilen App anbieten möchten, muss ein Administrator mit den erforderlichen Benutzerkonto-Berechtigungen verschiedene Einrichtungsaufgaben in CXone Mpower abschließen.

  • Digital Experience: Der Bereich von CXone Mpower, in dem Sie digitale Kanäle verwalten.