- Pagină de pornire
- /
- Articol
Webex Contact Center pentru serviciul salesforce Voice Cloud integrează CCaaS robust de la Cisco (Contact Center ca serviciu) cu CRM-ul Salesforce, permițând întreprinderilor să gestioneze interacțiunile cu clienții omnicanal (voce, digital) în interfața Salesforce, utilizând Webex AI pentru agenți virtuali, transcriere și rutare inteligentă, transformând agenții în „super-agenți” cu date unificate pentru o experiență mai bună a clienților.
Prezentare generală
Webex Contact Center pentru Salesforce Service Cloud Voice
Webex Contact Center for Service Cloud Voice este o soluție de integrare care introduce puterea Webex Contact Center în consola de agenți Omni-canal Salesforce Service Cloud Voice.
Înainte de a continua cu instalarea, consultați următoarea secțiune:
pentru a afla mai multe despre cerințele și limitările Salesforce Service Cloud Voice și pentru a vă asigura că organizația dvs. Salesforce este pregătită să activeze și să instaleze pachetul Webex Contact Center for Service Cloud Voice.
Cerințe preliminare și limitări
Cerințe preliminare (sub-subiect)
Interfețe utilizator: Service Cloud Voice este disponibil numai în Salesforce Lightning Experience.
Service Cloud Voice este disponibil în aceste ediții.
- Enterprise
- Nelimitat
- Dezvoltator
Licențe
-
Clienții trebuie să achiziționeze noua licență de completare A-SF-VOICE pentru fiecare agent conectat, în plus față de licențele Flex 3 Standard sau Premium pentru Webex Contact Center. Pentru mai multe informații, consultați ghidul de plasare a comenzilor Flex 3.
- Voce Salesforce pentru telefonia partenerului
Înainte de a activa Vocea, trebuie să configurați serviciile prealabile în organizația dvs.
- Navigați la Informații despre companie > Setare licență permisiune
- Verificați dacă există Utilizator de voce Service Cloud (Telefonie partener).
Toate edițiile de dezvoltator vin acum cu 5 licențe de telefonie pentru parteneri disponibile pentru testare.
- Verificați dacă există Utilizator de voce Service Cloud (Telefonie partener).
- În mod alternativ, puteți verifica acest lucru accesând Configurare Salesforce și căutând „voce” în bara laterală din stânga.
- Dacă apare „Centre de contact telefonică pentru parteneri”, aveți licența SCV.
- Dacă opțiunea „Centre de contact telefonică partener” nu este vizibilă, atunci „Activare Service Cloud Voice” urmând pașii de mai jos.
- Accesați Configurare Salesforce și căutați și selectați „Configurare telefonie partener” și comutați butonul la „Activare Service Cloud Voice”.
- Activați Omni-Channel pentru a permite agenților dvs. să efectueze și să primească apeluri.
- Accesați Configurare Salesforce și căutați și selectați „Configurare telefonie partener” și comutați butonul la „Activare Service Cloud Voice”.
Activați Omni-Channel
Dacă Omni-Channel este deja activat în organizația dvs., omiteți acest pas.
- Din Configurare, introduceți Omni-Channel Settings în caseta Găsire rapidă, apoi selectați Omni-Channel Settings.


- Selectare Enable Omni-Channel.
- Clic Save.
Limitări
- Vocea este disponibilă numai în Lightning Experience.
- Vocea este acceptată în Service Cloud și Sales Cloud ca licență de completare.
- Vocea nu este acceptată pe Salesforce Mobile sau pe iPad Safari.
- Vocea este acceptată numai în browserele web Google Chrome, Microsoft Edge (Chromium) și Mozilla Firefox. Modulele cookie trebuie să fie activate pentru a permite conectarea unică (SSO).
- Navigarea standard nu este acceptată.
- Telefonia este foarte reglementată, așa că verificați cu reprezentantul dvs. Salesforce disponibilitatea Vocii în regiunea dvs.
Cerințe
Coduri de inactivitate
Găsiți coduri de inactivitate
| 1 |
Conectați-vă la Portalul de management. |
| 2 |
Navigheaza catre Contact Center > DESKTOP EXPERIENCE > Idle/Wrap-up Codes. |
| 3 |
Asigurați-vă că sunt afișate codurile de inactivitate; în caz contrar, faceți clic pe butonul derulant al filtrului și selectați Idle Code în partea de sus a paginii. |
| 4 |
Faceți clic pe un cod de inactivitate pentru a deschide vizualizarea cu detalii. Acolo puteți găsi ID-ul codului de inactivitate.
ID-urile pot fi copiate și apoi utilizate pentru configurația Mapare stare de prezență. Unul dintre ID-uri trebuie să fie utilizat ca Motiv implicit Cisco Not Ready. |
Integra
Instalare
Înainte de a continua instalarea, consultați secțiunea Cerințe prealabile și limitări pentru a afla despre cerințele prealabile și limitările Salesforce Service Cloud.
Instalați și configurați Webex Contact Center pentru Service Cloud Voice
Când este obținută o licență Service Cloud Voice for Partner Telephony, pagina Configurare telefonie partener apare în meniul Configurare.
Informații suplimentare pot fi găsite în referința oficială a Salesforce ( link direct).
| 1 |
Din Configurare, introduceți
|
| 2 |
Activaţi Turn on Voice with Partner Telephony... Fișierul Partner Telephony Contact Centers pagina apare în Setup meniu.
Dacă intenționați să implementați pachetul într-o zonă protejată Salesforce, înlocuiți
|
Instalează pachetul
Pentru a instala pachetul:
| 1 |
Deschideți linkul furnizat al pachetului pentru a începe instalarea. |
| 2 |
Conectați-vă la organizația Salesforce unde trebuie instalat pachetul. |
| 3 |
În expertul de instalare, alegeți opțiunea de securitate „Instalare doar pentru administratori” (1) și faceți clic pe Instalare (2). Determinați utilizatorii care primesc anumite permisiuni pentru obiectele și componentele care vin cu pachetul Webex Contact Center for Service Cloud Voice. În plus, acordați-le aceste permisiuni; seturile de permisiuni furnizate împreună cu pachetul Webex Contact Center for Service Cloud Voice ajută la acest proces. Expertul de instalare a pachetului – Ecranul de întâmpinare apare: Pachetul de instalare nu este accesibil direct prin Salesforce AppExchange. Clienții trebuie să utilizeze butonul „Obțineți acum” din lista AppExchange, care deschide un formular de contact pentru a solicita link de instalare și activarea Cisco. |
| 4 |
Acordați următoarele seturi de permisiuni cel puțin unui utilizator, astfel încât să puteți crea Centrul de contact:
|
| 5 |
Faceți clic pe Configurare | Utilizatori | Utilizatori. |
| 6 |
Căutați și selectați un utilizator. |
| 7 |
Derulați în jos la „Permisiune setare alocări”. |
| 8 |
Faceți clic pe Edit Assignments |
| 9 |
Pentru Administratori Contact Center: atribuiți setul de permisiuni Administrator Contact Center (Telefonie partener).
|
| 10 |
Pentru Agenți Contact Center: atribuiți setul de permisiuni Agent Contact Center (Telefonie partener) și setul de permisiuni Agent Webex Contact Center SCV.
Nu se recomandă alegerea Install for All Users opțiune, deoarece acordă toate permisiunile (citire, creare, editare și ștergere) asupra componentelor și obiectelor pachetului oricărui utilizator care utilizează un Profil de utilizator personalizat. |
| 11 |
Alocați o licență de pachet pentru ca utilizatorii să lucreze cu Connects pentru Service Cloud Voice.
|
| 12 |
Ca alternativă, puteți face clic pe Configurare | Utilizatori | Utilizatori.. |
| 13 |
Căutați și selectați utilizatorul. |
| 14 |
Derulați în jos la Managed Packages. |
| 15 |
Clic Assign Licenses. |
| 16 |
Alegeți Webex Contact Center for Service Cloud Voice pachet din listă. |
| 17 |
Clic Add. |
| 18 |
Creați Stări de prezență pentru a defini ce canale de servicii sunt alocate diferitelor stări. Agenții se pot conecta la Omni-Channel cu stări diferite, în funcție de tipul de muncă pe care au dreptul să o primească. |
| 19 |
Din Configurare, introduceți
|
| 20 |
Clic New. Creați cel puțin o stare pentru „Online” și una pentru „Ocupat”.
|
Alocați starea (stările) de prezență agenților
| 1 |
Din Configurare, introduceți Seturi de permisiuni în caseta Găsire rapidă, apoi selectați Seturi de permisiuni. |
| 2 |
Faceți clic pentru a deschide Partner Telephony Permission Set. |
| 3 |
Clic Service Presence Statuses Access. |
| 4 |
Clic Edit. |
| 5 |
În Available Service Presences listă, selectați starea (stările) de prezență creată(e) anterior și faceți clic Add pentru a le asocia cu permisiunea setată. Agenții care sunt alocați acestui set de permisiuni se pot conecta la Omni-Channel cu oricare dintre stările de prezență puse la dispoziție. |
| 6 |
Clic Save. |
| 7 |
Clic Manage Assignments pe aceeași pagină. Apoi faceți clic pe Add Assignment în colțul din dreapta sus, selectați utilizatorul dorit, faceți clic pe Next, selectați un Expiration Option pentru utilizatorii alocați (Opțional) și apoi faceți clic pe Assign. Service Cloud Voice utilizează un domeniu extern pentru a opera cu înregistrarea VoiceCall. Următoarele URL-uri trebuie să fie adăugate în „Setări site la distanță” în configurare (Faceți clic aici pentru a deschide documentația oficială):
Exemplu: Cum să găsiți URL-ul instanței. |
| 8 |
După conectare, verificați URL-ul din bara de adrese a browserului. URL-ul instanței este partea dinaintea „.my.salesforce.com” sau „.salesforce.com” sau .” lightning.force.com”. De exemplu, dacă URL-ul dvs. este https://orgfarm-54a38e30ad-dev-ed.develop.my.salesforce-setup.com/, atunci „orgfarm-54a38e30ad-dev-ed.develop” este URL-ul instanței dvs. Exemplu: URL organizație origine: https://cisco.lightning.force.com Exemplu: URL de adăugat:
|
| 9 |
Elementul de utilitate Omni-Channel este necesar în aplicația Lightning Service Console pentru ca agentul să utilizeze Service Cloud Voice.
Referința oficială de la Salesforce poate fi găsită făcând clic pe Let's Do This buton care deschide pagina Configurare experiență agent pentru Service Cloud Voice cu Partner Telephony din Portalul de ajutor Salesforce (link direct). |
| 10 |
Din Configurare, introduceți Partner Telephony Setup în caseta Găsire rapidă, apoi selectați Partner Telephony Setup. |
| 11 |
Derulați în jos la secțiune 5 More Voice Settings. |
| 12 |
Pentru a Activa protecția cu clickjack pentru paginile Visualforce cu anteturile dezactivate în timp ce lucrați cu softphone-ul din Lightning Experience, trebuie să adăugați domeniile din care softphone-ul și barele de instrumente personalizate sunt încărcate ca domenii de încredere, pe lângă URL-ul instanței Salesforce. Aceste setări și lista Domenii de încredere pot fi găsite în Configurare | Securitate | Setări sesiune. Pentru a prelua domeniul Visualforce corect, navigați la Configurare | Cod personalizat | Visualforce Pages și faceți clic pe butonul Previzualizare pentru
Exemplu: Numele meu de domeniu--cisco_wxcc_scv.vf.force.com Pentru a obține domeniul instanței Salesforce, copiați URL-ul afișat în bara URL a browserului și adăugați-l în Trusted Domains for Inline Frames List selectare listă Visualforce Pages ca Tip IFrame. Exemplu: MyDomainName.lightning.force.com
Dacă nu aveți un domeniu implementat în organizația dvs., formatul URL-ului dvs. este diferit. Dacă ați implementat un domeniu meu și domeniile îmbunătățite nu sunt activate în organizația dvs., formatul URL-ului dvs. este diferit. Dacă domeniile îmbunătățite nu sunt activate, setarea URL-urilor de stabilizare din Visualforce, Experience Builder, Site.comstudio și fișierele de conținut Domeniul meu afectează, de asemenea, acest format. Pentru detalii, consultați Formatele URL ale domeniului meu în Ajutorul Salesforce. Setări de protecție a clickjack și domenii de încredere pentru experiența Lightning
|
| 13 |
Pentru a afișa comenzile de înregistrare în timpul apelurilor, agenții au nevoie de
Pentru a o atribui, adăugați-o la setul de permisiuni creat în pasul Stări de prezență.
|
Configurare
Centru de contact
Un fișier de definiție a centrului de contact specifică un set de câmpuri și valori care sunt utilizate pentru a defini un centru de contact în Salesforce pentru un anumit sistem CTI. Salesforce utilizează fișiere de definiție a centrului de contact pentru a sprijini integrarea cu mai mulți furnizori de sisteme CTI.
Informații suplimentare pot fi găsite în documentația oficială a Salesforce ( link direct).
Importați centrul de contact
Descărcați cea mai recentă versiune a Centrului de contact aici.
Upgrade de la Beta: Acest ghid descrie o instalare curată a versiunii Disponibilitate generală (GA) a integrării Webex Contact Center pentru Salesforce Service Cloud Voice.
Dacă efectuați upgrade de la o versiune Beta a integrării, nu reutilizați o înregistrare existentă a Centrului de contact al partenerului. În schimb:
- Importați fișierul XML al Centrului de contact al partenerului inclus în versiunea GA.
- Creați o nouă înregistrare a Centrului de contact al partenerului utilizând fișierul XML importat.
- Actualizați-vă configurația pentru a utiliza Centrul de contact pentru parteneri nou creat.
XML-ul centrului de contact al partenerului GA conține valori de configurare actualizate, inclusiv URL-ul conectorului corect și alte metadate. Reutilizarea unei înregistrări de Centru de contact partener creată din XML beta poate păstra valori de configurare perimate și poate împiedica funcționarea corectă a integrării.
| 1 |
Din Configurare, introduceți Partner Telephony Contact Centers în Quick Find casetă, apoi selectați Partner Telephony Contact Centers. Este afișată lista centrelor de contact existente (dacă există).
|
| 2 |
Clic Create Contact Center în partea dreaptă a paginii. |
| 3 |
Selectare Webex Contact Center în calitate de furnizor de servicii de telefonie. Apoi faceți clic pe Next.
Se deschide un browser de fișiere.
|
| 4 |
Selectează |
| 5 |
Clic Open. Fișierul este importat.
|
| 6 |
Verificați dacă centrul de contact este afișat în vizualizarea listei de centre de contact.
|
Configurați Centrul de contact
| 1 |
Din Configurare, introduceți Partner Telephony Contact Centers în Quick Find casetă, apoi selectați Partner Telephony Contact Centers. | ||||||||||||||||||||||||||||||
| 2 |
Faceți clic pe Centrul de contact importat anterior. | ||||||||||||||||||||||||||||||
| 3 |
Clic Edit.
| ||||||||||||||||||||||||||||||
| 4 |
În partea de jos Contact Center pagină, faceți clic Add buton sub Contact Center Users secțiune. | ||||||||||||||||||||||||||||||
| 5 |
Faceți clic pe + lângă utilizatorii care au acces la Centrul de contact deschis. Numai utilizatorii care au |
Personalizaţi
Aplicație client extern pentru integrarea Webex Contact Center
Configurarea aplicației client extern pentru Webex Contact Center Salesforce Connector
Pentru a utiliza pe deplin Service Cloud Voice, fluxul de apeluri la Centrul de contact poate fi adaptat pentru a crea înregistrarea apelurilor vocale și pentru a executa un flux Salesforce Omni-Channel în timp ce apelul este pe IVR.
Creare certificat
Asigurați-vă că ați creat deja un certificat digital conform politicii de securitate a organizației dvs.
Pentru a genera un certificat digital, consultați documentația Salesforce la https://developer.salesforce.com/docs/atlas.en-us.voice_pt_developer_guide.meta/voice_pt_developer_guide/voice_pt_generate_certificate.htm.
Exemplu
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 => Certificat pentru aplicația client extern Salesforce
server.key => Cheie privată pentru Salesforce Connector în Webex Control Hub
Permisiune setată pentru utilizatorul de integrare SCV
Următorul set de permisiuni acordă acces la clasele Apex utilizate de Conectori pentru SCV pentru integrarea cu fluxurile IVR ale centrului de contact și Webex Contact Center pentru Salesforce pentru SCV.
Următoarea este un exemplu de configurație și descrie permisiunile minime necesare pentru ca integrarea Centrului de contact/IVR să funcționeze.
- De la configurare, navigați la Utilizatori | Seturi de permisiuni.
- Faceți clic pe New buton.
- Introduceți o etichetă, de exemplu: Acces IVR la clasele SCV Apex
- Numele API este completat automat
- Licență: Fără
- Faceți clic pe Save buton.
- Se deschide noul set de permisiuni.
- Navigheaza catre Apex Class Access.
- Faceți clic pe Edit buton și adăugați următoarele clase Apex:
- cisco_wxcc_scv.RutareServiciu
- Navigheaza catre System Permissions.
- Faceți clic pe Edit buton și activați următoarele Permisiuni:
- Servicii REST Apex
- API activat
Acces minim - profil de integrări numai API
Acest profil este utilizat pentru integrarea cu Webex Contact Center for Salesforce pentru SCV pentru a crea înregistrări ale apelurilor vocale și pentru a Executa Omni-Flow din fluxul IVR.
Următoarea este un exemplu de configurație și descrie permisiunile minime necesare pentru ca integrarea Centrului de contact/IVR să funcționeze.
Aceasta este o clonă a profilului de integrări Acces minim - API Only.
- De la Configurare, navigați la Utilizatori | Profiluri.
- În lista Profiluri, căutați profilul Acces minim - integrări numai API.
- Faceți clic pe numele profilului pentru a deschide Minimum Access - API Only Integrations profilul.
- Pe Minimum Access - API Only Integrations profil, faceți clic pe Clone buton.
- Introduceți un nou nume de profil, de exemplu: Integrarea SCV.
- Faceți clic pe Save buton.
- Se deschide noul profil.
- Verificați dacă profilul dvs. de acces minim – integrări numai API are toate permisiunile eliminate din profilul în sine.
- Navigheaza catre System Permissions.
- Asigurați-vă că următoarele Permisiuni sunt activate:
- API activat
- Utilizator Exclusiv API
Utilizator integrare SCV
Următoarea este un exemplu de configurație și descrie permisiunile minime necesare pentru ca integrarea Centrului de contact/IVR să funcționeze. Nu este necesară nicio licență Salesforce Service Cloud Voice sau licență Webex Contact Center pentru Salesforce pentru SCV pentru utilizatorul de integrare SCV.
- De la Configurare, navigați la Utilizatori | Utilizatori.
- Faceți clic pe New User buton.
- Introduceți prenumele, numele de familie și toate celelalte câmpuri obligatorii.
- Licență utilizator: Integrarea Salesforce
- Profil: selectați profilul creat în pasul anterior („Profil de integrare SCV”, clonă a Accesului minim - profil integrări numai API)
- Faceți clic pe Save buton.
- Deschideți noua înregistrare de utilizator.
- Alocați Permission Set creat anterior („IVR Access to SCV Apex Classes”).
- Atribuiți licența setată de permisiune Integrare API Salesforce.
Creați aplicația client extern Salesforce
Creați o nouă aplicație client extern
Există două opțiuni pentru a vă conecta datele Salesforce cu aplicații terțe. Ambele Connected Apps și External Client Apps sunt cadre pentru integrarea datelor. Aplicațiile client externe sunt următoarea generație de aplicații conectate.
Pentru a configura aplicația client extern Salesforce care este utilizată de Cisco Webex Contact Center:
- din Setup, navigați la Apps | External Client Apps | External Client App Manager.
- Faceți clic pe New External Client App.
- External Client App—Basic Information
- Nume aplicație client extern: WxCC - SCV
- Nume API: WxCC_SCV
- E-mail de contact: < e-mailul dvs. >
- Stare distribuție: selectați Local

External Client App—API (Enable OAuth Settings)
- Selectați: Activați OAuth
- Setări aplicație
- URL de apelare inversă: http://localhost:1717/OauthRedirect ca exemplu de URL de apelare inversă
- Sfere OAuth
- Selectați domeniile OAuth:
- Administrați datele utilizatorului prin API (api)
- Efectuați solicitări în orice moment (refresh_token, offline_access)

Flow Enablement
- Selectați: Activare flux JWT Carrier
- Faceți clic pe Încărcare fișiere și încărcați
server.crtfișier care conține certificatul dvs. digital.

Security
Debifați Require secret for the Web Server Flow opțiune.

- Faceți clic pe Create buton.
- Modificați în Tab Policies apoi faceți clic pe Edit buton.
- Politici—Politici OAuth
- Politici modul
- Utilizatori permiși: selectați Utilizatorii aprobați de administrator sunt preautorizați
- Confirmați modificarea
- Autorizare aplicație
- Politica privind tokenurile de reîmprospătare: selectați Expiră imediat tokenul de reîmprospătare
- Relaxare IP: selectați Impunere restricții IP

- Politici modul
- Politici—Politici aplicație
- Pagina de pornire—fără
- Selectați seturi de permisiuni – atribuiți setul de permisiuni creat anterior („Acces IVR la clasele SCV Apex”)

- Clic Save.
- Treceți la Setări filă.
-
Setări OAuth secțiune, faceți clic Consumer Key și Secret buton; așteptați e-mailul și verificați-vă identitatea. O nouă filă de browser deschide un ecran cu detaliile consumatorului.

- Clic Copy și salvați Consumer Key. Cheia de consumator este utilizată ulterior pentru a crea Salesforce Connector în Webex Contact Center Control Hub.

-
Configurația Webex Contact Center și scriptul pentru a crea înregistrări ale apelurilor vocale
Pentru a obține valoarea completă a Salesforce Service Cloud Voice, fluxul de apeluri din Webex Contact Center trebuie modificat pentru a crea înregistrarea Apel vocal în Service Cloud Voice imediat ce apelul ajunge în Centrul de contact.
Un Omni-Flow opțional poate fi executat pentru decizii de rutare și automatizare în Salesforce.
Pentru detalii despre API-urile utilizate, consultați Wrapper API voce serviciu cloud.
Cerințe preliminare
Pentru a utiliza API-ul Service Cloud Voice, trebuie configurată o aplicație client extern Salesforce pentru integrarea IVR.
Configurați Salesforce Connector în Webex Control Hub
Configurați conectorii de integrare Salesforce pentru Webex Contact Center, conform descrierii din articolul de la https://help.webex.com/en-us/article/7fuy63/Set-Up-Integration-Connectors-for-Webex-Contact-Center#id_133211.
| 1 |
Conectați-vă la organizația dvs. client la https://admin.webex.com și navigați la Servicii > Centru de contact > Setări entitate găzduită > Integrări>Conectori. |
| 2 |
Pe cardul Salesforce, faceți clic pe Configurare sau Adăugare conector.
IMPORTANT: MENȚINEȚI SECURITATEA PRIN ROTIREA PERIODICĂ A SECRETELOR Asigurați-vă că rotiți în mod regulat cheia privată și certificatul pentru a vă menține integrările în siguranță. Actualizați cheia privată în Contact Center Connector din Webex Hub și certificatul în Aplicația client extern din Salesforce. Sfat soluționare probleme După ce faceți clic pe Terminat, iar conectorul nu salvează:
|
Fluxul principal pentru Webex Contact Center
| Variabilă flux | Descriere |
|---|---|
| Variabilă de flux pentru ID-ul înregistrării apelurilor vocale | Id unic pentru a identifica apelul. Necesar pentru a crea înregistrarea apelurilor vocale. Format: wxcc_<Id interacțiune> Exemplu: wxcc_fc4ec7d8-4c91-49aa-b764-081fbba344a8
|
| Variabilă locală pentru ora de începere a apelului |
Utilizat pentru a crea înregistrarea apelului vocal și la actualizarea apelului vocal.
|
| Variabilă locală pentru numele/ID-ul cozii |
Returnat de Executați Omni Flow, utilizat pentru rutarea apelurilor. Această variabilă este necesară numai când se utilizează Execute Omni Flow
|
| Variabilă locală pentru numele/id-ul agentului |
Returnat de Executați Omni Flow, utilizat pentru rutarea apelurilor. Această variabilă este necesară numai când se utilizează Execute Omni Flow
|
Prezentare generală a fluxului principal

- Generați cheia de apel a furnizorului
- Setare oră de începere a apelului
- Solicitare HTTP: Creați înregistrarea apelurilor vocale
- Evaluați răspunsul HTTP pentru crearea înregistrării apelurilor vocale
- Gestionarea erorilor pentru crearea înregistrării apelurilor vocale
- Solicitare HTTP: Executați fluxul Omni
- Evaluați răspunsul HTTP pentru executarea fluxului Omni
- Tratarea erorilor pentru Executarea Fluxului Omni
- Continuați cu rutarea apelurilor
| Flux | Descriere |
|---|---|
| Generați cheia de apel a furnizorului |
Fiecare apel gestionat în Service Cloud Voice creează o înregistrare a Apelului vocal în Salesforce și necesită un ID unic, denumit Cheia de apel a furnizorului. Pentru înregistrările apelurilor vocale create în Webex Contact Center, cheia apelului furnizorului trebuie să fie definită în fluxul WxCC și apoi transmisă împreună cu apelul către agent, utilizând o variabilă de flux. Valoarea vendorCallKey trebuie să respecte următoarele reguli:
|
| Setare oră de începere a apelului |
Marca temporală UTC a orei de începere a apelului. Acest marcaj temporal este utilizat pentru a crea înregistrarea apelului vocal și pentru a actualiza înregistrarea apelului vocal dacă apelantul închide înainte de a fi direcționat către agent.
|
| Solicitare HTTP: Creați înregistrarea apelurilor vocale |
Acest pas este necesar pentru fiecare apel. După ce este creată înregistrarea apelului vocal, ID-ul înregistrării apelului vocal trebuie să fie transmis împreună cu apelul către agent într-o variabilă, împreună cu cheia de apel a furnizorului. Configurați variabila utilizată în configurarea centrului de contact din Service Cloud Voice. |
| Setări solicitare HTTP |
|
Solicitare HTTP: Creați înregistrarea apelurilor vocale
Acest pas este necesar pentru fiecare apel. După ce este creată înregistrarea apelului vocal, ID-ul înregistrării apelului vocal trebuie să fie transmis împreună cu apelul către agent într-o variabilă, împreună cu cheia de apel a furnizorului. Configurați variabila utilizată în configurarea centrului de contact din Service Cloud Voice.
Setări solicitare HTTP
- Etichetă activitate: Creați apel vocal
- Utilizați punctul final autentificat: Activat
- Conector: Salesforce Connector creat în pasul anterior
- Calea solicitării:
/services/apexrest/cisco_wxcc_scv/voice/v1/createVoiceCall - Metodă: POST
- Tip conținut solicitare: Aplicație/JSON
Solicitare corp
Atunci când creați înregistrarea Apel vocal, puteți actualiza și câmpurile personalizate din înregistrarea Apel vocal cu datele apelurilor. Mai jos găsiți două exemple de corp de solicitare, unul cu toate câmpurile obligatorii, dar fără actualizarea câmpurilor personalizate și unul cu câmpuri personalizate.
Fără actualizarea câmpurilor personalizate din înregistrarea apelurilor vocale:
{
"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"
}
]
}
Exemplu cu actualizarea câmpurilor personalizate din înregistrarea apelurilor vocale:
{
"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>\"}"
}
Parametrii
| Denumire proprietate | Valoare |
|---|---|
| DevCentruApelareName | Numele dezvoltatorului Contact Center |
| certDevName | Numele API al certificatului (așa cum este configurat în Centrul de contact) |
| vânzătorCallKey | ID apel unic: {{SCV_VendorCallKey}}
|
| la | Număr apelat/DNIS: {{NewPhoneContact.DNIS}}
|
| din | Număr apelare/ANI: {{NewPhoneContact.ANI}}
|
| Oră începere | Marca temporală UTC {{SCV_CallStartTime}} (a se seta imediat după acceptarea în script a apelului) |
| Atribute apel |
Reprezintă câmpuri standard și personalizate suplimentare în înregistrarea apelului vocal, în care fiecare pereche de valori cheie corespunde unui câmp standard sau personalizat și valorilor sale. Exemplu:
|
Setări scanare
- Tip conținut: JSON
- Variabilă de ieșire: Id înregistrare apel vocal
- Expresie cale:
$.data.voiceCallId
ID-ul înregistrării apelurilor vocale, care va fi transmis agentului.
Evaluați răspunsul HTTP pentru crearea înregistrării apelurilor vocale
Verificați starea HTTP a solicitării http Creare apel vocal:
- Etichetă: statusCodeCreateVoiceCall
- Variabilă: CreateVoiceCall.httpStatusCode
Dacă codul de stare == 200 => successful else => nu a reușit, gestionarea erorilor
Gestionarea erorilor pentru crearea înregistrării apelurilor vocale
Doar pentru demo / depanare, redați mesajul în funcție de codul de stare http.
Dacă s-a reușit crearea apelului vocal, continuați cu Executare flux Omni. În caz contrar, continuați cu rutarea apelurilor.
Solicitare HTTP: Executați fluxul Omni (pas opțional)
Utilizați Executa Omni-Flow atunci când doriți:
- rulați activități automate, de exemplu căutați sau creați înregistrări și asociați înregistrările cu înregistrarea apelurilor vocale
- căutați înregistrări și efectuați mesaje pop-up pe ecran
- sincronizați cozile Salesforce și Cisco
- permiteți Service Cloud Voice să ia decizia de rutare
Această solicitare returnează întotdeauna „coada de apeluri” sau „agentul” către locul în care trebuie să fie direcționat apelul.
După executarea acestei solicitări, asigurați-vă că trimiteți Rutare Clară dacă apelantul închide înainte de a primi un răspuns de către un agent. Consultați Fluxul de evenimente Webex Contact Center.
Setări solicitare HTTP
- Etichetă activitate: ExecutăOmniFlow
- Utilizați punctul final autentificat: Activat
- Conector: Salesforce Connector creat în pasul anterior
- Calea solicitării:
/services/apexrest/cisco_wxcc_scv/voice/v1/executeOmniFlow - Metodă: POST
- Tip conținut solicitare: Aplicație/JSON
Solicitare corp
În afară de câmpurile obligatorii, puteți transmite date suplimentare ca variabile de intrare în Omni-Flow. În continuare se prezintă două exemple de cereri formulate. În primul rând, fără parametri de flux suplimentari, numai câmpurile obligatorii, al doilea cu două variabile de intrare.
Exemplu cu parametri 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>"
}
Exemplu pentru actualizarea câmpurilor personalizate din înregistrarea apelurilor vocale:
{
"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"
}
}
Parametrii
| Denumire proprietate | Valoare |
|---|---|
| DevCentruApelareName | Numele dezvoltatorului Contact Center |
| certDevName | Numele API al certificatului (așa cum este configurat în Centrul de contact) |
| ID apelare vocală | ID-ul înregistrării apelurilor vocale, creat la pasul anterior:
{{SCV_VoiceCallRecordId}}
|
| Număr apelat | Număr apelat/DNIS: {{NewPhoneContact.DNIS}}
|
| flowDevName | Numele dezvoltatorului fluxului Omni de executat |
| Coadă de rezervă | ID-ul cozii sau numele API-ului cozii de rezervă pentru coada Salesforce |
| parametrii flux |
intrări suplimentare la fluxul Omni-Channel (pereche valoare cheie). Exemplu:
|
Setări scanare
Secvenţă
- Tip conținut: JSON
- Variabilă de ieșire: Coadă SCV_OmniFlow
- Expresie cale:
$.data.queue
„Coada” returnată de la Execute Omni-Flow poate fi utilizată pentru rutare.
Agent- Tip conținut: JSON
- Variabilă de ieșire: Agent SCV_OmniFlow
- Expresie cale:
$.data.agent
"Agent" returnat de la Execute Omni-Flow, poate fi utilizat pentru rutare.
Evaluați răspunsul HTTP pentru executarea fluxului Omni
Verificați starea HTTP a solicitării Execute Omni Flow http:
- Etichetă: statusCodeExecuteOmniFlow
- Variabilă: ExecuteOmniFlow.httpStatusCode
Dacă codul de stare == 200 => successful else => nu a reușit, gestionarea erorilor.
Tratarea erorilor pentru Executarea Fluxului Omni
Doar pentru demo / depanare, redați mesajul în funcție de codul de stare http.
Dacă s-a reușit execuția fluxului Omni, variabilele SCV_OmniFlowQueue și SCV_OmniFlowAgent nu sunt setate. Decizie de rutare în fluxul de apeluri.
Continuați cu rutarea apelurilor
Continuați în fluxul de apeluri, direcționați apelul către agent. Opțional, utilizați SCV_OmniFlowQueue și SCV_OmniFlowAgent pentru a selecta coada de apeluri și agentul.
Fluxul evenimentelor pentru Webex Contact Center
Dacă apelantul închide apelul înainte ca un agent să îi răspundă, trebuie să actualizăm Service Cloud Voice și să terminăm apelul.
- Dacă s-a utilizat Execute Omni-Flow, trimiteți rutare clară pentru a șterge rutarea serviciului în așteptare (PSR)
- Trimiteți actualizarea apelului vocal, pentru a actualiza orele de începere și de încheiere din înregistrarea apelului vocal și pentru a schimba starea de la Nou la Finalizat

- PhoneContactEnded - Acest eveniment este declanșat atunci când un apel live este deconectat și toți participanții sunt eliminați.
- Solicitare HTTP: Eliminați rutarea
- Solicitare HTTP: Actualizați apelul vocal
Solicitare HTTP: Eliminați rutarea
- Etichetă: Ștergere rutare
- Utilizați punctul final autentificat: Activat
- Conector: Salesforce Connector creat în pasul anterior
- Calea solicitării:
/services/apexrest/cisco_wxcc_scv/voice/v1/clearRouting - Metodă: POST
Tip conținut solicitare: Aplicație/JSON
Solicitare corp
{
"callCenterDevName": "<Contact Center API name>",
"certDevName": "<cert dev name>",
"voiceCallId": "{{SCV_VoiceCallRecordId}}"
}
Parametrii
| Denumire proprietate | Valoare |
|---|---|
| DevCentruApelareName | Numele dezvoltatorului Contact Center |
| certDevName | Numele API al certificatului (așa cum este configurat în Centrul de contact) |
| ID apelare vocală | ID-ul înregistrării apelurilor vocale, creat la pasul anterior: Id înregistrare apel vocal |
Setări scanare
Nimic.
Solicitare HTTP: Actualizați apelul vocal
- Etichetă: Actualizați apel vocal
- Utilizați punctul final autentificat: Activat
- Conector: Salesforce Connector creat în pasul anterior
- Calea solicitării:
/services/apexrest/cisco_wxcc_scv/voice/v1/updateVoiceCall - Metodă: POST
- Tip conținut solicitare: Aplicație/JSON
Solicitare corp
{
"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 }
}
Parametrii
| Denumire proprietate | Valoare |
|---|---|
| DevCentruApelareName | Numele dezvoltatorului Contact Center |
| certDevName | Numele API al certificatului (așa cum este configurat în Centrul de contact) |
| ID apelare vocală | ID-ul înregistrării apelurilor vocale, creat la pasul anterior: Id înregistrare apel vocal |
| Oră începere | Marca temporală UTC de la începerea apelului {{SCV_CallStartTime}} (așa cum este utilizată pentru a crea înregistrarea apelurilor vocale) |
| Oră încheiere | Marca temporală curentă UTC `{{now() |
| deconectareReason | Motivul deconectării apelului. Proprietatea isError
trebuie să fie setată la true pentru ca acesta să se afișeze corect. |
Setări scanare
Nimic.
Referințe
- Creați o cheie privată și un certificat digital autosemnat
- Configurați aplicația conectată pentru Webex Contact Center Salesforce Connector
- Configurarea conectorilor de integrare pentru Webex Contact Center - Salesforce
- Ghid de configurare și administrare a Cisco Webex Contact Center > Designer de flux
- REST API integrare telefonie
Traducere limbă
(Opțional) Activați bancul de lucru pentru traduceri
Această setare se aplică numai dacă utilizați setările Limbii pentru traducere.
| 1 |
Accesaţi Configurare → Traducere Bench → Setări limbă traducere. |
| 2 |
Clic Enable pentru a selecta limba pentru traducere.
|
(Opțional) Activați limbile exclusiv pentru platformă
Această setare se aplică numai pentru alte limbi decât EN-US.
| 1 |
Accesați Configurare → Setări companie → Setări limbă. |
| 2 |
Alegeți limbile necesare. |
| 3 |
Selectați următoarele casete de selectare:
|
| 4 |
Salvați modificările.
|
Activați limba și selectați utilizatorul (sarcină)
| 1 |
Accesaţi Configurare → Traducere Bench → Setări limbă traducere. |
| 2 |
Alegeți limba și selectați utilizatorul care o va traduce. |
| 3 |
Salvați modificările.
|
Setări pentru mai multe limbi
Traduceți etichete personalizate
| 1 |
Accesați Configurare → Etichete personalizate. |
| 2 |
Selectați numele etichetei personalizate de deschis.
|
| 3 |
În lista Traduceri asociate, faceți clic pe |
| 4 |
Selectați Limba în care traduceți.
|
| 5 |
Introduceți valoarea tradusă în câmpul Text traducere. Acest text suprascrie valoarea specificată în câmpul Valoare al etichetei atunci când limba implicită a unui utilizator este limba de traducere. |
| 6 |
Salvați modificările. |
Permisiunile Salesforce sunt necesare De Funcția Utilizatorului
Setul de permisiuni pentru agenți SCV pentru Webex Contact Center conține toate permisiunile necesare pentru a funcționa cu gadgetul Webex Contact Center și integrările dezvoltate pentru agenți.
Acces clasă Apex (secțiune)
- cisco_wxcc_scv.CiscoScvWxcc
- cisco_wxcc_scv.ServiceResponseHandler
- cisco_wxcc_scv.RutareServiciu
- cisco_wxcc_scv.HandlerIntegrareTelefonie
Accesări tip de metadate particularizate (secțiune)
- Conexiune cisco_wxcc_scv.WxCC
Visualforce Page Access (secțiune)
- cisco_wxcc_scv.CiscoScvConectareWxCC
- cisco_wxcc_scv.CiscoScvMainWxCC
- cisco_wxcc_scv.CiscoScvOAuthRedirect
- cisco_wxcc_scv.CiscoScvSwLoader
Wrapper API voce Service Cloud
Cerințe preliminare
Pentru a utiliza API-ul Service Cloud Voice, trebuie configurată o aplicație client extern Salesforce pentru integrarea IVR.
Utilizați API-ul de voce Service Cloud
Service Cloud Voice (SCV) pentru Salesforce utilizează API REST pentru integrarea telefonică pentru a crea și actualiza apeluri vocale, a executa fluxuri Omni-Channel și a șterge înregistrările PendingServiceRouting asociate unui apel vocal. Acest serviciu necesită autorizare JWT și utilizarea metodei PATCH HTTP, care în prezent nu este acceptată de Răspunsul vocal interactiv Cisco IP (IVR).
Pentru a simplifica utilizarea API REST pentru integrarea telefonică pentru SCV într-un sistem IVR (nu numai), a fost pus la dispoziție un nou set de API-uri, care împachetează API-ul Salesforce existent și sunt accesibile direct din organizația Salesforce unde este instalat pachetul Webex Contact Center pentru servicii cloud voce.
Service Cloud Voice API wrapper elimină necesitatea de a autentifica un token JWT, implementează verificări suplimentare ale datelor solicitate de API Salesforce și îmbunătățește obiectele de răspuns.
Preluați tokenul_Access
Executați o solicitare POST către https://<your-domain-name>.my.salesforce.com/services/oauth2/token
Trimiterea următorilor parametri în corp:
{
"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>"
}
Executați solicitările
URL-ul instanței trebuie să conțină my.salesforce.com.
Exemplu de URL instanță corectă: https://abc-123.my.salesforce.com
Dacă utilizați orice alt domeniu ca URL de instanță (de exemplu, https://abc-123.lightning.force.com ), se generează o stare 401 Unauthorized, cu returnarea unui cod de eroare INVALID_SESSION_ID.
Creați apel vocal (secțiune)
Creează o înregistrare Apel vocal care conține participanții (adică apelantul și destinatarul) pentru înregistrarea Apel vocal. Când creați o înregistrare VoiceCall, se creează o conversație în Salesforce. Utilizați acest API numai în context în timp real, ceea ce înseamnă că ar trebui să invocați acest API numai atunci când este inițiat un apel. De asemenea, acest API poate fi utilizat pentru a crea înregistrări VoiceCall pentru apeluri de transfer și conferință prin includerea parametrului părinteVoiceCallId în sarcina utilă a solicitării.
URI punct final
<instance_url>/servicii/apexrest/cisco_wxcc_scv/voice/v1/createCallVoice
Metodă HTTP
POST
Antete
Autorizație: Purtător <access_token>
Tip conținut: aplicație/json
Parametrii
{
"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"
}
Răspuns (reușit)
{
"data": {
"voiceCallId": "00X000012345abc"
},
"errors": null,
"success": true
}
Răspuns (cu erori)
{
"data": null,
"errors": ["Error message 1", "Error message 2"],
"success": false
}
Actualizați apelul vocal
Actualizează apelul vocal după terminarea apelului. Utilizați acest API pentru a actualiza parametrii legați de apeluri care nu sunt disponibili în timpul etapei de creare a apelului vocal. Actualizarea API-ului VoiceCall este o operațiune asincron. Nu puteți solicita starea apelului API.
Acest terminal poate fi, de asemenea, utilizat pentru a crea un apel vocal chiar și după încheierea apelului. Acest comportament este util în scenariile în care doriți să înregistrați o înregistrare în Salesforce pentru apelurile abandonate sau pierdute sau pentru orice alt scenariu în care nu a fost deja creat un VoiceCall.
URI punct final
<instance_url>/servicii/apexrest/cisco_wxcc_scv/voice/v1/updateVoiceCall
Metodă HTTP
POST
Antete
Autorizație: Purtător <access_token>
Tip conținut: aplicație/json
Parametrii
{
"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
}
}
O descriere detaliată a parametrilor acceptați de această solicitare poate fi găsită în Salesforce documentația oficială , în secțiunea „Parametri”.
Răspuns (reușit)
{
"data": {
"status": "pending"
},
"errors": null,
"success": true
}
Actualizarea API-ului VoiceCall este o operațiune asincron. Nu puteți solicita starea apelului API.
Răspuns (cu erori)
{
"data": null,
"errors": ["Error message 1", "Error message 2"],
"success": false
}
Executați Omni-flow
Execută fluxul Omni-Channel pentru a direcționa apelurile. Acesta transmite ID-ul apelului (Salesforce VoiceCallId sau ContactId furnizorul de telefonie) ca parametri fluxului și returnează instrucțiunile de rutare ale agentului sau cozii către fluxul de contact. În mod implicit, Service Cloud Voice utilizează fluxul Omni-Channel (sau coada de rezervă) specificat pentru canalul telefonic care corespunde numărului format. Dacă numărul format nu corespunde unui canal telefonic existent, puteți seta, opțional, un nou număr format, un flux Omni-Channel și o coadă de rezervă ca parametri de intrare pentru acest apel API.
Service Cloud Voice utilizează această ordine de prioritate pentru a direcționa apelurile:
- Utilizează setările de flux omni-canal și coadă de rezervă pentru canalul telefonic care corespunde numărului format. Fluxul are prioritate. Dacă fluxul nu reușește, este utilizată coada de rezervă.
- Utilizează parametrii flowDevName și fallbackQueue specificați în apelul Execute API Omniflow.
URI punct final
<instance_url>/services/apexrest/cisco_wxcc_scv/voice/v1/executeOmniFlow
Metodă HTTP
POST
Antete
Autorizație: Purtător <access_token>
Tip conținut: aplicație/json
Parametrii
{
"callCenterDevName": "contactCenterDevName123",
"certDevName": "certDevName123",
"voiceCallId": "00X000012345abc",
"dialedNumber": "+18445791189",
"flowDevName": "Route_VoiceCall",
"fallbackQueue": "00G111222333444",
"flowInputParameters":
{
"Input1": "one",
"Input2": "two"
}
}
- Parametrul voiceCallId este ID-ul voiceCallId Salesforce sau ID-ul de contact al furnizorului de telefonie.
- O descriere detaliată a parametrilor acceptați de această solicitare poate fi găsită în Salesforce documentația oficială , în secțiunea „Parametri”.
Răspuns (reușit)
{
"data": {
"queue": "queue info",
"agent": "agent info"
},
"errors": null,
"success": true
}
AGENT_INFO și QUEUE_INFO corespund câmpului ExternalId din CallCenterRoutingMap
Răspuns (cu erori)
{
"data": null,
"errors": ["Error message 1", "Error message 2"],
"success": false
}
Ștergeți rutarea
Șterge înregistrarea PendingServiceRouting (PSR) pentru un apel vocal. Acest API nu trebuie să fie apelat pentru majoritatea scenariilor; înregistrarea PSR este ștearsă automat când apelul nu mai este rutat. Cu toate acestea, există unele scenarii, cum ar fi pentru apelurile pierdute sau abandonate atunci când utilizați sisteme de telefonie ale partenerilor, unde trebuie să apelați în mod explicit acest API pentru a șterge înregistrarea PSR.
URI punct final
<instance_url>/servicii/apexrest/cisco_wxcc_scv/voice/v1/clearRouting
Metodă HTTP
POST
Antete
Autorizație: Purtător <access_token>
Tip conținut: aplicație/json
Parametrii
{
"callCenterDevName": "contactCenterDevName123",
"certDevName": "certDevName123",
"voiceCallId": "00X000012345abc"
}
- Parametrul voiceCallId este ID-ul voiceCallId Salesforce sau ID-ul de contact al furnizorului de telefonie.
- O descriere detaliată a parametrilor acceptați de această solicitare poate fi găsită în Salesforce documentația oficială , în secțiunea „Parametri”.
Răspuns (reușit)
{
"data": {
"status": "Success"
},
"errors": null,
"success": true
}
Răspuns (cu erori)
{
"data": null,
"errors": ["Error message 1", "Error message 2"],
"success": false
}
Traduceri număr de telefon
Diferitele interacțiuni dintre Service Cloud Voice și Webex Contact Center depind de traducerile numerelor de telefon. Din cauza diferențelor internaționale și a aplicațiilor specifice clienților, este necesar un instrument personalizabil pentru a transfera numere de telefon din formatul A în formatul B.
Soluția Webex Contact Center for Service Cloud Voice elimină automat toate caracterele, cu excepția numerelor, a hashtag-urilor (#), a asteriscurilor (*), a virgulei (,) și a semnelor plus în față (+). De asemenea, elimină prima apariţie a (0). Acest lucru se va face ÎNAINTE DE aplicarea traducerilor numerelor dvs. de telefon.
Acest ghid descrie modul de configurare a traducerilor numerelor de telefon.
Câmpuri
Traducerile numerelor de telefon sunt stocate în câmpurile Nume-Valoare. Acest lucru vă permite să configurați un număr nelimitat de reguli pentru fiecare caracteristică.
Configurația este stocată ca șir JSON.
Rețineți că trebuie să scăpăm de bara oblică invers, de ex. \d+ devine \\d+.
{"Remove all characters but digits":"[1,17]->[^\\d]+","To internal number":"[7,17]->(\\d{7})(\\d{4})->$2"}
Din punct de vedere tehnic, numele câmpului nu este utilizat. Există pentru a adăuga un șir lizibil uman pentru a identifica rapid scopul acestei reguli. Numele bune sunt, de exemplu: Eliminați toate zerourile în față, Adăugați plus în față etc.
Se creează regulile pentru traducere
Regulile sunt furnizate ca Expresii Regulate. Pentru a fi mai precisă: Implementarea JavaScript a expresiilor regulate.
O modalitate bună de a începe este prin citirea documentului RegExp din documentele web MDN.
Cu toate acestea, crearea de Expresii Regulate complexe este adesea greoaie. Prin urmare, am adăugat sintaxă suplimentară pentru a face configurarea cât mai ușoară posibil.
Figura de mai jos prezintă sintaxa generală a regulii de traducere a unui număr de telefon:
Predicați
Predicatul este utilizat pentru a specifica un interval care definește lungimea numărului care se potrivește.
Predicatul de mai sus specifică faptul că toate numerele cu o lungime cuprinsă între 7 și 11 (inclusiv marginile + spațiile) corespund.
Predicatele corespund întotdeauna lungimii inițiale a numărului. Acest lucru ajută la simplificarea configurării prin reducerea riscului de coliziune a regulilor pentru numerele interne/externe.
Șablon
Modelul specifică formatul numărului care se va potrivi.
Modelul de mai sus afirmă că numărul trebuie să conțină numai cifre și le selectează.
Selector de fișiere
Selectorii definesc formatul final al numărului. În cazul în care trebuie adăugate caractere / cifre care nu au fost prezente inițial, acesta este locul în care se poate face acest lucru.
Selectorul este ultimul pas din construirea numărului. Pe baza ieșirii modelului, selectorul construiește noul număr.
Exemplu 1
Următorul exemplu arată cum puteți transfera un număr primit de la Centrul de contact în formatul 0319175200 în formatul elvețian E164 +41 31 917 52 00.
Acest exemplu utilizează două reguli de traducere (1 şi 2.)
Prima regulă din acest exemplu nu schimbă de fapt numărul. Pentru numerele cu lungimea cuprinsă între 1 și 17 (de) caractere, vor fi eliminate orice altceva decât cifrele. Deoarece nu există nicio cifră prezentă, nu se schimbă nimic.
A doua regulă se aplică numerelor care au exact 10 (inițial) caractere. 0319175200 se potrivește și, prin urmare, regula este aplicată. Modelul specifică faptul că numărul trebuie să înceapă cu un grup de o cifră (\d{1}), urmat de un grup de două cifre (\d{2}), urmat de un grup de trei cifre (\d{3}) etc.
Selectorul accesează apoi grupurile de șabloane pentru a defini noul șir de numere. Aceasta înseamnă că $2 face referire la primul (\d{2}) și, prin urmare, conține 31.
Exemplu 2
Următorul exemplu arată cum puteți transfera un număr primit de la Centrul de contact în formatul +14693150217 în formatul E164 +1 469 315 0217 din SUA.
Acest exemplu utilizează două reguli de traducere (1 şi 2.)
- Acest număr are exact 12 (de) caractere, astfel că se aplică regula „Adăugaţi spaţii la numerele din SUA”.
- (\+1) spune că numărul trebuie să înceapă cu +1. Dacă numărul are 12 (de) caractere, dar nu începe cu +1, regula este anulată și nu se modifică nimic.
- (\d{3}) spune că +1 trebuie să fie urmate de 3 cifre.
- (\d{3}) spune că ultimele 3 cifre trebuie să fie urmate de alte 3 cifre.
- (\d{4}) spune că ultimele 3 cifre trebuie să fie urmate de 4 cifre.
Dacă oricare dintre acestea nu se potrivește, numărul nu va fi modificat.
Deci, toate regulile se aplică pentru “+14693150217”. Prin urmare, numărul este modificat de „$1 $2 $3 $4”:
- $1 se referă la grup (\+1), numărul de trimis către Serviciul Cloud Voice arată ca +1.
- $2 se referă la primul dintre cele două (\d{3}); numărul de trimis către serviciul cloud de voce arată ca +1 469.
- $3 se referă la a doua dintre cele două (\d{3}); numărul de trimis către serviciul cloud de voce arată ca +1 469 315.
- $4 se referă la ultimul grup (\d{4}); numărul de trimis către serviciul cloud de voce arată ca +1 469 315 0217.
Spațiile din partea de înlocuire a regulii „$1 $2 $3 $4” sunt utilizate direct. Deci, dacă utilizați „$1-$2-$3-$4” numărul va fi tradus în: +1-469-315-0217
Și, de asemenea, vi se permite să eliminați grupuri: [12, 12]->(\+1)(\d{3})(\d{3})(\d{4})->$2 $3 $4 va fi tradus în: 469 315 0217. [12, 12]->(\+1)(\d{3})(\d{3})(\d{4})-> $3 $4 va fi tradus în: 315 0217.
De asemenea, este posibil să convertiţi un număr din SUA internaţional într-unul local, cum ar fi: [12, 12]->(\+1)(\d{3})(\d{3})(\d{4})->($2) $3-$4.
Apoi numărul de intrare „+14693150217” va fi tradus în: (469) 315-0217.
Exemplu 3
Următorul exemplu arată cum puteți transfera un număr primit de la Centrul de contact în formatul +491515555531 în formatul german E164 +49 151 5555 531.
Acest exemplu utilizează două reguli de traducere (1 şi 2.)
- Acest număr are exact 13 caractere, astfel că se aplică regula „Adăugaţi spaţii la numerele germane”.
- (\+49) spune că numărul trebuie să înceapă cu +49. Dacă numărul are 13 (de) caractere, dar nu începe cu +49, regula este anulată și nu se modifică nimic.
- (\d{3}) spune că +49 trebuie să fie urmate de 3 cifre.
- (\d{4}) spune că ultimele 3 cifre trebuie să fie urmate de 4 cifre.
- (\d{3}) spune că ultimele 4 cifre trebuie să fie urmate de 3 cifre.
Dacă oricare dintre acestea nu se potrivește, numărul nu va fi modificat.
Deci, toate regulile se aplică pentru „+491515555531”. Prin urmare, numărul este modificat de „$1 $2 $3 $4”:
- $1 se referă la grup (\+49), numărul de trimis către Serviciul Cloud Voice arată ca +49.
- $2 se referă la primul dintre cele două (\d{3}); numărul de trimis către serviciul cloud de voce arată ca +49 151.
- $3 se referă la a doua dintre cele două (\d{4}); numărul de trimis către serviciul cloud de voce arată ca +49 151 5555.
- $4 se referă la ultimul grup (\d{3}); numărul de trimis către serviciul cloud de voce arată ca +49 151 5555 531.
Același lucru este valabil și pentru prima regulă. Puteți utiliza piesa de schimb $1 $2 $3 $4 pentru a alege ce să utilizați din număr.
Mai multe exemple de Regex pentru traduceri
| Descriere | Regex pentru traduceri |
|---|---|
| Eliminați toate caracterele, dar cifrele | [1,17]->[^\d]+ |
| Eliminați toate caracterele, dar cifrele & + | [1,17]->[^+\d]+ |
| Descriere | Regex pentru traduceri |
|---|---|
| Eliminați +1 | [12,12]->(.{1})(\d{1})(\d{10})->$3 |
| Eliminați +1 | [10,12]->(^\+1+)(\d+)->$2 |
| Eliminați +49 | [10,15]->(^\+49+)(\d+)->$2 |
| Eliminați +49 | [10,15]->(.{1})(\d{2})(\d{9})->$3 |
| Eliminați +41 | [10,13]->(^\+41+)(\d+)->$2 |
| Eliminați +41 | [10,13]->(.{1})(\d{2})(\d{9})->$3 |
| Eliminați +XX | [10,14]->(^\++)(\d{2})(\d+)->$3 |
| Descriere | Regex pentru traduceri |
|---|---|
| Eliminați + și înlocuiți cu zerouri US E164 | [10,12]->(.{1})(\d{1})(\d{10})-> 001 $3 |
| Eliminaţi +1 şi înlocuiţi cu zerouri US E164 | [10,12]-> (^\+1+)(\d+)-> 001$2 |
| Eliminați + și înlocuiți cu zerouri DE E164 | [12,15]->(.{1})(\d{2})(\d{10})-> 0049 $3 |
| Eliminaţi +49 şi înlocuiţi cu zerouri DE E164 | [10,12]-> (^\+49+)(\d+)-> 0049$2 |
| Eliminați + și înlocuiți cu zerouri CH E164 | [10,13]->(.{1})(\d{2})(\d{9})-> 0041 $3 |
| Eliminaţi +41 şi înlocuiţi cu zerouri CH E164 | [10,12]-> (^\+41+)(\d+)-> 0041$2 |
| Descriere | Regex pentru traduceri |
|---|---|
| Număr SUA cu spațiu | [12,17]->(\d{1})(\d{3})(\d{3})(\d{4})->+1 $2 $3 $4 |
| Număr SUA cu spațiu | [12,17]->(\+1)(\d{3})(\d{3})(\d{4})->$1 $2 $3 $4 |
| Număr DE cu spațiu | [12,17]->(\d{2})(\d{3})(\d{4})(\d{3})->+49 $2 $3 $4 |
| Număr DE cu spațiu | [12,17]->(\+49)(\d{3})(\d{4})(\d{3})->$1 $2 $3 $4 |
| Număr CH cu spațiu | [12,17]->(\d{2})(\d{2})(\d{3})(\d{2})(\d{2})->+41 $2 $3 $4 |
| Număr CH cu spațiu | [12,17]->(\+41)(\d{2})(\d{3})(\d{2})(\d{2})->$1 $2 $3 $4 |
Configurarea paginii Apelare vocală
Configurați pagina de înregistrare apel vocal
Pagina de înregistrare VoiceCall este preconfigurată în mod prestabilit, cu un aspect pe coloană 3 și următoarele componente:
- Acțiuni și recomandări
- Note de apel
- Detalii apel
- Înregistrări
Componentele pot fi eliminate sau adăugate în pagină în mod liber, în funcție de nevoile afacerii. De asemenea, pot fi utilizate diferite machete de pagină, dar unele componente, cum ar fi player-ul de înregistrare a apelurilor și corpul conversației, pot încăpea numai pe zone medii și mari ale șablonului.
Afişaţi componenta motivului concluzionării
Componenta Motiv concluzionare trebuie să fie afișată în timpul apelului și în timpul Concluzionării.
Adăugați componenta Motiv concluzionare Cisco la pagina de înregistrare VoiceCall:
- Trageți Cisco Wrap-Up Reason Componentă web Lightning din zona personalizată a listei de componente Lightning în pagina Înregistrare apel vocal.
- Clic Save.
- Clic Activate.
- Clic Assign as Org Default.
- Clic Save.
- Clic Save din nou, apoi faceți clic Back arrow pentru a reveni la pagină.
Fișierul Cisco Wrap-Up Reason componenta se va afișa automat în timpul apelului și în timpul Concluzionării:
Dacă este adăugată la pagină, se afișează componenta Motiv de concluzionare Cisco pentru fiecare apel, de asemenea, dacă nu este configurată nicio concluzionare în Cisco Contact Center.
Afișați playerul de înregistrare a apelurilor
Player-ul de înregistrare a apelurilor va fi afișat dacă a fost salvat un link de înregistrare pentru Apelul vocal corespunzător.
Urmați acești pași pentru a adăuga componenta Player de înregistrare a apelurilor la pagina Înregistrare apel vocal:
- Glisați componenta web Lightning a playerului de înregistrare a apelurilor pe pagina de înregistrare a apelurilor vocale
- Clic Save.
- Clic Activate.
- Clic Assign as Org Default.
- Clic Save.
- Clic Save din nou, apoi faceți clic pe săgeata Înapoi pentru a reveni la pagină.
Administratori Webex
Configurație flux
Fereastră Pop
Un nod „Ecran pop-up” este disponibil în fluxul Webex Contact Center. Poate fi utilizat pentru a declanșa o fereastră pop-up pe ecran în cadrul Service Cloud Voice sau într-o fereastră separată.
Informații suplimentare despre această funcție pot fi găsite în documentația Proiectantului de flux .
Fereastră pop-up pe ecran într-o fereastră separată
Pentru a deschide mesajele pop-up pe ecran într-o fereastră separată, trebuie furnizat un URL absolut în nodul „Mesaje pop-up pe ecran”. Parametrii de interogare vor fi adăugați ca parametri de căutare la adresa URL.
Sunt acceptate următoarele moduri:
- Filă nouă de browser - Deschide întotdeauna o filă nouă de browser.
- Fila de browser existentă - Se deschide o nouă filă de browser în fereastra pop-up de pe prima filă de browser existentă. Fila respectivă va fi fila dedicată pentru afișări ulterioare ale ecranului filelor de browser existente, iar URL-ul va fi reîmprospătat în fila respectivă de browser.
- În Interiorul Desktopului - Este tratată în același mod ca Fila nouă de browser.
Pagina deschisă momentan poate împiedica o redirecționare. În acest caz, se deschide o fereastră pop-up de ecran cu fila de browser existentă într-o filă nouă de browser.





