Mobile SDK

Met Mobile SDK kunt u CXone Mpower digitale chat integreren in uw zakelijke mobiele telefoon apps. Hierdoor kunnen appgebruikers chatten met de agents en bots van uw contactcenter via digitale 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 weergeven en beheren van de functies die u instelt in CXone Mpower, zoals pushmeldingen of uitgebreide berichten Elementen in digitale berichten, zoals buttons, afbeeldingen, menu's en optiekiezers..

De SDK ondersteunt zowel iOS als Android apps. iOS apps moet geschreven worden in Swift en Android apps moet geschreven worden in Kotlin . Bovendien vereist de SDK minimaal Android versie 7.0 en minimaal iOS versie 15.0.

Mobile SDK biedt de volgende mogelijkheden:

• U kunt zowel livechat- als chatberichtenkanalen implementeren. De SDK ondersteunt geen chat via Guide.
  • Live chat is realtime berichten versturen.
  • Chatberichten zijn asynchrone berichten, net als directe berichten (DM's).
• Contacten kunnen gelijktijdig meerdere interacties hebben met uw contactcenter via multi-thread In een multi-thread app kunnen contacten zoveel threads maken als ze willen om nieuwe onderwerpen te bespreken. Deze threads kunnen gelijktijdig actief zijn. messaging. U kunt ook een single-thread In een single-threaded app, heeft elk contact een chatthread die elke interactie die deze met uw organisatie heeft, afhandelt. configuratie definiëren.
• U kunt rijke media gebruiken om interactieve berichten zoals snelle antwoorden, lijsten of links naar uw chat in de app toe te voegen.
• Contacten en agents kunnen onderling bijlagen delen, bijvoorbeeld video's en documenten.
• Contacten en agents kunnen zien wanneer de ander typt, waardoor ze betrokken blijven.
• U kunt meldingen in de app en pushberichten triggeren op basis van gebeurtenissen, zoals het arriveren van een nieuw bericht.
• U kunt proactieve regels maken om inhoud in de app weer te geven op basis van gebeurtenissen of voorwaarden.
• U kunt interacties starten met welkomstberichten en pre-chat formulieren om de eerste informatie van een contact te verzamelen.

SDK-bronnen

Download de SDK-pakketten van openbare GitHub-opslagplaatsen (Android iOS ). 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 iOS ).

Uw ontwikkelaars kunnen ook naar voorbeeld applicaties kijken voor zowel Android als iOS platforms. Hierdoor kunnen ze voorbeelden van geïmplementeerde functionaliteit zien.

Mobile SDKVersiebeheer

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

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:

• 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 SDKin Digital Experiencepast

De Mobile SDK is een manier om Digital Experience uit te breiden en digitaal chat aan te bieden op mobiel apps. 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.

Uw chat-UI bouwen

De Mobile SDK wordt geleverd met een standaard UI/UX-module. U kunt ervoor kiezen om het te implementeren als onderdeel van het standaard implementatiepakket. Hierdoor wordt de implementatietijd aanzienlijk verkort. De standaardmodule verwerkt automatisch alle chatfuncties, waardoor u zelf minder hoeft te ontwikkelen, zoals:

• Rijke berichten Elementen in digitale berichten, zoals buttons, afbeeldingen, menu's en optiekiezers.

• Bijlagen

• Werken met bestanden

• Foutmeldingen

• Emoji-gedrag

Het kan echter zijn dat u bepaalde aanvullende configuraties wilt maken, zoals lokalisatie, pushmeldingen en OAuth-verificatie. Als u een andere taal dan English wilt ondersteunen, moet u vertalingen voor de tekstreeksen aanleveren. Als u een andere taal implementeert dan English, test dan alle gebieden van de gebruikersinterface om er zeker van te zijn dat de weergave correct wordt verwerkt.

Het voorbeeld Mobile SDK applicatie toont de standaard UI/UX. Documentatie voor de UI/UX-module bevindt zich in de module zelf, zodat uw ontwikkelaars deze kunnen bekijken.

Ten slotte kunt u er ook voor kiezen om uw eigen gebruikersinterface te gebruiken of te ontwikkelen. U bent niet verplicht om de standaard gebruikersinterface/gebruikerservaring te gebruiken. Als u uw eigen gebruikersinterface (of een gebruikersinterfacepakket van derden) gebruikt, biedt NiCE hiervoor geen ondersteuning.

Mobile SDK Beperkingen

• Om u te helpen met de implementatie van Mobile SDK, moet u het basisimplementatiepakket van NiCEaanschaffen. Een partner van NiCE begeleidt u bij de implementatie.

• Voor vragen over de installatie buiten NiCE kunt u Professional Services-uren aanschaffen bij Mobile SDK.

• De SDK kan niet worden gebruikt zonder een bestaande mobiele app. U moet uw eigen applicatie laten schrijven in Kotlin of Swift.

• Niet-native of hybride frameworks, zoals React Native, worden niet ondersteund.

• Deze SDK werkt met zelfstandige Digital-chat, niet met chat via Guide.

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

Term	Details
Thread	Een gesprek binnen de chat app. Het eerste bericht dat door de agent of het contact 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 app ontwerp waarbij het contact slechts één gesprek tegelijk kan voeren.
Multi-thread	Een app ontwerp waarbij de contactpersoon meerdere gesprekken tegelijk kan voeren.
Kanaal	In de context van Digital Experienceverwijst kanaal naar het type berichtgeving of het platform dat wordt gebruikt voor communicatie. 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.
Kanaal-ID	De ID van het digitale chatkanaal dat is aangemaakt in sectie Digital van CXone Mpower. Deze ID is te vinden in de instellingen van het chatkanaal in CXone Mpower (ACD > Digital > Digitale contactpunten > Chat > Initialisatie en test).
Merk-ID	Dit is als een tenant Een organisatorische eenheid op hoog niveau die wordt gebruikt om technische ondersteuning, facturering en globale instellingen voor uw CXone Mpower-systeem 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).
Klant-ID	De unieke ID van de chatgebruiker. 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 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	Deze termen verwijzen allemaal naar 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	De kern platform waar u alle tools voor klantervaringen die CXone Mpower biedt, beheert en gebruikt. 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 kanalenkunt beheren.