Tässä artikkelissa
dropdown icon
Yleiskatsaus
    Webex Contact Center for Salesforce Service Cloud Voice
    Edellytykset ja rajoitukset
    Lisenssit
    Ota käyttöön Omni-Channel
    Rajoitukset
dropdown icon
Vaatimukset
    Salesforce-paketti 1.2 ja uudemmat
    Tyhjäkäyntikoodit
    Hintarajat
dropdown icon
Integroida
    Asennus
    Asenna ja määritä Webex Contact Center for Service Cloud Voice
    Määritä läsnäolotila (t) agenteille
dropdown icon
Kokoonpano
    Luo Webex Contact Center -tunnistetietojen mukautettu metatietotietue
    Yhteydenottokeskus
    Yhteydenottokeskuksen tuominen
    Määritä yhteyskeskus
dropdown icon
Mukauta
    Ulkoinen asiakassovellus Webex Contact Center -integrointia varten
    Webex Contact Center -kokoonpano ja komentosarja äänipuhelutietueiden luomiseksi
Käyttäjätoiminnon edellyttämät Salesforce-käyttöoikeudet
dropdown icon
Service Cloud Voice API -kääre
    Ennakkoedellytykset
    Service Cloud Voice API -kääreen käyttäminen
    Hae Access_Token
    Suorita pyynnöt
    Luo äänipuhelu (osio)
    Päivitä äänipuhelu
    Suorita Omni-flow
    Selkeä reititys
dropdown icon
Puhelinnumeron käännökset
    Käännössääntöjen luominen
dropdown icon
VoiceCall-sivun määritykset
    VoiceCall-tietuesivun määrittäminen
    Wrap-Up Rease-komponentin näyttäminen
    Puhelun tallennussoittimen näyttäminen
dropdown icon
Webex-järjestelmänvalvojat
    Virtauksen kokoonpano
Integroi Webex-yhteyskeskus Salesforce Service Cloud Voice -palveluun
list-menuTässä artikkelissa
list-menuOnko sinulla palautetta?

Webex Contact Center for salesforce Service Cloud Voice integroi Ciscon vankan CCaaS: n (Contact Center as a Service) Salesforcen CRM:ään, jolloin yritykset voivat hallita monikanavaista asiakasvuorovaikutusta (ääni, digitaalinen) Salesforce-käyttöliittymässä käyttämällä Webexin tekoälyä virtuaalisiin agentteihin, transkriptioon ja älykkääseen reititykseen, muuttaen agentit ”superagenteiksi”, joilla on yhtenäiset tiedot paremman asiakaskokemuksen saavuttamiseksi.

Yleiskatsaus

Webex Contact Center for Salesforce Service Cloud Voice

Webex Contact Center for Service Cloud Voice on valmis integrointiratkaisu, joka tuo Webex Contact Centerin tehon Salesforce Service Cloud Voice Omnikanavaiseen agenttikonsoliin.

Ennen kuin jatkat asennusta, katso seuraava kohta:

saat lisätietoja Salesforce Service Cloud Voice -palvelun ennakkoedellytyksistä ja rajoituksista sekä varmista aksesi, että Salesforce-organisaatio on valmis ottamaan käyttöön ja asentamaan Webex Contact Center for Service Cloud Voice -paketin.

SCV Voice Connector Release 1 on yleisesti saatavilla. Tämä opas sisältää määritystoimenpiteet, kumppanipuhelinpalvelun käyttöönoton ja kertakirjautumisen (SSO) määritykset.

Edellytykset ja rajoitukset

Edellytykset (alaaihe)

Käyttöliittymät: Service Cloud Voice on käytettävissä vain Salesforce Lightning Experience -palvelussa.

Service Cloud Voice on saatavana seuraavissa versioissa:

  • Yritys
  • Rajoittamaton
  • Kehittäjä

Lisenssit

  • Asiakkaiden on hankittava uusi A-SF-VOICE-lisäosalisenssi kirjautunutta edustajaa kohden Webex Contact Centerin Flex 3 Standard- tai Premium-lisenssien lisäksi. Lisätietoja on Flex 3 -tilausoppaassa.

  • Salesforce-ääni kumppanipuhelinta varten

Ennen kuin otat Äänen käyttöön, sinun on määritettävä organisaatiosi edellyttämät palvelut.

  • Siirry kohtaan Yritystiedot > Käyttöoikeusjoukon käyttöoikeus
    • Tarkista Service Cloud Voice User (Partner Telephony).

      Kaikissa kehittäjäversioissa on nyt viisi kumppanipuhelinlisenssiä, jotka ovat testattavissa.

  • Vaihtoehtoisesti voit vahvistaa tämän siirtymällä Salesforce Setup -kohtaan ja etsimällä ”ääni” vasemmasta sivupalkista.

    • Jos näky viin tulee ”Partner Telephony Contact Centers”, sinulla on SCV- lisenssi.
    • Jos ”Partner Telephony Contact Centers” -vaihtoehto ei ole näkyvissä, "Ota Service Cloud Voice käyttöön” noudattamalla alla olevia ohjeita.
      • Siirry Salesforce-asetuksiin ja etsi ja valitse "Partner Telephony Setup" ja vaihda painike kohtaan "Ota Service Cloud Voice käyttöön ”.

      • Ota Omni-Channel käyttöön, jotta edustajat voivat soittaa ja vastaanottaa puheluita.

Ota käyttöön Omni-Channel

Jos Omni-Channel on jo käytössä organisaatiossasi, ohita tämä vaihe.

  1. Kirjoita Asetukset-kohdasta Pik ahaku -ruutuun Omni-Channel Sett ings ja valitse sitten Omni- Channel Settings.

  2. Valitse Ota omnikanava käyttöön.
  3. Valitse Tallenna.

Rajoitukset

  • Ääni on käytettävissä vain Lightning Experience -sovelluksessa.
  • Voicea tuetaan Service Cloudissa ja Sales Cloudissa lisälisenssinä.
  • Ääntä ei tueta Salesforce Mobilessa tai iPad Safarissa.
  • Ääntä tuetaan vain Google Chrome-, Microsoft Edge (Chromium )- ja Mozilla Firefox -selaimissa. Evästeiden on oltava käytössä, jotta kertakirjautuminen (SSO) voidaan sallia.
  • Normaali navigointi ei ole tuettu.
  • Puhelinpalvelut ovat tiukasti säänneltyjä, joten kysy Salesforce-edustajaltasi, onko Äänen saatavuus alueellasi.
  • Salesforce Service Cloud Voice -liitäntä ei tue usean osapuolen konferenssia.

Vaatimukset

Salesforce-paketti 1.2 ja uudemmat

Salesforce Package 1.2: n tai uudemman käyttöönoton on otettava huomioon digitaalinen ja puheintegraatio sekä WebSocket keep-alive -käsittely.

Tyhjäkäyntikoodit

Etsi tyhjäkäyntikoodit

Aseta tyhjäkäyntikoodit seuraavasti:
1

Kirjaudu sisäänManagement Portal.

2

Siirry kohtaan Yhteydenottokeskus > TYÖPÖ YTÄ KOKEMUS > Tyhjäkäynti -/käännöskoodit.

3

Varmista, että tyhjäkäyntikoodit näkyvät, muuten napsauta suodattimen pudotus painiketta ja valitse sivun yläreunasta Idle Code.

4

Napsauta tyhjäkäyntikoodia avataksesi yksityiskohtaisen näkymän. Sieltä löydät Idle Code ID -tunnuksen.

Tunnukset voidaan kopioida ja käyttää sitten Presence State Mapping - määrit yksessä. Yksi tunnuksista on käytettävä oletusarvoisena Cisco Not Ready -syynä.

Hintarajat

Tämä osio koskee vain Early Access -pakettia, jos Early Access -pak etissa testataan enemmän agentteja (esim. 0.2). Tätä EI vaadita GA- paketille.

Webex Contact Center soveltaa tavallisia API-hintarajoituksia Contact Center -organisaation integrointiin. Katso lisätietoja kohdasta API-nopeusrajoit ukset.

Korkorajaa on korotettava. Tämän saavuttamiseksi:

  • Luo lippu Webexin yhteyskeskuksen tuella.
  • Määritä Webex Contact Center -organisaatio ja vaadittu standardiintegraatio-sovellusliittymän nopeusraja (laskentaa varten, katso alla).
  • Mainitse, että sovellusliittymän nopeusrajaa on lisättävä, koska käytät Webex Contact Center for Service Cloud Voice -palvelua.

Webex Contact Center for Service Cloud Voice, 15 pyyntöä edustajaa kohti minuutissa Contact Center -organisaation integrointia varten. Voit laskea hyvän lähtökohdan hintarajallesi käyttämällä seuraavaa kaavaa:

Nopeusrajoitus minuutissa = 15 * Webex Contact Center -organisaatiossa rinnakkain työskentelevien agenttien enimmäismäärä

Integroida

Asenna ja määritä Webex Contact Center for Service Cloud Voice

Kun Service Cloud Voice for Partner Telephony -lisenssi on hankittu, Partner Tele phony Setup - sivu tulee näkyviin Asetukset-valikossa.

Lisätietoja löytyy Salesforcen virallisesta viitteestä (suora linkki).

1

Kirjoita Asetukset-kohdasta Partner Telephony SetupPikahaku - ru utuun ja valitse sitten Partner Telephony Setup.

2

Ota pu he käyttöön kumppanipuhelintoiminnon avulla.

Partner Telephony Contact Centers -sivu tulee näkyviin Asetukset- valikossa.

Jos aiot ottaa paketin käyttöön Salesforce-hiekkalaatikossa, korvaa asennuslinkin login.salesforce.comosa. test.salesforce.com Huomaa, että tämä paketti poistetaan hiekkalaatikkoorganisaatiosta aina, kun luot uuden hiekkalaatikon kopion.

Asenna paketti

Paketin asentaminen:

1

Aloita asennus avaamalla paketin mukana toimitettu linkki.

2

Kirjaudu Salesforce-organisaatioon, johon paketti on asennettava.

3

Valitse ohjatussa asennustoiminnossa suojausvaihtoehto ”Asenna vain järjestelmänvalvojille” (1) ja napsauta Asen na (2).

Määritä, mitkä käyttäjät saavat tietyt käyttöoikeudet Webex Contact Center for Service Cloud Voice -paketin mukana toimitettuihin objekteihin ja komponentteihin. Anna heille lisäksi nämä käyttöoikeudet; Webex Contact Center for Service Cloud Voice -paketin mukana toimitetut käyttöoikeusjoukot auttavat tätä prosessia.

Ohjattu paketin asennustoiminto — Tervetuloa-näyttö tulee näkyviin:

Asennuspaketti ei ole suoraan käytettävissä Salesforce AppExchangen kautta. Asiakkaiden on käytettävä AppExchange-luettelon ”Hanki se nyt” -painiketta, joka avaa yhteydenottolomakkeen pyytä äkseen asennuslink kiä ja Ciscon aktivointia.

4

Anna seuraavat käyttöoikeusjoukot vähintään yhdelle käyttäjälle, jotta voit luoda yhteysk eskuksen:

Contact Center Admin (Partner Telephony).
5

Napsauta Asetukset | Käyttäjät | Käyttäjät.

6

Haku ja valitse käyttäjä.

7

Vieritä alaspäin kohtaan ”Käyttöoikeusasetusten tehtävät”.

8

Napsauta Muokkaa tehtäviä

9

Yhteysk eskuksen järjestelmänvalvojille: määritä yhteyskeskuksen järjestelmänvalvojan (kumppani puhelinta) käyttö oikeusjoukko.

10

Yhteyskeskuksen edustajille: määritä Contact Center Agent (Partner Tele phony) - käyttöoikeusjoukko ja Webex Contact Center SCV Agent -käyttöoikeusjoukko.

Asenna kaikille käyttäjille - vaihtoeh toa ei suositella, koska tämä antaa kaikki paketin komponenttien ja objektien oikeudet (lukea, luoda, muokata ja poistaa) kaikille käyttäjille, jotka käyttävät mukautettua käyttäjäprofiilia.

11

Määritä käyttäjille pakettilisenssi, jotta käyttäjät voivat työskennellä Connects for Service Cloud Voice -palvelun kanssa.

  • Napsauta Asetukset | Sovellukset | Pakkaus | Asennetut paketit.
  • Valitse Hil jattain asennetun Webex Contact Center for Service Cloud Voice -sovelluksen vieressä Hallitse käyttöoikeuksia.
  • Valitse Lisää käyttäjiä.
  • Valitse käyttäjät, joille käyttöoikeusmuuse on määritetty, ja napsauta Lisää.

12

Vaihtoehtoisesti voit napsauttaa Asetukset | Käyttäjät | Käyttäjät. .

13

Etsi ja valitse käyttäjä.

14

Vieritä alas kohtaan Hall itut paketit.

15

Valitse Määritä käyttöoikeudet.

16

Valitse luettel osta Webex Contact Center for Service Cloud Voice -paketti.

17

Klik kaa Lisää.

18

Luo läsnäolotilat määrittääksesi, mitkä palvelukanavat on määritetty eri tiloille. Edustajat voivat kirjautua Omni-Channeliin eri tiloilla riippuen siitä, millaista työtä he ovat oikeutettuja vastaanottamaan.

19

Kirjoita Asetukset-kohdasta Presence StatusesPikahaku -ruutuun ja valitse sitten Läsn äolotilat.

20

Valitse Uusi. Luo vähintään yksi tila kohdalle ”Online” ja yksi ”Kiireinen” -tilalle.

  • Luo omistettu kiireisen läsnäolon tila RONA:lle. Läsnäolokokoonpanoa voidaan käyttää Omni-Channel -tilan asettamiseen automaattisesti määritettyyn tilaan aina, kun RONA esiintyy CTI-puolella tai Salesforcen sisällä.
  • Jos määrität RONA-tilan läsnäolokokoonpanossa, varmista, ettet käytä oletusarvoisia läsnäoloasetuksia. Tällä hetkellä Webex Contact Center for Service Cloud Voice ei nouda oletusmäärityksessä määritettyä RONA-tilaa.

Määritä läsnäolotila (t) agenteille

1

Kirjoita Asennus-kohdasta Käyttöoikeusjoukot Pikahaku -ruutuun ja valitse sitten Käyttöoikeus joukot.

2

Avaa Kumpp anin puhelinkäyttöoikeusjoukko napsauttamalla.

3

Valitse Palvelun läsnäolotilojen käyttö.

4

Valitse Muokkaa.

5

Valitse Av ailable Service Presences -luettelosta aiemmin luodut läsnäolotilat ja liitä ne käyttöoikeusjoukkoon valitsem alla Lisää. Tähän käyttöoikeusjoukkoon määritetyt edustajat voivat kirjautua Omni-Channel -palveluun millä tahansa käytettävissä olevalla läsnäolotilalla.

6

Valitse Tallenna.

7

Napsauta Hallitse tehtäviä samalla sivulla. Napsauta sitten oikeassa yläkulmassa Lisää tehtävä, valitse haluamasi käyttäjä, valitse Seuraava, valitse määritettyjen käyttäjien vanhentumis vaihtoehto (valinnainen) ja valitse sitten Määritä.

Service Cloud Voice käyttää ulkoista verkkotunnusta VoiceCall-tietueen käyttämiseen. Seuraavat URL-osoitteet on lisättävä Asetusten ”Etäsivuston asetuksiin” (napsauta tätä avataksesi virallisen dokumentaation):

Esimerkki: Instanssin URL-osoitteen löytäminen.

8

Katso URL-osoite selaimesi osoiteriviltä kirjautumisen jälkeen. Esiintymän URL-osoite on osa ennen ”.my.salesforce.com” tai ”.salesforce.com” tai. ”lightning.force.com”. Jos URL-osoitteesi on esimerkiksi https://orgfarm-54a38e30ad-dev-ed.develop.my.salesforce-setup.com/, esiintymän URL-osoite on orgfarm-54a38e30ad-dev-ed.develop.

Esimerkki:

Alkuperäorganisaation URL-osoite: https://cisco.lightning.force.com

Esimerkki: Lisättävä URL-osoite:

  • https://cisco.my.salesforce-scrt.com

9

Omni-Channel -apuohjelma vaaditaan Lightning Service Console -sovelluksessa, jotta agentti voi käyttää Service Cloud Voice -sovellusta.

  • Kirjoita Asetukset-kohdasta Pikahaku -ruutuun Sovellukset ja valitse sitten Sovellusten hallinta.
  • Napsauta Service Console -sovelluksen tai sovelluksen vieressä olevaa avattavaa luetteloa, jota haluat käyttää, ja napsauta sitten Muokkaa.
  • Valitse Sovellusasetukset-kohdasta Apuohjelmakohteet (Vain työpöytä).
  • Valitse Lisää apuohjelmakohde.
  • Etsi modaalisessa ikkunassa Omni-Channel.
  • Valitse Omni-Channel.
  • Napsauta Tallenna ja poistu App Manager -sovelluksesta.

Salesforcen virallinen viite löytyy napsauttamalla Let's Do This -painiketta, joka avaa Con figure the Agent Experience for Service Cloud Voice with Partner Telephony -sivun Salesforcen ohjeporta alissa (suora linkki).

10

Kirjoita Asetukset-kohdasta Pikahaku -ruutuun Partner Telephony Setup ja valitse sitten Partner Telephony Setup.

11

Vieritä alas kohtaan 5 Lisää ääniasetuksia.

12

Jotta napsautussuojauksen voi ottaa käyttöön Visualforce-sivuilla, joiden otsikot on poistettu käytöstä työskennellessäsi ohjelmistopuhelimen kanssa Lightning Experiencessä, sinun on lisättävä verkkotunnukset, joista ohjelmistopuhelin ja mukautetut työkalurivit ladataan luotettavina toimialueina Salesforce-ilmentymän URL-osoitteen lisäksi.

Nämä asetukset ja Luotetut verkkotunnukset -luettelo löytyvät kohdasta Asetukset | Suojaus | I stuntoasetukset.

Jos haluat hakea oikean Visualforce-verkkotunnuksen, siirry kohtaan Asetukset | Mukautettu koodi | Visualforce-sivut ja napsauta Esikatselu-painiketta. CiscoScvMainWxCC Salesforce voi ohjata automaattisesti toiseen URL-osoitteeseen Salesforce ORG:n kokoonpanon mukaan. Kopioi URL-osoite ja lisää se Trusted Domains for Inline Framesluettel oon valitsemalla ”Visualforce P ages” iFrame-tyypiksi.

Esimerkki: MyDomainName-- .vf.force.com cisco_wxcc_scv

Saat Salesforce-esiintymän toimialueen kopioimalla selaimen URL-palkissa näkyvän URL-osoitteen ja lisäämällä sen Luotetut verkkotunnukset sisäisten kehysten luetteloon valitsemalla Visualforce-sivut iFrame-tyypiksi.

Esimerkki: MyDomainName.Lightning.Force.com

Jos organisaatiossasi ei ole otettu Oma toimialue käyttöön, URL-osoitteesi muoto on erilainen. Jos sinulla on Oma toimialue käytössä ja parannettuja toimialueita ei ole otettu käyttöön organisaatiossasi, URL-osoitteesi muoto on erilainen. Jos parannetut verkkotunnukset eivät ole käytössä, Visualforcen, Experience Builderin, Site.com-studion URL-osoitteiden vakauttaminen ja sisältötiedostojen Oma toimialue -asetus vaikuttaa myös tähän muotoon. Lisätietoja on Salesforce-ohje essa Oma toimialueen URL-osoitteiden muodot.

Clickjack-suojaus ja luotetut verkkotunnukset Lightning-kokemuksen asetukset

13

Jotta tallennussäätimet voidaan näyttää puhelujen aikana, agentit tarvitsevat Control Call Recordingsovelluksen luvan.

Voit määrittää sen lisäämällä sen Läsnäolotilat-vaiheessa luotuun käyttöoikeusjoukkoon.

  • Avaa käyttöoikeusjoukko.
  • Napsauta Sovelluksen käyttöoikeudet - linkkiä.
  • Napsauta Muokka a-painiketta.
  • Lisää Call Center Control Call Recording - oikeus ja tall enna.

Kokoonpano

Luo Webex Contact Center -tunnistetietojen mukautettu metatietotietue

Jotta voit muodostaa yhteyden Webex Contact Centeriin, sinun on luotava mukautettu metatietotyyppinen tietue:
1

Kirjoita Asetukset-kohdasta Pik ahaku -ruut uun Mukaut ettu met ati etotyyppi ja valitse sitten Mu kautetut metatietotyypit.

2

Etsi luettelosta wxCC-yhteyden mukautettu metatieto tyyppi.

3

Valitse wxCC- yhteyden edessä Hallitse tiet ueita ja sitten Uusi.

4

Anna nimi. Esimerkki: WebExccMetadata

5

Anna organisaatiosi standardin wxCC-todennusURL-osoite ja asiakassalaisuus. Jos haluat käyttää Salesforce-puhelinasetuksia, noudata Määritä Salesforce-liitäntä Webex Control Hubissa.

6

Valitse Tallenna.

7

Muista wxCC-yhteyden nimi, jota tarvitset yhteyskeskuksen kokoonpanossa.

Yhteydenottokeskus

Yhteyskeskuksen määritystiedosto määrittää joukon kenttiä ja arvoja, joita käytetään määrittämään yhteysk eskus Salesforcessa tietylle CTI-järjestelmälle. Salesforce käyttää Contact Centerin määritelmätiedostoja tukeakseen integrointia useiden CTI-järjestelmätoimittajien kanssa.

Lisätietoja löytyy Salesforcen virallisista asiakirjoista (suora linkki).

Yhteydenottokeskuksen tuominen

Lataa Contact Centerin uusin versio täältä.

Päivitys beetaversiosta: Tässä oppaassa kuvataan Salesforce Service Cloud Voice -palvelun Webex Contact Center -integraation yleisen saatavuuden (GA) version puhdas asennus.

Jos päivität integraation beetaversiosta, älä käytä olemassa olevaa Partner Contact Center -tietuetta uudelleen. Sen sijaan:

  1. Tuo GA-julkaisuun sisältyvä Partner Contact Center XML -tiedosto.
  2. Luo uusi Partner Contact Center -tietue tuodun XML-tiedoston avulla.
  3. Päivitä kokoonpanosi, jotta voit käyttää äskettäin luotua Partner Contact Centeriä.

GA Partner Contact Center XML sisältää päivitetyt määritysarvot, mukaan lukien oikea liittimen URL-osoite ja muut metatiedot. Beta-XML:stä luodun kumppanin yhteyskeskuksen tietueen uudelleenkäyttö saattaa säilyttää vanhentuneet määritysarvot ja estää integroinnin toimimisen oikein.

1

Kirjoita Asetukset-kohdasta Pikah aku -ruutuun Partner Tele phony Contact Centers ja valitse sitten Partner Telephony Contact Centers.

Luettelo olemassa olevista (jos sellaisia on) yhteyskeskuksista tulee näkyviin.
2

Napsauta sivun oikeassa reunassa Luo yhteyskeskus.

3

Valitse puhelinoperaattoriksi Webex Contact Center. Napsauta sitten Seuraava.

Tiedostoselain avautuu.
4

Valitse .xmltiedosto, joka sisältää yhteyskeskuksen määritelmän.

5

Valitse Avaa.

Tiedosto tuodaan.
6

Tarkista, näkyykö Contact Center -luettelonäkymässä Contact Center (Contact Center) -luettelonäkymässä.

Määritä yhteyskeskus

1

Kirjoita Asetukset-kohdasta Pikah aku -ruutuun Partner Tele phony Contact Centers ja valitse sitten Partner Telephony Contact Centers.

2

Valitse aiemmin tuotu Contact Center.

3

Valitse Muokkaa.

Taulukko 1. Yhteydenottokeskuksen tiedot
KenttäKuvaus
Näyttönimi Tämä on yhteyskeskuksen nimi, joka näkyy käytettävissä olevien yhteyskeskusten luettelossa. Sama Contact Center -määritelmätiedosto (.xml) voidaan tuoda useita kertoja, ja sille voidaan antaa eri näyttönimet.
Julkinen avain

Äänitoimintojen käyttäminen edellyttää julkisen ja yksityisen avaimen varment een. Yksityisen avaimen hankkimiseksi on mahdollista luoda itse allekirjoitettu varmenne, luoda allekirjoit ettu varmenne tai tuoda suoraan Java-avainsäilytystiedostoja (JKS) Certificate Authority tai B ouncy castle fips keystore -tiedostoja (BCFKS) käyttämällä Tuo avainvarastosta -painiketta.

Kun sertifikaatti on luotu:

  • Napsauta varmenteen ot sikkoa.
  • Valitse Lataa varmenne.
  • Avaa ladattu varmenne tekstieditorilla.
  • Kopioi sen sisältö Yhteysk eskuksen Julkinen avain -kenttään.

Vaaditaan: Kyllä

Todistuksen yksilöllinen nimi

Julkis Unique Nameelle avaimelle luodun itse allekirjoitetun var ment een nimi.

Vaaditaan: Kyllä

Valmiustilan tunnus
  • Avaa Esiin tymistilat- sivu Asetuksissa.
  • Napsauta Online- tilaa ja kopioi sen Salesforce-tunnus URL-palk ista.
  • Liitä tunnus tähän kenttään.

Vaaditaan: Kyllä

Ei valmis tilatunnus
  • Avaa Esiin tymistilat- sivu Asetuksissa.
  • Napsauta Varat tua tilaa ja kopioi sen Salesforce-tunnus URL-palkista.
  • Liitä tunnus tähän kenttään.

Vaaditaan: Kyllä

Oletusarvoinen Cisco ei ole valmis syy

Ciscon käyttämättömän koodin tunnus, jota käytetään oletuskäyttökoodina, jos tietylle läsnä olotilalle ei tarjota kartoitusta.

Vaaditaan: Kyllä

Jos haluat tarkistaa määritetyt käyttämättömän koodin tunnukset, katso Tyhj äkäyntikoodit - osiosta.

Läsnäolotilan kartoitus

Käytetään Salesforce Omni Presence -tilojen kartoittamiseen Cisco Ready -tilaan ja Not Ready -syykoodeihin.

Tyhjä käyntikoo din tilat on lisättävä:

  • Avaa Esiin tymistilat- sivu Asetuksissa.
  • Napsauta yhtä Varattu-tilo ista ja kopioi sen Salesforce-tunnus URL-palkista. Läsnäolon tilat 0N5unnukset alkavat esimerkiksi 0N51X0000000AUT.
  • Liitä tunnus tähän kenttään, jota seuraa pilkku ja Ciscon käyttämättömän koodin tunnus.
  • Yksi tai useampi Busy- kartoitus voidaan lisätä pilkkujen erottelulla.

Synkronointiongelmien välttämiseksi Default Not Ready IDon määritettävä myös kartoituksessa.

Jos olet määrittänyt hylkäämisen ja lähet yksen aik akatkaisun tilat läsnäolok okoonpan ossa, lisää ne myös kartoitukseen vastaavalla Cisco Not Ready -tilalla.

Muoto:

  • Kiireinen kartoitus: busyPresenceID1, ciscoAuxCodeID1
  • Oletusarvoinen ei-valmis kartoitus:, defaultNotReadyPresenceIDciscoDefaultNotReadyAuxCodeID
  • Online-kartoitus: onlinePresenceId, 0

Erota jokainen täydellinen kartoitus puolipisteellä.

Vaaditaan: Kyllä

Tässä on esimerkki valmiista tyhjäkäyntikoodeista lounaalle, kokoukselle, tauolle.

Äänipuhelutunnuksen puhelumuuttuja

Puhelumuuttuja, jota käytetään nykyisen äänipuhelun tunnuksen tallentamiseen. Sitä käytetään puhelun tilan päivittämiseen oikein.

Muoto: Muuttujan nimi, joka on määritetty Webex Contact Center Flow -sovelluksessa. Esimerkiksi SCV_VoiceCallRecordId

Vaaditaan: Kyllä

Oletusarvo: SCV_VoiceCallRecordId

Jos olet yhdistänyt Äänipuhelutietueen tunnuksen ja toimittajan puhelunavaimen yhdeksi virtamuuttujaksi, voit määrittää sen nimen tässä kentässä. Katso myös Äänipuhel utietueen tunnuksen ja toimittajan puhelunavaimen virtausmuuttuja.

Toimittajan soittoavaimen soittomuuttuja

Puhelumuuttuja, jota käytetään nykyisen äänipuhelun toimittajan soittonäppäimen tall entamiseen. Sitä käytetään oikean äänipuhelutietueen avaamiseen.

Muoto: Muuttujan nimi, joka on määritetty Webex Contact Center Flow -sovelluksessa. Esimerkiksi SCV_VendorCallKey

Vaaditaan: Kyllä

Oletusarvo: SCV_VendorCallKey

Jos olet yhdistänyt äänipuhelutietueen tunnuksen ja toimittajan puhelunäppäimen yhdeksi virtamuuttujaksi, voit jättää tämän kentän tyhjäksi ja määrittää virtamuuttujan nimen äänipuhelutunnuksen tunnuksen ja toimittajan puhelunäppäimen kentässä ”Puhelutunnuksen puhelutunnus” -kentässä. Katso myös Ääni puhelutietueen tunnuksen ja toimittajan puhelunavaimen virtausmuuttuja.

Puhelinnumeron kääntäminen

Puhelinnumeron käännössäännöt, joita sovelletaan numeroon ennen valin taa.

Katso puhelinnumeron käännökset

Vaaditaan: Ei

Webexin yhteyskeskuksen alue

Vuokralaisen avulla määritetään Webex Contact Center -alue. Se löytyy Webex Contact Center -portaalin, kehittäjäportaalin tai työpöydän URL-osoitteesta. Kä devportal.wxcc-eu2.cisco.comyttää esimerkiksi aluetta eu2.

Muoto: eu2

Vaaditaan: Kyllä

Webex Contact Center -alueet ja vastaavat merkkijonot:

  • USA: us1
  • Kanada: ca1
  • UK: eu1
  • Saksa: eu2
  • Australia: anz1
  • Singapore: sg1
  • Japani: jp1
Webex-yhteyskeskuksen WebRTC-verkkotunnus

Verkkotunnusta käytetään oikean WebRTC-yhteyden muodostamiseen. Käytä Webex Contact Center -vuokralaisen sijaintia:

  • USA: rtw.prod-us1.rtmsprod.net
  • ANZ: rtw.prod-as1.rtmsprod.net
  • CA: rtw.prod-ca1.rtmsprod.net
  • JP: rtw.prod-ja1.rtmsprod.net
  • EU1: rtw.prod-uk1.rtmsprod.net
  • EU2: rtw.prod-gm1.rtmsprod.net

Vaaditaan: Kyllä WebRTC: lle

Ota WCCAI transkriptio käyttöön

Käytetään WCCAI-transkription ottamiseen käyttöön tai poistamiseen käytöstä.

Muoto: Truetai False

Vaaditaan: Ei

Oletusarvo: False

Tallenna tallennuslinkki

Käytetään Webex-puhelun tallennuslinkin tallentamiseen Äänipuhelutietueeseen.

Muoto: Truetai False

Vaaditaan: Ei

Oletusarvo: True

4

Napsauta Yhteystietokeskuksen sivun alareun assa Lisää-painiketta Yhteystietok eskuksen käyttäjät - osiossa.

5

Napsauta + niiden käyttäjien vieressä, joilla on pääsy avoimeen yhteyskeskukseen.

Tässä luettelossa näkyvät Contact Center Agent (Partner Telephony) vain käyttäjät, joille on asetettu käyttöoikeudet ja joita ei ole vielä määritetty muihin yhteyskeskuksiin.

Mukauta

Ulkoinen asiakassovellus Webex Contact Center -integrointia varten

Määritä ulkoinen asiakassovellus Webex Contact Center Salesforce Connectorille

Jotta Service Cloud Voicea voidaan käyttää täysimääräisesti, Contact Centerin puheluvirtaa voidaan mukauttaa luomaan äänipuhelutallenne ja suorittamaan Salesforce Omni-Channel -kulku puhelun ollessa IVR:ssä .

Luo sertifikaatti

Varmista, että olet jo luonut digitaalisen varmenteen organisaatiosi suojauskäytännön mukaisesti.

Jos haluat luoda digitaalisen varmenteen, tutustu Salesforcen ohjeisiin osoitteessa https://developer.salesforce.com/docs/atlas.en-us. voice_pt_developer_guide.meta/voice_pt_developer_guide/voice_pt_generate_certificate.htm.

Esimerkki

openssl genrsa -des3 -passout pass:<password> -out server.pass.key 2048
openssl rsa -passin pass:<password> -in server.pass.key -out server.key
rm server.pass.key
openssl req -new -key server.key -out server.csr

    Country Name (2 letter code) [AU]:CH
    State or Province Name (full name) [Some-State]:
    Locality Name (eg, city) []:
    Organization Name (eg, company) [Internet Widgits Pty Ltd]:
    Organizational Unit Name (eg, section) []:
    Common Name (e.g. server FQDN or YOUR name) []:
    Email Address []: my-api-user@my-example-org.com
    Please enter the following 'extra' attributes
    to be sent with your certificate request
    A challenge password []:<password>
    An optional company name []:

openssl x509 -req -sha256 -days 365 -in server.csr -signkey server.key -out server.crt

server.crt => Certificate for the Salesforce External Client App

server.key => Private key for the Salesforce Connector in Webex Control Hub

SCV-integraatiokäyttäjän käyttöoikeusjoukko

Seuraava käyttöoikeusjoukko antaa pääsyn Apex-luokkiin, joita Connects for SCV käyttää integrointiin Contact Center IVR -virtojen ja Webex Contact Center for Salesforce for SCV: n kanssa.

Seuraavassa on esimerkkikokoonpano ja kuvataan yhteystietokesk uksen ja IVR-integroinnin edellyttämät vähimmäisoikeudet.

  • Siirry Asetukset-kohdasta Käyttäjät | Käyttöoikeusjoukot.
  • Napsauta U usi -painiketta.
    • Anna tarra, esimerkiksi: IVR Access to SCV Apex -luokat
    • API-nimi täytetään automaattisesti
    • Lisenssi: Ei mitään
    • Napsauta Tallenna- painiketta.
  • Uusi käyttöoikeusjoukko avautuu.
  • Siirry Apex Class Access -palveluun.
  • Napsauta Muokka a-painiketta ja lisää seuraavat Apex-luokat:
    • cisco_wxcc_scv.Palveluretki
  • Siirry kohtaan Järjestelmän käyttöoikeudet.
  • Napsauta Muokka a-painiketta ja ota käyttöön seuraavat käyttöoikeudet:
    • Apex REST -palvelut
    • API käytössä

Vähimmäiskäyttöoikeus - Vain API-integraatioprofiili

Tätä profiilia käytetään integrointiin Webex Contact Center for Salesforce for SCV -palveluun äänipuhelutietueiden luomiseksi ja Omni-Flow-suorituksen suorittamiseksi IVR-virrasta.

Seuraavassa on esimerkkikokoonpano ja kuvataan yhteystietokesk uksen ja IVR-integroinnin edellyttämät vähimmäisoikeudet.

Tämä on klooni Minimum Access - API Only Integrations -profiilista.

  • Siirry Asetukset-kohdasta Käyttäjät | Profiilit.
  • Etsi Profiilit-luettelosta Profiilin vähimmäiskäyttöoikeus - Vain API- integraatiot.
  • Napsauta profiilin nimeä avataksesi Vähim mäiskäyttöoikeudet - Vain API- integroinnit -profi ilin.
  • Napsauta Vähim mäiskäyttöoikeus - Vain API-integraati ot -profiilissa Klo ona- painiketta.
  • Anna uusi profiilinimi, esimerkiksi: SCV-integrointi.
  • Napsauta Tallenna- painiketta.
  • Uusi profiili avautuu.
  • Varmista, että Minimi Access - API Only Integrations -profiilissasi on kaikki käyttöoikeudet poistettu itse profiilista.
  • Siirry kohtaan Järjestelmän käyttöoikeudet.
  • Varmista, että seuraavat käyttöoikeudet ovat käytössä:
    • API käytössä
    • Vain Api Käyttäjä

SCV-integraatiokäyttäjä

Seuraavassa on esimerkkikokoonpano ja kuvataan yhteystietokesk uksen ja IVR-integroinnin edellyttämät vähimmäisoikeudet. SCV-integrointikäyttäjälle ei tarvita Salesforce Service Cloud Voice -lisenssiä tai Webex Contact Center for Salesforce for SCV -lisenssiä.

  • Siirry Asetukset-kohdasta Käyttäjät | Käyttäjät.
  • Napsauta Uusi käyttäjä -painiketta.
    • Kirjoita etunimi, sukunimi ja kaikki muut pakolliset kentät.
    • Käyttäjälisenssi: Salesforce Integration
    • Profiili: valitse edellisessä vaiheessa luotu profiili (”SCV-integraatioprofiili”, minimipää syn klooni - vain API Integraatio-profiili)
  • Napsauta Tallenna- painiketta.
  • Avaa uusi käyttäjätietue.
  • Määritä aiemmin luotu käyttö oikeusjoukko (”IVR-pääsy SCV Apex - luokkiin”).
  • Määritä käyttöoikeusjoukon lisenssi Salesforce-sovellusliittymän integrointi.
Salesforcen ulkoisen asiakassovelluksen luominen

Tällä hetkellä, Yhdistettyjen sovellusten luominen on toiminto, jota ohjaa Salli yhdistettyjen sovellusten luominen -asetus, joka on oletusarvoisesti poistettu käytöstä uusissa organisaatioissa ja se voidaan ottaa käyttöön uuden Ulkoisten asiakassovellusten asetukset -valikko-osan asetussivulla.

  • Etsi Asetukset-kohdasta Ul koiset asiakassovellukset | Asetukset.
  • Aseta Yhdistetyt sovellukset -kohdassa Salli yhdistettyjen sovellusten luominen -valintaruutuun Käytössä, jotta Uusi yhdistetty sovellus -painike otetaan käyttöön.
  • Napsauta Uusi yhdistetty sovellus -painiketta.

Jos Uusi yhdistetty sovellus -painiketta ei näy Ulkoiset asiakassovellukset -valikossa, siirry kohtaan Sovel lukset | Sovellusten hallinta | Uusi yhdistetty sovellus.

Määritä Salesforce Connected -sovellus, jota Cisco Webex Contact Center käyttää. Katso myös artikkeli: Yhdist etyn sovelluksen määrittäminen Webex Contact Center Salesforce Connectorille osoitteessa https://help.webex.com/en-us/article/n26v7heb/Configure-Connected-App-for-Webex-Contact-Center-Salesforce-Connector.

1

Anna uuden Connected App -sovelluksen osalta seuraavat tiedot:

  • Yhdistetyn sovelluksen nimi: wxCC - SCV
  • Sovellusliittymän nimi: WxCC_SCV
  • Yhteystiedot Sähköposti: Anna kelvollinen sähköpostiosoite.
  • API (Ota OAuth-asetukset käyttöön) => Ota OAuth-asetukset käyttöön
  • Takaisinsoitto-URL-osoite: http://localhost:1717/OauthRedirect esimerkkinä takaisinsoit to-URL-osoitteesta
  • Valitse Käytä digitaalisia allekirjoituksia
  • Valitse Valitse tiedosto ja lataa palvelin.crt-tiedosto, joka sisältää digitaalisen varmenteen.
  • Valitse OAuth-laajuudet:
    • Hallitse käyttäjätietoja sovellusliittymien (api) avulla
    • Käyttäjätietojen hallinta Web-selaimilla (web)
    • Suorita pyynnöt milloin tahansa (refresh_token,offline_access)
  • Poista WWW-palvelimen virran vaadittu salaisuus - asetus.

2

Valitse Tall enna ja sitten Jatka.

3

Valitse API (Ota OAuth-asetukset käyttöön) -osiosta Hallitse kuluttajati et oja.

4

Valitse Kopio i ja tallenna kuluttaja-avain. Kuluttaja-avainta käytetään myöhemmin Salesforce-liittimen luomiseen Webex Contact Center Control Hubissa.

Tärkeää: Ylläpidä turvallisuutta kiertämällä säännöllisesti salaisuuksia

Varmista, että ClientID- ja Client Secrets -tunnuksia vaihdetaan säännöllisesti. Katso kuluttaj a-avain ja kuluttaj asalaisuus

Varmistaaksesi, että nykyiset integraatiosi eivät katkea, päivitä äskettäin luotu asiakastunnus ja asiakassalaisuus kaikissa Contact Center -virroissa ja IVR-komentosarjoissa, joissa näitä salaisuuksia käytetään.

5

Valitse Tak aisin hallitaksesi yhdistettyjä sovelluksia.

6

Valitse Hallitse.

7

Valitse Muokkaa käytäntöä.

8

Valitse OAuth-käytännöt- osiossa Järjestelmänvalvojan hyväksymät käyttäjät ovat valmiiksi valtuutettuja Sallittuja käyttäjiä varten.

9

Valitse Tallenna.

10

Vieritä alaspäin kohtaan Käyttö oikeusjoukko ja napsauta Hallitse käyttöoikeusjoukkoja -painiketta. Määritä aiemmin luotu käyttö oikeusjoukko (”IVR-pääsy SCV Apex -luokkiin”).

Luo Salesforcen ulkoinen asiakassovellus
Uuden ulkoisen asiakasohjelman luominen

Salesforce-tietojen yhdistämiseen kolmannen osapuolen sovelluksiin on kaksi vaihtoehtoa. Sekä yhdistetyt sovellukset että ulkoiset asiakassovellukset ovat kehyksiä tietojen integroimiseksi. Ulkoiset asiakassovellukset ovat seuraavan sukupolven yhdistettyjä sovelluksia.

Voit määrittää Salesforce External Client App -sovelluksen, jota käyttävät: Cisco Webex Contact Center

  1. Siirry Asetuk set-kohdasta Sovellukset | Ulkoiset asiakassovellukset | Ulkoisen asiakkaan sovellusten hallinta.
  2. Napsauta Uusi ulkoinen asiakassovellus.
  3. Ulkoinen asiakassovellus — perustiedot
    • Ulkoisen asiakkaan sovelluksen nimi: wxCC - SCV
    • Sovellusliittymän nimi: WxCC_SCV
    • Yhteystiedot Sähköposti: < your email >
    • Jakelutila: valitse Paikallinen

    Basic information

    Ulkoinen asiakassovellus — API (Ota OAuth-asetukset käyttöön)

    • Valitse: Ota OAuth käyttöön
    • Sovelluksen asetukset
    • Takaisinsoitto-URL-osoite: http://localhost:1717/OauthRedirect esimerkkinä takaisinsoitto-URL-osoitteesta
    • OAuth-laajuudet
    • Valitse OAuth-laajuudet:
    • Hallitse käyttäjätietoja sovellusliittymien (api) avulla
    • Suorita pyynnöt milloin tahansa (refresh_token,offline_access)

    API (Enable oAuth settings)

    Virtauksen käyttöönotto

    • Valitse: Ota käyttöön JWT Bearer Flow
    • Valitse Lataa tiedostot ja lataa server.crttiedosto, joka sisältää digitaalisen varmenteen.

    Floe enablement

    Turvallisuus

    Poista valinta Va adi salaista Web-palvelimen virtaukselle - vaihtoehto.

    Security

  4. Napsauta Lu o- painiketta.
  5. Vaihda välilehtikäytäntöihin ja napsauta sitten Muokka a-painiketta.
  6. Policies — OAuth Hotellin säännöt
    • Plugin-käytännöt
      • Sallitut käyttäjät: valitse Järjestelmänvalvojan hyväksymät käyttäjät ovat ennalta valtuutettuja
      • Vahvista muutos
    • Sovelluksen valtuutus
      • Päivitä tunnuskäytäntö: valitse Vanhenee päivitystunnus välittömästi
      • IP-rentoutuminen: valitse Ota IP-rajoitukset käyttöön

    OAuth policies

  7. Käytännöt — sovelluskäytännöt
    • Aloitussivu — ei mitään
    • Valitse käyttöoikeusjoukot — Määritä aiemmin luotu käyttöoikeusjoukko (”IVR-pääsy SCV Apex -luokkiin”) 

    App policies

  8. Valitse Tallenna.
  9. Vaihda välilehden asetuksiin.
    • Kohdassa OAuth-asetukset, napsauta Kulut taj a-avain ja Salainen -painiketta; odota sähköpostia ja vahvista henkilöllisyytesi. Uusi selainvälilehti avaa näytön, jossa on kuluttajatiedot.

      OAuth Settings

    • Valitse Kopio i ja tallenna kuluttaja-avain. Kuluttaja-avainta käytetään myöhemmin Salesforce-liittimen luomiseen Webex Contact Center Control Hubissa. 

      External client App name

Webex Contact Center -kokoonpano ja komentosarja äänipuhelutietueiden luomiseksi

Jotta saat Salesforce Service Cloud Voice -palvelun täyden arvon, Webex Contact Centerin puheluvirtaa on muokattava, jotta äänipuhelutallenne luodaan Service Cloud Voice -palvelussa heti, kun puhelu saapuu yhteyskeskukseen.

Valinnainen Omni-Flow voidaan suorittaa reitityspäätöksiin ja automaatioon Salesforcessa .

Lisätietoja käytetyistä sovellusliittymistä on kohdassa Service Cloud Voice API Wrapper.

Ennakkoedellytykset

Jotta Service Cloud Voice API Wrapper -sovellusta voidaan käyttää, Salesforcen ulkoinen asiakassovellus IVR-integrointia varten on määritettävä.

Määritä Salesforce-liitin Webex Control Hubissa

Määritä Salesforce-integrointiliittimet Webex Contact Centerille artikkelissa osoitteessa https://help.webex.com/en-us/article/7fuy63/Set-Up-Integration-Connectors-for-Webex-Contact-Center # kuvatulla tavalla. id_133211

1

Kirjaudu asiakasorganisaatioosi osoitteessa https://admin.webex.com ja siirry kohtaan Palvelut > Contact Center > Vuok ralaisen asetukset > Integraatiot > Liittimet.

2

Valitse Salesforce-kortilla Määritä tai Lisää liitin.

  • Asiakastunnus: Ulkoisen asiakassovelluksen kuluttaja-avain
  • Salesforce-sähköpostitunnus: ”SCV-integraation” Salesforce-käyttäjänimi (katso SC V-integraation käyttäjä)
  • URL: tuotantokäyttöön https://login.salesforce.com tai jos olet perustamassa kehittäjä/hiekkalaatikkoa, käytä https://test.salesforce.com
  • Yksityinen avain: tiedoston sisältö server.key

IMPORTANT: MAINTAIN SECURITY BY PERIODICALLY ROTATING SECRETS

Varmista, että kierrätät yksityistä avainta ja varmennetta säännöllisesti, jotta integraatiosi pysyvät turvassa.

Päivitä yksityinen avain yhteyskeskuksen liittimessä Webex Hubissa ja varmenne Salesforcen ulkoisen asiakkaan sovelluksessa.

Vianmääritysvinkki

Kun olet napsauttanut Valmis ja liitin ei tallenna:

  • Tarkista, onko sinulla välilyöntejä ennen tai jälkeen merkintöjen jälkeen.
  • Varmista, että yksityinen avaimesi (server.key) vastaa server.crt. Jos määrität useita organisaatioita ja vaihdat varmenteita, ne eivät toimi.
  • varmista, että Server.key alkaa. ----- Begin RSA Private Key -----

Webex-yhteyskeskuksen päävirta

Taulukko 2. Vaihteleva virtaus
VirtausmuuttujaKuvaus
Äänipuhelutietueen tunnuksen virtausmuuttuja Yksilöllinen tunnus puhelun tunnistamiseksi. Vaaditaan äänipuhelu tietueen luomiseen.

Muoto: wxcc_ <Interaction Id>

Esimerkki: wxcc_fc4ec7d8 -4c91-49aa-b764-081fbba344a8

  • Nimi: SCV_VendorCallKey
  • Tyyppi: Merkkijono
  • Tee agentti näkyväksi: Käytössä
Puhelun alkamisajan paikallinen muuttuja

Käytetään äänipuhelutietueen luomiseen ja äänipuhelun päivittämiseen.

  • Nimi: SCV_CallStartTime
  • Tyyppi: Merkkijono
  • Tee agentti näky väksi: ei
Jonon nimen/tunnuksen paikallinen muuttuja

Palauttaa Execute Omni Flow, jota käytetään puhelun reitittämiseen.

Tämä muuttuja vaaditaan vain käytettäessä Execute Omni Flow

  • Nimi: SCV_OmniFlowQueue
  • Tyyppi: Merkkijono
  • Tee agentti näky väksi: ei
Paikallinen muuttuja agentin nimellä/tunnuksella

Palauttaa Execute Omni Flow, jota käytetään puhelun reitittämiseen.

Tämä muuttuja vaaditaan vain käytettäessä Execute Omni Flow

  • Nimi: SCV_OmniFlowAgent
  • Tyyppi: Merkkijono
  • Tee agentti näky väksi: ei

Main Flow yleiskatsaus

  1. Luo toimittajan puhelunavain
  2. Aseta puhelun alkamisaika
  3. HTTP-pyyntö: Luo äänipuhelutietue
  4. HTTP-vastauksen arviointi Äänipuhelutietueen luomiseen
  5. Luo äänipuhelutietueen virheenkäsittely
  6. HTTP-pyyntö: Suorita Omni Flow
  7. Arvioi HTTP-vastaus Execute Omni Flow -sovelluksessa
  8. Virheenkäsittely Execute Omni Flow -sovelluksessa
  9. Jatka puhelun reititystä
Taulukko 3. Päävirtaus
VirtausKuvaus
Luo toimittajan puhelunavain

Jokainen Service Cloud Voicessa käsitelty puhelu luo äänipuhelutallenteen Salesforcessa ja vaatii yksilöllisen tunnuksen nimeltä Vendor Call Key. Webex Contact Centerissä luotujen äänipuhelutietueiden osalta toimittajan puhelunavain on määritettävä wxCC-virrassa ja lähetettävä sitten puhel un mukana agenttiin suoritettavan puhelun mukana virtausmuuttujan avulla.

VendorCallKey-arvon on oltava seuraavien sääntöjen mukainen:

  • Arvon on oltava enintään 255 merkkiä pitkä.
  • Arvo voi sisältää aakkosnumeerisia merkkejä sekä alaviivat (_), vi iva (-) ja piste (.).
  • Arvon on alettava kirjaimella, ei sisällä välilyöntejä, ei saa päättyä alaviivoilla eikä sisältää kahta peräkkäistä alaviivaa.

  • Toimintamerkki: Generate_VendorCallKey
  • Muuttujan nimi: SCV_VendorCallKey
  • Muuttujan tyyppi: merkkijono
  • Muuttujan arvo - Aseta arvo: wxcc_ {{newPhoneContact.interactionId}}

Aseta puhelun alkamisaika

Puhelun alkamisajan UTC-aikaleima. Tätä aikaleimaa käytetään äänipuhelutietueen luomiseen ja ääni puhelutietueen päivittämiseen, jos soittaja lopettaa puhelun ennen kuin hänet reititetään edustajalle.

  • Toiminnan tarra: setCallStartTime
  • Muuttuja: SCV_CallStartTime
  • Muuttujan arvo - Aseta arvo: {{now () | replace ({'[UTC]': ”})}}
HTTP-pyyntö: Luo äänipuhelutietue

Tämä vaihe vaaditaan jokaisessa puhelussa. Kun Äänipuhelutietue on luotu, Puhelutietueen tunnus on välitettävä puhelun mukana edustajalle muuttujassa yhdessä toimittajan puhelunavaimen kanssa. Määritä käytetty muuttuja Service Cloud Voice -palvel ussa Contact Center -määrityksessä.

HTTP-pyynnön asetukset
  • Toiminta-etiketti: CreateVoiceCall
  • Käytä todennettua päätepistettä: Käyt össä
  • Liitin: edellisessä vaiheessa luotu Salesforce-liitin
  • Pyyntöpolku: /services/apexrest//voice/v1/createVoiceCall cisco_wxcc_scv
  • Menetel mä: POST
  • Pyynnön sisältötyyppi: Application/JSON

HTTP-pyyntö: Luo äänipuhelutietue

Tämä vaihe vaaditaan jokaisessa puhelussa. Kun Äänipuhelutietue on luotu, Puhelutietueen tunnus on välitettävä puhelun mukana edustajalle muuttujassa yhdessä toimittajan puhelunavaimen kanssa. Määritä käytetty muuttuja Service Cloud Voice -palvel ussa Contact Center -määrityksessä.

HTTP-pyynnön asetukset

  • Toiminta-etiketti: CreateVoiceCall
  • Käytä todennettua päätepistettä: Käyt össä
  • Liitin: edellisessä vaiheessa luotu Salesforce-liitin
  • Pyyntöpolku: /services/apexrest/cisco_wxcc_scv/voice/v1/createVoiceCall
  • Menetel mä: POST
  • Pyynnön sisältötyyppi: Application/JSON

Pyynnön elin

Kun luot äänipuhelutietuetta, voit myös päivittää puhelutietueen mukautetut kent ät puhelutiedoilla. Alla on kaksi esimerkkiä pyynnön rungosta, yksi, jossa on kaikki vaaditut kentät, mutta päivittämättä mukautettuja kenttiä, ja toinen mukautetuilla kentillä.

Päivittämättä mukautettuja kenttiä Äänipuhelu tietueessa:

{
  "callCenterDevName": "<Contact Center API name>",
  "certDevName": "<cert dev name>",
  "vendorCallKey": "{{SCV_VendorCallKey}}",
  "to": "{{NewPhoneContact.DNIS}}",
  "from": "{{NewPhoneContact.ANI}}",
  "initiationMethod": "Inbound",
  "startTime": "{{SCV_CallStartTime}}",
  "participants": [
    {
      "participantKey": "{{NewPhoneContact.ANI}}",
      "type" : "END_USER"
    }
  ]
}

Esimerkki äänipuhelutietueen mukautettujen kenttien päivittä misestä:

{
  "callCenterDevName": "<Contact Center API name>",
  "certDevName": "<cert dev name>",
  "vendorCallKey": "{{SCV_VendorCallKey}}",
  "to": "{{NewPhoneContact.DNIS}}",
  "from": "{{NewPhoneContact.ANI}}",
  "initiationMethod": "Inbound",
  "startTime": "{{SCV_CallStartTime}}",
  "participants": [
    {
      "participantKey": "{{NewPhoneContact.ANI}}",
      "type" : "END_USER"
    }
  ],
  "callAttributes": "{\"custfield1__c\": \"<value1>\",\"custfield2__c\": \"<value2>\",\"custfield3__c\": \"<value3>\"}"
}

Parametrit
Ominaisuuden nimi Arvo
PuhelinkeskuksenDevName Contact Center Kehittäjän nimi
CertDevName Varmenteen sovellusliittymän nimi (kuten on määritetty Contact Centerissä)
MyyjäCallkey Yksilöllinen puhelutunnus: {{SCV_VendorCallKey}}
siihen Kutsuttu numero/DNIS: {{NewPhoneContact.DNIS}}
alkaen Soittonumero/nimi: {{NewPhoneContact.ANI}}
Aloitusaika UTC-aikaleima {{SCV_CallStartTime}}(asetetaan heti puhelun hyväksymisen jälkeen komentosarjassa)
Puheluattribuutit

Käytä callAttributesvain Voice Call-objektin mukautettuja kenttiä varten. Käytä Salesforce-kentän sovellusliittymän nimeä, kuten nimeä __c, joka päättyy jokaiseen avainarvo-parin kohdalla.

Älä käytä tav callAttributesallisten VoiceCall -kenttien päivittämiseen, kuten tai. Description CallDurationInSeconds Salesforce laskee, CallDurationInSecondsmilloin molemmat startTime ja ne endTimetoimitetaan.

Esimerkki:

custfield1__c, custfield2__c, custfield3__c: Äänipuhelu objektin mukautetun kentän sovellusliittymän nimi

value1, value2, value3: Mukaut etun kentän arvo

Jäsennä asetukset
  • Sisältötyyppi: JSON
  • Lähtömuuttuja: SCV_VoiceCallRecordId
  • Polun lauseke: $.data.voiceCallId

Äänipuhelutietueen tunnus, joka välitetään edustajalle.

HTTP-vastauksen arviointi Äänipuhelutietueen luomiseen

Tarkista Luo äänipuhelu http-pyynnön HTTP-tila:

  • Yhtiö: StatusCodeCreateVoiceCall
  • Muuttuja: CreateVoiceCall.httpStatusCode

Jos tilakoodi == 200 => onnistunut muu => pyyntö epäonnistui, virheenkäsittely

Luo äänipuhelutietueen virheenkäsittely

Vain esittelyä/virheenkorjaus varten, toista viesti http-tilakoodista riippuen.

Jos Luo äänipuhelu onnistui, jatka Suorita Omni Flow -toimintoa. Muussa tapauksessa jatka puhel un reititystä.

HTTP-pyyntö: Suorita Omni Flow (valinnainen vaihe)

Käytä Execute Omni-Flow -toimintoa, kun haluat:

  • suorittaa automaattisia tehtäviä, esimerkiksi etsiä tai luoda tietueita, ja linkittää tietueet ääni puhelutallenteeseen
  • etsi levyjä ja tee screen-pop
  • synkronoi Salesforce- ja Cisco-jonot
  • Anna Service Cloud Voicen tehdä reitityspäätöksen

Tämä pyyntö palauttaa aina ”jonon” tai ”agentin”, johon puhelu on reititettävä.

Kun olet suorittanut tämän pyynnön, varmista, että lähetät Tyhjennä reititys, jos soittaja sulkeutuu, ennen kuin agentti vastaa siihen. Katso Webex Contact Center -tapahtumien kulku.

HTTP-pyynnön asetukset

  • Toiminnan etiketti: ExecuteOmniFlow
  • Käytä todennettua päätepistettä: Käyt össä
  • Liitin: edellisessä vaiheessa luotu Salesforce-liitin
  • Pyyntöpolku: /services/apexrest/cisco_wxcc_scv/voice/v1/executeOmniFlow
  • Menetel mä: POST
  • Pyynnön sisältötyyppi: Application/JSON

Pyynnön elin

Pakollisten kenttien lisäksi voit välittää muita tietoja syöttömuuttujina Omni-Flow-palveluun. Alla on kaksi esimerkkiä pyyntöelimestä. Ensimmäinen ilman lisävirtaus parametreja, vain vaaditut kentät, toinen kahdella syöttömuuttujalla.

Esimerkki Omni-Flow-parametreista:

{
  "callCenterDevName": "<Contact Center API name>",
  "certDevName": "<cert dev name>",
  "voiceCallId": "{{SCV_VoiceCallRecordId}}",
  "dialedNumber": "{{NewPhoneContact.DNIS}}",
  "flowDevName": "<flow api name>",
  "fallbackQueue": "<fallback queue name>"
}

Esimerkki äänipuhelutietueen mukautettujen kenttien päivittä misestä:

{
  "callCenterDevName": "<Contact Center API name>",
  "certDevName": "<cert dev name>",
  "voiceCallId": "{{SCV_VoiceCallRecordId}}",
  "dialedNumber": "{{NewPhoneContact.DNIS}}",
  "flowDevName": "<flow api name>",
  "fallbackQueue": "<fallback queue name>",
  "flowInputParameters": 
  {
    "param1": "value1",
    "param2": "value2"
  }
}

Parametrit
Ominaisuuden nimi Arvo
PuhelinkeskuksenDevName Contact Center Kehittäjän nimi
CertDevName Varmenteen sovellusliittymän nimi (kuten on määritetty Contact Centerissä)
VoiceCallid Edellisessä vaiheessa luodun äänipuhelutietueen tunnus: {{SCV_VoiceCallRecordId}}
Soitettu numero Kutsuttu numero/DNIS: {{NewPhoneContact.DNIS}}
FlowDevName Kehittäjän nimi Omni-Flow to execute
FallbackQueue Vara-Salesforce-jonon jonotunnus tai jono-sovellusliittymän nimi
Virtaussyöttöparametrit

Lisätulot Omni-Channel-virtaukseen (avainarvo-pari).

Esimerkki:

param1, param2: Omni-Flow-syöttöparametrin nimi

value1, value2: Parametrin arvo

Jäsennä asetukset

Jono

  • Sisältötyyppi: JSON
  • Lähtömuuttuja: SCV_OmniFlowQueue
  • Polun lauseke: $.data.queue

Execute Omni-Flow -palvelusta palautettua ”jonoa” voidaan käyttää reititykseen.

Agentti
  • Sisältötyyppi: JSON
  • Lähtömuuttuja: SCV_OmniFlowAgent
  • Polun lauseke: $.data.agent

Execute Omni-Flow -palvelusta palautettua ”Agenttia” voidaan käyttää reititykseen.

Arvioi HTTP-vastaus Execute Omni Flow -sovelluksessa

Tarkista Execute Omni Flow http -pyynnön HTTP-tila:

  • Tag: StatusCodeExecuteOmniFlow
  • Muuttuja: ExecuteOmniflow.httpStatusCode

Jos tilakoodi == 200 => onnistunut muu => pyyntö epäonnistui, virheenkäsittely.

Virheenkäsittely Execute Omni Flow -sovelluksessa

Vain esittelyä/virheenkorjaus varten, toista viesti http-tilakoodista riippuen.

Jos Execute Omni Flow onnistui, muuttujia SCV_OmniFlowQueue ja muuttu SCV_OmniFlowAgent jia ei aseteta. Reitityspäätös puheluvirrassa.

Jatka puhelun reititystä

Jatka puheluvirtaa, reititä puhelu edustajalle. Valinnainen, käytä SCV_OmniFlowQueue ja SCV_OmniFlowAgent valitse jono ja agentti.

Webex Contact Center -tapahtumien kulku

Jos soittaja keskeyttää puhelun ennen kuin edustaja vastaa siihen, meidän on päivitettävä Service Cloud Voice ja lopetettava puhelu.

  • Jos käytössä on Execute Omni-Flow, lähetä Tyhjennä reititys poistaaksesi odottavan palvelun reitityksen (PSR)
  • Lähetä Päivitä äänipuhelu, jotta voit päivittää äänipuhelutietueen alkamis- ja lopetusajat ja muuttaa tilan Uudesta valmiiksi

  1. PhoneContactended - Tämä tapahtuma käynnistyy, kun live-puhelu katkaistaan ja kaikki osallistujat poistetaan.
  2. HTTP-pyyntö: Tyhjennä reititys
  3. HTTP-pyyntö: Päivitä äänipuhelu
HTTP-pyyntö: Tyhjennä reititys

  • Levy-yhtiö: ClearRouting
  • Käytä todennettua päätepistettä: Käyt össä
  • Liitin: edellisessä vaiheessa luotu Salesforce-liitin
  • Pyyntöpolku: /services/apexrest/cisco_wxcc_scv/voice/v1/clearRouting
  • Menetel mä: POST

Pyynnön sisältötyyppi: Application/JSON

Pyynnön elin

{
  "callCenterDevName": "<Contact Center API name>",
  "certDevName": "<cert dev name>",
  "voiceCallId": "{{SCV_VoiceCallRecordId}}"
}

Parametrit

Kiinteistön nimiArvo
PuhelinkeskuksenDevName Contact Center Kehittäjän nimi
CertDevName Varmenteen sovellusliittymän nimi (kuten on määritetty Contact Centerissä)
VoiceCallid Edellisessä vaiheessa luodun äänipuhelutietueen tunnus: SCV_VoiceCallRecordId

Jäsennä asetukset

Ei mitään.

HTTP-pyyntö: Päivitä äänipuhelu

  • Levy-yhtiö: UpdateVoiceCall
  • Käytä todennettua päätepistettä: Käyt össä
  • Liitin: edellisessä vaiheessa luotu Salesforce-liitin
  • Pyyntöpolku: /services/apexrest/cisco_wxcc_scv/voice/v1/updateVoiceCall
  • Menetel mä: POST
  • Pyynnön sisältötyyppi: Application/JSON

Pyynnön elin

{
  "callCenterDevName": "<Contact Center API name>",
  "certDevName": "<cert dev name>",
  "voiceCallId": "{{SCV_VoiceCallRecordId}}",
  "startTime": "{{SCV_CallStartTime}}",
  "endTime": "{{now() | replace({'[UTC]': ''})}}",
  "disconnectReason": { "value": "Abandoned in queue", "isError": true }
}

Kun annat molemmat startTimeja endTime, Salesforce laskee CallDurationInSeconds. Älä kulje CallDurationInSecondssisään callAttributes.

Parametrit

Kiinteistön nimiArvo
PuhelinkeskuksenDevName Contact Center Kehittäjän nimi
CertDevName Varmenteen sovellusliittymän nimi (kuten on määritetty Contact Centerissä)
VoiceCallid Edellisessä vaiheessa luodun äänipuhelutietueen tunnus: SCV_VoiceCallRecordId
Aloitusaika Puhelun alkamisen UTC-aikaleima {{SCV_CallStartTime}}(jota käytetään äänipuhel utietueen luomiseen)
Loppuaika Nykyinen UTC-aikaleima `{{now ()
Irrotuspetos Syy puhelun katkaisemiseen. Omin isError aisuus on asetettava asetuk trueseksi, jotta se näkyy oikein.

Jäsennä asetukset

Ei mitään.

Referenssit

Kielen käännös

(Valinnainen) Ota käännöstyöpöytä käyttöön

Tämä asetus on käytettävissä vain, jos käytät Käännöskieliasetuksia.

1

Siirry kohtaan Asetukset → Käännöstyöpöytä → Käännöskielen asetukset.

2

Valitse kä ännö skieli valitsemalla Ota käyttöön.

(Valinnainen) Ota käyttöön vain alustan kielet

Tämä asetus koskee vain muita kieliä kuin FI-US.

1

Siirry kohtaan Asetukset → Yrityksen asetukset → Kieliasetukset.

2

Valitse haluamasi kielet.

3

Valitse seuraavat valintaruudut:

  • Ota käyttöön loppukäyttäjän kielet - Ohjeita ja asetuksia ei käännetä loppu käyttäjän kielille
  • Ota käyttöön vain alustalle tarkoitetut kielet - vain alustalle tarkoitetuille kielille ei tarjota oletuskäännöksiä
4

Tallenna muutokset.

Aktivoi kieli ja valitse käyttäjä (tehtävä)
1

Siirry kohtaan Asetukset → Käännöstyöpöytä → Käännöskielen asetukset.

2

Valitse kieli ja valitse käyttäjä, joka kääntää sen.

3

Tallenna muutokset.

Monikieliset asetukset
Käännä mukautetut tarrat
1

Siirry kohtaan Asetukset → Mukautetut tarrat.

2

Valitse avattavan mukautetun tarran nimi.

3

Kirjoita uusi käännös napsauttamalla Aihe Neweseen liittyviä käännöksiä -luettelossa tai muokkaa käännöstä Muokkaa (kielen vieressä).

4

Valitse kieli, jolle käännät.

5

Kirjoita käännetty arvo Käännösteksti -kenttään. Tämä teksti ohittaa otsikon Arvo-kentässä määritetyn arvon, kun käyttäjän oletuskieli on kä ännöskieli.

6

Tallenna muutokset.

Käyttäjätoiminnon edellyttämät Salesforce-käyttöoikeudet

Webex Contact Center SCV Agent -käyttöoikeusjoukko sisältää kaikki käyttöoikeudet, joita tarvitaan Webex Contact Center Gadgetin ja agenteille kehitettyjen integraatioiden kanssa työskentelemiseen.

Apex-luokan käyttöoikeus (osio)

  • cisco_wxcc_scv.CiscosCVWXCC
  • cisco_wxcc_scv.ServiceVastauskäsittelijä
  • cisco_wxcc_scv.Palveluretki
  • cisco_wxcc_scv.TelephonyIntegrationHandler

Mukautetut metatietotyypin käyttöoikeudet (osio)

  • cisco_wxcc_scv.wxCC-yhteys

Visualforce-sivun käyttö (osio)

  • cisco_wxcc_scv.ciscosCVLoginWXCC
  • cisco_wxcc_scv.ciscosCVmainWXCC
  • cisco_wxcc_scv.CiscosCvoAuthRedirect
  • cisco_wxcc_scv.CiscosCVSWLoader

Service Cloud Voice API -kääre

Ennakkoedellytykset

Jotta Service Cloud Voice API Wrapper -sovellusta voidaan käyttää, Salesforcen ulkoinen asiakassovellus IVR-integrointia varten on määritettävä.

Service Cloud Voice API -kääreen käyttäminen

Service Cloud Voice (SCV) for Salesforce käyttää Telephony Integration REST -sovellusliittymää VoiceCall-puhelujen luomiseen ja päivittämiseen, Omni-Channel -virtojen suorittamiseen ja VoiceCall-järjestelmään liittyvien PendingServiceRouting-tietueiden poistamiseen. Tämä palvelu vaatii JWT-valtuutuksen ja PATCH HTTP -menetelmän käyttöä, jota Cisco IP Interactive Voice Response (IVR) ei tällä hetkellä tue.

SCV:n Telephony Integration REST API -sovellusliittymän käytön yksinkertaistamiseksi (ei vain) IVR-järjestelmässä on otettu käyttöön uusi joukko sovellusliittymiä, jotka kattavat olemassa olevan Salesforce-sovellusliittymän ja ovat käytettävissä suoraan Salesforce-organisaatiosta, johon Webex Contact Center for Service Cloud Voice -paketti on asennettu.

Service Cloud Voice API Wrapper poistaa JWT-tunnuksen todentamisen tarpeen, toteuttaa lisätarkastuksia Salesforce-sovellusliittymän vaatimille tiedoille ja parantaa vastausobjekteja.

Hae Access_Token

Suorita POST-pyyntö osoitteeseen https://<your-domain-name>.my.salesforce.com/services/oauth2/token

Seuraavien parametrien lähettäminen kehoon:

{
 "grant_type": "client_credentials",
 "client_id": "<consumer key of the connected app>",
 "client_secret": "<consumer secret of the connected app>"
 }
If the request is successful, the following JSON response will be returned:
{
 "access_token": "<your-access-token>",
 "instance_url": "<your-org-base-url>",
 "id": "https://login.salesforce.com/id/<id>/<id>",
 "token_type": "Bearer",
 "issued_at": "<timestamp>",
 "signature": "<unique-signature-code>"
 }

Suorita pyynnöt

Esiintymän URL-osoitteen on sisällettävä my.salesforce.com.

Esimerkki oikeasta esiintymän URL-osoitteesta: https://abc-123.my.salesforce.com

Minkä tahansa muun verkkotunnuksen käyttäminen esiintymän URL-osoitteena (esim. https://abc-123.lightning.force.com) johtaa 401 Luvattomaan tilaan, jolloin INVALID_SESSION_ID virhekoodi palautetaan .

Luo äänipuhelu (osio)

Luo VoiceCall-tietueen, joka sisältää VoiceCall-tietueen osallistujat (eli soittajan ja vastaanottajan) . Kun luot VoiceCall-tietueen, Salesforcessa luodaan keskustelu. Käytä tätä sovellusliittymää vain reaaliaikaisessa yhteydessä, mikä tarkoittaa, että sinun pitäisi kutsua tämä sovellusliittymä vain, kun kutsu aloitetaan. Tätä sovellusliittymää voidaan käyttää myös VoiceCall- tietueiden luomiseen siirto- ja neuvottelupuheluita varten sisällyttämällä ParentVoiceCallid-parametri pyynnön hyötykuormaan.

Päätepisteen URI

< instance_url >/ cisco_wxcc_scv palvelut/apexrest//ääni/v1/CreateVoice Call

HTTP-menetelmä

POST

Otsikot

Valtuutus: Haltija <> access_token

Sisältötyyppi: application/json

Parametrit

{
 "callCenterDevName": "contactCenterDevName123",
 "certDevName": "certDevName123",
 "vendorCallKey": "5324881f-1e84-4367-8930-f69a74b30ca6",
 "to": "8002345678",
 "from": "4081456688",
 "initiationMethod": "Inbound",
 "startTime": "2019-07-02T17:32:28Z",
 "participants": [
 {
 "participantKey": "4081456688",
 "type" : "END_USER"
 }
 ],
 "callAttributes": "{\"devscv24__AAA_Test__c\":\"field value\",\"Other_Field__c\":\"other value\"}",
 "parentVoiceCallId": "fsdfzuhsdfsa-43556fgef3-56g44gv4ew",
 "callOrigin": "Preview",
 "queue": "queue123"
 }

Käytä callAttributesvain Voice Call-objektin mukautettuja kenttiä varten. Tavallisia VoiceCall -kenttiä, kuten Descriptionja CallDurationInSeconds, ei päivitetä. callAttributes Täytä CallDurationInSeconds, anna startTimeja endTimeniin Salesforce voi laskea arvon.

Yksityiskohtainen kuvaus tämän pyynnön hyväksymistä paramet reista löytyy Salesforcen virallisista asiakirjoista ”Parametrit” -osiosta.

Vastaus (onnistunut)

{
 "data": {
 "voiceCallId": "00X000012345abc"
 },
 "errors": null,
 "success": true
 }

Vastaus (virheillä)

 
{
 "data": null,
 "errors": ["Error message 1", "Error message 2"],
 "success": false
 }

Päivitä äänipuhelu

Päivittää VoiceCall -puhelun puhelun päättymisen jälkeen. Tämän sovellusliittymän avulla voit päivittää puheluun liittyvät parametrit, jotka eivät ole käytettävissä VoiceCall-luontivaiheen aikana. Update VoiceCall -sovellus liittymä on asynkroninen toiminto. Et voi kysyä API-kutsun tilaa.

Tätä päätepistettä voidaan käyttää myös VoiceCall -puhelun luomiseen myös puhelun päättymisen jälkeen. Tämä toim into on hyödyllinen tilanteissa, joissa haluat kirjata tietueen Salesforcessa hylätyille tai vastaamattomille puheluille, tai missä tahansa muussa tilanteessa, jossa VoiceCall-puhelua ei ole vielä luotu.

Päätepisteen URI

< instance_url >/ cisco_wxcc_scv palvelut/apexrest//ääni/v1/päivitysVoiceCall

HTTP-menetelmä

POST

Otsikot

Valtuutus: Haltija <> access_token

Sisältötyyppi: application/json

Parametrit

{
 "callCenterDevName": "contactCenterDevName123",
 "certDevName": "certDevName123",
 "voiceCallId": "00X000012345abc",
 "startTime": "2020-08-26T21:21:14Z",
 "endTime": "2019-08-26T21:21:34Z",
 "isActiveCall": true,
 "fromNumber": "1234",
 "callOrigin": "Preview",
 "enqueueTime": "2019-08-26T21:21:34Z",
 "acceptTime": "2019-08-26T21:21:24Z",
 "numberOfHolds": 20,
 "queue": "queue123",
 "agent": "agent123",
 "agentInteractionDuration": 12,
 "longestHoldDuration": 10,
 "totalHoldDuration": 21,
 "recordingLocation": "Bern",
 "totalRecordingDuration": 55,
 "callAttributes": "{\"devscv24__AAA_Test__c\":\"field value\",\"Other_Field__c\":\"other value\"}",
 "disconnectReason": {
 "value": "TELECOM_PROBLEM",
 "isError": true
 }
 }

Yksityiskohtainen kuvaus tämän pyynnön hyväksymistä parametreista löytyy Sales forcen virallisista asiakirjoista ”Parametrit” -osiosta.

Vastaus (onnistunut)

{
 "data": {
 "status": "pending"
 },
 "errors": null,
 "success": true
 }

Update VoiceCall -sovellus liittymä on asynkroninen toiminto. Et voi kysyä API-kutsun tilaa.

Vastaus (virheillä)

{
 "data": null,
 "errors": ["Error message 1", "Error message 2"],
 "success": false
 }

Suorita Omni-flow

Suorittaa Omni-Channel -virran puhelujen reitittämiseksi. Se välittää puhelutunnuksen (Salesforce VoiceCallid tai puhelintoimittajan ContactID) parametreina kulkuun ja palauttaa agentin tai jonon reititysohjeet yhteysvirtaan. Service Cloud Voice käyttää oletusarvoisesti valittua numeroa vastaavalle puhelinkanavalle määritettyä Omni-Channel -virtaa (tai varajonoa). Jos valittu numero ei vastaa olemassa olevaa puhelinkanavaa, voit halutessasi määrittää uuden soitetun numer on, Omni-Channel-kulun ja varajonon tämän API-kutsun syöttö parametreiksi.

Service Cloud Voice käyttää tätä prioriteettijärjestystä puheluiden reitittämiseen:

  1. Käyttää valittua numeroa vastaavan puhelinkanavan Omni-Channel Flow- ja Varajono-aset uksia. Virtaus menee etusijalle. Jos virtaus epäonnistuu, käytetään varajonoa.
  2. Käyttää Exec ute Omniflow API -kutsussa määritettyjä flowDevName- ja fallbackQueue-parametreja.

Päätepisteen URI

< instance_url >/ cisco_wxcc_scv palvelut/apexrest//ääni/v1/ExecuteOmniflow

HTTP-menetelmä

POST

Otsikot

Valtuutus: Haltija <> access_token

Sisältötyyppi: application/json

Parametrit

{
  "callCenterDevName": "contactCenterDevName123",
  "certDevName": "certDevName123",
  "voiceCallId": "00X000012345abc",
  "dialedNumber": "+18445791189",
  "flowDevName": "Route_VoiceCall",
  "fallbackQueue": "00G111222333444",
  "flowInputParameters":
  {
    "Input1": "one",
    "Input2": "two"
  }
}

  • VoiceCallid-parametri on Salesforce VoiceCallid tai puhelintoimittajan yhteyshenkilön tunnus.
  • Yksityiskohtainen kuvaus tämän pyynnön hyväksymistä parametreista löytyy Sales forcen virallisista asiakirjoista ”Parametrit” -osiosta.

Vastaus (onnistunut)

{
  "data": {
    "queue": "queue info",
    "agent": "agent info"
  },
  "errors": null,
  "success": true
}

AGENT_INFOja QUEUE_INFO vastaavat CallCenterRoutingMapin externalID-kenttää

Vastaus (virheillä)

{
 "data": null,
 "errors": ["Error message 1", "Error message 2"],
 "success": false
 }

Selkeä reititys

Poistaa äänipuhelun PendingServiceRouting (PSR) -tietueen. Tätä sovellusliittymää ei tarvitse kutsua useimmissa skenaarioissa; PSR-tietue poistetaan automaattisesti, kun puhelua ei enää reititetä. On kuitenkin joitain skenaarioita, kuten vastaamattomille tai hylätyille puheluille, kun käytät kumppanipuhelinjärjestelmiä, joissa sinun on nimenomaisesti kutsuttava tämä sovellusliittymä PSR-tietueen tyhjentämiseksi.

Päätepisteen URI

< instance_url >/ cisco_wxcc_scv palvelut/apexrest//ääni/v1/tyhjennysreititys

HTTP-menetelmä

POST

Otsikot

Valtuutus: Haltija <> access_token

Sisältötyyppi: application/json

Parametrit

{
 "callCenterDevName": "contactCenterDevName123",
 "certDevName": "certDevName123",
 "voiceCallId": "00X000012345abc"
 }

  • VoiceCallid-parametri on Salesforce VoiceCallid tai puhelintoimittajan yhteyshenkilön tunnus.
  • Yksityiskohtainen kuvaus tämän pyynnön hyväksymistä parametreista löytyy Sales forcen virallisista asiakirjoista ”Parametrit” -osiosta.

Vastaus (onnistunut)

{
 "data": {
 "status": "Success"
 },
 "errors": null,
 "success": true
 }

Vastaus (virheillä)

{
 "data": null,
 "errors": ["Error message 1", "Error message 2"],
 "success": false
 }

Puhelinnumeron käännökset

Erilaiset vuorovaikutukset Service Cloud Voicen ja Webex Contact Centerin välillä riippuvat puhelin numeron käännöksistä. Kansainvälisten erojen ja asiakaskohtaisten sovellusten vuoksi, puhelinnumeroiden siirtämiseen muodosta A muotoon B. tarvitaan muokattava työkalu.

Webex Contact Center for Service Cloud Voice -ratkaisu poistaa automaattisesti kaikki merkit lukuun ottamatta numeroita, hashtageja (#), tähtimerkkejä (*), pilkkuja (,) ja johtavia plusmerkkejä (+). Se poistaa myös ensimmäisen esiintymisen (0). Tämä tehdään ENNEN kuin puhelin numerosi käännökset otetaan käyttöön.

Tässä oppaassa kuvataan, miten puhelinnumeroiden käännökset määritetään.

Kentät

Puhelinnumeron käännökset tallennetaan Nimi-Arvo -kenttiin. Tämän avulla voit määrittää rajoittamattoman määrän sääntöjä ominaisuutta kohden.

Kokoonpano tallennetaan JSON-merkkijonona.

Huomaa, että käänteisiä viivoja on vältettävä, esim.\ d+ muuttuu\ \ d+.

{"Remove all characters but digits":"[1,17]->[^\\d]+","To internal number":"[7,17]->(\\d{7})(\\d{4})->$2"}

Nimi -kenttää ei teknisesti käytetä. Se on lisättävä ihmisen luettava merkkijono tämän säännön tarkoituksen tunnistamiseksi nopeasti. Hyviä nimiä ovat esimerkiksi: Poista kaikki johtavat nollat, Lisää johtava plus jne.

Käännössääntöjen luominen

Säännöt annetaan säännöllisinä lausekkeina. Tarkemmin sanottuna: Säännöllisten laus ekkeiden JavaScript-toteutus.

Hyvä tapa aloittaa on lukea RegExp-asiakirja MDN-verkkodokumenteista.

Monimutkaisten säännöllisten lausekkeiden luominen on kuitenkin usein hankalaa. Siksi lisäsimme ylimääräisen syntaksin, jotta kokoonpano olisi mahdollisimman helppoa.

Alla olevassa kuvassa näkyy puhelinnumeron käännössäännön yleinen syntaksi:

Predikaatti

Predikaattia käytetään määrittämään aikaväli, joka määrittelee vastaavan numeron pituuden .

Yllä oleva predikaatti määrittää, että kaikki numerot, joiden pituus on 7—11 merkkiä (mukaan lukien reunat + välilyönnit), vastaavat toisiaan.

Predikaatit vastaavat aina numeron alkuperäistä pituutta. Tämä auttaa yksinkertaistamaan kokoonpanoa vähentämällä sisäisten tai ulkoisten numeroiden törmäyssääntöjen riskiä.

Kuvio

Kuvio määrittää vastaavan numeron muodon.

Yllä olevassa kuviossa todetaan, että numeron on koostuttava vain numeroista ja valitsee ne.

Valitsin

Valitsimet määrittelevät numeron lopullisen muodon. Jos on lisättävä merkkejä tai numero ita, joita ei alun perin ollut, tämä on oikea paikka tehdä se.

Valitsin on viimeinen vaihe numeron rakentamisessa. Kuviolähdön perusteella valitsin rakentaa uuden numeron.

Esimerkki 1

Seuraavassa esimerkissä näytetään, miten yhteystietokeskuksesta saatu numero 0319175200 siirretään sveitsiläiseen E164-muotoon +41 31 917 52 00.

Tässä esimerkissä käytetään kahta käännössääntöä (1. ja 2.)

Tämän esimerkin ensimmäinen sääntö ei itse asiassa muuta numeroa. Numeroista, joiden pituus on 1—17 merkkiä, kaikki muu kuin numerot poistetaan. Koska ei ole numero a, mikään ei muutu.

Toinen sääntö koskee numeroita, jotka ovat täsmälleen 10 merkkiä pitkiä (alun perin). 0319175200 ottelut ja siksi sääntöä sovelletaan. Kuvio määrittää, että numeron on alettava yhden numeron ryhmällä (\ d {1}), jota seuraa kahden numeron ryhmä (\ d {2}), jota seuraa kolmen numeron ryhmä (\ d {3}) ja niin edelleen.

Valitsin käyttää sitten kuvioryhmiä määrittääkseen uuden numeromerkkijonon. Tämä tarkoittaa, että $2 viittaa ensimmäiseen (\ d {2}) ja sisältää siten 31.

Esimerkki 2

Seuraavassa esimerkissä näytetään, miten yhteystietokeskuksesta saatu numero muodossa +14693150217 siirretään Yhdysvaltain E164-muotoon +1 469 315 0217.

Tässä esimerkissä käytetään kahta käännössääntöä (1. ja 2.)

  1. Tämä numero on täsmälleen 12 merkkiä pitkä, joten sääntöä ”Lisää välilyöntejä Yhdysvaltain numeroihin” sovelletaan.
  2. (\ +1) sanoo, että numeron on alettava +1: lla. Jos numero on 12 merkkiä pitkä, mutta ei ala +1: lla, sääntö peruutetaan eikä mitään muuteta.
  3. (\ d {3}) sanoo, että +1: n jälkeen on oltava 3 numeroa.
  4. (\ d {3}) sanoo, että viimeisiä kolmea numeroa seuraa vielä 3 numeroa.
  5. (\ d {4}) sanoo, että viimeisiä kolmea numeroa seuraa 4 numeroa.

Jos jokin näistä ei täsmää, numeroa ei muuteta.

Joten kaikki säännöt koskevat ”+14693150217”. Siksi numeroa muutetaan ”$1 $2 $3 $4”:

  1. $1 viittaa ryhmään (\ +1), Service Cloud Voice -palveluun lähetettävä numero näyttää +1: ltä.
  2. $2 viittaa ensimmäiseen kahdesta (\ d {3}), Service Cloud Voicelle lähetettävä numero näyttää +1 469.
  3. $3 viittaa toiseen kahdesta (\ d {3}), Service Cloud Voicelle lähetettävä numero näyttää +1 469 315.
  4. $4 viittaa viimeiseen ryhmään (\ d {4}), Service Cloud Voice -palveluun lähetettävä numero näyttää +1 469 315 0217.

Säännön ”$1 $2 $3 $4” korvaavan osan välilyöntejä käytetään suoraan. Joten jos käytät ”$1-$2-$3-$4” numero käännetään seuraavasti: +1-469-315-0217

Ja sinulla on myös oikeus poistaa ryhmiä: [12, 12] -> (\ +1) (\ d {3}) (\ d {3}) (\ d {4}) -> $2 $3 $4 käännetään muotoon: 469 315 0217. [12, 12] -> (\ +1) (\ d {3}) (\ d {3}) (\ d {4}) -> $3 $4 käännetään osoitteeseen: 315 0217.

On myös mahdollista muuntaa kansainvälinen yhdysvaltalainen numero paikalliseksi, kuten: [12, 12] -> (\ +1) (\ d {3}) (\ d {3}) (\ d {4}) -> ($2) $3-$4.

Sitten saapuva numero ”+14693150217” käännetään seuraavasti: (469) 315-0217.

Esimerkki 3

Seuraavassa esimerkissä näytetään, miten yhteystietokeskuksesta saatu numero +491515555531 siirretään saksalaiseen E164-muotoon +49 151 5555 531.

Tässä esimerkissä käytetään kahta käännössääntöä (1. ja 2.)

  1. Tämä numero on tarkalleen 13 merkkiä pitkä, joten sovelletaan sääntöä ”Lisää välilyöntejä saksankielisiin numero ihin”.
  2. (\ +49) sanoo, että numeron on alettava numerosta +49. Jos numero on 13 merkkiä pitkä, mutta ei ala +49: llä, sääntö peruutetaan eikä mitään muuteta.
  3. (\ d {3}) sanoo, että +49: n jälkeen on oltava 3 numeroa.
  4. (\ d {4}) sanoo, että viimeisiä kolmea numeroa seuraa 4 numeroa.
  5. (\ d {3}) sanoo, että viimeisiä 4 numeroa seuraa 3 numeroa.

Jos jokin näistä ei täsmää, numeroa ei muuteta.

Joten kaikki säännöt koskevat ”+491515555531". Siksi numeroa muutetaan ”$1 $2 $3 $4”:

  1. $1 viittaa ryhmään (\ +49), Service Cloud Voice -palveluun lähetettävä numero näyttää +49.
  2. $2 viittaa ensimmäiseen kahdesta (\ d {3}), Service Cloud Voicelle lähetettävä numero näyttää +49 151.
  3. $3 viittaa toiseen kahdesta (\ d {4}), Service Cloud Voice -palveluun lähetettävä numero näyttää tältä +49 151 5555.
  4. $4 viittaa viimeiseen ryhmään (\ d {3}), Service Cloud Voice -palveluun lähetettävä numero näyttää tältä +49 151 5555 531.

Sama pätee ykkössääntöön. Voit käyttää varaosaa $1 $2 $3 $4 valitaksesi, mitä haluat käyttää numerosta.

Lisää käännöksen Regex-esimerkkejä

Kuvaus Käännös Regex
Poista kaikki merkit lukuun ottamatta numeroita [1,17] -> [^\ d] +
Poista kaikki merkit paitsi numerot & + [1,17] -> [^+\ d] +
Kuvaus Käännös Regex
Poistaa +1 [12,12] -> (. {1}) (\ d {1}) (\ d {10}) -> $3
Poistaa +1 [10,12] -> (^\ +1+) (\ d+) -> $2
Poistaa +49 [10,15] -> (^\ +49+) (\ d+) -> $2
Poistaa +49 [10,15] -> (. {1}) (\ d {2}) (\ d {9}) -> $3
Poistaa +41 [10,13] -> (^\ +41+) (\ d+) -> $2
Poistaa +41 [10,13] -> (. {1}) (\ d {2}) (\ d {9}) -> $3
Poista+XX [10,14] -> (^\ ++) (\ d {2}) (\ d+) -> $3
Kuvaus Käännös Regex
Poista+ja korvaa se nollilla US E164 [10,12] -> (. {1}) (\ d {1}) (\ d {10}) -> 001 $3
Poista +1 ja korvaa se nollilla US E164 [10,12] -> (^\ +1+) (\ d+) -> 001$2
Poista + ja korvaa se nollilla DE E164 [12,15] -> (. {1}) (\ d {2}) (\ d {10}) -> 0049 $3
Poista +49 ja korvaa se nollilla DE E164 [10,12] -> (^\ +49+) (\ d+) -> 0049 dollaria
Poista + ja korvaa se nollilla CH E164 [10,13] -> (. {1}) (\ d {2}) (\ d {9}) -> 0041 $3
Poista +41 ja korvaa se nollilla CH E164 [10,12] -> (^\ +41+) (\ d+) -> 0041 dollaria
Kuvaus Käännös Regex
Yhdysvaltain numero avaruudella [12,17] -> (\ d {1}) (\ d {3}) (\ d {3}) (\ d {4}) ->+1 $2 $3 $4
Yhdysvaltain numero avaruudella [12,17] -> (\ +1) (\ d {3}) (\ d {3}) (\ d {4}) -> $1 $2 $3 $4
DE-numero välilyönnillä [12,17] -> (\ d {2}) (\ d {3}) (\ d {4}) (\ d {3}) ->+49 $2 $3 $4
DE-numero välilyönnillä [12,17] -> (\ +49) (\ d {3}) (\ d {4}) (\ d {3}) -> $1 $2 $3 $4
CH-numero välilyönnellä [12,17] -> (\ d {2}) (\ d {2}) (\ d {3}) (\ d {2}) ->+41 $2 $3 $4
CH-numero välilyönnellä [12,17] -> (\ +41) (\ d {2}) (\ d {3}) (\ d {2}) (\ d {2}) ->$1 $2 $3 $4

VoiceCall-sivun määritykset

VoiceCall-tietuesivun määrittäminen

VoiceCall-tietuesivu on oletusarvoisesti ennalta määritetty, ja siinä on kolmen sarakkeen asettelu ja seuraavat osat:

  • Toimet ja suositukset
  • Puhelumuistiinpanot
  • Puhelutiedot
  • Tallenteet

Komponentit voidaan vapaasti poistaa tai lisätä sivulle liiketoiminnan tarpeiden mukaan. Eri sivuasetteluja voidaan käyttää myös, mutta jotkin komponentit, kuten puhelun tallennusso itin ja keskustelurunko, mahtuvat vain mallin keskisuurille ja suurille alueille.

Wrap-Up Rease-komponentin näyttäminen

Wrap-Up Reason -komponentti on näytettävä puhelun aikana ja Wrap-Up -ohjelman aikana.

Lisää Cisco Wrap-Up Reason -komponentti VoiceCall-tietuesivulle:

  1. Vedä Cisco Wrap-Up Reason Lightning -verkkokomponentti Lightning-komponentit -luettelon Mu kautettu alueelta VoiceCall Record -sivulle.
  2. Valitse Tallenna.
  3. Valitse Aktivoi.
  4. Valitse Määritä organisaation oletukseksi.
  5. Valitse Tallenna.
  6. Pal aa sivulle valitsemalla Tallenna uudelleen ja napsauta sitten Takaisin-nu olta.

Cisco Wrap-Up Reason - komponentti näkyy automaattisesti puhelun aikana ja Wrapupin aikana:

Jos se lisätään sivulle, Cisco Wrap-Up Reason -komponentti näkyy jokaisessa puhelussa, myös jos Ciscon yhteyskeskuksessa ei ole määritetty Wrap-Up -ohjelmaa.

Puhelun tallennussoittimen näyttäminen

Puhelun tallennussoitin tulee näkyviin, jos vastaavaa äänipuhelua varten on tallennettu tallennuslinkki.

Voit lisätä Call Recording Player -komponentin VoiceCall Record -sivulle seuraavasti:

  1. Vedä Call Recording Player Lightning Web -komponentti VoiceCall Record -sivulle
  2. Valitse Tallenna.
  3. Valitse Aktivoi.
  4. Valitse Määritä organisaation oletukseksi.
  5. Valitse Tallenna.
  6. Pal aa sivulle valitsemalla Tallenna uudelleen ja napsauta sitten Takaisin-nuolta.

Webex-järjestelmänvalvojat

Virtauksen kokoonpano

Näyttö Pop

”Screen Pop” -solmu on käytettävissä Webex Contact Center Flow -palvelussa. Sitä voidaan käyttää käynnistämään näytön ponnahdusikkuna Service Cloud Voicessa tai erillisessä ikkunassa.

Lisätietoja tästä toiminnosta on Flow Designerin dokumentaatiossa .

Näyttö Pop erillisessä ikkunassa

Jos haluat avata näytön ponnahdusikkunan erillisessä ikkunassa, ”Screen Pop” -solmussa on annettava ab soluuttinen URL-osoite. QueryParameters lisätään hakuparametreina URL-osoitteeseen.

Seuraavia tiloja tuetaan:

  • Uusi selainvälilehti - Avaa aina uuden selainvälilehden.
  • Olemassa oleva selainvälilehti - Ensimmäisessä Olemassa olevan selaimen välilehden ikkunassa av autuu uusi selainvälilehti. Tämä välilehti on erillinen välilehti seuraaville Olemassa olev alle selainvälilehden näytölle, ja URL-osoite päivitetään kyseisessä selain välilehdessä.
  • Työpöydän sisällä - Käsitellään samalla tavalla kuin Uusi selain välilehti.

Tällä hetkellä avattu sivu voi estää uudelleenohjauksen. Siinä tapauksessa Olemassa oleva selaimen välileh den ikkuna avautuu uuteen selainvälilehteen.

Oliko tästä artikkelista apua?
Oliko tästä artikkelista apua?