Konfigurera en chattresurs

Översikt

Använd Digitala kanaler i Control Hub för att skapa och konfigurera en chattresurs för webben (livechatt), mobil (meddelanden i appen) och push-meddelanden. Vilka inställningar som är tillgängliga för konfiguration beror på vilken tjänst som val ts i Tilldela till och om du väljer Webb, Mobil eller båda.

Den här artikeln beskriver hela processen för tillgångskonfiguration, inklusive funktioner som stöds, meddelanden, inloggningsuppgifter för push-provider, JWT-auktorisering (JWT), JSON Web Keys (JWK), transportprotokoll, registrering av flera användare och tjänstespecifik konfiguration efter att resursen har skapats.

Funktioner som stöds

Tabell 1. Funktioner som stöds per tjänst
Förmåga	Webex Connect	Webex kontaktcenter	Webex Contact Center Enterprise
Livechatt på webben	Stöds	Stöds	Stöds
Mobilmeddelanden i appen	Stöds	Stöds	Stöds
Webb och mobil i en enda tillgång	Stöds	Stöds inte	Stöds inte
Mobil - Android push-aviseringar	Stöds	Stöds	Stöds
Mobil - iOS push-meddelanden	Stöds	Stöds	Stöds
Web Push-aviseringar	Stöds (Chrome och Firefox)	Stöds inte	Stöds inte
JWT - Mobil	Stöds	Stöds och krävs	Stöds och krävs
JWT - Webb	Stöds	Stöds inte	Stöds inte
Registreringar för flera användare	Stöds	Stöds	Stöds
Inkorg på serversidan	Stöds	Ej tillämpligt	Ej tillämpligt
Dataström	Stöds	Ej tillämpligt	Ej tillämpligt

Innan du börjar

Logga in på Control Hub som fullständig administratör eller Contact Center-administratör som kan hantera digitala tillgångar.
Se till att Webex Connect digitala tjänster, Webex Contact Center eller Contact Center Enterprise är etablerade för organisationen. Utan rätten är digitala tillgångar inte tillgängliga.
Identifiera kontaktcenteringången och flödet som kommer att ta emot nya chatt konversationer.
Om distributionen använder mobila push-meddelanden förbereder du Firebase-, Huawei- eller Apple-autentisering suppgifter som krävs av den valda plattformen.
Om du planerar att använda JWT-auktorisering, förbered den offentliga JWK som används för att verifiera tokens som utfärdats av din betrodda backend.

Konfigurera chattresursen

Så här konfigurerar du en chattresurs:

1	Logga in på Control Hub.
2	Gå till Tjänster > Digitala tillgångar.
3	Välj Skapa resurs.
4	Ange följande värden i Konfigurera tillgångsinformation: Namn (obligatoriskt): Ange ett tillgångsnamn. Beskrivning: Ange en valfri beskrivning av användningsfall. Kanal (krävs): Välj Chatt. Du kan inte ändra kanal efter att resursen har skapats. Tilldela till (krävs): VäljWebex Connect, Webex Contact Center eller Webex Contact Center Enterprise. De tillgängliga alternativen beror på organisationens rättigheter.
5	I Meddelanden väljer du plattformen och konfigurerar Live Chat/In-App Messaging och alla nödvändiga push-aviseringar. Vilka alternativ som visas beror på den valda plattformen. Android- och iOS-aviseringsinställningarna är tillgängliga när Mobil är valt. Web Push är tillgängligt när Webb är markerat för en resurs som tilldelatsWebex Connect.

Konfigurera meddelanden

I Meddelanden väljer du plattformen och konfigurerar meddelandefunktionerna för tillgången.

Så här konfigurerar du meddelanden:

De primära och sekundära transportprotokollen måste vara olika. Om SDK:en inte kan upprätta en anslutning med det primära protokollet använder den det sekundära protokollet som en reserv.

1	Plattform: FörWebex Connect, välj Webb, Mobil eller båda. För mobil väljer du Android, iOS eller båda. För Webex Contact Center eller Webex Contact Center Enterprise väljer du antingen Webb eller Mobil.
2	Livechatt/Meddelanden i appen: FörWebex Connect, det är tillgängligt för webb och mobil. För Webex Contact Center eller Webex Contact Center Enterprise tillhandahåller webben livechatt och mobil tillhandahåller meddelanden i appen.
3	Primärt transportprotokoll: Välj MQTT eller Web Socket.
4	Sekundärt transportprotokoll: Välj det protokoll som inte är valt som primärt.

Konfigurera push-meddelanden

Aktivera Tillåt push-meddelanden när programmet måste ta emot aviseringar via en konfigurerad push-leverantör. De meddelandesektioner som visas beror på den valda plattformen.

Följande push-leverantörsalternativ är tillgängliga:

Android: Firebase Cloud Messaging (FCM), Huawei eller båda. Gäller förWebex Connect, Webex Contact Center och Webex Contact Center Enterprise.
iOS: FCM, Apple Push Notification Service (APNS) eller tokenbaserad autentisering för APNS. Gäller förWebex Connect, Webex Contact Center och Webex Contact Center Enterprise.
Webb: Firebase Cloud Messaging. Gäller Webex Connect endast.

Välj plattformen och konfigurera tillämplig leverantör i motsvarande ämne.

Skaffa Firebase-tjänstkontot JSON

Webex använder en JSON-fil för Firebase-tjänstkonto för att autentisera serverförfrågningar till Firebase Cloud Messaging. Använd Firebase-projektet som är associerat med din applikation.

Så här hämtar du och laddar upp Firebase Service Account JSON:

Säkerhet: Firebase-tjänstkontot JSON innehåller känsliga autentiseringsuppgifter. Lagra det säkert och ladda bara upp filen för det avsedda Firebase-projektet.

Konfigurationsinstruktioner för Firebase Cloud Messaging finns i Skicka ett meddelande med FCM HTTP v1 API.

1	Öppna Firebase-konsolen och välj det Firebase-projekt som används av ditt program.
2	Öppna Projektinställningar > Servicekonton.
3	Välj Skapa ny privat nyckel och bekräfta nedladdningen.
4	Förvara den nedladdade JSON-filen säkert. Filen innehåller autentiseringsuppgifter för privata nycklar.
5	I Control Hub laddar du upp JSON-filen i Ladda upp Firebase Service Account JSON för tillämplig Android-, iOS- eller webbaviseringskonfiguration.

Konfigurera Android-push-aviseringar

Android-aviseringsavsnittet visas när Mobil, Android och Tillåt push- aviseringar är markerade. Välj minst en leverantör; Firebase och Huawei kan konfigureras individuellt eller tillsammans. Den här konfigurationen är tillgänglig för Webex Connect Webex Contact Center och Webex Contact Center Enterprise Mobile-tillgångar.

Leverantörsdokumentation: Huawei - Push Kit installation och testning

1	Välj Mobil, Android och Tillåt push-aviseringar. Android-aviseringsavsnittet visas.
2	Välj Firebase Cloud Messaging och ladda upp den nödvändiga JSON -filen för Firebase Service Account från Firebase-projektet.
3	Om appen stöder enheter som använder Huawei Mobile Services väljer du Huawei och anger In-app ID och In-app Secret från AppGallery Connect. Huawei-undantag: Huawei-konfiguration kan hoppas över när appen inte stöder enheter utan Google Play Services. Aktuell Webex Connect vägledning stöder EMUI 10.x och senare.

Konfigurera iOS-push-aviseringar

Avsnittet för iOS-meddelanden visas när Mobil, iOS och Tillåt push-aviseringar är markerade. Välj en push-leverantör. Den här konfigurationen är tillgänglig för Webex Connect Webex Contact Center och Webex Contact Center Enterprise Mobile-tillgångar.

Konfigurationsinstruktioner för certifikatbaserade APN finns i Upprätta en certifikatbaserad anslutning till APN.

För tokenbaserade APN-konfigurationsinstruktioner, se Upprätta en tokenbaserad anslutning till APN.

1	Välj Mobil, iOS och Tillåt push-aviseringar. iOS-aviseringsavsnittet visas.
2	Välj en push-leverantör.
3	För Firebase Cloud Messaging laddar du upp JSON-filen för Firebase Service Account som hämtats från Firebase-projektet.
4	För Apple Push Notification Service (APNS) anger du certifikatlösenordet, väljer Sandlåda eller Produktion, laddar upp APNS-certifikatet, anger ett namn och validerar konfigurationen . Endast certifikatformatet .p12 stöds.
5	För tokenbaserad APNS-autentisering anger du nyckel-ID, team-ID och apppaket- eller paket-ID, väljer Sandlåda eller Produktion och laddar upp APNS-filen med privat nyckel. Gateway-val: Använd Sandbox för en utvecklingsapp och Produktion för en produktionsklar app. Lagra APNS privata nyckel på ett säkert sätt. Apple tillåter att den nedladdade.p8-nyckelfilen bara hämtas en gång.
6	Byt ut Apple-leverantörscertifikatet innan det löper ut för att undvika avbrott i push-leveransen.

Konfigurera Web Push-aviseringar

Web Push-aviseringar är endast tillgängliga för tillgångar som tilldelats Webex Connect med Webb markerad. Chrome och Firefox stöds. Safari Web Push stöds för närvarande inte.

Web Push-aviseringar stöds inte för tillgångar som tilldelats Webex Contact Center eller Webex Contact Center Enterprise.

Så här konfigurerar du Web Push-aviseringar:

1	Bekräfta att resursen är tilldelad Webex Connect och att webben är markerad.
2	Använd Chrome eller Firefox för att komma åt webbplatsen och ta emot Web Push-aviseringar.
3	Webbadress (obligatoriskt): Ange webbadressen till webbplatsen som kommer att ta emot Web Push-meddelanden.
4	Meddelandeikon (obligatoriskt): Ange sökvägen till meddelandeikonen. Ikonen måste vara 80 x 80 pixlar.
5	Konfigurera Firebase Cloud Messaging (FCM) för ditt webbprogram genom att följa Fire base-dokumentationen.
6	Firebase Service-konto JSON (krävs): Ladda upp JSON-filen för Firebase-tjänstkontot som innehåller den privata nyckel som krävs för att använda Firebase Cloud Messaging HTTP v1 API.

Konfigurera JSON-webbtoken-auktorisering

JWT-auktorisering kräver att SDK-kommunikation auktoriseras med en giltig JSON Web Token. För nya tillgångar är krypteringstypen asymmetrisk.

JWT-stöd är som följer:

Webex Connect: Stöds för mobil och webb i samma resurs.
Webex Contact Center och Webex Contact Center Enterprise - Webb: stöds inte.
Webex Contact Center och Webex Contact Center Enterprise - Mobile: Stöds och krävs för konfigurationen av mobiltillgångar.

Konfigurera följande inställningar:

Krypteringstyp: Asymmetrisk för nya tillgångar.
Token Utgång (Obligatoriskt): Ange hur länge JWT förblir giltigt innan en ny användaridentitetstoken krävs. Giltigt intervall: 5-360 minuter. Standard: 60 minuter.
JSON Web Keys (krävs): Ladda upp den offentliga JWK som används för att verifiera tokens. Du kan lägga till en andra nyckel för rotation. Maximalt: två nycklar.

Lägg till och förbered den offentliga JSON-webbnyckeln enligt beskrivningen i underordnade ämnen.

Förbered den offentliga JWK

Den uppladdade filen måste innehålla den offentliga RSA-verifieringsnyckeln. Webex validerar följande JWK-egenskaper.

JWK-egenskaper definieras i RFC 7517, avsnitt 4. Algoritmspecifika egenskaper definieras i RFC 7518.

Tabell 2. Offentliga JWK-fastigheter
Fastighetsnamn	Beskrivning
alg	Identifierar den kryptografiska algoritm som används med nyckeln. Det erforderliga värdet är RS256, vilket anger RSASSA-PKCS1- med SHA-256. v1_5
e	Exponenten för den offentliga RSA-nyckeln, representerad som ett Base64URLuint-kodat värde.
key_ops	Anger vilken åtgärd nyckeln är avsedd för. Värdet som stöds är verifiera, vilket indikerar att nyckeln används för att verifiera digitala signaturer. Se RFC 7517, avsnitt 4.3.
kty	Identifierar den kryptografiska algoritmfamilj som används med nyckeln. Värdet måste vara RSA. Se RFC 7517, avsnitt 4.1.
n	Modulen för den offentliga RSA-nyckeln, representerad som ett Base64URLuint-kodat värde.
använd	Anger avsedd användning av den offentliga nyckeln. Värdet måste vara sig, vilket indikerar att nyckeln är avsedd för signaturverifiering. Se RFC 7517, avsnitt 4.2.
unge	Identifierar nyckeln och används för att matcha en specifik nyckel, till exempel under nyckelrotation. Se RFC 7517, avsnitt 4.5.

Ladda bara upp den offentliga verifieringsnyckeln. Behåll motsvarande privata signeringsnyckel i det betrodda systemet som utfärdar JWT-enheter.

Lägga till en JSON-webbnyckel

Så här lägger du till en offentlig JSON-webbnyckel:

1	Välj Lägg till nyckel.
2	Ange ett JSON-webbnyckelnamn.
3	Ange JSON-webbnyckelutfärdaren. Detta värde måste matcha emittenten som används av den betrodda backend när den genererar JWT.
4	Ladda upp den offentliga JWK-filen.
5	Välj Spara.

Konfigurera registreringar för flera användare

Aktivera Tillåt registrering av flera användare på samma enhet när flera användare kan registrera sig på samma fysiska enhet.

Push-meddelanden levereras för både aktiva och inaktiva registrerade användare.
Livechatt eller meddelanden i appen levereras till den för närvarande aktiva användaren. Meddelanden för inaktiva användare står i kö tills användaren blir aktiv igen.

Konfigurera ytterligare Webex Connect -inställningar

Följande avancerade inställningar gäller endast Webex Connect tillgångar och är inte tillämpliga på Webex Contact Center eller Webex Contact Center Enterprise-tillgångar.

En enhet per användare: Begränsar en användare till en registrerad enhet. Registrering på en ny enhet stoppar push-leverans till den äldre enheten.
Inkorg på serversidan: Lagrar en kopia av inkorgsdata på serversidan för senare hämtning.
Dataström: Skickar tillämplig händelsedata till den valda Webex Connect integrationen för meddelanden som skickas via Messaging API.

Spara för att skapa resursen

När du har konfigurerat tillämpliga meddelanden, JWT-behörighet, fleranvändarregistrering och Webex Connect inställningar sparar du konfigurationen för att skapa chattresursen.

Välj Spara för att skapa resursen.

Vänta på bekräftelse på att tillgången skapades framgångsrikt.

Komplett tjänsteintegration

När du har skapat chattresursen slutför du integreringen för tjänsten som valts i Tilldela till. Följ tillämplig procedur förWebex Connect, Webex Contact Center eller Webex Contact Center Enterprise.

Komplett Webex Connect integration

För en tillgång som tilldelatsWebex Connect, slutför tjänstkartläggningen och flödeskonfigurationen iWebex Connect. Nodbehörighet krävs inte.

Du kan använda en startnod, anpassad händelse eller anpassad webbkrok för att fånga inkommande händelser och utlösa ett flöde. Mer information finns i Startnod, Anpassad händelse och An passad webbkrok.

1	Logga in påWebex Connect.
2	Slutför tillämplig tjänstekartläggning och flödeskonfiguration för chattresursen.
3	Spela in det genererade app-ID och klientnyckeln.
4	Ladda ner SDK-konfigurationsfilen för varje vald plattform.

Komplett Webex Contact Center-integration

För en tillgång som tilldelats Webex Contact Center mappar du tillgången till en kontaktcenteringångspunkt och slutför sedan Webex Contact Center-nodauktorisering.

En tillgång kan mappas till endast en ingångspunkt. Slutför ingångspunkten och flödeskartläggningen innan du publicerar kundupplevelsen.

1	Öppna Contact Center- konfigurationen i Control Hub.
2	Skapa eller öppna ingångspunkten som tar emot chattkonversationer.
3	I F lödesmappning väljer du chattresursen och önskat flöde för kundinmatning.
4	Spara ingångspunkten och verifiera tillgångs- och flödeskartläggningen.
5	Slutför Webex Contact Center-nodbehörighet iWebex Connect. Instruktioner finns i Webex CC-aktivitetsintegrationsnoder och nodbehörigheter.
6	För en webbdistribution konfigurerar du widgeten Live Chat och hämtar webbplatsens inbäddningskod i Control Hub.

Komplett Webex Contact Center Enterprise-integration

För en tillgång som tilldelats Webex Contact Center Enterprise, slutför CCE-nodauktorisering Webex Connect innan du konfigurerar routningsflödet.

1	Logga in påWebex Connect.
2	Fullständig CCE-nodbehörighet. Anvisningar finns i CCE-integrationsnoder och nodbehörigheter.
3	Konfigurera tillämpliga CCE-integrationsnoder och routningsflöde för chattresursen. För flödesexempel, se F lödeskonfigurationer.
4	Spara och testa flödet.

För ytterligare konfigurationsvägledning, se Bästa praxis och riktlinjer och vanliga frågor.

Undantag och begränsningar

Tänk på följande undantag och begränsningar:

Bekräfta kanal-, plattform-, tilldelnings- och routingval innan du skapar tillgången. Kanalen kan inte ändras efter skapandet och plattformsändringar begränsas av arbetsbelastningen.
För Webex Contact Center och Webex Contact Center Enterprise kan en enda tillgång inte använda webb och mobil tillsammans. Skapa separata tillgångar när båda behövs.
Web Push-aviseringar är endast tillgängliga förWebex Connect. Safari Web Push, Webex Contact Center Web Push och Webex Contact Center Enterprise Web Push stöds inte.
JWT-auktorisering stöds inte för webbtillgångar som tilldelats Webex Contact Center eller Webex Contact Center Enterprise.
För Webex Contact Center och Webex Contact Center Enterprise, utför konfigurering av ingångspunkt, flöde, widget och inbäddningskod i avsnittet Contact Center i Control Hub.
FörWebex Connect, slutföra tjänsten och flödeskonfigurationen iWebex Connect.
Ta inte bort en chattresurs efter att den har mappats till en tjänst utan att först ta bort eller uppdatera nedströms mappning. En borttagen resurs kan inte återställas och kan göra en befintlig mappning oanvändbar.
Efter skapandet behåller du det genererade app-ID, klientnyckeln och SDK-konfigurationsfilerna som krävs för att initiera lämplig SDK.

Cisco AI Assistant

Tack för din feedback.