Mobile SDK

Huidige versie: 2.2 (overeenkomend met de 24.4 CXone Mpower release)
API-referentiemateriaal:

Om u op weg te helpen bij het implementeren van de mobiele SDK, moet u het standaard implementatiepakket uit NICE aanschaffen. Een partner van NICE begeleidt u bij de implementatie.

Met Mobile SDK kunt u CXone Mpower digitale chat integreren in uw zakelijke mobiele telefoonsapp. Hierdoor kunnen appgebruikers chatten met de agents en bots van uw contactcenter via digitaleGesloten Kanaal, contact of skill verbonden met Digital Experience. chatkanalen. De SDK vereenvoudigt het implementeren van digitale chat. Ontwikkelaars hoeven geen bedrijfslogica te implementeren. De hoofdtaak van uw ontwikkelaars is het visueel presenteren en beheren van functies die u in CXone Mpower configureert, zoals pushmeldingen of rijke berichten. De SDK ondersteunt zowel iOS- als Android-apps. iOS-apps moeten in Swift Deze link wordt in een nieuw venster geopend zijn geschreven, en Android-apps in Kotlin Deze link wordt in een nieuw venster geopend.

Mobile SDK biedt de volgende mogelijkheden:

Raadpleeg het informatieblad van Mobile SDK Deze link wordt in een nieuw venster geopend voor een beknopt overzicht van de voordelen van de SDK. U kunt ook een korte demonstratievideo Deze link wordt in een nieuw venster geopend bekijken.

Een SDK ofwel Software Development Kit is een 'gereedschapskist' voor ontwikkelaars. SDK's leveren een set tools en middelen die het bouwen van software-applicaties vergemakkelijken. Een SDK is als het ware een verzameling kant-en-klare bouwstenen. Deze bouwstenen hebben bestaande functionaliteit. Uw ontwikkelaars kunnen deze bestaande stenen gebruiken in plaats van de functionaliteit vanaf nul op te bouwen. Vier algemene voordelen van het gebruik van een SDK zijn:

  1. Efficiëntie: De SDK levert kant-en-klare tools en componenten die ontwikkelaars tijd besparen. In plaats van het wiel opnieuw uit te vinden, kunnen zij zich richten op de unieke aspecten van hun app.

  2. Consistentie: De SDK garandeert consistentie in verschillende apps. Door dezelfde set tools en bibliotheken te gebruiken, zorgen ontwikkelaars voor een uniforme gebruikerservaring.

  3. Platformcompatibiliteit: De iOS-SDK en de Android-SDK zijn afgestemd op hun respectieve platforms. Zij rekenen af met platformspecifieke complexiteiten en maken het makkelijker om apps voor verschillende platforms te creëren.

  4. Kwaliteitsborging: Met de functie voor logboekregistratie kunnen ontwikkelaars hun code verifiëren, fouten in een vroeg stadium opsporen en betrouwbaardere software leveren.

Kortom, een SDK vereenvoudigt het ontwikkelingsproces, garandeert kwaliteit en bevordert samenwerking, en is daarmee een essentiële tool voor het maken van apps.

SDK-bronnen

Download de SDK-pakketten van openbare GitHub-opslagplaatsen (Android Deze link wordt in een nieuw venster geopend iOS Deze link wordt in een nieuw venster geopend). Beide opslagplaatsen bevatten een README-bestand dat u aan de slag helpt. Ze bieden ook gebruiksscenario's met codevoorbeelden in /docs. Gebruik deze als inspiratiebron bij het ontwikkelen van uw chat. De twee opslagplaatsen bevatten ook wijzigingslogboeken.

U hebt toegang tot het API-referentiemateriaal in uw browser (Android Deze link wordt in een nieuw venster geopend iOS Deze link wordt in een nieuw venster geopend).

Uw ontwikkelaars kunnen ook voorbeeldapplicaties voor Android Deze link wordt in een nieuw venster geopend- en iOS Deze link wordt in een nieuw venster geopend-platforms bekijken. Hierdoor kunnen ze voorbeelden van geïmplementeerde functionaliteit zien.

Versies van Mobile SDK

De SDK-versies worden over het algemeen bijgewerkt met de belangrijkste marketingreleases, zoals 25.2, 25.3, enzovoort.CXone Mpower In GitHub wordt elke releaseversie getagd volgens de hieronder uitgelegde semantische versiebeheer.

NICE ondersteunt de huidige en één eerdere hoofdversie van de SDK. Als de huidige versie bijvoorbeeld 2.2 is, ondersteunt NICE v2.2 en 1.3 (de nieuwste versie 1.xx).

U bent er zelf verantwoordelijk voor dat uw app up-to-date blijft, aangezien de SDK ook wordt bijgewerkt. Het gedeelte SDK-bronnen hierboven bevat links naar de meest up-to-date hulpbronnen. In de SDK-opslagplaatsen kunt u de tags gebruiken om eerdere versies van de SDK op te zoeken. Houd er ook rekening mee dat de SDK achterwaarts compatibel is met de laatste twee belangrijke versies.

Versiewijzigingen

Wanneer de SDK-versie van release tot release verandert, geeft het versienummer het type wijziging aan. Het volgende verklaart de aanduiding:

  • 2.0.0: Het eerste getal geeft de belangrijkste API-wijziging aan.

  • 2.1.0: Het tweede getal geeft een niet-brekende verandering aan. Vaak worden nieuwe functies toegevoegd als niet-brekende wijzigingen.

  • 2.0.1: Het derde getal geeft aan dat er een bug is opgelost. Deze zijn altijd achterwaarts compatibel.

Bugfixes

NICE Professional Services werkt met u samen aan het oplossen van bugs. U kunt bugs via hen (of de implementatiepartner) melden. Zij sturen u dan naast het SDK-wijzigingenlogboek ook oplossingen.

Bovendien zijn eventuele bugs opgelost in de versies die momenteel worden ondersteund. Als de huidige versie bijvoorbeeld 3.0 is, dan zijn de twee ondersteunde versies 3.0 en 2.3 (de nieuwste versie van 2.x). Als u een bug in v2.1 vindt, lost NICE deze op voor 2.3 en 3.0, maar niet voor 2.1 of 2.2.

Hoe de Mobile SDK in Digital Experience past

De mobiele SDK is een manier om Digital Experience uit te breiden en digitaal chat op mobiel apps aan te bieden. Digital Experience is het CXone Mpower-onderdeel dat digitale kanalen ondersteunt. Voorbeelden van digitale kanalen zijn WhatsApp, berichten op Facebook en digitale chat. Om digitale chat toe te voegen aan uw CXone Mpower, moet u bepaalde appsfuncties configureren in het -gedeelte van de Digital Experience-interface.CXone Mpower Vervolgens gebruikt u de SDK om functies die u in CXone Mpower hebt ingesteld, op te roepen en te gebruiken.

Bijvoorbeeld: wanneer u aan de slag gaat, configureert u een digitaal chatkanaal in CXone Mpower. Vervolgens moet uw app een WebSocket verbinding maken met het digitale chatkanaal dat u hebt aangemaakt. U kunt ook geavanceerde functies zoals welkomstberichten of pre-chatvragenlijsten configureren. Hierdoor krijgt u diverse opties om de ervaring van uw appgebruikers te stroomlijnen. Gebruikers kunnen initiële informatie over hun probleem of verzoek verstrekken, essentiële persoonsgegevens invoeren enzovoort. Deze functies worden in eerste instantie in CXone Mpower geconfigureerd, dat u vervolgens met de SDK kunt gebruiken.

Schema van infrastructuur van Mobile SDK

Uw chat-UI bouwen

Als integrator bent u verantwoordelijk voor het bouwen van uw chat-UI. Dit is nodig om te kunnen profiteren van bepaalde functies zoals het weergeven van en werken met bestanden of het opnemen van spraakberichten. U moet bijvoorbeeld een knop toevoegen die contacten toegang biedt tot de microfoon van het apparaat, zodat ze het bericht kunnen opnemen. Raadpleeg desgewenst de voorbeeldapplicaties (Android Deze link wordt in een nieuw venster geopend iOS Deze link wordt in een nieuw venster geopend) voor informatie over het implementeren van de UI.

U kunt een kit voor UI-ontwikkeling van een externe leverancier gebruiken, bijvoorbeeld MessageKit. Hieraan zijn echter misschien beperkingen verbonden, afhankelijk van uw gebruiksscenario. Bovendien heeft CXone Mpower geen UI-pakket van een externe leverancier en biedt het hiervoor geen ondersteuning.

Voordat u begint met ontwikkelen

Stel uzelf de volgende vragen voordat u aan de slag gaat met de Mobile SDK:

  • Hebt u zowel een beheerdersaccount als een agentaccount in CXone Mpower? Kan een beheerder u helpen bij het instellen van de nodige functies in het CXone Mpower-platform?
  • Is uw mobiele app beschikbaar voor iOS (Apple), voor Android of voor allebei? Zijn uw ontwikkelaars vertrouwd met de talen Swift en Kotlin?
  • Hebt u bestaande chatberichtenkanalen of wilt u een nieuw chatberichtenkanaal maken?
  • Gaat u OAuth gebruiken om uw appgebruikers te authenticeren? Zo ja, welke OAuth-provider gaat u dan gebruiken?
  • Wilt u single-thread or multi-thread conversaties aanbieden?
  • Gaat u proactieve acties zoals pop-ups of welkomstberichten gebruiken?
  • Wilt u pushmeldingen gebruiken? Hebt u bestaande Firebase- of Apple Developer-accounts?
  • Welke typen rijke berichten wilt u instellen? In welke use cases kunt u deze interactieve berichten zoal gebruiken?
  • Wilt u gebruikersgegevens traceren? Hoe kunt u de bezoekersgebeurtenissen gebruiken om analyses te produceren?

Belangrijke termen

  • Thread: Een conversatie via de chat-app. Het eerste bericht dat door de agent of het contactGesloten De persoon die contact heeft met een agent, IVR of bot in uw contactcenter. wordt verzonden, start een thread. Alle hieropvolgende berichten in de conversatie worden aan de thread toegevoegd. Threads zijn objecten die elk bericht bevatten. Berichten worden gestructureerd door de auteur van het bericht. Een threadId identificeert een volledige conversatie, en alle berichten in een conversatie hebben een bericht-ID. Een thread eindigt wanneer de conversatie eindigt.

  • Single-Thread: Een appontwerp waarbij het contact slechts één conversatie tegelijk kan voeren.

  • Multi-Thread: Een appontwerp waarbij het contact meerdere conversaties tegelijk kan voeren.

  • Kanaal: In de context van Digital Experience heeft kanaal betrekking op het type messaging of het platform dat voor communicatie wordt gebruikt. U kunt bijvoorbeeld een WhatsApp-kanaal voor realtime messaging hebben. Met de Mobile SDK kunt u een chatberichtenkanaal toevoegen aan uw mobiele app. Er wordt een kanaal gemaakt in het CXone Mpower-platform. Dit bepaalt de instellingen van het kanaal en een kanaal ID. U gebruikt deze ID om het chatkanaal te starten wanneer een appgebruiker de chat opent.

  • ChannelId: De ID van het digitale chatkanaal dat in het Digital-gedeelte van CXone Mpower is gemaakt. Deze ID is te vinden in de instellingen van het chatkanaal in CXone Mpower (ACD > Digital > Digitale contactpunten > Chat > Initialisatie en test).

  • BrandId: Dit is als het ware een tenantGesloten Een organisatorische eenheid die wordt gebruikt om technische ondersteuning, facturering en globale instellingen voor uw CXone Mpower-omgeving te beheren-ID voor Digital Experience. Hiermee wordt de chat geïnitialiseerd. Deze ID is te vinden in de instellingen van het chatkanaal in CXone Mpower (ACD > Digital > Digitale contactpunten > Chat > Initialisatie en test).

  • CustomerId: De unieke ID van de chat-eindgebruiker. De SDK maakt deze ID wanneer de chat wordt geïnitialiseerd. Als OAuth op uw systeem is geïnstalleerd, blijft deze ID voor alle contacten op al hun respectieve apparaten hetzelfde. Als OAuth niet is geïnstalleerd, is deze ID voor elk apparaat anders. De ID werkt dan min of meer als een gast-login.

  • Regio of omgeving: De geografische locatie waar uw CXone Mpower-implementatie wordt gehost. Dit kunnen de volgende regio's zijn: Australië (AU1), Canada (CA1), Europa (EU1), Japan (JP1), Noord-Amerika (NA1) of Verenigd Koninkrijk (UK1). De ontwikkelaar moet gebruikmaken van de regio waar uw CXone Mpower-systeem wordt gehost. Anders wordt de chatverbinding geweigerd.

  • Contact, klant en gebruiker: Al deze termen hebben betrekking op de eindgebruiker van de mobiele app. In de online help wordt meestal de term contact gebruikt. In de SDK-documentatie en code-opmerkingen ziet u waarschijnlijk customer (klant) en user (gebruiker).

  • CXone Mpower: Het kernplatform waar u alle klantervaringstools van CXone Mpower kunt beheren en oproepen. Afhankelijk van de chatfuncties die u in uw mobiele app wilt aanbieden, moet een beheerder met de nodige gebruikersaccountmachtigingen verschillende configuratietaken in CXone Mpower uitvoeren.

  • Digital Experience: Het gedeelte van CXone Mpower waar u alles over digitale kanalen kunt beheren.