- Početak
- /
- Članak
Webex Contact Center for salesforce Service Cloud Voice integrira Ciscove robusne CCAAs (Contact Center as a Service) sa Salesforceovim CRM-om, omogućujući tvrtkama upravljanje višekanalnim interakcijama kupaca (glasovne, digitalne) unutar Salesforce sučelja, koristeći Webex AI za virtualne agente, transkripciju i inteligentno usmjeravanje, pretvarajući agente u "super-agente" s jedinstvenim podacima za bolje korisničko iskustvo.
Pregled
Webex kontakt centar za usluge Salesforce Cloud Voice
Webex Contact Center for Service Cloud Voice je rješenje za integraciju koje donosi snagu Webex Contact Center u konzolu višekanalnih agenta Salesforce Service Cloud Voice.
Prije nastavka instalacije pogledajte sljedeći odjeljak:
da biste saznali više o preduvjetima i ograničenjima Salesforce Service Cloud Voice i osigurali da je vaš Salesforce Org spreman omogućiti i instalirati Webex Contact Center for Service Cloud Voice paket.
SCV Voice Connector Release 1 općenito je dostupno. Ovaj vodič uključuje postupke postavljanja, pružanje usluga partnerske telefonije i konfiguraciju jednokratne prijave (SSO).
Preduvjeti i ograničenja
Preduvjeti (podtema)
Korisnička sučelja: Service Cloud Voice dostupan je samo u Salesforce Lightning Experience.
Usluga Cloud Voice dostupna je u sljedećim izdanjima:
- Poduzeće
- Neograničeno
- Razvojni programer
Licence
-
Korisnici moraju kupiti novu licencu za dodatak A-SF-VOICE po prijavljenom agentu uz Flex 3 Standard ili Premium licence za Webex Contact Center. Za više informacija pogledajte vodič za naručivanje Flex 3.
- Salesforce Voice za partnersku telefoniju
Prije nego što uključite Voice, morate postaviti preduvjetne usluge u svojoj organizaciji.
- Idite na Informacije o tvrtki > Licenca za postavljanje dozvol a
- Provjerite ima li usluge Cloud Voice User (partnerska telefonija).
Sva izdanja za programere sada dolaze s 5 licenci za partnersku telefoniju dostupne za testiranje.

- Provjerite ima li usluge Cloud Voice User (partnerska telefonija).
- Alternativno, to možete provjeriti tako da odete na Salesforce Setup i potražite
"glas" na lijev oj bočnoj traci.

- Ako se pojavi "Kontaktni centri za partnersku telefoniju", imate SCV licencu.
- Ako opcija "Kontaktni centri za partnersku telefoniju" nije vidljiva,
"O mogući servis Cloud Voice" slijedeći korake u nastavku.
- Idite na Salesforce Setup i pretražite i odaberite "Post avljanje partnerske telefoni je"
i prebacite gumb na "O mogući servis Cloud Voice".

- Omogućite Omni-Channel kako biste svojim agentima omogućili upućivanje i primanje poziva.
- Idite na Salesforce Setup i pretražite i odaberite "Post avljanje partnerske telefoni je"
i prebacite gumb na "O mogući servis Cloud Voice".
Omogući Omni-Channel
Ako je Omni-Channel već omogućen u vašoj organizaciji, preskočite ovaj korak.
- U okviru Postavljanje unesite Omni-Channel Settings u okvir Brzo pronalaženje, a
zatim odaberite Postavke višekanalnih kanala.


- Odaberite O mogući Omni-Channel.
- Kliknite S premi.
Ograničenja
- Glas je dostupan samo u programu Lightning Experience.
- Glas je podržan na uslužnom oblaku i Sales Cloud kao dodatna licenca.
- Glas nije podržan na usluzi Salesforce Mobile ili iPad Safari.
- Glas je podržan samo na web preglednicima Google Chrome, Microsoft Edge (Chromium) i Mozilla Firefox. Kolačići moraju biti omogućeni kako bi se omogućila jednokratna prijava (SSO).
- Standardna navigacija nije podržana.
- Telefonija je visoko regulirana, stoga provjerite sa svojim predstavnikom Salesforcea o dostupnosti Voice u vašoj regiji.
- Višestranačka konferencija nije podržana pomoću Salesforce Service Cloud Voice konektora.
Pogledajte Glas ovna ograničenja i ograničenja usluge u oblaku te V odič za instalaciju i konfiguraciju.
Zahtjevi
Salesforce paket 1.2 i noviji
Za Salesforce paket 1.2 ili noviji, implementacija mora uzeti u obzir digitalnu i glasovnu integraciju i održavanje WebSocket-a.
Neaktivni kodovi
Pronađite neaktivne kodove
| 1 |
Prijavite se uManagement Portal. |
| 2 |
Idite na Kontakt centar > DESKTOP EXPERIENCE > Idle/Wra p-up kodovi. |
| 3 |
Provjerite jesu li prikazani neaktivni kodovi, inače kliknite padajući gumb filtra i odaberite Idle Code na vrhu stranice. |
| 4 |
Kliknite na Idle Code da biste otvorili prikaz detalja. Tamo možete pronaći ID Idle Code.
ID-ovi se mogu kopirati, a zatim koristiti za konfiguraciju mapiranja stanja prisutnosti. Jedan od ID-a mora se koristiti kao zadani razlog Cisco Not Ready. |
Ograničenja stope
Ovaj se odjeljak odnosi samo na paket ranog pristupa u slučaju da se na paketu za rani pristup testira veći broj agenata (npr. 0.2). Ovo NIJE potrebno za GA paket.
Webex Contact Center primjenjuje standardna ograničenja stope API-ja na integraciju organizacije Contact Center. Za detal je pogledajte API ograničenja stop e.
Potrebno je povećati ograničenje stope. Da biste to postigli:
- Napravite kartu uz podršku Webex Contact Center.
- Navedite organizaciju Webex Contact Center i traženo standardno ograničenje stope integracije API-ja (za izračun pogledajte dolje).
- Spomenite da je povećanje ograničenja stope API-ja potrebno jer koristite Webex Contact Center for Service Cloud Voice.
Webex kontakt centar za usluge Cloud Voice, 15 zahtjeva po agentu u minuti za integraciju organizacije Contact Center. Da biste izračunali dobru početnu točku za ograničenje stope, možete koristiti sljedeću formulu:
Ograničenje brzine u minuti = 15 * maksimalni broj agenata koji rade paralelno u organizaciji Webex Contact Center
Integrirati
Instalacija
Prije nastavka instalacije pogledajte odjeljak Preduvjeti i ograničenja kako biste saznali više o preduvjetima i ograničenjima Salesforce Service Cloud .
Instalirajte i konfigurirajte Webex kontakt centar za uslugu Cloud Voice
Kada se dobije licen ca Service Cloud Voice za partnersku telefoni ju, stranica Post avljanje partnerske telefoni je pojavljuje se u izborniku Postavljanje telefonije.
Daljnje informacije možete pronaći u službenoj referenci Salesforcea (izravna veza).
| 1 |
U odjeljku Postavljanje unesite
|
| 2 |
Omoguć ite Uključivanje glasa pomoću partnerske telefonije. Stranica Kontaktni centri za partnersku telefoni ju pojavljuje se u izborniku Post avljanje.
Ako planirate implementirati paket u Salesforceov sandbox, zamijenite
|
Instalirajte paket
Da biste instalirali paket:
| 1 |
Otvorite priloženi link paketa da biste pokrenuli instalaciju. |
| 2 |
Prijavite se u organizaciju Salesforce gdje bi paket trebao biti instaliran. |
| 3 |
U čarobnjaku za instalaciju odaberite sigurnosnu opciju "Instaliraj samo za administratore" (1) i kliknite Instaliraj (2). Odredite koji korisnici dobivaju određena dopuštenja za objekte i komponente koje dolaze s Webex Contact Center for Service Cloud Voice paketom. Osim toga, dodijel ite im ta dopuštenja; Skupovi dopuštenja koji dolaze s Webex Contact Center for Service Cloud Voice paketom pomažu ovom procesu. Čarobnjak za instalaciju paketa - pojavljuje se zaslon dobrodošlice: Instalacijski paket nije izravno dostupan putem Salesforce AppExchange. Kupci moraju koristiti gumb "Preuzmi sada" na popisu AppExchange, koji otvara obrazac za kontakt za zatraženje veze za instalaciju i Cisco aktiv aciju. |
| 4 |
Dajte sljedeće skupove dopuštenja barem jednom korisniku kako biste mogli stvoriti kontakt centar:
|
| 5 |
Kliknite Post avljanje | Korisnici | Korisnici. |
| 6 |
Pretraživanje i odabrani korisnik. |
| 7 |
Pomaknite se prema dolje do "Zadaci postavki dopuštenja". |
| 8 |
Kliknite Uredi zadatke |
| 9 |
Za administr atore kontaktnog centra: do dijelite skup dopušten ja administratora kontaktnog centra (partnerska telefonija).
|
| 10 |
Za ag ente kontaktnog centra: dodijelite skup dozvola agenta kontaktnog centra (partnerska telefonija) i skup dopuštenja agenta Webex kontaktnog centra SCV.
Ne preporučuje se odabir opcije Instaliraj za sve korisnike jer to daje sva dopuštenja (čitanje, stvaranje, uređivanje i brisanje) na komponentama i objektima paketa svakom korisniku koji koristi prilagođeni korisnički profil. |
| 11 |
Dodijelite licencu za paket za korisnike za rad s Connects for Service Cloud Voice.
|
| 12 |
Alternativno, možete kliknuti Post avljanje | Korisnici | Korisnici. . |
| 13 |
Pretražite i odaberite korisnika. |
| 14 |
Pomaknite se prema dolje do Upravljani paketi. |
| 15 |
Kliknite Dodjel jivanje licenci. |
| 16 |
Odaberite Webex Contact Center za paket Service Cloud Voice s popisa. |
| 17 |
Kliknite Dodaj. |
| 18 |
Stvorite statuse prisutnosti kako biste definirali koji su servisni kanali dodijeljeni različitim statusima. Agenti se mogu prijaviti na Omni-Channel s različitim statusima ovisno o vrsti posla koji imaju pravo primiti. |
| 19 |
U okviru Postavljanje unesite
|
| 20 |
Kliknite Novo. Stvorite barem jedan status za "Online" i jedan za "Zauzet".
|
Dodijelite status prisutnosti agentima
| 1 |
U okviru Postavljanje unesite Skupovi dopuštenja u okvir Brzo pronalaženje, a zatim odaberite Skupovi dopu štenja. |
| 2 |
Kliknite da biste otvorili Set dozvola za partnersku telefoniju. |
| 3 |
Kliknite Pri stup statusima prisutnosti usluge. |
| 4 |
Kliknite Uredi. |
| 5 |
Na popisu Prisutnosti dostupnih usluga odaberite prethodno stvorene statuse prisutnosti i kliknite Dodaj da biste ih povezali sa skupom dozvol a. Agenti koji su dodijeljeni ovom skupu dozvola mogu se prijaviti na Omni-Channel s bilo kojim statusom prisutnosti koji su im dostupni. |
| 6 |
Kliknite S premi. |
| 7 |
Kliknite U pravljanje zad acima na istoj stranici. Zatim kliknite Dodaj dodjelu u gornjem desnom kutu, odaberite željenog korisnika, kliknite Dal je, odaberite opciju isteka za dodijeljene korisnike (Opcionalno), a zatim kliknite Dodjeljivanje. Usluga Cloud Voice koristi vanjsku domenu za rad sa zapisom VoiceCall. Sljedeći URL-ovi moraju se dodati u "Remote Site Settings" u Postavku (kliknite ovdje da biste otvorili službenu dokumentaciju):
Primjer: Kako pronaći URL instance. |
| 8 |
Pogledajte URL u adresnoj traci preglednika nakon prijave. URL instance je dio prije ".my.salesforce.com" ili ".salesforce.com" ili." lightning.force.com". Na primjer, ako je vaš URL https://orgfarm-54a38e30ad-dev-ed.develop.my.salesforce-setup.com/, onda je "orgfarm-54a38e30ad-dev-ed.development" URL vaše instance. Primjer: URL podrijetla org: https://cisco.lightning.force.com Pri@@ mjer: URL za dodavanje:
|
| 9 |
Stavka uslužnog programa Omni-Channel potrebna je u aplikaciji Lightning Service Console da bi agent mogao koristiti Service Cloud Voice.
Službenu referencu iz Salesforcea možete pronaći klikom na gumb Učinimo ovo koji otvara stranicu Konfiguriraj iskustvo agenta za uslugu Cloud Voice s partnerskom telefoni jom na portalu pomoći Salesforce (izravna veza). |
| 10 |
U okviru Postavljanje unesite Post avljanje partnerske telefonije u okvir Brzo pronalaženje, a zatim odaberite Post avljanje partnerske telefonije. |
| 11 |
Pomaknite se prema dolje do odjel jka 5 Više glasovnih postav ki. |
| 12 |
Da biste omogućili zaštitu od klikova za stranice Visualforce s zaglavljima on emo gućenim tijekom rada s softfonom u programu Lightning Experience, morate dodati domene iz kojih se softphone i prilagođene alatne trake učitavaju kao pouzdane domene, uz URL instance Salesforce. Ove postavke i popis Pouzdane domene možete pronaći u odjeljku Post avljanje | Sigurnost | Post avke sesije. Da biste preuzeli ispravnu Visualforce domenu, idite na Post avljanje | Prilagođeni kôd |
Visualforce Pages i kliknite gumb Pregled za.
Primjer: MyDomainName-- .vf.force.com cisco_wxcc_scv Da biste dobili domenu Instance Salesforce, kopirajte URL prikazan u traci URL-a preglednika i dodajte ga na popis Pouzdane domene za ugrađene okvire od abirom Visualforce Pages kao iFrame Type. Primjer: MyDomainName.Lightning.Force.com
Ako u organizaciji nemate instaliranu Moju domenu, format URL-a je drugačiji. Ako imate instaliranu Moju domenu, a poboljšane domene nisu omogućene u vašoj organizaciji, vaš format URL-a je drugačiji. Ako poboljšane domene nisu omogućene, postav ka Stabilizirajte URL-ove u Visualforce, Experience Builder, studiju Site.com i sadržajnim datotekama Moja domena također utječe na ovaj format. Pojedinosti potražite u odjelj ku Formati URL-ova moje domene u pomoći Salesforcea. Postavke zaštite od klikova i pouzdanih domena za Lightning Experience
|
| 13 |
Da bi prikazali kontrole snimanja tijekom poziva, agenti trebaju dopu
Da biste ga dodijelili, dodajte ga skupu dopuštenja stvorenom u kor aku Statusi prisutnosti.
|
Konfiguracija
Stvorite prilagođeni zapis metapodataka za vjerodajnice Webex Contact Center
| 1 |
U okviru Postavljanje unesite Prilagođeni tip meta podataka u okvir Brzo pronalaženje, a zatim odaberite Prilagođene vrste metapodataka. |
| 2 |
Na popisu pronađite prilagođenu vrstu meta podataka wXCC veze. |
| 3 |
Kliknite U pravljanje zap isima ispred WxCC veze, a zatim Novo. |
| 4 |
Unesite ime. Primjer: WebExccMetadata |
| 5 |
Unesite standardni wXCC URL za provjeru autentičnosti i tajnu klijenta za svoju organizaciju. Za postavljanje Salesforce telefonije slijedite Konfiguriranje Salesforce konektora u Webe x Control Hub. |
| 6 |
Kliknite S premi. |
| 7 |
Zapamtite naziv veze wxCC koji vam treba ovo ime u konfiguraciji Contact Center.
|
Kontakt centar
Datoteka definicije kontaktnog centra određuje skup polja i vrijednosti koje se koriste za definiranje kontakt nog centra u Salesforceu za određeni CTI sustav. Salesforce koristi datoteke definicije Contact Center za podršku integraciji s više dobavljača CTI sustava.
Dodatne informacije mogu se naći u službenoj dokumentaciji Salesforcea (izravna veza).
Uvezite kontakt centar
Preuzmite najnoviju verziju Kontakt centra ovdje.
Nadogradnja s beta verzije: Ovaj vodič opisuje čistu instalaciju izdanja Opće dostupnosti (GA) integracije Webex Contact Center za Salesforce Service Cloud Voice.
Ako nadograđujete s beta verzije integracije, nemojte ponovno koristiti postojeći zapis Partnerskog kontaktnog centra. Umjesto toga:
- Uvezite XML datoteku Partner Contact Center uključenu u GA izdanje.
- Stvorite novi zapis Partner Contact Center pomoću uvezenog XML-a.
- Ažurirajte svoju konfiguraciju da biste koristili novo stvoreni kontakt centar za partnere.
XML GA Partner Contact Center sadrži ažurirane vrijednosti konfiguracije, uključujući ispravan URL konektora i druge metapodatke. Ponovna upotreba zapisa Partnerskog kontaktnog centra stvorenog iz Beta XML-a može zadržati zastarjele vrijednosti konfiguracije i spriječiti ispravno funkcioniranje integracije.
| 1 |
U okviru Postavljanje unesite kontakt centre za partnersku telefoniju u okvir Brzo pronalaženje, a zatim odaberite Kontaktni centri za partnersku telefoniju. Prikazuje se popis postojećih (ako ih ima) kontakt centara.
|
| 2 |
Kliknite Stvori kontakt centar na desnoj strani stranice. |
| 3 |
Odaberite Webex Contact Center kao svog pružatel ja telefonije. Zatim kliknite Dalje.
Otvara se preglednik datoteka.
|
| 4 |
Odaberite |
| 5 |
Kliknite Otvor i. Datoteka je uvezena.
|
| 6 |
Provjerite je li vaš kontakt centar prikazan u prikazu popisa kontaktnih centara.
|
Konfigurirajte kontakt centar
| 1 |
U okviru Postavljanje unesite kontakt centre za partnersku telefoniju u okvir Brzo pronalaženje, a zatim odaberite Kontaktni centri za partnersku telefoniju. | ||||||||||||||||||||||||||||||
| 2 |
Kliknite prethodno uvezeni kontakt centar. | ||||||||||||||||||||||||||||||
| 3 |
Kliknite Uredi.
| ||||||||||||||||||||||||||||||
| 4 |
Na dnu stranice Contact Center kliknite Dodaj gumb u odjeljku Korisnici kontaktnog centra. | ||||||||||||||||||||||||||||||
| 5 |
Kliknite + pored korisnika koji imaju pristup otvorenom kontaktnom centru. Na ovom se popisu |
Prilagodite
Aplikacija vanjskog klijenta za integraciju Webex Contact Center
Konfigurirajte aplikaciju vanjskog klijenta za Webex Contact Center Salesforce Connector
Da biste u punoj mjeri koristili Service Cloud Voice, tijek poziva Contact Center može se prilagoditi za stvaranje zapisa glasovnog poziva i za izvršavanje protoka višekanalnog Salesforce dok je poziv na IVR-u.
Stvorite certifikat
Provjerite jeste li već stvorili digitalni certifikat u skladu sa sigurnosnim pravilima vaše organizacije.
Da biste generirali digitalni certifikat, pogledajte Salesforceovu dokumentaciju na https://developer.salesforce.com/docs/atlas.en-us. voice_pt_developer_guide.meta/voice_pt_developer_guide/voice_pt_generate_certificate.htm.
Primjer
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
Skup dopuštenja za SCV integracijskog korisnika
Sljedeći skup dopuštenja daje pristup Apex klasama koje koristi Connects for SCV za integraciju s tokovima IVR kontaktnog centra i Webex kontakt centrom za Salesforce za SCV.
Slijedi primjer konfiguracije i opisuje minimalna potrebna dopuštenja za rad integracije Kontaktnog centra/IVR.
- Iz Postavke idite na Korisnici | Skupovi dopuštenja.
- Kliknite gumb N ovo.
- Unesite oznaku, na primjer: IVR pristup SCV Apex klasama
- Naziv API-ja automatski se popunjava
- Licenca: Nema
- Kliknite gumb S premi.
- Otvara se novi skup dopuštenja.
- Idite na Apex Class Access.
- Kliknite gumb Uredi i dodajte sljedeće Apex klase:
- cisco_wxcc_scv.ServiceIzlet
- Idite na D ozvole sustava.
- Kliknite gumb Uredi i omogućite sljedeće dozvole:
- Apex REST usluge
- API omogućen
Minimalni pristup - Profil integracije samo API-ja
Ovaj se profil koristi za integraciju s Webex kontaktnim centrom za Salesforce za SCV za stvaranje zapisa glasovnih poziva i izvršavanje Omni-Flow iz IVR toka.
Slijedi primjer konfiguracije i opisuje minimalna potrebna dopuštenja za rad integracije Kontaktnog centra/IVR.
Ovo je klon iz profila Minimalni pristup - API Only Integrations.
- Iz Postavke idite na Korisnici | Profili.
- Na popisu Profili potražite Minimalni pristup profilu - samo API integracije.
- Kliknite naziv profila da biste otvorili profil Minimalni pristup - API On ly Integrations.
- Na profilu Minimalni pristup - API Only Integrations kliknite gumb Kloniraj.
- Unesite novo ime profila, na primjer: SCV Integracija.
- Kliknite gumb S premi.
- Otvara se novi profil.
- Provjerite ima li vaš profil Minimalni pristup — API Only Integrations uklonjena sva dopuštenja iz samog profila.
- Idite na D ozvole sustava.
- Provjerite jesu li omogućena sljedeća dopuštenja:
- API omogućen
- Api samo korisnik
Korisnik SCV integracije
Slijedi primjer konfiguracije i opisuje minimalna potrebna dopuštenja za rad integracije Kontaktnog centra/IVR. Za korisnika SCV integracije nije potrebna Salesforce Service Cloud Voice licenca ili Webex kontakt centar za Salesforce za SCV licencu.
- Iz Postavke idite na Korisnici | Korisnici.
- Kliknite gumb Novi korisnik.
- Unesite Ime, Prezime i sva ostala obvezna polja.
- Korisnička licen ca: Salesforce Integration
- Profil: odaberite profil stvoren u prethodnom koraku ("SCV Integration profile", klon Minimalni pristup - API Only Integrations profil)
- Kliknite gumb S premi.
- Otvorite novi korisnički zapis.
- Dodijelite sk up dopu štenja stvoren prije ("IVR pristup SCV Apex klasama").
- Dodijelite skupu dopuštenja License Salesforce API Integration.
Stvorite aplikaciju za vanjski klijent Salesforce
Trenutno je stvaranje povezanih aplikacija funkcionalnost koju kontrolira preferencija Dopusti stvaranje povezanih aplikacija, koja je prema zadanim postavkama onemogućena za nove organizacije i može se omogućiti na stranici postavki novog odjeljka Izbornik Podešavanje vanjskih klijentskih aplikacija.
- U okviru Postavljanje pretražite Van jski klijentski programi | Postavke.
- U odjeljku Povezane aplikacije postavite potvrdni okvir Dopusti stvaranje povezanih aplikacija na Uključeno da biste omogućili gumb Nova povezana aplikacija.
- Kliknite gumb Nova povezana aplikacija.
Ako se gumb Nova povezana aplikacija ne prikazuje u izborniku Aplikacije vanjskog klijenta, idite na Aplikacije | Upravitelj aplikacija | Nova povezana aplikacija.

Konfigurirajte aplikaciju Salesforce Connected koju Cisco Webex Contact Center koristi. Također pogledajte članak: Konfigurirajte povezanu aplikaciju za Webex Contact Center Salesforce Connector na https://help.webex.com/en-us/article/n26v7heb/Configure-Connected-App-for-Webex-Contact-Center-Salesforce-Connector.
| 1 |
Za novu povezanu aplikaciju unesite sljedeće pojedinosti:
|
| 2 |
Kliknite S premi, a zatim Nastavi. |
| 3 |
U odjeljku API (Omogući postavke OAuth) kliknite U pravljanje detaljima potrošača.
|
| 4 |
Kliknite Kopira j i spremite potrošački ključ. Potrošački ključ kasnije se koristi za stvaranje Salesforce konektora na Webex Contact Center Control Hub.
Važno: Održavajte sigurnost periodičnim rotiranjem tajni Pobrinite se da se vaši tokeni ClientIds i Client Secrets povremeno rotiraju. Pogledajte ključ potrošača i tajnu potrošača Kako biste osigurali da vaše postojeće integracije ne budu prekinute, ažurirajte novo generirani ID klijenta i tajnu klijenta u svim tokovima kontaktnog centra i IVR skriptama u kojima se te tajne koriste. |
| 5 |
Kliknite N atrag za upravljanje povezanim aplikacijama. |
| 6 |
Kliknite U pravljanje.
|
| 7 |
Kliknite Uredi pravilo. |
| 8 |
U odjeljku Pravila OAuth odaberite Koris nici odobreni od administratora unaprijed su ovlašteni za dopuštene korisnike.
|
| 9 |
Kliknite S premi. |
| 10 |
Pomaknite se prema dolje do odjel jka Skup dozvol a i kliknite gumb U pravljanje skupovima dopu štenja. Dodijelite sk up dopu šten ja stvoren prije ("IVR pristup SCV Apex klasama").
|
Stvorite aplikaciju za vanjski klijent Salesforce
Stvorite novu aplikaciju za vanjski klijent
Postoje dvije opcije za povezivanje podataka Salesforce s aplikacijama trećih strana. I povezane aplikacije i vanjske klijentske aplikacije okviri su za integraciju podataka. Eksterne klijentske aplikacije sljedeća su generacija povezanih aplikacija.
Da biste konfigurirali aplikaciju za vanjski klijent Salesforce koju koristi: Cisco Webex Contact Center
- U okviru Postavljanje idite na Aplikacije | Aplikacije vanjskog klijenta | Upravitelj aplikacija vanjskog klijenta.
- Kliknite na Nova aplikacija vanjskog klijenta.
- Aplikacija vanjskog klijenta - Osnovne informacije
- Naziv aplikacije vanjskog klijenta: wxCC - SCV
- Naziv API-ja: WxCC_SCV
- Email za kontakt: < your email >
- Stanje distribucije: odaberite Lokalno

Aplikacija vanjskog klijenta — API (Omogući OAuth postavke)
- Odaberite: Omogući OAuth
- Postavke aplikacije
- URL povratnog poziva: http://localhost:1717/OauthRedirect kao primjer URL-a za povratni poziv
- Opsezi OAuth
- Odaberite opsege OAuth:
- Upravljanje korisničkim podacima putem API-ja (api)
- Izvršite zahtjeve u bilo kojem trenutku (refresh_token,offline_access)

Omogućavanje protoka
- Odaberite: Omogući protok nosača JWT
- Kliknite Učitaj datoteke i prenesite
server.crtdatoteku koja sadrži vaš digitalni certifikat.

Sigurnost
Poništite opciju Zah tijeva tajnu za tijek web poslužitelja.

- Kliknite gumb St vori.
- Promijenite u pravila kartica, a zatim kliknite gumb Uredi.
- Politike—Pravila OAuth
- Pravila dodataka
- Dozvoljeni korisnici: odaberite Korisnici odobreni od administratora unaprijed su ovlašteni
- Potvrdite promjenu
- Autorizacija aplikacije
- Pravila osvježavanja tokena: odaberite Odmah istekne token osvježavanja
- Opuštanje IP-a: odaberite Provedite IP ograničenja

- Pravila dodataka
- Politike—Pravila aplikacija
- Početna stranica - nema
- Odaberite Skupove dopuštenja—dodijelite skup dopuštenja stvoren prije ("IVR pristup SCV Apex klasama")

- Kliknite S premi.
- Promijenite u Postavke kartice.
-
Odjeljak Postavke OAuth, kliknite gumb Korisnički ključ i Taj na; pričekajte e-poštu i potvrdite svoj identitet. Nova kartica preglednika otvara zaslon s pojedinostima o potrošaču.

- Kliknite Kopira j i spremite potrošački ključ. Potrošački ključ kasnije se
koristi za stvaranje Salesforce konektora na Webex Contact Center Control Hub.

-
Webex Contact Center Konfiguracija i skripta za stvaranje zapisa glasovnih poziva
Da biste dobili punu vrijednost Salesforce Service Cloud Voice, protok poziva u Webex kontaktnom centru mora se izmijeniti kako bi se stvorio zapis glasovnog poziva u Service Cloud Voice čim poziv stigne u kontakt centar.
Opcijski Omni-Flow može se izvršiti za usmjeravanje odluka i automatizaciju u Salesforceu.
Pojedinosti o korištenim API-jima potražite u odjel jku Service Cloud Voice API Wrapper.
Preduvjeti
Da biste koristili Service Cloud Voice API Wrapper, morate konfigurirati Salesforce External Client App za integraciju IVR -a.
Konfigurirajte Salesforce konektor u Webex Control Hub
| 1 |
Prijavite se u svoju korisničku organizaciju na https://admin.webex.com i id ite na Usluge > Kontakt centar> Postavke stanara > Integracije> Konektori. |
| 2 |
Na kartici Salesforce kliknite Postavi ili Dodaj konektor.
IMPORTANT: MAINTAIN SECURITY BY PERIODICALLY ROTATING SECRETS Obavezno redovito rotirajte privatni ključ i certifikat kako bi integracije bile sigurne. Ažurirajte privatni ključ u konektoru kontaktnog centra u Webex Hu bu i certifikat u aplikaciji vanjskog klijenta u Salesforceu. Savjet za rješavanje problema Nakon što kliknete Gotovo, a priključak se ne sprema:
|
Glavni protok Webex kontaktnog centra
| Promjenjiva protoka | Opis |
|---|---|
| Varijabilna protoka za ID zapisa glasovnog poziva | Jedinstveni ID za identifikaciju poziva. Potrebno za stvaranje
zapisa glasovnog poziva. Format: wxcc_ <Interaction Id> Primjer: wxcc_fc4ec7d8 -4c91-49aa-b764-081fbba344a8
|
| Lokalna varijabla za vrijeme početka poziva |
Koristi se za stvaranje zapisa glasovnog poziva i prilikom ažuriranja glasovnog poziva.
|
| Lokalna varijabla za ime čeka/id |
Vraća ga Execute Omni Flow, koristi se za usmjeravanje poziva. Ova je varijabla potrebna samo kada se koristi Execute Omni Flow
|
| Lokalna varijabla za ime/id agenta |
Vraća ga Execute Omni Flow, koristi se za usmjeravanje poziva. Ova je varijabla potrebna samo kada se koristi Execute Omni Flow
|
Pregled glavnog toka

- Generirajte pozivni ključ dobavljača
- Postavite vrijeme početka poziva
- HTTP zahtjev: Stvorite zapis glasovnog poziva
- Procijenite HTTP odgovor za stvaranje zapisa glasovnog poziva
- Rukovanje pogreškama za Stvaranje zapisa glasovnog poziva
- HTTP zahtjev: Izvršite Omni Flow
- Procijenite HTTP odgovor za Execute Omni Flow
- Rukovanje pogreškama za Execute Omni Flow
- Nastavite s usmjeravanjem poziva
| protok | Opis |
|---|---|
| Generirajte pozivni ključ dobavljača |
Svaki poziv obrađen u usluzi Service Cloud Voice stvara zapis glasovnog poziva u Salesforceu i zahtijeva jedinstveni ID pod nazivom Vendor Call Key. Za zapise glasovnih poziva stvorene u Webex kontaktnom centru, ključ poziva dobavljača mora biti definiran u protoku wxCC, a zatim zajedno s pozi vom proslijeđen agentu pomoću varijable protoka. Vrijednost VendorCallKey mora biti u skladu sa sljedećim pravilima:
|
| Postavite vrijeme početka poziva |
UTC vremenska oznaka vremena početka poziva. Ova vremenska oznaka koristi se za stvaranje zapisa glasovnog poziva i za ažuriranje zapisa glasovnog poziva ako se pozivatelj prekine prije nego što bude usmje ren agentu.
|
| HTTP zahtjev: Stvorite zapis glasovnog poziva |
Ovaj korak je potreban za svaki poziv. Nakon stvaranja zapisa glasovnog poziva, ID zapisa glasovnog poziva mora se proslijediti s pozivom agentu u varijabli, zajedno s tipkom za poziv dobavljača. Konfigurirajte korištenu varijablu u konfiguraciji Contact Center u programu Service Cloud Voice. |
| Postavke HTTP zahtjeva |
|
HTTP zahtjev: Stvorite zapis glasovnog poziva
Ovaj korak je potreban za svaki poziv. Nakon stvaranja zapisa glasovnog poziva, ID zapisa glasovnog poziva mora se proslijediti s pozivom agentu u varijabli, zajedno s tipkom za poziv dobavljača. Konfigurirajte korištenu varijablu u konfiguraciji Contact Center u programu Service Cloud Voice.
Postavke HTTP zahtjeva
- Oznaka aktivnosti: CreateVoiceCall
- Korištenje autentificirane krajnje točke: Omogućeno
- Priključ ak: Salesforce konektor stvoren u prethodnom koraku
-
Put zahtjeva:
/services/apexrest/cisco_wxcc_scv/voice/v1/createVoiceCall - Metoda: POST
- Vrsta sadržaja zahtjeva: Aplikacija/JSON
Tijelo zahtjeva
Prilikom izrade zapisa glasovnog poziva možete ažurirati i prilagođena polja u zapisu glasovnog poziva s podacima o pozivu. Ispod su dva primjera tijela zahtjeva, jedan sa svim obaveznim poljima, ali bez ažuriranja prilagođenih polja, i jedan s prilagođenim poljima.
Bez ažuriranja prilagođenih polja u zapisu glasov nog poziva:
{
"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"
}
]
}
Primjer s ažuriranjem prilagođenih polja u zapisu glasov nog poziva:
{
"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>\"}"
}
Parametri
| Naziv nekretnine | Vrijednost |
|---|---|
| CallCenterDevName | Kontakt centar Ime razvojnog programera |
| CertDevName | API Naziv certifikata (kako je konfigurirano u Contact Centru) |
| DobavljačCallkey | Jedinstveni ID poziva: {{SCV_VendorCallKey}} |
| do | Nazvani broj/DNIS: {{NewPhoneContact.DNIS}} |
| od | Broj poziva/Ani: {{NewPhoneContact.ANI}} |
| Vrijeme početka | UTC vremenska {{SCV_CallStartTime}}oznaka (postavlja se odmah nakon prihvaćanja
poziva u skripti) |
| CallAtributs |
Koristi Nemojte koristiti za ažuri Primjer:
|
Parsiranje postavki
- Vrsta sadržaja: JSON
- Izlazna varijab la: SCV_VoiceCallRecordId
-
Izraz putanje:
$.data.voiceCallId
ID zapisa glasovnog poziva, koji će se proslijediti agentu.
Procijenite HTTP odgovor za stvaranje zapisa glasovnog poziva
Provjerite HTTP status http zahtjeva za izradu glasovnog poziva:
- Oznaka: StatusCodeCreateVoiceCall
- Varijabil na: CreateVoiceCall.HttpStatusCode
Ako statusni kod == 200 => uspješno ostalo => zahtjev nije uspio, rukovanje pogreškama
Rukovanje pogreškama za Stvaranje zapisa glasovnog poziva
Samo za demonstraciju/ispravljanje pogrešaka reproducirajte poruku ovisno o http statusu koda.
Ako je Create Voice Call uspješno, nastavite s Execute Omni Flow. U suprotnom, nastav ite s usmjeravanjem poziva.
HTTP zahtjev: Izvršite Omni Flow (izborni korak)
Koristite Execute Omni-Flow kada želite:
- pokretanje automatiziranih zadataka, primjerice pretraživanje ili stvaranje zapisa i povezivanje zapisa sa zapis om glasovnog poziva
- pretražite zapise i napravite screenpop
- sinkronizirajte redove Salesforce i Cisco
- neka Service Cloud Voice donese odluku o usmjeravanju
Ovaj zahtjev uvijek vraća "red čekanja" ili "agenta" tamo gdje se poziv mora usmjeriti.
Nakon izvršenja ovog zahtjeva, pobrinite se da pošaljete Clear Routing ako se pozivatelj prekine prije nego što mu agent odgovori. Pogledajte Ti jek događaja Webex kontakt centra.
Postavke HTTP zahtjeva
- Oznaka aktivnosti: ExecuteOmniFlow
- Korištenje autentificirane krajnje točke: Omogućeno
- Priključ ak: Salesforce konektor stvoren u prethodnom koraku
- Put zahtjeva:
/services/apexrest/cisco_wxcc_scv/voice/v1/executeOmniFlow - Metoda: POST
- Vrsta sadržaja zahtjeva: Aplikacija/JSON
Tijelo zahtjeva
Osim potrebnih polja, možete proslijediti dodatne podatke kao ulazne varijable u Omni-Flow. Ispod su dva primjera tijela zahtjeva. Prvo bez dodatnih parametara protoka, samo obavezna polja, drugo s dvije ulazne varijable.
Primjer s parametrima Omni-Flow:
{
"callCenterDevName": "<Contact Center API name>",
"certDevName": "<cert dev name>",
"voiceCallId": "{{SCV_VoiceCallRecordId}}",
"dialedNumber": "{{NewPhoneContact.DNIS}}",
"flowDevName": "<flow api name>",
"fallbackQueue": "<fallback queue name>"
}
Primjer s ažuriranjem prilagođenih polja u zapisu glasov nog poziva:
{
"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"
}
}
Parametri
| Naziv nekretnine | Vrijednost |
|---|---|
| CallCenterDevName | Kontakt centar Ime razvojnog programera |
| CertDevName | API Naziv certifikata (kako je konfigurirano u Contact Centru) |
| VoiceCallid | ID zapisa glasovnog poziva, stvoren u prethodnom koraku:
{{SCV_VoiceCallRecordId}}
|
| Izbirani broj | Nazvani broj/DNIS: {{NewPhoneContact.DNIS}}
|
| FlowDevName | Ime razvojnog programera Omni-Flow za izvršenje |
| FallbackQueue | ID reda čekanja ili naziv API-ja čekanja rezervnog reda Salesforcea |
| Parametri unosa protoka |
Dodatni ulazi u Omni-Channel protok (par ključ-vrijednost). Primjer:
|
Parsiranje postavki
Red čekanja
- Vrsta sadržaja: JSON
- Izlazna varijab la: SCV_OmniFlowQueue
- Izraz putanje:
$.data.queue
"Red čekanja" vraćen iz Execute Omni-Flow može se koristiti za usmjeravanje.
Agent- Vrsta sadržaja: JSON
- Izlazna varijab la: SCV_OmniFlowAgent
- Izraz putanje:
$.data.agent
"Agent" vraćen iz Execute Omni-Flow, može se koristiti za usmjeravanje.
Procijenite HTTP odgovor za Execute Omni Flow
Provjerite HTTP status HTTP zahtjeva Execute Omni Flow http:
- Oznaka: StatusCodeExecuteOmniFlow
- Varijabil na: ExecuteOmniflow.httpStatusCode
Ako statusni kod == 200 => uspješno else => zahtjev nije uspio, rukovanje pogreškom.
Rukovanje pogreškama za Execute Omni Flow
Samo za demonstraciju/ispravljanje pogrešaka reproducirajte poruku ovisno o http statusu koda.
Ako je Execute Omni Flow uspješno, varijable SCV_OmniFlowQueue i SCV_OmniFlowAgent nisu postavljene. Odluka o usmjeravanju u toku poziva.
Nastavite s usmjeravanjem poziva
Nastavite u toku poziva, usmjerite poziv agentu. Opcionalno, koristite SCV_OmniFlowQueue i SCV_OmniFlowAgent za odabir reda čekanja i agenta.
Tijek događaja Webex kontakt centra
Ako pozivatelj prekine poziv prije nego što agent odgovori, moramo ažurirati Service Cloud Voice i prekinuti poziv.
- Ako je korišten Execute Omni-Flow, pošaljite Clear Routing da biste izbrisali usmjeravanje usluga na čekanju (PSR)
- Pošalji ažurirani glasovni poziv za ažuriranje vremena početka i završetka zapisa glasovnog poziva i za promjenu statusa iz Novo u Završeno

- PhoneContactended - Ovaj događaj se aktivira kada se poziv uživo prekine i svi sudionici budu uklonjeni.
- HTTP zahtjev: Obriši usmjeravanje
- HTTP zahtjev: Ažurirajte glasovni poziv
HTTP zahtjev: Obriši usmjeravanje
- Oznaka: ClearRouting
- Korištenje autentificirane krajnje točke: Omogućeno
- Priključ ak: Salesforce konektor stvoren u prethodnom koraku
- Put zahtjeva:
/services/apexrest/cisco_wxcc_scv/voice/v1/clearRouting - Metoda: POST
Vrsta sadržaja zahtjeva: Aplikacija/JSON
Tijelo zahtjeva
{
"callCenterDevName": "<Contact Center API name>",
"certDevName": "<cert dev name>",
"voiceCallId": "{{SCV_VoiceCallRecordId}}"
}
Parametri
| Naziv nekretnine | Vrijednost |
|---|---|
| CallCenterDevName | Kontakt centar Ime razvojnog programera |
| CertDevName | API Naziv certifikata (kako je konfigurirano u Contact Centru) |
| VoiceCallid | ID zapisa glasovnog poziva, stvoren u prethodnom koraku: SCV_VoiceCallRecordId |
Parsiranje postavki
Nijedan.
HTTP zahtjev: Ažurirajte glasovni poziv
- Oznaka: UpdateVoiceCall
- Korištenje autentificirane krajnje točke: Omogućeno
- Priključ ak: Salesforce konektor stvoren u prethodnom koraku
-
Put zahtjeva:
/services/apexrest/cisco_wxcc_scv/voice/v1/updateVoiceCall - Metoda: POST
- Vrsta sadržaja zahtjeva: Aplikacija/JSON
Tijelo zahtjeva
{
"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 }
}
Kada navedete oba startTimei endTime,
Salesforce izračunava CallDurationInSeconds. Ne ulazite
CallDurationInSecondsunutra callAttributes.
Parametri
| Naziv nekretnine | Vrijednost |
|---|---|
| CallCenterDevName | Kontakt centar Ime razvojnog programera |
| CertDevName | API Naziv certifikata (kako je konfigurirano u Contact Centru) |
| VoiceCallid | ID zapisa glasovnog poziva, stvoren u prethodnom koraku: SCV_VoiceCallRecordId |
| Vrijeme početka | UTC vremenska oznaka početka poziva {{SCV_CallStartTime}}(kako se koristi za
stvaranje zapisa glasovnog poziva) |
| Krajnje vrijeme | Trenutna UTC vremenska oznaka `{{now () |
| Isključiizdajstvo | Razlog za isključivanje poziva. Nekretnina isError
mora biti postavljena truena kako bi se pravilno prikazala. |
Parsiranje postavki
Nijedan.
Reference
- Stvorite privatni ključ i samostalno potpisani digital ni certifikat
- Konfigurirajte povezanu aplikaciju za Webex Contact Center Salesforce Connector
- Postavljanje integracijskih konektora za Webex kontakt centar - Salesforce
- Cisco Webex Contact CenterV odič za postavljanje i administraciju > Flow Designer
- Integracija telefonije REST API
Jezični prijevod
(Opcionalno) Omogući radni stol za prijevod
Ova je postavka primjenjiva samo ako koristite postavke jezika prijevoda.
| 1 |
Idite na Postavljanje → Radni stol za prijevod → Postavke jezika prijevoda. |
| 2 |
Kliknite O mogući da biste odabrali jezik prijevoda.
|
(Opcionalno) Omogući jezike samo za platformu
Ova je postavka primjenjiva samo za jezike koji nisu HR-US.
| 1 |
Idite na Postavljanje → Postavke tvrtke → Postavke jezika. |
| 2 |
Odaberite potrebne jezike. |
| 3 |
Odaberite sljedeće potvrdne okvire:
|
| 4 |
Spremite svoje promjene.
|
Aktivirajte jezik i odaberite korisnika (zadatak)
| 1 |
Idite na Postavljanje → Radni stol za prijevod → Postavke jezika prijevoda. |
| 2 |
Odaberite jezik i odaberite korisnika koji će ga prevesti. |
| 3 |
Spremite svoje promjene.
|
Višejezične postavke
Prevedi prilagođene oznake
| 1 |
Idite na Postavljanje → Prilagođene naljepnice. |
| 2 |
Odaberite naziv prilagođene naljepnice koju želite otvoriti.
|
| 3 |
Na popisu povezanih prijevoda kliknite za |
| 4 |
Odaberite jezik na koji prevodite.
|
| 5 |
Unesite prevedenu vrijednost u polje Tekst prijevoda. Ovaj tekst nadjačava vrijednost navedenu u polju Vrijednost oznake kada je korisnikov zadani jezik prijevoda. |
| 6 |
Spremite svoje promjene. |
Salesforce dozvole potrebne korisničkoj funkciji
Skup dopuštenja agenta Webex Contact Center SCV sadrži sva dopuštenja potrebna za rad s gadgetom Webex Contact Center i integracije razvijene za agente.
Pristup klasi Apex (odjeljak)
- cisco_wxcc_scv.ciscoscVwxCC
- cisco_wxcc_scv.ServiceResponseHandler
- cisco_wxcc_scv.ServiceIzlet
- cisco_wxcc_scv.TelephonyIntegrationHandler
Prilagođeni pristupi vrsti metapodataka (odjeljak)
- cisco_wxcc_scv.wxCC veza
Pristup stranici Visualforce (odjeljak)
- cisco_wxcc_scv.ciscosCvlogInWxCC
- cisco_wxcc_scv.ciscoscvMainWxCC
- cisco_wxcc_scv.ciscoscvoAuthRedirect
- cisco_wxcc_scv.ciscoscvswutovarivač
Usluga Cloud Voice API omotnica
Preduvjeti
Da biste koristili Service Cloud Voice API Wrapper, morate konfigurirati Salesforce External Client App za integraciju IVR -a.
Korištenje servisnog Cloud Voice API Wrappera
Service Cloud Voice (SCV) za Salesforce koristi REST API za integraciju telefonije za stvaranje i ažuriranje VoiceCalls, izvršavanje višekanalnih tokova i brisanje zapisa PendingServiceRouting povezanih s VoiceCallom. Ova usluga zahtijeva autorizaciju JWT-a i korištenje PATCH HTTP metode, koju trenutno ne podržava Cisco IP Interactive Voice Response (IVR).
Kako bi se pojednostavilo korištenje REST API-ja za integraciju telefoni je za SCV u (ne samo) IVR sustavu, dostupan je novi skup API-ja koji obavijaju postojeći Salesforce API i dostupni su izravno iz Salesforce Org gdje je instaliran Webex Contact Center for Service Cloud Voice paket.
Service Cloud Voice API Wrapper uklanja potrebu za autentifikacijom JWT tokena, provodi dodatne provjere podataka koje zahtijeva Salesforce API i poboljšava objekte odgovora.
Preuzmite Access_Token
Izvršite POST zahtjev na https://<your-domain-name>.my.salesforce.com/services/oauth2/token
Slanje sljedećih parametara u tijelo:
{
"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>"
}
Izvršite zahtjeve
URL instance mora sadržavati my.salesforce.com.
Primjer ispravnog URL-a instance: https://abc-123.my.salesforce.com
Korištenje bilo koje druge domene kao URL-a instance (tj. https://abc-123.lightning.force.com) rezultira 401 neovlaštenim statusom s vraćenim pogreš INVALID_SESSION_ID nim kodom .
Stvori glasovni poziv (odjeljak)
Stvara zapis VoiceCall koji sadrži sudionike (odnosno pozivatelja i primatelja) za zapis VoiceCall. Kada kreirate zapis VoiceCall, u Salesforceu se stvara razgovor. Ovaj API koristite samo u kontekstu u stvarnom vremenu, što znači da biste trebali pozvati ovaj API samo kada je poziv pokrenut. Ovaj API se također može koristiti za stvaranje zapisa VoiceCall za prijenos i konferencijske pozive uključivanjem parametra ParentVoiceCallid u korisni teret zahtjeva.
URI krajnje točke
< instance_url >/usluge/apexrest/ /glas/v1/createVoiceCall cisco_wxcc_scv
HTTP metoda
POST
zaglavlja
Autorizacija: Nositelj < > access_token
Vrsta sadržaja: aplikacija/json
Parametri
{
"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"
}
Koristi callAttributesse samo za prilagođena polja na objektu VoiceCall
.
Standardna polja glasovnog poziva, kao što su Descriptioni
CallDurationInSeconds, ne ažuriraju se.
callAttributes Da biste popunili
CallDurationInSeconds, navedite startTimei
endTimetako Salesforce može izračunati vrijednost.
Odgovor (uspješan)
{
"data": {
"voiceCallId": "00X000012345abc"
},
"errors": null,
"success": true
}
Odgovor (s pogreškama)
{
"data": null,
"errors": ["Error message 1", "Error message 2"],
"success": false
}
Ažurirajte glasovni poziv
Ažurira glasovni poziv nakon završetka poziva. Koristite ovaj API za ažuriranje parametara povezanih s pozivima koji nisu dostupni tijekom faze stvaranja VoiceCall. Update VoiceCall API je asinhrona operacija. Ne možete tražiti status API poziva.
Ova krajnja točka također se može koristiti za stvaranje glasovnog poziva čak i nakon završetka poziva. Ovo ponašanje korisno je u scenarijima u kojima želite zabilježiti zapis u Salesforceu za napuštene ili propuštene pozive ili za bilo koji drugi scenarij u kojem glasovni poziv već nije stvoren.
URI krajnje točke
< instance_url >/usluge/apexrest/ /glasov/v1/UpdatevoicePoziv cisco_wxcc_scv
HTTP metoda
POST
zaglavlja
Autorizacija: Nositelj < > access_token
Vrsta sadržaja: aplikacija/json
Parametri
{
"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
}
}
Detaljan opis parametara prihvaćenih ovim zahtjevom može se naći u službenoj dokument aciji Salesforcea u odjeljku "Parametri".
Odgovor (uspješan)
{
"data": {
"status": "pending"
},
"errors": null,
"success": true
}
Update VoiceCall API je asinhrona operacija. Ne možete tražiti status API poziva.
Odgovor (s pogreškama)
{
"data": null,
"errors": ["Error message 1", "Error message 2"],
"success": false
}
Izvršite Omni-flow
Izvršava Omni-Channel protok za usmjeravanje poziva. Prosljeđuje ID poziva (Salesforce VoiceCallid ili ContacTid dobavljača telefonije) kao parametre u tok i vraća upute za usmjeravanje agenta ili reda u tok kontakata. Prema zadanim postavkama, Service Cloud Voice koristi protok Omni-Channel (ili rezervni red) naveden za telefonski kanal koji odgovara biranom broju . Ako birani broj ne odgovara postojećem telefonskom kanalu, možete po želji postaviti novi birani broj, protok Omni-Channel i rezervni red čekanja kao ulaz ne parametre za ovaj API poziv.
Usluga Cloud Voice koristi ovaj redoslijed prioriteta za usmjeravanje poziva:
- Koristi postavke Omni-Channel Flow i Fallback Queue za telefonski kanal koji odgovara biranom broju. Protok ima prednost. Ako protok ne uspije, koristi se rezervni red.
- Koristi parametre FlowDevName i FallbackQueue navedene u pozivu Exec ute Omniflow API.
URI krajnje točke
< instance_url >/usluge/apexrest/ /glas/v1/ExecuteOmniFlow cisco_wxcc_scv
HTTP metoda
POST
zaglavlja
Autorizacija: Nositelj < > access_token
Vrsta sadržaja: aplikacija/json
Parametri
{
"callCenterDevName": "contactCenterDevName123",
"certDevName": "certDevName123",
"voiceCallId": "00X000012345abc",
"dialedNumber": "+18445791189",
"flowDevName": "Route_VoiceCall",
"fallbackQueue": "00G111222333444",
"flowInputParameters":
{
"Input1": "one",
"Input2": "two"
}
}
- Parametar VoiceCallid je Salesforce VoiceCallid ili ID kontakta dobavljača telefonije.
- Detaljan opis parametara prihvaćenih ovim zahtjevom može se naći u službenoj dokument aciji Salesforcea u odjeljku "Parametri".
Odgovor (uspješan)
{
"data": {
"queue": "queue info",
"agent": "agent info"
},
"errors": null,
"success": true
}
AGENT_INFOi QUEUE_INFO odgovaraju polju ExternalID u callCenterRoutingMap
Odgovor (s pogreškama)
{
"data": null,
"errors": ["Error message 1", "Error message 2"],
"success": false
}
Jasno usmjeravanje
Briše zapis PendingServiceRouting (PSR) za glasovni poziv. Ovaj API ne treba pozivati za većinu scenarija; PSR zapis se automatski briše kada se poziv više ne usmjerava. Međutim, postoje neki scenariji, poput propuštenih ili napuštenih poziva kada koristite partnerske telefonijske sustave gdje morate izričito pozvati ovaj API da biste izbrisali PSR zapis.
URI krajnje točke
< instance_url >/usluge/apexrest//glas/v1/ClearRouting cisco_wxcc_scv
HTTP metoda
POST
zaglavlja
Autorizacija: Nositelj < > access_token
Vrsta sadržaja: aplikacija/json
Parametri
{
"callCenterDevName": "contactCenterDevName123",
"certDevName": "certDevName123",
"voiceCallId": "00X000012345abc"
}
- Parametar VoiceCallid je Salesforce VoiceCallid ili ID kontakta dobavljača telefonije.
- Detaljan opis parametara prihvaćenih ovim zahtjevom može se naći u službenoj dokument aciji Salesforcea u odjeljku "Parametri".
Odgovor (uspješan)
{
"data": {
"status": "Success"
},
"errors": null,
"success": true
}
Odgovor (s pogreškama)
{
"data": null,
"errors": ["Error message 1", "Error message 2"],
"success": false
}
Prijevodi telefonskih brojeva
Različite interakcije između Service Cloud Voice i Webex Contact Center ovise o prijevodu telefonskih brojeva. Zbog međunarodnih razlika i aplikacija specifičnih za kupce, potreban je prilagodljivi alat za prijenos telefonskih brojeva iz formata A u format B.
Webex Contact Center for Service Cloud Voice rješenje automatski uklanja sve znakove osim brojeva, hashtagova (#), zvjezdica (*), zareza (,) i vodećih znakova plus (+). Također uklanja prvu pojavu (0). To će biti učinjeno PRIJE nego što se primijene prijevodi vašeg telefonskog broja.
Ovaj vodič opisuje kako konfigurirati prijevode telefonskih brojeva.
Polja
Prijevodi telefonskih brojeva pohranjeni su u poljima Name-Value. To vam omogućuje konfiguriranje ne ograničene količine pravila po značajci.
Konfiguracija se pohranjuje kao JSON niz.
Imajte na umu da je potrebno izbjeći zazore, npr.\ d+ postaje \\ d+.
{"Remove all characters but digits":"[1,17]->[^\\d]+","To internal number":"[7,17]->(\\d{7})(\\d{4})->$2"}
Polje Naziv tehnički se ne koristi. Tu je za dodavanje ljudskog čitljivog niza kako bi se brzo identificirala svrha ovog pravila. Dobra imena su na primjer: Uklonite sve vodeće nule, Dodaj vodeći plus itd.
Izrada pravila prijevoda
Pravila su navedena kao regularni izrazi. Da budemo precizniji: JavaScript implementacija regularnih izraza.
Dobar način za početak je čitanje RegExp dokumenta iz MDN web dokumenata.
Ipak, stvaranje složenih regularnih izraza često je glomazno. Stoga smo dodali dodatnu sintaksu kako bismo konfiguraciju učinili što jednostavnijom.
Donja slika prikazuje opću sintaksu pravila prijevoda telefonskog broja:
Predikat
Predikat se koristi za određivanje intervala koji definira duljinu broja koji se podudara.
Gornji predikat određuje da se svi brojevi duljine između 7 i 11 znakova (uključujući rubove+razmake) podudaraju.
Predikati uvijek odgovaraju izvornoj duljini broja. To pomaže u pojednostavljenju konfiguracije smanjenjem rizika od sudara pravila za unutarnje/vanjske brojeve.
Uzorak
Uzorak određuje format broja koji će odgovarati.
Gornji uzorak navodi da se broj mora sastojati samo od znamenki i odabire ih.
Selektor
Selektori definiraju konačni format broja. Ako je potrebno dodati znakove/znamenke koji izvorno nisu bili prisutni, ovo je mjesto za to.
Selektor je posljednji korak u izgradnji broja. Na temelju izlaza uzorka, selektor stvara novi broj.
Primjer 1
Sljedeći primjer prikazuje kako prenijeti broj primljen iz Kontakt centra u formatu 0319175200 u švicarski E164 format +41 31 917 52 00.
Ovaj primjer koristi dva pravila prijevoda (1. i 2.)
Prvo pravilo u ovom primjeru zapravo ne mijenja broj. Za brojeve duljine od 1 do 17 znakova bilo bi uklonjeno sve drugo osim znamenki. Budući da nema prisutnosti bez znamenki, ništa se ne mijenja.
Drugo pravilo vrijedi za brojeve koji su dugi točno 10 znakova (izvorno). 0319175200 odgovara i stoga se primjenjuje pravilo. Uzorak određuje da broj mora započeti skupinom od jedne znamenke (\ d {1}), nakon čega slijedi skupina od dvije znamenke (\ d {2}), nakon čega slijedi skupina od tri znamenke (\ d {3}) i tako dalje.
Selektor zatim pristupa grupama uzoraka kako bi definirao novi niz brojeva. To znači da $2 upućuje na prvo (\ d {2}) i stoga sadrži 31.
Primjer 2
Sljedeći primjer prikazuje kako prenijeti broj primljen iz Kontakt centra u formatu +14693150217 u američki format E164 +1 469 315 0217.
Ovaj primjer koristi dva pravila prijevoda (1. i 2.)
- Ovaj broj je dug točno 12 znakova, pa se primjenjuje pravilo "Dodaj razmake u američke brojeve".
- (\ +1) kaže da broj mora početi sa +1. Ako je broj dug 12 znakova, ali ne počinje sa +1, pravilo se poništava i ništa se ne mijenja.
- (\ d {3}) kaže da +1 moraju slijediti 3 znamenke.
- (\ d {3}) kaže da posljednje 3 znamenke moraju slijediti još 3 znamenke.
- (\ d {4}) kaže da posljednje 3 znamenke moraju slijediti 4 znamenke.
Ako se nešto od ovoga ne podudara, broj se neće mijenjati.
Dakle, sva pravila vrijede za "+14693150217". Stoga se broj mijenja sa "$1 $2 $3 $4":
- $1 odnosi se na grupu (\ +1), broj za slanje na Service Cloud Voice izgleda kao +1.
- $2 odnosi se na prvi od dva (\ d {3}), broj za slanje na Service Cloud Voice izgleda kao +1 469.
- $3 odnosi se na drugi od dva (\ d {3}), broj za slanje na Service Cloud Voice izgleda kao +1 469 315.
- $4 odnosi se na zadnju grupu (\ d {4}), broj za slanje na Service Cloud Voice izgleda kao +1 469 315 0217.
Razmaci u zamjenskom dijelu pravila "$1 $2 $3 $4" koriste se izravno. Dakle, ako koristite "$1-$2-$3-$4" broj bi se preveo na: +1-469-315-0217
Također možete ukloniti grupe: [12, 12] -> (\ +1) (\ d {3}) (\ d {3}) (\ d {4}) ->$2 $3 $4 bit će prevedeno na: 469 315 0217. [12, 12] -> (\ +1) (\ d {3}) (\ d {3}) (\ d {4}) -> $3 $4 bit će prevedeno na: 315 0217.
Također je moguće pretvoriti međunarodni američki broj u lokalni poput: [12, 12] -> (\ +1) (\ d {3}) (\ d {3}) (\ d {4}) -> ($2) $3-$4.
Tada će dolazni broj "+14693150217" biti preveden na: (469) 315-0217.
Primjer 3
Sljedeći primjer prikazuje kako prenijeti broj primljen iz Kontakt centra u formatu +491515555531 u njemački format E164 +49 151 5555 531.
Ovaj primjer koristi dva pravila prijevoda (1. i 2.)
- Ovaj broj je dug točno 13 znakova, pa se primjenjuje pravilo "Dodaj razmake njemačkim brojevima".
- (\ +49) kaže da broj mora početi sa +49. Ako je broj dug 13 znakova, ali ne počinje s +49, pravilo se poništava i ništa se ne mijenja.
- (\ d {3}) kaže da +49 moraju slijediti 3 znamenke.
- (\ d {4}) kaže da posljednje 3 znamenke moraju slijediti 4 znamenke.
- (\ d {3}) kaže da posljednje 4 znamenke moraju slijediti 3 znamenke.
Ako se nešto od ovoga ne podudara, broj se neće mijenjati.
Dakle, sva pravila vrijede za "+491515555531". Stoga se broj mijenja sa "$1 $2 $3 $4":
- $1 odnosi se na grupu (\ +49), broj za slanje na Service Cloud Voice izgleda kao +49.
- $2 odnosi se na prvi od dva (\ d {3}), broj za slanje na Service Cloud Voice izgleda kao +49 151.
- $3 odnosi se na drugi od dva (\ d {4}), broj za slanje na Service Cloud Voice izgleda kao +49 151 5555.
- $4 odnosi se na zadnju grupu (\ d {3}), broj za slanje na Service Cloud Voice izgleda kao +49 151 5555 531.
Isto vrijedi i za pravilo 1. Možete koristiti zamjenski dio $1 $2 $3 $4 da biste odabrali što ćete koristiti iz broja.
Više primjera Regexa za prijevod
| Opis | Prijevod Regex |
|---|---|
| Uklonite sve znakove osim znamenki | [1,17] -> [^\ d] + |
| Uklonite sve znakove osim znamenki & + | [1,17] -> [^+\ d] + |
| Opis | Prijevod Regex |
|---|---|
| Ukloni +1 | [12,12] -> (. {1}) (\ d {1}) (\ d {10}) ->$3 |
| Ukloni +1 | [10,12] -> (^\ +1+) (\ d+) -> $2 |
| Ukloni +49 | [10,15] -> (^\ +49+) (\ d+) -> $2 |
| Ukloni +49 | [10,15] -> (. {1}) (\ d {2}) (\ d {9}) ->$3 |
| Ukloni +41 | [10,13] -> (^\ +41+) (\ d+) -> $2 |
| Ukloni +41 | [10,13] -> (. {1}) (\ d {2}) (\ d {9}) ->$3 |
| Ukloni+XX | [10,14] -> (^\ ++) (\ d {2}) (\ d+) -> $3 |
| Opis | Prijevod Regex |
|---|---|
| Uklonite + i zamijenite ga nulama US E164 | [10,12] -> (. {1}) (\ d {1}) (\ d {10}) -> 001 $3 |
| Uklonite +1 i zamijenite ga nulama US E164 | [10,12] -> (^\ +1+) (\ d+) -> 001$2 |
| Uklonite + i zamijenite ga nulama DE E164 | [12,15] -> (. {1}) (\ d {2}) (\ d {10}) -> 0049 $3 |
| Uklonite +49 i zamijenite ga nulama DE E164 | [10,12] -> (^\ +49+) (\ d+) -> 0049$2 |
| Uklonite + i zamijenite ga nulama CH E164 | [10,13] -> (. {1}) (\ d {2}) (\ d {9}) -> 0041 $3 |
| Uklonite +41 i zamijenite ga nulama CH E164 | [10,12] -> (^\ +41+) (\ d+) -> 0041$2 |
| Opis | Prijevod Regex |
|---|---|
| Američki broj s prostorom | [12,17] -> (\ d {1}) (\ d {3}) (\ d {3}) (\ d {4}) ->+1 $2 $3 $4 |
| Američki broj s prostorom | [12,17] -> (\ +1) (\ d {3}) (\ d {3}) (\ d {4}) ->$1 $2 $3 $4 |
| DE broj s razmakom | [12,17] -> (\ d {2}) (\ d {3}) (\ d {4}) (\ d {3}) ->+49 $2 $3 $4 |
| DE broj s razmakom | [12,17] -> (\ +49) (\ d {3}) (\ d {4}) (\ d {3}) ->$1 $2 $3 $4 |
| CH broj s razmakom | [12,17] -> (\ d {2}) (\ d {2}) (\ d {3}) (\ d {2}) (\ d {2}) ->+41 $2 $3 $4 |
| CH broj s razmakom | [12,17] -> (\ +41) (\ d {2}) (\ d {3}) (\ d {2}) (\ d {2}) ->$1 $2 $3 $4 |
Konfiguracija stranice VoiceCall
Konfigurirajte stranicu zapisa VoiceCall
Stranica zapisa VoiceCall dolazi prema zadanim postavkama unaprijed konfigurirana, s rasporedom u 3 stupca i sljedećim komponentama:
- Akcije i preporuke
- Napomene o pozivu
- Detalji poziva
- Snimke
Komponente se mogu slobodno ukloniti ili dodati na stranicu, ovisno o poslovnim potrebama. Mogu se koristiti i različiti rasporedi stranica, ali neke komponente, poput uređaja za snim anje poziva i tijela razgovora, mogu stati samo na srednja i velika područja predloška.
Prikaz komponente Wrap-Up Reason
Komponenta Wrap-Up Reason mora biti prikazana tijekom poziva i tijekom završetka.
Dodajte komponentu Cisco Wrap-Up Reason na stranicu zapisa VoiceCall:
- Povucite web-komponentu Cisco Wrap-Up Reas on Lightning iz područja Prilagođeno na popisu Lightning Components na stranicu zapisa VoiceCall Record.
- Kliknite S premi.
- Kliknite Aktiviraj.
- Kliknite Dod jeli kao zadano uređenje.
- Kliknite S premi.
- Ponovno kliknite Spremi, a zatim kliknite strelica Natra g da biste se vratili na stranicu.
Komponenta Cisco Wrap-Up Reason automatski će se prikazati tijekom poziva i tijekom Wrap Up:
Ako se doda na stranicu, komponenta Cisco Wrap-Up Reason prikazuje se za svaki poziv, također ako nije konfiguriran nikakav Wrap-Up u Cisco Contact Centru.
Prikažite uređaj za snimanje poziva
Igrač za snimanje poziva prikazat će se ako je spremljena veza za snimanje za odgovarajući glasovni poziv.
Slijedite ove korake da biste dodali komponentu Player za snimanje poziva na stranicu za snimanje glasovnog poziva:
- Povucite web-komponentu Lightning Player za snimanje poziva na stranicu za snimanje glasovnog poziva
- Kliknite S premi.
- Kliknite Aktiviraj.
- Kliknite Dod jeli kao zadano uređenje.
- Kliknite S premi.
- Ponovno kliknite Spremi, a zatim kliknite strelica Natrag da biste se vratili na stranicu.
Webex administratori
Konfiguracija protoka
Pop zaslon
Čvor "Screen Pop" dostupan je u Webex Contact Center Flow. Može se koristiti za pokretanje skočnog zaslona unutar Service Cloud Voice ili u zasebnom prozoru.
Dodatne informacije o ovoj funkciji mogu se naći u dokumentaciji Flow Designer .
Screen Pop u zasebnom prozoru
Da biste otvorili skočni ekran u zasebnom prozoru, apsolut ni URL mora biti naveden u č voru "Screen Pop". QueryParameters bit će dodani kao parametri pretraživanja URL-u.
Podržani su sljedeći načini rada:
- Nova kartica preglednika - Uvijek otvara novu karticu preglednika.
- Postojeća kartica preglednika - Na prvom iskačućem zaslonu kartice Postojeći preglednik otvara se nova kartica preglednika. Ta će kartica biti namjenska kartica za naknadne iskačuće prozore postojećih kartica preglednika, a URL će se osvježiti unutar te određene kartice preglednika.
- Unutar radne površine - obrađuje se na isti način kao i Nova kartica preglednika.
Trenutno otvorena stranica može spriječiti preusmjeravanje. U tom se slučaju na novoj kartici preglednika otvori iskačući zaslon kartice Postojećeg preglednika.











