Visszajelzés

Csevegéshitelesítési beállítások létrehozása

  • Cikk
  • 7 perc alatt elolvasható

Az Omnichannel for Customer Service olyan lehetőségek tárházát biztosítja, amelyekkel kibővítheti a Dynamics 365 Customer Service Enterprise lehetőségeit, és így a szervezetek azonnal kapcsolatba léphetnek és kapcsolatot építhetnek ügyfeleikkel a digitális üzenetküldési csatornákon keresztül. Az Omnichannel for Customer Service használatához kiegészítő licenc szükséges. További információért keresse fel a Dynamics 365 Customer Service árképzése – áttekintés és a Dynamics 365 Customer Service árképzési terv oldalakat.

Fontos

Az Omnicsatorna-felügyelet 2022. április 30. után nem lesz támogatott, és egy következő verzióban elavulttá válik. Javasoljuk, hogy használja az Omnicsatorna felügyeleti központ alkalmazást helyette. A legújabb funkciók, mint például az egyesített átirányítás és a hangcsatorna csak ebben a felügyeleti alkalmazásban konfigurálhatóak és használhatók. Az elavulással kapcsolatos közleménnyel kapcsolatos további információért lásd: Az Omnicsatorna adminisztrációs alkalmazás elavult.

Bevezetés

A hitelesítési beállításokat létrehozhatja az aláírt ügyfél tartományból történő ellenőrzéséhez, majd a definiált környezeti változók alapján kinyerheti az adatokat. A névtelen ügyfelek megkülönböztethetők a hitelesített ügyfelektől, és a környezeti változók alapján is létrehozhatók szabályok.

Például a névtelen ügyfelek és a hitelesített ügyfelek esetében külön várólisták szerepelhetnek. Mivel a hitelesített ügyfelekkel kapcsolatban további információval rendelkezik, konkrét változók, például a bevásárlókosár értéke vagy a privilegizált állapot alapján is rangsorolhatja őket.

A hitelesítési beállítások bejegyzésének létrehozása után azt fel kell vennie a megfelelő csevegési vezérlő Alapadatok lapjára annak érdekében, hogy működjön.

Az ügynök értesítést kap a Beszélgetés összegzése szakaszában, hogy az ügyfél hitelesítve van-e vagy sem. A Hitelesített mező beállítása Igen vagy Nem értékre az ügyfél hitelesítése alapján történik. Ha egy csevegő vezérlő nincs hozzá hitelesítési beállítás társítva, a Hitelesített mező értéke Nem , még akkor is, ha egy ügyfél be van jelentkezve a portálra. A beszélgetési összesítéssel kapcsolatos információkért lásd: Beszélgetés összegzése.

Előfeltételek

Győződjön meg róla, hogy szervezete jól ismeri az OAuth 2.0 és a JSON Web Tokeneket (JWT-k).

Csevegéshitelesítést beállító bejegyzés létrehozása

Csevegés-hitelesítési beállítási rekordot a ügyfélszolgálat Felügyeleti központban vagy az Omnichannel Felügyeleti központ alkalmazásban hozhat létre.

  1. Nyissa meg az egyik alkalmazást, és hajtsa végre a következő lépéseket.

    1. A webhelytérképen válassza az Ügyfélbeállítások lehetőséget az Ügyfélszolgálatban. Megjelenik az Ügyfélbeállítások lap.
    2. A Hitelesítési beállítások szakaszban válassza a Kezelés lehetőséget .

    Megjelenik az Aktív hitelesítés beállításai lap.

  2. A hitelesítési beállítások bejegyzésének hozzáadásához válassza az Új lehetőséget.

  3. Az Új csevegési vezérlő hitelesítési beállításai oldalon adja meg a következő információkat:

    • Név: adja meg a hitelesítési beállítás nevét.

    • Tulajdonos: Fogadja el az alapértelmezett értéket, vagy változtassa meg a szükséges értéket.

    • Hitelesítési típus: Alapértelmezés szerint az OAuth 2.0 implicit folyamat nem szerkeszthető.

    • Nyilvános kulcs URL-címe: adja meg a tartomány nyilvános kulcsának URL-címét. Ez az URL-cím az ügyfél bejelentkezési tartományának JavaScript Object Notation (JSON) webtokenjéből (JWT) származó információk ellenőrzésére szolgál.

    • JavaScript-kliens funkciója: adja meg a hitelesítéshez használandó JavaScript-kliens funkcióját. Ez a funkció kivon egy tokent a tokenvégpontból.

      Csevegéshitelesítést beállító bejegyzés létrehozása.

    A nyilvános kulcs URL-címének és JavaScript-ügyfélfüggvényének megkereséséről a cikk későbbi szakaszában, a Portálok Power Apps telepítése vagy a nem a cikk későbbi szakaszában létrehozott Power Apps egyéni portálok beállítása című részben olvashat bővebben.

  4. Válassza a Mentés parancsot.

Hitelesítés hozzáadása a csevegési vezérlőhöz

  1. Nyissa meg azt a csevegésvezérlőt, amelyhez hitelesítést kíván hozzáadni, és tegye a következő lépések egyikét:
    • A felügyeleti központ vagy az Omnichannel felügyeleti központ ügyfélszolgálat a Viselkedés lapon lépjen.
    • Az Omnicsatorna felügyeletben válassza az Alapadatok lapot.
  2. A Hitelesítési beállítások mezőben keresse meg és jelölje ki a csevegés hitelesítési rekordját.

Amikor egy portálon egy bejelentkezett ügyfél megnyitja a csevegési vezérlőt, a JavaScript-kliens függvény átadja a JWT-t az ügyféltől a kiszolgálónak. A JWT visszafejtése és érvényesítése a nyilvános kulccsal történik, majd az információ továbbításra kerül a csevegőügynöknek a alkalmazásban Omnichannel for Customer Service. Rendszergazdaként az egyéni környezeti változók definiálásával további információkat adhat meg az aláírt ügyfélről a JWT-ben. A környezeti változókat pontosan úgy kell definiálni, ahogy a csevegési vezérlő társított munkafolyamatban definiálják őket.

A Power Apps portálok beállítása

Ha a Power Apps Portálok használatával létrehozott webhelyen egy csevegési vezérlőhöz ad hozzá hitelesítést, a nyilvános kulcs URL-címe, a JavaScript-kliens funkció és a JWT azonnal elérhetők. Így szerezheti be a szükséges értékeket:

  • Nyilvános kulcs URL-je: <portal_base_URL>/_services/auth/publickey
  • JavaScript-kliens funkciója: auth.getAuthenticationToken
  • Token végpontja: <portal_base_URL>/_services/auth/token

A Power Apps portál megpróbál automatikusan összekapcsolni egy kapcsolattartó-rekordot a beszélgetéssel a JavaScript ügyfélfunkciójában átadott kontextuson keresztül.

Olyan egyéni portálok beállítása, amelyek nem a használatával lettek létrehozva Power Apps

Ha hitelesített csevegési élményt ad hozzá egy egyéni webhelyhez, a webfejlesztő csapatnak el kell végeznie néhány kezdeti beállítást, mielőtt a rendszergazdák konfigurálhatnák a hitelesített csevegést.

  1. Hozzon létre nyilvános/személyes kulcspárt a hitelesítési kiszolgálóin. A kulcsokat RSA256 segítségével kell létrehozni.

    Íme a mintakód a privát/nyilvános kulcspárok létrehozásához.

    openssl genpkey -algorithm RSA -out private_key.pem -pkeyopt rsa_keygen_bits:2048
openssl rsa -pubout -in private_key.pem -out public_key.pem

  2. Hozzon létre egy végpontot, amely visszaadja a nyilvános kulcsokat. A nyilvános kulcsokat az Omnicsatorna-kiszolgálók használják a JWT-jogkivonatnak a csevegéskérelem hitelesítésének részeként átadott ellenőrzéséhez. A hitelesítési beállítás bejegyzésének létrehozásakor a program a végpont URL-címét beviszi a Omnicsatorna hitelesítési alkalmazásba.

    A nyilvános kulcs végpont ehhez a példához hasonlóan fog megjelenni:

      -----BEGIN PUBLIC KEY----- 
  NIIBIjANBgkqhkiG9w0BAQEFABCOPQ8AMIIBCgKCAQEAn+BjbrY5yhSpLjcV3seP 
  mNvAvtQ/zLwkjCbpc8c0xVUOzEdH8tq4fPi/X5P/Uf2CJomWjdOf1wffmOZjFasx 
  ELG+poTqy5uX2dNhH6lOMUsV31QGG36skLivpLBCSK6lWlzsV6WGkb/m8r86aGzp 
  jtNhw8yvoTYB4updDrJ8pC+tx4EWK0WEmKn1GsW6TjUtxJjcTLI1puSbmcGHbkSi 
  RSbWkKPqaEVFALprw+W5ZCung5QX3KOkY/rJd+2JwULm7okyQCQaF7qwa5i9Uf65 
  7M6ZL4vsDevq7E/v3tf6qxpSSHzt4XspXVQty9QHhqDqBEY3PfI4L2JjgIGuPhfS 
  YQIDAQAB 
  -----END PUBLIC KEY-----

If you need to use multiple public keys, your public key endpoint can return a set of <kid, publickey > pairs. (Note that key ID pairs must be unique.) The kid will need to be passed in the JWT token in step 4. If you're using multiple keys, your public key endpoint should return something that looks like this. The public key is base 64 encoded:

 [      {          "kid": "qWO4EaKT1xRO7JC/oqALz6DCVr41B/qL0Hqp4in7hu4=",          "publicKey": LS0tLS1CRUdJTiBQVUJMSUMgS0VZLS0tLS0NCk1JSUJJakFOQmdrcWhraUc5dzBCQVFFRkFBT0NBUThBTUlJQkNnS0NBUUVBbjFLdXhtSEh3V3hjelZSWGRBVmMNCnBEaFZwa0FnYklhTGZBUWc1bFpvemZqc29vcWRGWkl0VlFMdmRERWFVeDNqTytrTkxZM0JFRnBYVDZTN3ZNZCsNCnZoM2hpMDNsQ1dINnNCTWtaSWtuUUliMnFpekFsT0diU2EvK3JrUElnYnpXQjRpT1QyWVhyOVB4bXR5d2o4WUINCnYram55VU5DSzMyZy9FYWsvM0k3YW1vZ2pJY0JISjNFTjVuQWJBMExVVnJwMW5DODJmeEVPOHNJTzNYdjlWNVUNCnc5QnVTVVFRSmtMejNQYVI5WTdRZUEyNW5LUGtqTXZ2Y0UxVU5oeVpIYlNLbmorSitkZmFjb1hsSGtyMEdGTXYNCldkSDZqR0pWcGNQMHBkNjFOa3JKa2c0aStheThwS2ZqdjNUOHN3NWdaVHFweFFaaitVRWxqaVM0SHRPTlhkNlENCnZRSURBUUFCDQotLS0tLUVORCBQVUJMSUMgS0VZLS0tLS0NCg==",          "expiry": 1608495423      }, {          "kid": "qWO4EaKT1xRO7JC/oqALz6DCVr41B/qL0Hqp__valid=",          "publicKey": "LS0tLS1CRUdJTiBQVUJMSUMgS0VZLS0tLS0NCk1JSUJJakFOQmdrcWhraUc5dzBCQVFFRkFBT0NBUThBTUlJQkNnS0NBUUVBbjFLdXhtSEh3V3hjelZSWGRBVmMNCnBEaFZwa0FnYklhTGZBUWc1bFpvemZqc29vcWRGWkl0VlFMdmRERWFVeDNqTytrTkxZM0JFRnBYVDZTN3ZNZCsNCnZoM2hpMDNsQ1dINnNCTWtaSWtuUUliMnFpekFsT0diU2EvK3JrUElnYnpXQjRpT1QyWVhyOVB4bXR5d2o4WUINCnYram55VU5DSzMyZy9FYWsvM0k3YW1vZ2pJY0JISjNFTjVuQWJBMExVVnJwMW5DODJmeEVPOHNJTzNYdjlWNVUNCnc5QnVTVVFRSmtMejNQYVI5WTdRZUEyNW5LUGtqTXZ2Y0UxVU5oeVpIYlNLbmorSitkZmFjb1hsSGtyMEdGTXYNCldkSDZqR0pWcGNQMHBkNjFOa3JKa2c0aStheThwS2ZqdjNUOHN3NWdaVHFweFFaaitVRWxqaVM0SHRPTlhkNlENCnZRSURBUUFCDQotLS0tLUVORCBQVUJMSUMgS0VZLS0tLS0NCg==",          "expiry": 1608495423      } ]

  1. You'll need a service that generates the JWT to send to Omnichannel’s servers as a part of starting a chat for an authenticated user.

    a. The JWT header will look similar to the following example.

    { 
  "alg": "RS256", 
  "typ": "JWT", 
}

    Ha több nyilvános kulcsot használ, be kell adnia a kulcsazonosítót (kölyök). A JWT fejléce a példához hasonlóan fog kinézni:

    { 
  "alg": "RS256", 
  "typ": "JWT",
  "kid": "qWO4EaKT1xRO7JC/oqALz6DCVr41B/qL0Hqp4in7hu4="
}

    b. A JWT hasznos adatnak a következőket kell tartalmaznia.

    • Legalább a következő jogcímek.

      Jogcím Definíció
      Iss A lexikális elem kibocsátója.
      Iat A token kibocsátásának dátuma. Ez numerikus dátumformátum.
      Exp A token lejárati dátuma. Ezen a napon túl már nem érvényes. Ez numerikus dátumformátum.
      sub A jogcím tárgya.
      MEGJEGYZÉS: Javasoljuk, hogy adja át a bejelentkezett felhasználónak a Customer Service alkalmazásban található kapcsolattartó- vagy partnerrekord GUID-azonosítóját. A GUID-azonosítóval azonosíthatja és összekapcsolhatja a kapcsolattartó-rekordot a beszélgetéssel.

    • Az lwicontexts: A beszélgetés részeként átadható környezeti változók továbbítási célokból vagy az ügynöknek való megjelenítés céljából. Ha többet szeretne megtudni a lwicontexts elemekről, tekintse meg az Egyéni környezet kezelése című témakört.

      Megjegyzés

      A rekordokat a környezeti változók segítségével automatikusan is azonosíthatja. További információk: Az ügyfelek automatikus azonosítása a csevegés előtti válaszok és setContext API módszer használatával.

    • Minden más átadni kívánt adat.

      A hasznos adat a példához hasonlóan fog kinézni:

      { 

  "sub" : "87b4d06c-abc2-e811-a9b0-000d3a10e09e",  
  "lwicontexts" :"{\"msdyn_cartvalue\":\"10000\", \"msdyn_isvip\":\"false\", \"portalcontactid\":\"87b4d06c-abc2-e811-a9b0-000d3a10e09e\"}", 
  "iat" : 1542622071, 
  "iss" : "contosohelp.com", 
  "exp" : 1542625672, 
  "nbf" : 1542622072 
}

    c. A JWT aláírását a személyes kulcsának kell aláírnia.

    Megjegyzés

    • Ha a token lejárt vagy érvénytelen, a csevegési vezérlő egy hibaüzenetet ad.
    • A setContextProvider metódust nem szükséges a hitelesített csevegéshez használni. A JWT hasznos adat részeként át kell adnia az lwicontexts elemét.

  2. Hozzon létre egy JavaScript függvényt a webhelyén, amely fogadja a visszahívási függvényt, és visszaadja a JWT-t a visszahívási függvénynek. Az időtúllépés elkerülése érdekében ennek a JavaScript függvénynek 10 másodpercen belül vissza kell adnia egy JWT-t. Ez a JWT:

    • Tartalmazza fejlécet, a hasznos tartalmat és az aláírást a 3. lépésből.

    • A személyes kulccsal alá kell írni az 1. lépésben szereplő kulcspár alapján.

      Javasoljuk, hogy a JWT-t a webkiszolgálón hozza létre.

      A JavaScript-módszer neve lesz használva a hitelesítési beállítások rekordjának létrehozásához használható az Omnicsatorna felügyeleti alkalmazásban.

      // This is a sample javascript client function  

auth.getAuthenticationToken = function(callback){ 

  var xhttp = new XMLHttpRequest(); 
  xhttp.onreadystatechange = function() { 
      if (this.readyState == 4 && this.status == 200) { 
          callback(xhttp.responseText); 
      } 
  }; 
  xhttp.onerror = function(error) { 
      callback(null); 
  }; 
//Replace this with a call to your token generating service 
  xhttp.open("GET", "https://contosohelp.com/token", true); 
  xhttp.send(); 
}

  3. A fejlesztőnek a következő információkat kell megosztania a Omnicsatorna rendszergazdájával:

    a. A nyilvános kulcs szolgáltatás URL-címe a 2. lépésből.

    Példa: https://www.contoso.com/auth/publickey

    b. A JavaScript-ügyfél függvényének neve a 4. lépésből. Ezt a csevegés megkezdése közben a live chat vezérlő belsőleg fogja meghívni.

    Példa: auth.getAuthenticationToken

    Megjegyzés

    Ha felhasználói élménye kiteszi a csevegés gombot a felhasználók hitelesítése előtt, akkor biztosítsam hogy át legyenek irányítva a hitelesítési lapra. Ezt a 4. lépésben található módszerrel lehet elvégezni, vagy a felhasználói folyamat korábbi lépéseként.

    Ez az ábra végigvezeti a beállításon:

    Hitelesített csevegési beállítás.

    Ezután a következő lépések végrehajtásával állíthatja be a hitelesített csevegést:

  4. Lépjen az Omnicsatorna felügyeleti központba vagy az Omnicsatorna felügyelet alkalmazásba, és hozzon létre egy hitelesítési beállítási rekordot az 5. lépésből származó adatokkal. További információkért lásd: Csevegéses hitelesítési beállítás rekordjának létrehozása.

  5. Társítsa a hitelesítési beállításokat a csevegő-vezérlőhoz, amelyhez hitelesített élmény tartozik. További tájékoztatás a Hitelesítés hozzáadása a csevegési vezérlőhöz című témakörben olvasható.

    Ez az ábra végigvezeti a hívási sorrenden, amikor a felhasználó a csevegést egy hitelesített beállításban éri el:

    Hitelesített csevegés futásideje.

Kapcsolódó információk

Csevegési vezérlő hozzáadása
Csevegés előtti felmérés konfigurálása
Gyors válaszok létrehozása
Üzemórák létrehozása és kezelése
Csevegési vezérlő beágyazása a Power Apps portálokba
Ügyfelek automatikus azonosítása

Megjegyzés

Megosztja velünk a dokumentációja nyelvi preferenciáit? Rövid felmérés elvégzése. (ne feledje, hogy ez a felmérés angol nyelvű)

A felmérés elvégzése körülbelül hét percet vesz igénybe. Semmilyen személyes adatot nem gyűjtünk (adatvédelmi nyilatkozat).