- Početak
- /
- Članak
Webex kontaktni centar za Salesforce Service Cloud Voice integrira Ciscovu robusnu CCaaS (kontaktni centar kao usluga) sa Salesforceovim CRM-om, omogućujući tvrtkama upravljanje višekanalnim interakcijama s kupcima (glasovne, digitalne) unutar Salesforce sučelja, koristeći Webex umjetnu inteligenciju za virtualne agente, transkripciju i inteligentno usmjeravanje, transformirajući agente u "super-agente" s objedinjenim podacima za bolja korisnička iskustva.
Pregled
Webex kontaktni centar za Salesforce Service Cloud Voice
Webex Contact Center za Service Cloud Voice je rješenje za integraciju koje je spremno za korištenje i donosi snagu Webex Contact Centra u Salesforce Service Cloud Voice Omni-channel agentsku konzolu.
Prije nego što nastavite s instalacijom, pogledajte sljedeći odjeljak:
kako biste saznali više o preduvjetima i ograničenjima Salesforce Service Cloud Voicea i osigurali da je vaša Salesforce organizacija spremna za omogućavanje i instaliranje paketa Webex Contact Center for Service Cloud Voice.
Preduvjeti i ograničenja
Preduvjeti (podtema)
Korisnička sučelja: Usluga Cloud Voice dostupna je samo u Salesforce Lightning Experienceu.
Usluga Cloud Voice dostupna je u ovim izdanjima.
- Poduzeće
- Neograničeno
- Razvojni programer
Licence
-
Korisnici moraju kupiti novu dodatnu licencu A-SF-VOICE po prijavljenom agentu uz standardne ili premium licence Flex 3 za Webex kontaktni centar. Za više informacija pogledajte vodič za naručivanje Flex 3.
- Salesforce Voice za partnersku telefoniju
Prije nego što uključite Voice, morate postaviti potrebne usluge u svojoj organizaciji.
- Idi na Informacije o tvrtki > Licenca za skup dopuštenja
- Provjerite Korisnik usluge Cloud Voice (Partnerska telefonija).
Sva razvojna izdanja sada dolaze s 5 partnerskih licenci za telefoniju dostupnih za testiranje.
- Provjerite Korisnik usluge Cloud Voice (Partnerska telefonija).
- Alternativno, to možete provjeriti tako da odete na Salesforce Setup i potražite "voice" u lijevoj bočnoj traci.
- Ako se pojavi "Partnerski telefonski kontaktni centri", imate SCV licencu.
- Ako opcija "Kontakt centri partnerske telefonije" nije vidljiva, tada "Omogući uslugu Cloud Voice" slijedeći korake u nastavku.
- Idite na Salesforce Setup (Postavljanje Salesforcea), pretražite i odaberite "Partner Telephony Setup (Postavljanje partnerske telefonije) " i prebacite gumb na "Enable Service Cloud Voice (Omogući uslugu Cloud Voice).
- Omogućite Omni-Channel kako biste svojim agentima omogućili upućivanje i primanje poziva.
- Idite na Salesforce Setup (Postavljanje Salesforcea), pretražite i odaberite "Partner Telephony Setup (Postavljanje partnerske telefonije) " i prebacite gumb na "Enable Service Cloud Voice (Omogući uslugu Cloud Voice).
Omogući Omni-Channel
Ako je Omni-Channel već omogućen u vašoj organizaciji, preskočite ovaj korak.
- U odjeljku Postavke unesite Postavke više kanala u okvir Brzo pretraživanje, a zatim odaberite Postavke više kanala.


- Odaberite Omogući višekanalni pristup.
- Kliknite na Spremi.
Ograničenja
- Glas je dostupan samo u Lightning Experienceu.
- Glas je podržan na Service Cloudu i Sales Cloudu kao dodatna licenca.
- Glas nije podržan na Salesforce Mobileu ili na iPadu u pregledniku Safari.
- Glasovne naredbe podržavaju samo web preglednici 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 strogo regulirana, stoga se obratite svom predstavniku Salesforcea o dostupnosti Voicea u vašoj regiji.
Zahtjevi
Kodovi praznog hoda
Pronađite kodove neaktivnosti
| 1 |
Prijavite se na Upravljački portal. |
| 2 |
Idi na Kontaktni centar > ISKUSTVO NA RAČUNALU > Idle/Wrap-up Kodovi. |
| 3 |
Provjerite jesu li prikazani kodovi neaktivnosti, u suprotnom kliknite padajući gumb filtra i odaberite Kod neaktivnosti na vrhu stranice. |
| 4 |
Kliknite na kod u mirovanju za otvaranje detaljnog prikaza. Tamo možete pronaći ID koda neaktivnosti.
ID-ovi se mogu kopirati i zatim koristiti za konfiguraciju Mapiranje stanja prisutnosti. Jedan od ID-ova mora se koristiti kao zadani razlog za nespremnost Cisco uređaja. |
Integriraju
Instalacija
Prije nego što nastavite s instalacijom, pogledajte odjeljak Preduvjeti i ograničenja kako biste saznali više o preduvjetima i ograničenjima Salesforce Service Clouda.
Instalirajte i konfigurirajte Webex kontaktni centar za Service Cloud Voice
Kada se dobije licenca za Service Cloud Voice za partnersku telefoniju, u izborniku Postavke pojavljuje se stranica Postavljanje partnerske telefonije.
Dodatne informacije možete pronaći u službenoj referenci Salesforcea ( izravna poveznica).
| 1 |
Iz Postavljanja unesite |
| 2 |
Omogući Uključi glas s partnerskom telefonijom. Stranica Kontaktni centri partnerske telefonije pojavljuje se u izborniku Postavke. Ako planirate implementirati paket u Salesforce sandboxu, zamijenite dio |
Instalirajte paket
Za instalaciju paketa:
| 1 |
Otvorite priloženu poveznicu paketa za početak instalacije. |
| 2 |
Prijavite se u Salesforce organizaciju u koju treba instalirati paket. |
| 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 paketom Webex Contact Center for Service Cloud Voice. Osim toga, dodijelite im ova dopuštenja; skupovi dopuštenja koji dolaze s paketom Webex Contact Center for Service Cloud Voice pomažu u ovom procesu. Čarobnjak za instalaciju paketa – pojavljuje se početni ekran: Instalacijski paket nije izravno dostupan putem Salesforce AppExchangea. Korisnici moraju koristiti gumb 'Preuzmi odmah' na popisu AppExchangea, koji otvara kontaktni obrazac za zahtjev za poveznicu za instalaciju i aktivaciju Cisco proizvoda. |
| 4 |
Dodijelite sljedeće skupove dopuštenja barem jednom korisniku kako biste mogli stvoriti Kontaktni centar: |
| 5 |
Kliknite Postavi | Korisnici | Korisnici. |
| 6 |
Pretraži i odaberi korisnika. |
| 7 |
Pomaknite se prema dolje do "Dodjele skupa dozvola". |
| 8 |
Kliknite na Uredi zadatke |
| 9 |
Za administratore kontakt centra: dodijelite skup dopuštenja Administrator kontaktnog centra (telefonija partnera).
|
| 10 |
Za agente kontakt centra: dodijelite skup dopuštenja za agenta kontaktnog centra (partnerska telefonija) i skup dopuštenja za SCV agenta Webex kontaktnog centra.
Ne preporučuje se odabir opcije Instaliraj za sve korisnike, jer se time dodjeljuju sva dopuštenja (čitanje, stvaranje, uređivanje i brisanje) za komponente i objekte paketa svakom korisniku koji koristi prilagođeni korisnički profil. |
| 11 |
Dodijelite licencu paketa korisnicima za rad s Connects for Service Cloud Voice.
|
| 12 |
Alternativno, možete kliknuti na Postavi | Korisnici | Korisnici.. |
| 13 |
Pretražite i odaberite korisnika. |
| 14 |
Pomaknite se prema dolje do Upravljani paketi. |
| 15 |
Kliknite Dodijeli licence. |
| 16 |
S popisa odaberite paket Webex Contact Center for Service Cloud Voice. |
| 17 |
Kliknite na Dodaj. |
| 18 |
Izradite Statuse prisutnosti kako biste definirali koji su servisni kanali dodijeljeni različitim statusima. Agenti se mogu prijaviti u Omni-Channel s različitim statusima ovisno o vrsti posla koji imaju pravo primiti. |
| 19 |
U odjeljku Postavke unesite |
| 20 |
Kliknite Novo. Kreirajte barem jedan status za "Online" i jedan za "Zauzet".
|
Dodijelite status(e) prisutnosti agentima
| 1 |
U odjeljku Postavljanje unesite Skupovi dozvola u okvir Brzo pretraživanje, a zatim odaberite Skupovi dozvola. |
| 2 |
Kliknite za otvaranje Skup dopuštenja za partnersku telefoniju. |
| 3 |
Kliknite Pristup statusima prisutnosti usluge. |
| 4 |
Kliknite Uredi. |
| 5 |
Na popisu Dostupne prisutnosti usluga odaberite prethodno kreirani status(e) prisutnosti i kliknite Dodaj da biste ih povezali sa skupom dopuštenja. Agenti koji su dodijeljeni ovom skupu dozvola mogu se prijaviti u Omni-Channel s bilo kojim od dostupnih statusa prisutnosti. |
| 6 |
Kliknite na Spremi. |
| 7 |
Kliknite Upravljanje zadacima na istoj stranici. Zatim kliknite Dodaj dodjelu u gornjem desnom kutu, odaberite željenog korisnika, kliknite Dalje, odaberite Opciju isteka za dodijeljene korisnike (nije obavezno) i zatim kliknite Dodijeli. Service Cloud Voice koristi vanjsku domenu za rad sa zapisom VoiceCall. Sljedeće URL-ove treba dodati u "Postavke udaljene lokacije" u Postavkama ( kliknite ovdje za otvaranje službene dokumentacije):
Primjer: Kako pronaći URL instance. |
| 8 |
Nakon prijave pogledajte URL u adresnoj traci preglednika. 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/,, tada je "orgfarm-54a38e30ad-dev-ed.develop" URL vaše instance. Primjer: URL izvorne organizacije: https://cisco.lightning.force.com Primjer: URL za dodavanje:
|
| 9 |
Uslužni program Omni-Channel potreban je u aplikaciji Lightning Service Console kako bi agent mogao koristiti Service Cloud Voice.
Službenu referencu tvrtke Salesforce možete pronaći klikom na gumb Napravimo ovo koji otvara stranicu Konfiguriraj iskustvo agenta za Service Cloud Voice s partnerskom telefonijom na portalu za pomoć Salesforcea ( izravna poveznica). |
| 10 |
U odjeljku Postavljanje unesite Postavljanje partnerske telefonije u okvir Brzo pretraživanje, a zatim odaberite Postavljanje partnerske telefonije. |
| 11 |
Pomaknite se prema dolje do odjeljka 5 Više postavki glasa. |
| 12 |
Da biste omogućili zaštitu od klikanja za Visualforce stranice s onemogućenim zaglavljima tijekom rada sa softphoneom u Lightning Experienceu, morate dodati domene s kojih se softphone i prilagođene alatne trake učitavaju kao pouzdane domene, uz URL instance Salesforcea. Ove postavke i popis pouzdanih domena mogu se pronaći pod Postavke | Sigurnost | Postavke sesije. Za dohvaćanje ispravne Visualforce domene, idite na Postavljanje | Prilagođeni kod | Visualforce stranice i kliknite gumb Pregled za Primjer: MyDomainName--cisco_wxcc_scv.vf.force.com Da biste dobili domenu instance Salesforcea, kopirajte URL prikazan u URL traci preglednika i dodajte ga na popis Pouzdane domene za popis umetnutih okvira odabirom Visualforce stranice kao vrste IFramea. Primjer: MyDomainName.lightning.force.com Ako u svojoj organizaciji nemate implementiranu Moju domenu, format URL-a je drugačiji. Ako imate implementiranu Moju domenu i poboljšane domene nisu omogućene u vašoj organizaciji, format URL-a je drugačiji. Ako poboljšane domene nisu omogućene, postavka Stabiliziraj URL-ove u Visualforceu, Experience Builderu, Site.com studiju i datotekama sadržaja Moja domena također utječe na ovaj format. Za detalje pogledajte Formati URL-ova moje domene u pomoći za Salesforce. Postavke zaštite od Clickjacka i pouzdanih domena za Lightning Experience |
| 13 |
Za prikaz kontrola snimanja tijekom poziva, agentima je potrebno dopuštenje aplikacije Da biste ga dodijelili, dodajte ga skupu dozvola stvorenom u koraku Statusi prisutnosti.
|
Konfiguracija
Contact Center
Datoteka definicije kontaktnog centra određuje skup polja i vrijednosti koje se koriste za definiranje kontaktnog centra u Salesforceu za određeni CTI sustav. Salesforce koristi datoteke definicije kontaktnog centra za podršku integraciji s više dobavljača CTI sustava.
Dodatne informacije možete pronaći u službenoj dokumentaciji Salesforcea ( izravna poveznica).
Uvoz kontaktnog centra
Preuzmite najnoviju verziju Kontakt centra ovdje.
Nadogradnja s Beta verzije: Ovaj vodič opisuje čistu instalaciju izdanja Opće dostupnosti (GA) integracije Webex kontaktnog centra za Salesforce Service Cloud Voice.
Ako nadograđujete s Beta verzije integracije, nemojte ponovno koristiti postojeći zapis Centra za kontakt s partnerima. Umjesto toga:
- Uvezite XML datoteku Centra za kontakt s partnerima koja je uključena u GA izdanje.
- Izradite novi zapis kontaktnog centra partnera pomoću uvezenog XML-a.
- Ažurirajte konfiguraciju kako biste koristili novoizrađeni Centar za kontakt s partnerima.
XML kontaktnog centra za partnere GA sadrži ažurirane vrijednosti konfiguracije, uključujući ispravan URL konektora i ostale metapodatke. Ponovna upotreba zapisa kontaktnog centra partnera stvorenog iz Beta XML-a može zadržati zastarjele vrijednosti konfiguracije i spriječiti ispravan rad integracije.
| 1 |
U odjeljku Postavljanje unesite Kontaktni centri partnerske telefonije u okvir Brzo pretraživanje, a zatim odaberite Kontaktni centri partnerske telefonije. Prikazuje se popis postojećih (ako ih ima) kontaktnih centara.
|
| 2 |
Kliknite Izradi kontaktni centar na desnoj strani stranice. |
| 3 |
Odaberite Webex Contact Center kao svog davatelja telefonskih usluga. Zatim kliknite Dalje. Otvara se preglednik datoteka.
|
| 4 |
Odaberite datoteku |
| 5 |
Kliknite Otvori. Datoteka je uvezena.
|
| 6 |
Provjerite je li vaš kontaktni centar prikazan na popisu kontaktnih centara. |
Konfigurirajte kontaktni centar
| 1 |
U odjeljku Postavljanje unesite Kontaktni centri partnerske telefonije u okvir Brzo pretraživanje, a zatim odaberite Kontaktni centri partnerske telefonije. | ||||||||||||||||||||||||||||||
| 2 |
Kliknite na prethodno uvezeni Kontaktni centar. | ||||||||||||||||||||||||||||||
| 3 |
Kliknite Uredi.
| ||||||||||||||||||||||||||||||
| 4 |
Na dnu stranice Kontaktni centar kliknite gumb Dodaj u odjeljku Korisnici kontaktnog centra. | ||||||||||||||||||||||||||||||
| 5 |
Klik + pored korisnika koji imaju pristup otvorenom Kontaktnom centru. Na ovom popisu prikazuju se samo korisnici koji imaju postavljeno dopuštenje |
Prilagodba
Aplikacija za vanjske klijente za integraciju Webex kontaktnog centra
Konfigurirajte aplikaciju vanjskog klijenta za Webex Contact Center Salesforce Connector
Kako bi se Service Cloud Voice iskoristio u potpunosti, tijek poziva kontaktnog centra može se prilagoditi za stvaranje zapisa glasovnog poziva i izvršavanje Salesforce Omni-Channel toka dok je poziv na IVR-u.
Izradi certifikat
Provjerite jeste li već izradili digitalni certifikat u skladu sa sigurnosnom politikom vaše organizacije.
Za generiranje digitalnog certifikata pogledajte dokumentaciju Salesforcea 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: -out server.pass.key 2048
openssl rsa -passin pass: -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 []:
An optional company name []:
openssl x509 -req -sha256 -days 365 -in server.csr -signkey server.key -out server.crt
poslužitelj.crt => Certifikat za Salesforce aplikaciju za vanjske klijente
poslužiteljski_ključ => Privatni ključ za Salesforce Connector u Webex Control Hubu
Postavljena dopuštenja za korisnika SCV integracije
Sljedeći skup dopuštenja daje pristup Apex klasama koje koristi Connects for SCV za integraciju s tokovima IVR-a kontaktnog centra i Webex Contact Center for Salesforce za SCV.
Slijedeći primjer konfiguracije opisuje minimalne potrebne dozvole za Kontaktni centar. / IVR integracija za rad.
- Iz Postavljanja idite na Korisnici | Skupovi dozvola.
- Kliknite na gumb Novo.
- Unesite oznaku, na primjer: IVR pristup SCV Apex tečajevima
- Naziv API-ja se automatski popunjava
- Licenca: Ništa
- Kliknite gumb Spremi.
- Otvara se novi skup dozvola.
- Idite na Pristup Apex klasi.
- Kliknite gumb Uredi i dodajte sljedeće Apex klase:
- cisco_wxcc_scv.ServiceRouting
- Idite na Dozvole sustava.
- Kliknite gumb Uredi i omogućite sljedeća dopuštenja:
- Apex REST usluge
- API omogućen
Minimalni pristup - profil integracija samo s API-jem
Ovaj se profil koristi za integraciju s Webex Contact Centerom za Salesforce za SCV kako bi se stvorili zapisi glasovnih poziva i izvršio Omni-Flow iz IVR toka.
Slijedeći primjer konfiguracije opisuje minimalne potrebne dozvole za Kontaktni centar. / IVR integracija za rad.
Ovo je klon profila Minimalni pristup - Integracije samo s API-jem.
- Iz Postavke idite na Korisnici | Profili.
- Na popisu Profili potražite Profil Minimalni pristup - Integracije samo s API-jem.
- Kliknite naziv profila da biste otvorili profil Minimalni pristup - Integracije samo s API-jem.
- Na profilu Minimalni pristup - Integracije samo s API-jem kliknite gumb Kloniraj.
- Unesite novi naziv profila, na primjer: Integracija SCV-a.
- Kliknite na gumb Spremi.
- Otvara se novi profil.
- Provjerite jesu li s vašeg profila Minimalni pristup – Integracije samo s API-jem uklonjena sva dopuštenja.
- Idite na Dozvole sustava.
- Provjerite jesu li omogućena sljedeća dopuštenja:
- API omogućen
- Korisnik samo API-ja
Korisnik SCV integracije
Slijedeći primjer konfiguracije opisuje minimalne potrebne dozvole za Kontaktni centar. / IVR integracija za rad. Za korisnika SCV integracije nije potrebna licenca za Salesforce Service Cloud Voice ili licenca za Webex Contact Center for Salesforce for SCV.
- Iz Postavljanja idite na Korisnici | Korisnici.
- Kliknite na gumb Novi korisnik.
- Unesite Ime, Prezime i sva ostala obavezna polja.
- Korisnička licenca: Integracija Salesforcea
- Profil: odaberite profil kreiran u prethodnom koraku ("SCV integracijski profil", klon profila Minimalni pristup - Integracije samo s API-jem)
- Kliknite na gumb Spremi.
- Otvorite novi zapis korisnika.
- Dodijelite skup dopuštenja koji je prethodno kreiran ("IVR pristup SCV Apex klasama").
- Dodijelite licencu skupa dopuštenja Integracija Salesforce API-ja.
Izradite aplikaciju za vanjske klijente Salesforcea
Izradite novu aplikaciju za vanjske klijente
Postoje dvije mogućnosti za povezivanje vaših Salesforce podataka s aplikacijama trećih strana. IPovezane aplikacijeiAplikacije vanjskih klijenatasu okviri za integraciju podataka. Aplikacije vanjskih klijenata su sljedeća generacija povezanih aplikacija.
Za konfiguriranje aplikacije Salesforce External Client koju koristi Cisco Webex Contact Center:
- Iz Postavkeidite naAplikacije | Aplikacije vanjskog klijenta | Upravitelj aplikacija vanjskog klijenta.
- Kliknite naNova vanjska klijentska aplikacija.
- Aplikacija vanjskog klijenta - osnovne informacije
- Naziv aplikacije vanjskog klijenta: WxCC - SCV
- Naziv API-ja: WxCC_SCV
- E-pošta za kontakt: < your email >
- Stanje distribucije: odaberite Lokalno

Vanjska klijentska aplikacija—API (Omogući postavke OAuth)
- Odaberite: Omogući OAuth
- Postavke aplikacije
- Povratni poziv URL: http://localhost:1717/OauthRedirect as primjer URL-a povratnog poziva
- Opsezi OAuth-a
- Odaberite OAuth opsege:
- 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 JWT protok nosača
- Kliknite Prenesi datoteke i prenesite datoteku
server.crtkoja sadrži vaš digitalni certifikat.

Sigurnost
Poništite odabir opcije Zahtijevaj tajnu za tijek web poslužitelja.

- Kliknite na gumbIzradi.
- Promijenite na Pravila kartice, a zatim kliknite gumbUredi.
- Pravila – Pravila OAuth-a
- Pravila o dodacima
- Dozvoljeni korisnici: odabrani korisnici koje je odobrio administrator su prethodno autorizirani
- Potvrdite promjenu
- Autorizacija aplikacije
- Pravila osvježavanja tokena: odaberite Odmah istekni token za osvježavanje
- Opuštanje IP-a: odaberite Primijeni ograničenja IP-a

- Pravila o dodacima
- Pravila – Pravila aplikacije
- Početna stranica - nema
- Odaberite skupove dopuštenja – dodijelite skup dopuštenja koji je prethodno kreiran ("IVR pristup SCV Apex klasama")

- Kliknite na Spremi.
- Promijeni u Postavke kartice.
-
U odjeljku Postavke OAuth kliknite gumbKljuč potrošača i Tajna; pričekajte e-poštu i potvrdite svoj identitet. Nova kartica preglednika otvara zaslon s podacima o potrošaču.

- Kliknite Kopiraj i spremiteKljuč potrošača. Ključ potrošača se kasnije koristi za stvaranje Salesforce konektora na Webex Contact Center Control Hubu.

-
Konfiguracija i skripta Webex kontakt centra za izradu zapisa glasovnih poziva
Da biste iskoristili punu vrijednost Salesforce Service Cloud Voicea, tijek poziva u Webex kontaktnom centru mora se izmijeniti kako bi se zapis glasovnog poziva u Service Cloud Voiceu stvorio čim poziv stigne u kontaktni centar.
Za donošenje odluka o usmjeravanju i automatizaciju u Salesforceu može se izvršiti opcionalni Omni-Flow.
Za detalje o korištenim API-jima pogledajte Service Cloud Voice API Wrapper.
Preduvjeti
Za korištenje Service Cloud Voice API Wrappera, potrebno je konfigurirati Salesforce vanjsku klijentsku aplikaciju za IVR integraciju.
Konfigurirajte Salesforce konektor u Webex Control Hubu
Postavite Salesforce Integration Connectors za Webex kontaktni centar kako je opisano u članku na https://help.webex.com/en-us/article/7fuy63/Set-Up-Integration-Connectors-for-Webex-Contact-Center#id_133211.
| 1 |
Prijavite se u svoju korisničku organizaciju na https://admin.webex.com i idite na Usluge > Kontaktni centar > Postavke najmoprimca > Integrations>Connectors. |
| 2 |
Na kartici Salesforce kliknite Postavi ili Dodaj konektor.
VAŽNO: ODRŽAVAJTE SIGURNOST PERIODIČNOM ROTIRAJUĆOM TAJNOM Redovito rotirajte svoj privatni ključ i certifikat kako biste osigurali sigurnost svojih integracija. Ažurirajte privatni ključ u konektoru kontaktnog centra u Webex Hubui certifikat u aplikaciji vanjskog klijenta u Salesforceu. Savjet za rješavanje problema Nakon što kliknete Gotovo, a konektor se ne spremi:
|
Glavni tok Webex kontaktnog centra
| Varijabla protoka | Opis |
|---|---|
| Varijabla 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 red čekanja name/id |
Vraćeno od strane Izvrši Omni Flow, koristi se za usmjeravanje poziva. Ova varijabla je potrebna samo pri korištenju Execute Omni Flow
|
| Lokalna varijabla za agenta name/id |
Vraćeno od strane Izvrši Omni Flow, koristi se za usmjeravanje poziva. Ova varijabla je potrebna samo pri korištenju Execute Omni Flow
|
Pregled glavnog toka

- Generiraj ključ poziva dobavljača
- Postavi vrijeme početka poziva
- HTTP zahtjev: Izradi zapis glasovnog poziva
- Procijenite HTTP odgovor za stvaranje zapisa glasovnog poziva
- Rješavanje pogreške pri stvaranju zapisa glasovnog poziva
- HTTP zahtjev: Izvrši Omni Flow
- Procijenite HTTP odgovor za izvršavanje Omni Flow-a
- Rješavanje pogrešaka za Izvršavanje Omni Flow-a
- Nastavi s usmjeravanjem poziva
| Tijek | Opis |
|---|---|
| Generiraj ključ poziva dobavljača |
Svaki poziv obrađen u Service Cloud Voiceu stvara zapis glasovnog poziva u Salesforceu i zahtijeva jedinstveni ID pod nazivom Ključ poziva dobavljača. Za zapise glasovnih poziva kreirane u Webex kontaktnom centru, ključ poziva dobavljača mora biti definiran u WxCC toku, a zatim proslijeđen zajedno s pozivom agentu pomoću varijable toka. Vrijednost vendorCallKey mora biti u skladu sa sljedećim pravilima:
|
| Postavi 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 pozivatelj prekine vezu prije nego što bude preusmjeren agentu.
|
| HTTP zahtjev: Izradi zapis glasovnog poziva |
Ovaj korak je potreban za svaki poziv. Nakon što se kreira zapis glasovnog poziva, ID zapisa glasovnog poziva mora se proslijediti agentu s pozivom u varijabli, zajedno s ključem poziva dobavljača. Konfigurirajte korištenu varijablu u konfiguraciji kontaktnog centra u Service Cloud Voiceu. |
| Postavke HTTP zahtjeva |
|
HTTP zahtjev: Izradi zapis glasovnog poziva
Ovaj korak je potreban za svaki poziv. Nakon što se kreira zapis glasovnog poziva, ID zapisa glasovnog poziva mora se proslijediti agentu s pozivom u varijabli, zajedno s ključem poziva dobavljača. Konfigurirajte korištenu varijablu u konfiguraciji kontaktnog centra u Service Cloud Voiceu.
Postavke HTTP zahtjeva
- Oznaka aktivnosti: CreateVoiceCall
- Koristi autentificiranu krajnju točku: Omogućeno
- Priključak: Salesforce konektor stvoren u prethodnom koraku
- Put zahtjeva:
/services/apexrest/cisco_wxcc_scv/voice/v1/createVoiceCall - Metoda: OBJAVA
- Vrsta sadržaja zahtjeva: Application/JSON
Tijelo zahtjeva
Prilikom stvaranja zapisa glasovnog poziva, možete ažurirati i prilagođena polja u zapisu glasovnog poziva podacima o pozivu. U nastavku su dva primjera tijela zahtjeva, jedan sa svim potrebnim poljima, ali bez ažuriranja prilagođenih polja, i jedan s prilagođenim poljima.
Bez ažuriranja prilagođenih polja u zapisu glasovnog poziva:
{
"callCenterDevName": "",
"certDevName": "",
"vendorCallKey": "{{SCV_VendorCallKey}}",
"to": "{{NewPhoneContact.DNIS}}",
"from": "{{NewPhoneContact.ANI}}",
"initiationMethod": "Inbound",
"startTime": "{{SCV_CallStartTime}}",
"participants": [
{
"participantKey": "{{NewPhoneContact.ANI}}",
"type" : "END_USER"
}
]
}
Primjer ažuriranja prilagođenih polja u zapisu glasovnog poziva:
{
"callCenterDevName": "",
"certDevName": "",
"vendorCallKey": "{{SCV_VendorCallKey}}",
"to": "{{NewPhoneContact.DNIS}}",
"from": "{{NewPhoneContact.ANI}}",
"initiationMethod": "Inbound",
"startTime": "{{SCV_CallStartTime}}",
"participants": [
{
"participantKey": "{{NewPhoneContact.ANI}}",
"type" : "END_USER"
}
],
"callAttributes": "{\"custfield1__c\": \"\",\"custfield2__c\": \"\",\"custfield3__c\": \"\"}"
}
Parametri
| Naziv nekretnine | Vrijednost |
|---|---|
| NazivProgrameraPozivnogCentra | Ime razvojnog programera kontaktnog centra |
| Naziv_programera_cert | API naziv certifikata (kako je konfigurirano u Kontakt centru) |
| dobavljačKljučPozivaKupa | Jedinstveni ID poziva: {{SCV_VendorCallKey}} |
| do | CalledNumber/DNIS: {{NewPhoneContact.DNIS}} |
| od | CallingNumber/ANI: {{NewPhoneContact.ANI}} |
| vrijeme početka | UTC vremenska oznaka {{SCV_CallStartTime}} (postavlja se odmah nakon što je poziv prihvaćen u skripti) |
| Atributi poziva |
Predstavlja dodatna standardna i prilagođena polja u zapisu glasovnog poziva, gdje svaki par ključ-vrijednost odgovara standardnom ili prilagođenom polju i njegovim vrijednostima. Primjer: |
Postavke parsiranja
- Vrsta sadržaja: JSON
- Izlazna varijabla: SCV_ID snimke glasovnog poziva
- Izraz puta:
$.data.voiceCallId
ID zapisa glasovnog poziva koji se prosljeđuje agentu.
Procijenite HTTP odgovor za stvaranje zapisa glasovnog poziva
Provjerite HTTP status http zahtjeva za stvaranje glasovnog poziva:
- Oznaka: statusCodeCreateVoiceCall
- Varijabla: CreateVoiceCall.httpStatusCode
Ako je kod statusa == 200 => uspješan inače => zahtjev nije uspio, rukovanje greškom
Rješavanje pogreške pri stvaranju zapisa glasovnog poziva
Za demonstraciju / samo otklanjanje pogrešaka, reproduciraj poruku ovisno o http statusnom kodu.
Ako je Kreiranje glasovnog poziva bilo uspješno, nastavite s Izvršavanjem Omni Flowa. U suprotnom, nastavite s usmjeravanjem poziva.
HTTP zahtjev: Izvršite Omni Flow (neobavezni korak)
Koristite Execute Omni-Flow kada želite:
- izvršavanje automatiziranih zadataka, na primjer pretraživanje ili stvaranje zapisa i povezivanje zapisa sa zapisom glasovnog poziva
- pretraži zapise i pokreni skočni ekran
- sinkronizirajte redove čekanja Salesforcea i Ciscoa
- neka Service Cloud Voice donese odluku o usmjeravanju
Ovaj zahtjev uvijek vraća "red" ili "agenta" kamo poziv mora biti usmjeren.
Nakon izvršenja ovog zahtjeva, obavezno pošaljite poruku "Clear Routing" ako pozivatelj prekine poziv prije nego što mu se agent javi. Vidi Tijek događaja Webex kontaktnog centra.
Postavke HTTP zahtjeva
- Oznaka aktivnosti: Izvrši OmniFlow
- Koristi autentificiranu krajnju točku: Omogućeno
- Priključak: Salesforce konektor stvoren u prethodnom koraku
- Put zahtjeva:
/services/apexrest/cisco_wxcc_scv/voice/v1/executeOmniFlow - Metoda: OBJAVA
- Vrsta sadržaja zahtjeva: Application/JSON
Tijelo zahtjeva
Osim obaveznih polja, Omni-Flowu možete proslijediti dodatne podatke kao ulazne varijable. U nastavku su dva primjera tijela zahtjeva. Prvi bez dodatnih parametara protoka, samo obavezna polja, drugi s dvije ulazne varijable.
Primjer s Omni-Flow parametrima:
{
"callCenterDevName": "",
"certDevName": "",
"voiceCallId": "{{SCV_VoiceCallRecordId}}",
"dialedNumber": "{{NewPhoneContact.DNIS}}",
"flowDevName": "",
"fallbackQueue": ""
}
Primjer ažuriranja prilagođenih polja u zapisu glasovnog poziva:
{
"callCenterDevName": "",
"certDevName": "",
"voiceCallId": "{{SCV_VoiceCallRecordId}}",
"dialedNumber": "{{NewPhoneContact.DNIS}}",
"flowDevName": "",
"fallbackQueue": "",
"flowInputParameters":
{
"param1": "value1",
"param2": "value2"
}
}
Parametri
| Naziv nekretnine | Vrijednost |
|---|---|
| NazivProgrameraPozivnogCentra | Ime razvojnog programera kontaktnog centra |
| Naziv_programera_cert | API naziv certifikata (kako je konfigurirano u Kontakt centru) |
| ID glasovnog poziva | ID zapisa glasovnog poziva, kreiranog u prethodnom koraku: {{SCV_VoiceCallRecordId}} |
| birani broj | CalledNumber/DNIS: {{NewPhoneContact.DNIS}} |
| NazivRazvojaToka | Ime programera Omni-Flowa koji treba izvršiti |
| rezervni red | ID reda čekanja ili naziv API-ja reda čekanja za rezervni Salesforce red čekanja |
| Parametri ulaza protoka |
Dodatni ulazi u Omni-Channel tok (par ključ-vrijednost). Primjer: |
Postavke parsiranja
Red čekanja
- Vrsta sadržaja: JSON
- Izlazna varijabla: SCV_OmniFlowQueue
- Izraz puta:
$.data.queue
"Red čekanja" vraćen iz Execute Omni-Flow može se koristiti za usmjeravanje.
Agent- Vrsta sadržaja: JSON
- Izlazna varijabla: SCV_OmniFlowAgent
- Izraz puta:
$.data.agent
"Agent" vraćen iz Execute Omni-Flow, može se koristiti za usmjeravanje.
Procijenite HTTP odgovor za izvršavanje Omni Flow-a
Provjerite HTTP status zahtjeva za izvršavanje Omni Flow protokola:
- Oznaka: statusCodeExecuteOmniFlow
- Varijabla: IzvršiOmniFlow.httpStatusCode
Ako je kod statusa == 200 => uspješan inače => Zahtjev nije uspio, obrada pogreške.
Rješavanje pogrešaka za Izvršavanje Omni Flow-a
Za demonstraciju / samo otklanjanje pogrešaka, reproduciraj poruku ovisno o http statusnom kodu.
Ako je Izvršavanje Omni Flow-a bilo uspješno, varijable SCV_OmniFlowQueue i SCV_OmniFlowAgent nisu postavljene. Odluka o usmjeravanju u toku poziva.
Nastavi s usmjeravanjem poziva
Nastavite u tijeku poziva, usmjerite poziv agentu. Neobavezno, koristite SCV_OmniFlowQueue i SCV_OmniFlowAgent za odabir reda čekanja i agenta.
Tijek događaja u Webex kontaktnom centru
Ako pozivatelj prekine poziv prije nego što se agent javi, moramo ažurirati Service Cloud Voice i prekinuti poziv.
- Ako je korišteno Izvrši Omni-Flow, pošalji Clear Routing za brisanje Pending Service Routing (PSR)
- Pošalji Ažuriraj glasovni poziv za ažuriranje vremena početka i završetka zapisa glasovnog poziva i promjenu statusa iz Novo u Završeno

- PhoneContactEnded - Ovaj se događaj pokreće kada se prekine aktivni poziv i svi sudionici se uklone.
- HTTP zahtjev: Očisti usmjeravanje
- HTTP zahtjev: Ažuriraj glasovni poziv
HTTP zahtjev: Očisti usmjeravanje
- Oznaka: Očisti usmjeravanje
- Koristi autentificiranu krajnju točku: Omogućeno
- Priključak: Salesforce konektor stvoren u prethodnom koraku
- Put zahtjeva:
/services/apexrest/cisco_wxcc_scv/voice/v1/clearRouting - Metoda: OBJAVA
Vrsta sadržaja zahtjeva: Application/JSON
Tijelo zahtjeva
{
"callCenterDevName": "",
"certDevName": "",
"voiceCallId": "{{SCV_VoiceCallRecordId}}"
}
Parametri
| Naziv nekretnine | Vrijednost |
|---|---|
| NazivProgrameraPozivnogCentra | Ime razvojnog programera kontaktnog centra |
| Naziv_programera_cert | API naziv certifikata (kako je konfigurirano u Kontakt centru) |
| ID glasovnog poziva | ID zapisa glasovnog poziva, kreiranog u prethodnom koraku: SCV_ID snimke glasovnog poziva |
Postavke parsiranja
Ništa.
HTTP zahtjev: Ažuriraj glasovni poziv
- Oznaka: Ažuriraj glasovni poziv
- Koristi autentificiranu krajnju točku: Omogućeno
- Priključak: Salesforce konektor stvoren u prethodnom koraku
- Put zahtjeva:
/services/apexrest/cisco_wxcc_scv/voice/v1/updateVoiceCall - Metoda: OBJAVA
- Vrsta sadržaja zahtjeva: Application/JSON
Tijelo zahtjeva
{
"callCenterDevName": "",
"certDevName": "",
"voiceCallId": "{{SCV_VoiceCallRecordId}}",
"startTime": "{{SCV_CallStartTime}}",
"endTime": "{{now() | replace({'[UTC]': ''})}}",
"disconnectReason": { "value": "Abandoned in queue", "isError": true }
}
Parametri
| Naziv nekretnine | Vrijednost |
|---|---|
| NazivProgrameraPozivnogCentra | Ime razvojnog programera kontaktnog centra |
| Naziv_programera_cert | API naziv certifikata (kako je konfigurirano u Kontakt centru) |
| ID glasovnog poziva | ID zapisa glasovnog poziva, kreiranog u prethodnom koraku: SCV_ID snimke glasovnog poziva |
| vrijeme početka | UTC vremenska oznaka početka poziva {{SCV_CallStartTime}} (kao što se koristi za stvaranje zapisa glasovnog poziva) |
| Vrijeme završetka | Trenutna UTC vremenska oznaka `{{now() |
| Razlog prekida veze | Razlog prekida poziva. Svojstvo isError mora biti postavljeno na true da bi se ispravno prikazalo. |
Postavke parsiranja
Ništa.
Reference
- Izradite privatni ključ i samopotpisani digitalni certifikat
- Konfigurirajte povezanu aplikaciju za Webex kontaktni centar Salesforce Connector
- Postavljanje integracijskih konektora za Webex kontaktni centar - Salesforce
- Vodič za postavljanje i administraciju kontaktnog centra Cisco Webex > Dizajner toka
- REST API za integraciju telefonije
Prijevod jezika
(Neobavezno) Omogući radnu površinu za prevođenje
Ova se postavka primjenjuje samo ako koristite postavke jezika prijevoda.
| 1 |
Idite na Postavke → Radna površina za prevođenje → Postavke jezika za prevođenje. |
| 2 |
Kliknite Omogući za odabir jezika prijevoda. |
(Neobavezno) Omogući jezike samo za platformu
Ova postavka primjenjuje se samo za jezike koji nisu EN-US.
| 1 |
Idite na Postavke → Postavke tvrtke → Postavke jezika. |
| 2 |
Odaberite potrebne jezike. |
| 3 |
Označite sljedeće potvrdne okvire:
|
| 4 |
Spremite promjene. |
Aktivirajte jezik i odaberite korisnika (zadatak)
| 1 |
Idite na Postavke → Radna površina za prevođenje → Postavke jezika za prevođenje. |
| 2 |
Odaberite jezik i odaberite korisnika koji će ga prevesti. |
| 3 |
Spremite promjene. |
Višejezične postavke
Prevedi prilagođene oznake
| 1 |
Idite na Postavke → Prilagođene oznake. |
| 2 |
Odaberite naziv prilagođene oznake koju želite otvoriti.
|
| 3 |
Na povezanom popisu prijevoda kliknite |
| 4 |
Odaberite jezik na koji prevodite. |
| 5 |
Unesite prevedenu vrijednost u polje Tekst prijevoda. Ovaj tekst poništava vrijednost navedenu u polju Vrijednost oznake kada je zadani jezik korisnika jezik prijevoda. |
| 6 |
Spremite promjene. |
Dozvole Salesforcea potrebne za korisničku funkciju
Skup dopuštenja agenta za Webex Contact Center SCV sadrži sva dopuštenja potrebna za rad s Webex Contact Center Gadgetom i integracijama razvijenim za agente.
Pristup Apex klasi (odjeljak)
- cisco_wxcc_scv.CiscoScvWxcc
- cisco_wxcc_scv.ServiceResponseHandler
- cisco_wxcc_scv.ServiceRouting
- cisco_wxcc_scv.TelephonyIntegrationHandler
Pristupi prilagođenim vrstama metapodataka (odjeljak)
- cisco_wxcc_scv.WxCC veza
Pristup stranici Visualforce (odjeljak)
- cisco_wxcc_scv.CiscoScvLoginWxCC
- cisco_wxcc_scv.CiscoScvMainWxCC
- cisco_wxcc_scv.CiscoScvOAuthPreusmjeravanje
- cisco_wxcc_scv.CiscoScvSwLoader
Omotač API-ja za uslugu Cloud Voice
Preduvjeti
Za korištenje Service Cloud Voice API Wrappera, potrebno je konfigurirati Salesforce vanjsku klijentsku aplikaciju za IVR integraciju.
Koristite Service Cloud Voice API Wrapper
Service Cloud Voice (SCV) za Salesforce koristi REST API za integraciju telefonije za stvaranje i ažuriranje glasovnih poziva, izvršavanje višekanalnih tokova i brisanje zapisa PendingServiceRouting povezanih s glasovnim pozivom. Ova usluga zahtijeva JWT autorizaciju i korištenje PATCH HTTP metode, koju Cisco IP Interactive Voice Response (IVR) trenutno ne podržava.
Kako bi se pojednostavilo korištenje REST API-ja za integraciju telefonije za SCV u (ne samo) IVR sustavu, dostupan je novi skup API-ja koji obuhvaćaju postojeći Salesforce API i dostupni su izravno iz Salesforce organizacije u kojoj je instaliran paket Webex Contact Center for Service Cloud Voice.
Service Cloud Voice API Wrapper uklanja potrebu za autentifikacijom JWT tokena, implementira dodatne provjere podataka koje zahtijeva Salesforce API i poboljšava objekte odgovora.
Dohvati token Access_
Izvrši POST zahtjev za https://<your-domain-name>.my.salesforce.com/services/oauth2/token
Slanje sljedećih parametara u tijelu:
{
"grant_type": "client_credentials",
"client_id": "",
"client_secret": ""
}
If the request is successful, the following JSON response will be returned:
{
"access_token": "",
"instance_url": "",
"id": "https://login.salesforce.com/id//",
"token_type": "Bearer",
"issued_at": "",
"signature": ""
}
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 (npr. https://abc-123.lightning.force.com ) rezultira statusom 401 Neovlašteno s vraćenim kodom pogreške INVALID_SESSION_.
Kreiraj glasovni poziv (odjeljak)
Stvara zapis VoiceCall koji sadrži sudionike (tj. pozivatelja i primatelja) za zapis VoiceCall. Kada kreirate zapis VoiceCall, u Salesforceu se kreira razgovor. Koristite ovaj API samo u stvarnom vremenu, što znači da biste trebali pozivati ovaj API samo kada se pokrene poziv. Ovaj API se također može koristiti za stvaranje VoiceCall zapisa za prijenos i konferencijske pozive uključivanjem parametra parentVoiceCallId u korisni teret zahtjeva.
URI krajnje točke
<instance_url>/services/apexrest/cisco_wxcc_scv/voice/v1/createVoiceCall
HTTP metoda
OBJAVA
Zaglavlja
Autorizacija: Nositelj <access_token>
Vrsta sadržaja: application/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"
}
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žuriraj glasovni poziv
Ažurira VoiceCall nakon završetka poziva. Pomoću ovog API-ja ažurirajte parametre povezane s pozivima koji nisu dostupni tijekom faze stvaranja VoiceCall-a. API za ažuriranje VoiceCall-a je asinhrona operacija. Ne možete upitati za status API poziva.
Ova krajnja točka može se koristiti i za stvaranje glasovnog poziva čak i nakon što je poziv završen. Ovo je ponašanje korisno 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 VoiceCall još nije kreiran.
URI krajnje točke
<instance_url>/services/apexrest/cisco_wxcc_scv/voice/v1/updateVoiceCall
HTTP metoda
OBJAVA
Zaglavlja
Autorizacija: Nositelj <access_token>
Vrsta sadržaja: application/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
}
} Odgovor (uspješan)
{
"data": {
"status": "pending"
},
"errors": null,
"success": true
} API za ažuriranje VoiceCall-a je asinhrona operacija. Ne možete upitati za status API poziva.
Odgovor (s pogreškama)
{
"data": null,
"errors": ["Error message 1", "Error message 2"],
"success": false
} Izvrši Omni-flow
Izvršava Omni-Channel tok za usmjeravanje poziva. Prosljeđuje ID poziva (Salesforce VoiceCallId ili ContactId dobavljača telefonije) kao parametre toku i vraća upute za usmjeravanje agenta ili reda čekanja toku kontakta. Prema zadanim postavkama, Service Cloud Voice koristi Omni-Channel tok (ili rezervni red čekanja) naveden za telefonski kanal koji odgovara biranom broju. Ako birani broj ne odgovara postojećem telefonskom kanalu, opcionalno možete postaviti novi birani broj, Omni-Channel tijek i rezervni red kao ulazne parametre za ovaj API poziv.
Service Cloud Voice koristi ovaj redoslijed prioriteta za usmjeravanje poziva:
- Koristi postavke Omni-Channel Flow i Fallback Queue za telefonski kanal koji odgovara biranom broju. Tok ima prednost. Ako tok ne uspije, koristi se rezervni red čekanja.
- Koristi parametre flowDevName i fallbackQueue navedene u pozivu Execute Omniflow API-ja.
URI krajnje točke
<instance_url>/services/apexrest/cisco_wxcc_scv/voice/v1/executeOmniFlow
HTTP metoda
OBJAVA
Zaglavlja
Autorizacija: Nositelj <access_token>
Vrsta sadržaja: application/json
Parametri
{
"callCenterDevName": "contactCenterDevName123",
"certDevName": "certDevName123",
"voiceCallId": "00X000012345abc",
"dialedNumber": "+18445791189",
"flowDevName": "Route_VoiceCall",
"fallbackQueue": "00G111222333444",
"flowInputParameters":
{
"Input1": "one",
"Input2": "two"
}
} Odgovor (uspješan)
{
"data": {
"queue": "queue info",
"agent": "agent info"
},
"errors": null,
"success": true
} AGENT_INFO i QUEUE_INFO odgovaraju polju ExternalId u CallCenterRoutingMap-u
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 u većini 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 pri korištenju partnerskih telefonskih sustava, gdje morate eksplicitno pozvati ovaj API za brisanje PSR zapisa.
URI krajnje točke
<instance_url>/services/apexrest/cisco_wxcc_scv/voice/v1/clearRouting
HTTP metoda
OBJAVA
Zaglavlja
Autorizacija: Nositelj <access_token>
Vrsta sadržaja: application/json
Parametri
{
"callCenterDevName": "contactCenterDevName123",
"certDevName": "certDevName123",
"voiceCallId": "00X000012345abc"
} 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 Voicea i Webex kontaktnog centra ovise o prijevodima telefonskih brojeva. Zbog međunarodnih razlika i specifičnih primjena kod korisnika, potreban je prilagodljiv alat za prijenos telefonskih brojeva iz formata A u format B.
Rješenje Webex Contact Center for Service Cloud Voice automatski uklanja sve znakove osim brojeva i hashtagova (#), zvjezdice (*), zarezi (,) i vodeći znakovi plus (+). Također uklanja prvo pojavljivanje (0). To će se obaviti PRIJE primjene prijevoda vaših telefonskih brojeva.
Ovaj vodič opisuje kako konfigurirati prijevode telefonskih brojeva.
Polja
Prijevodi telefonskih brojeva pohranjeni su u poljima Naziv-Vrijednost. To vam omogućuje konfiguriranje neograničenog broja pravila po značajki.
Konfiguracija se pohranjuje kao JSON niz znakova.
Imajte na umu da obrnute kose crte moraju biti izbjegnute, npr. \d+ postaje \\d+.
{"Remove all characters but digits":"[1,17]->[^\\d]+","To internal number":"[7,17]->(\\d{7})(\\d{4})->$2"}
Polje Naziv se tehnički ne koristi. Tu je da doda čovjeku čitljiv niz znakova kako bi se brzo identificirala svrha ovog pravila. Dobra imena su na primjer: Ukloni sve vodeće nule, Dodaj vodeći plus itd.
Izrada pravila prevođenja
Pravila su data kao regularni izrazi. Da budem precizniji: JavaScript implementacija regularnih izraza.
Dobar način za početak je čitanje RegExp dokumenta iz MDN web dokumentacije.
Ipak, stvaranje složenih regularnih izraza često je nezgrapno. Stoga smo dodali dodatnu sintaksu kako bismo konfiguraciju učinili što jednostavnijom.
Donja slika prikazuje opću sintaksu pravila za prevođenje telefonskog broja:
Predikat
Predikat se koristi za određivanje intervala koji definira duljinu broja koji treba pronaći.
Gornji predikat određuje da svi brojevi duljine između 7 i 11 znakova (uključujući rubove + razmaci) podudaraju se.
Predikati uvijek odgovaraju izvornoj duljini broja. To pomaže u pojednostavljenju konfiguracije smanjenjem rizika od kolizijskih pravila za interne / vanjski brojevi.
Uzorak
Uzorak određuje format broja koji treba odgovarati.
Gornji uzorak navodi da broj mora sadržavati samo znamenke i odabire ih.
Selektor
Selektori definiraju konačni format broja. Ako znakovi / Treba dodati znamenke koje izvorno nisu bile prisutne, ovo je mjesto za to.
Selektor je posljednji korak u izgradnji broja. Na temelju izlaza uzorka, selektor izgrađuje novi broj.
Primjer 1
Sljedeći primjer pokazuje kako prenijeti broj primljen iz Kontakt centra u formatu 0319175200 u švicarski E164 format +41 31 917 52 00.
Ovaj primjer koristi dva pravila prevođenja (1. i 2.)
Prvo pravilo u ovom primjeru zapravo ne mijenja broj. Za brojeve duljine između 1 i 17 znakova, sve osim znamenki bi se uklonilo. Budući da nema prisutne ne-cifre, ništa se ne mijenja.
Drugo pravilo se primjenjuje na brojeve koji su (izvorno) dugi točno 10 znakova. 0319175200 se podudara i stoga se pravilo primjenjuje. 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 $2 referencira se na prvi (\d{2}) i stoga sadrži 31.
Primjer 2
Sljedeći primjer pokazuje kako prenijeti broj primljen iz Kontakt centra u formatu +14693150217 u američki E164 format +1 469 315 0217.
Ovaj primjer koristi dva pravila prevođenja (1. i 2.)
- Ovaj broj ima točno 12 znakova, pa se primjenjuje pravilo "Dodaj razmake američkim brojevima".
- (\+1) kaže da broj mora početi s +1. Ako broj ima 12 znakova, ali ne počinje s +1, Pravilo je poništeno i ništa se ne mijenja.
- (\d{3}) kaže da +1 moraju slijediti 3 znamenke.
- (\d{3}) kaže da nakon posljednje 3 znamenke moraju slijediti još 3 znamenke.
- (\d{4}) kaže da nakon posljednje 3 znamenke moraju slijediti 4 znamenke.
Ako se bilo što od ovoga ne podudara, broj se neće mijenjati.
Dakle, sva pravila vrijede za “+14693150217”. Stoga se broj mijenja za “$1 $2 $3 $4”:
- $1 odnosi se na grupu (\+1), Broj koji treba poslati Service Cloud Voiceu izgleda ovako +1.
- $2 odnosi se na prvo od dva (\d{3}), broj koji treba poslati Service Cloud Voiceu izgleda ovako +1 469.
- $3 odnosi se na drugo od ta dva (\d{3}), broj koji treba poslati Service Cloud Voiceu izgleda ovako +1 469 315.
- $4 odnosi se na posljednju skupinu (\d{4}), broj koji treba poslati Service Cloud Voiceu izgleda ovako +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 u: +1-469-315-0217
Također vam je dopušteno uklanjati 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 kao što je: [12, 12]->(\+1)(\d{3})(\d{3})(\d{4})->($2) $3-$4.
Zatim dolazni broj “+14693150217” bit će prevedeno na: (469) 315-0217.
Primjer 3.
Sljedeći primjer pokazuje kako prenijeti broj primljen iz Kontakt centra u formatu +491515555531 u njemačkom formatu E164 +49 151 5555 531.
Ovaj primjer koristi dva pravila prevođenja (1. i 2.)
- Ovaj broj ima točno 13 znakova, pa se primjenjuje pravilo "Dodaj razmake njemačkim brojevima".
- (\+49) kaže da broj mora početi s +49. Ako broj ima 13 znakova, ali ne počinje s +49, Pravilo je poništeno i ništa se ne mijenja.
- (\d{3}) kaže da +49 moraju slijediti 3 znamenke.
- (\d{4}) kaže da nakon posljednje 3 znamenke moraju slijediti 4 znamenke.
- (\d{3}) kaže da nakon posljednje 4 znamenke moraju slijediti 3 znamenke.
Ako se bilo što od ovoga ne podudara, broj se neće mijenjati.
Dakle, sva pravila vrijede za “+491515555531”. Stoga se broj mijenja za “$1 $2 $3 $4”:
- $1 odnosi se na grupu (\+49), Broj koji treba poslati Service Cloud Voiceu izgleda ovako +49.
- $2 odnosi se na prvo od dva (\d{3}), broj koji treba poslati Service Cloud Voiceu izgleda ovako +49 151.
- $3 odnosi se na drugo od ta dva (\d{4}), broj koji treba poslati Service Cloud Voiceu izgleda ovako +49 151 5555.
- $4 odnosi se na posljednju skupinu (\d{3}), broj koji treba poslati Service Cloud Voiceu izgleda ovako +49 151 5555 531.
Isto vrijedi i za pravilo broj jedan. Možete koristiti zamjenski dio $1 $2 $3 $4 odabrati što će se koristiti iz broja.
Više primjera regularnih izraza za prijevod
| Opis | Prijevod regularnog izraza |
|---|---|
| Uklonite sve znakove osim znamenki | [1,17]->[^\d]+ |
| Uklonite sve znakove osim znamenki & + | [1,17]->[^+\d]+ |
| Opis | Prijevod regularnog izraza |
|---|---|
| Ukloniti +1 | [12,12]->(.{1})(\d{1})(\d{10})->$3 |
| Ukloniti +1 | [10,12]->(^\+1+)(\d+)->$2 |
| Ukloniti +49 | [10,15]->(^\+49+)(\d+)->$2 |
| Ukloniti +49 | [10,15]->(.{1})(\d{2})(\d{9})->$3 |
| Ukloniti +41 | [10,13]->(^\+41+)(\d+)->$2 |
| Ukloniti +41 | [10,13]->(.{1})(\d{2})(\d{9})->$3 |
| Ukloniti +XX | [10,14]->(^\++)(\d{2})(\d+)->$3 |
| Opis | Prijevod regularnog izraza |
|---|---|
| Ukloniti + i zamijenite ga nulama US E164 | [10,12]->(.{1})(\d{1})(\d{10})-> 001 $3 |
| Ukloniti +1 i zamijenite ga nulama US E164 | [10,12]->(^\+1+)(\d+)-> 001$2 |
| Ukloniti + i zamijenite ga nulama DE E164 | [12,15]->(.{1})(\d{2})(\d{10})-> 0049 $3 |
| Ukloniti +49 i zamijenite ga nulama DE E164 | [10,12]->(^\+49+)(\d+)-> 0049$2 |
| Ukloniti + i zamijenite ga nulama CH E164 | [10,13]->(.{1})(\d{2})(\d{9})-> 0041 $3 |
| Ukloniti +41 i zamijenite ga nulama CH E164 | [10,12]->(^\+41+)(\d+)-> 0041$2 |
| Opis | Prijevod regularnog izraza |
|---|---|
| Američki broj s razmakom | [12,17]->(\d{1})(\d{3})(\d{3})(\d{4})->+1 $2 $3 $4 |
| Američki broj s razmakom | [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 |
| Broj CH-a s razmakom | [12,17]->(\d{2})(\d{2})(\d{3})(\d{2})(\d{2})->+41 $2 $3 $4 |
| Broj CH-a s razmakom | [12,17]->(\+41)(\d{2})(\d{3})(\d{2})(\d{2})->$1 $2 $3 $4 |
Konfiguracija stranice VoiceCall
Konfigurirajte stranicu za snimanje glasovnih poziva
Stranica za snimanje VoiceCall-a dolazi unaprijed konfigurirana prema zadanim postavkama, s rasporedom u 3 stupca i sljedećim komponentama:
- Radnje & preporuke
- Bilješke o pozivu
- Pojedinosti poziva
- Snimke
Komponente se mogu slobodno uklanjati ili dodavati na stranicu, ovisno o poslovnim potrebama. Mogu se koristiti i različiti izgledi stranica, ali neke komponente, poput Playera za snimanje poziva i Tijela razgovora, mogu stati samo na srednja i velika područja predloška.
Prikaz komponente Razlog zaključenja
Komponenta Razlog za završetak 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 Reason Lightning iz područja Custom na popisu Lightning Components na stranicu VoiceCall Record.
- Kliknite na Spremi.
- Kliknite Aktiviraj.
- Kliknite Dodijeli kao zadano za organizaciju.
- Kliknite na Spremi.
- Ponovno kliknite Spremi, a zatim kliknite Strelica natrag za povratak na stranicu.
Komponenta Cisco Wrap-Up Reason automatski će se prikazati tijekom poziva i tijekom WrapUp-a:
Ako se doda na stranicu, komponenta Cisco Wrap-Up Reason prikazuje se za svaki poziv, također i ako Wrap-Up nije konfiguriran u Cisco kontaktnom centru.
Prikaz playera za snimanje poziva
Player za snimanje poziva prikazat će se ako je za odgovarajući glasovni poziv spremljena veza za snimanje.
Slijedite ove korake za dodavanje komponente Player za snimanje poziva na stranicu Snimanje glasovnih poziva:
- Povucite web komponentu Lightning programa za snimanje poziva na stranicu za snimanje glasovnih poziva
- KlikniteSpremi.
- KlikniteAktiviraj.
- KlikniteDodijeli kao zadano za organizaciju.
- KlikniteSpremi.
- Ponovno klikniteSpremi, a zatim kliknite strelicu natrag za povratak na stranicu.
Webex administratori
Konfiguracija protoka
Skočni prozor na zaslonu
Čvor "Iskačući zaslon" dostupan je u Webex Contact Center Flowu. Može se koristiti za pokretanje skočnog prozora unutar Service Cloud Voicea ili u zasebnom prozoru.
Više informacija o ovoj funkciji možete pronaći u dokumentaciji za Flow Designer .
Iskačući prozor u zasebnom prozoru
Za otvaranje skočnog prozora u zasebnom prozoru, u čvoru "Screen Pop" mora biti naveden apsolutni URL. Parametri upita 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 skočnom zaslonu Postojeća kartica preglednika otvara se nova kartica preglednika. Ta će kartica biti namjenska kartica za sljedeće skočne prozore postojećih kartica preglednika, a URL će se osvježavati 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 slučaju se u novoj kartici preglednika otvara skočni prozor Postojeća kartica preglednika.





