- Pagină de pornire
- /
- Articol
Webex Contact Center pentru salesforce Service Cloud Voice integrează CCaaS (Contact Center as a Service) robust Cisco cu CRM-ul Salesforce, permițând companiilor să gestioneze interacțiunile omnicanal cu clienții (voce, digital) în interfața Salesforce, folosind Webex AI pentru agenți virtuali, transcriere și rutare inteligentă, transformând agenții în super-agenți cu date unificate pentru experiențe mai bune ale 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 out-of-the-box care aduce puterea Webex Contact Center în consola de agent omnicanal Salesforce Service Cloud Voice Omnichannel.
Înainte de a continua instalarea, consultați următoarea secțiune:
Pentru a afla despre cerințele preliminare și limitările Salesforce Service Cloud Voice și asigurați-vă că organizația dvs. Salesforce este gata să activeze și să instaleze Webex Contact Center pentru pachetul 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.
- Intreprindere
- Nelimitat
- Dezvoltator
Licenţe
-
Clienții trebuie să achiziționeze noua licență suplimentară A-SF-VOICE pentru fiecare agent conectat, pe lângă licențele Flex 3 Standard sau Premium pentru Webex Contact Center. Pentru mai multe informații, consultați ghidul de comandă Flex 3.
- Salesforce Voice pentru telefonia partenerului
Înainte de a TURN pe Voice, trebuie să configurați serviciile necesare în organizația dvs.
- Navigați la Informații companie > la Licență set de permisiuni
- Verificați dacă există utilizator de voce în cloud (telefonie parteneră).
Toate edițiile pentru dezvoltatori vin acum cu 5 licențe de telefonie partenere disponibile pentru testare.
- Verificați dacă există utilizator de voce în cloud (telefonie parteneră).
- Alternativ, puteți verifica acest lucru accesând Configurarea Salesforce și căutați "voce" în bara laterală din stânga.
- Dacă apare "Centre de contact pentru telefonia partenerilor", aveți licența SCV.
- Dacă opțiunea "Centre de contact telefonice partenere" nu este vizibilă, atunci "Activați Service Cloud Voice" urmând pașii de mai jos.
- Accesați Salesforce Setup și căutați și selectați "Partner Telephony Setup" și comutați butonul la "Enable Service Cloud Voice".
- Activați Omni-Channel pentru a permite agenților să efectueze și să primească apeluri.
- Accesați Salesforce Setup și căutați și selectați "Partner Telephony Setup" și comutați butonul la "Enable 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 Setări omnicanal în caseta Găsire rapidă, apoi selectați Setări omnicanal.


- Selectați Activare Omnicanal.
- Faceți clic pe Salvare.
Limitări
- Vocea este disponibilă numai în Experiența Lightning.
- 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 pe 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ă consultați reprezentantul Salesforce despre disponibilitatea Voice în regiunea dvs.
Consultați Limitele și limitările vocii în cloud și Ghidul de instalare și configurare.
Cerințe
Coduri inactive
Găsiți coduri inactive
| 1 |
Conectați-vă la Portalul de management. |
| 2 |
Navigați la Centru de contact > EXPERIENȚĂ DESKTOP >Coduri inactiv/de concluzionare. |
| 3 |
Asigurați-vă că sunt afișate codurile inactive, altfel faceți clic pe butonul derulant filtru și selectați Cod inactiv în partea de sus a paginii. |
| 4 |
Faceți clic pe un cod inactiv pentru a deschide vizualizarea detaliată. Acolo puteți găsi codul inactiv ID.
ID-urile pot fi copiate și apoi utilizate pentru configurația de mapare a stării de prezență. Unul dintre ID-uri trebuie utilizat ca motiv implicit Cisco nepregătit. |
INTEGRA
Instalare
Înainte de a continua instalarea, consultați secțiunea Cerințe preliminare și limitări pentru a afla despre cerințele preliminare și limitările Salesforce Service Cloud.
Instalați și configurați Webex Contact Center pentru Service Cloud Voice
Atunci când se obține o licență Service Cloud Voice for Partner Telephony , pagina Partner Telephony Setup (Configurare telefonie partener) apare în meniul Setup.
Informații suplimentare pot fi găsite în referința oficială Salesforce ( link direct).
| 1 |
Din Setup, introduceți
|
| 2 |
Activați TURN pe Voce cu telefonia parteneră. Pagina Centre de contact pentru telefonia partenerilor apare în meniul Configurare .
Dacă intenționați să implementați pachetul într-un sandbox Salesforce, înlocuiți |
Instalați pachetul
Pentru a instala pachetul:
| 1 |
Deschideți linkul furnizat 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 numai pentru administratori" (1) și faceți clic pe Instalare (2). Determinați care utilizatori primesc anumite permisiuni pentru obiectele și componentele livrate cu pachetul Webex Contact Center for Service Cloud Voice. În plus, acordați-le aceste permisiuni; seturile de permisiuni livrate împreună cu pachetul Webex Contact Center for Service Cloud Voice ajută acest proces. Expertul de instalare a pachetului – apare ecranul de întâmpinare: |
| 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 un utilizator selectat. |
| 7 |
Derulați în jos la "Atribuiri set de permisiuni". |
| 8 |
Faceți clic pe Editați atribuirile |
| 9 |
Pentru administratorii centrului de contact: atribuiți setul de permisiuni Admin centru de contact (telefonie partener).
|
| 10 |
Pentru agenții centrului de contact: atribuiți setul de permisiuni pentru agentul centrului de contact (telefonia partenerului) și setul de permisiuni pentru agentul SCV Webex Contact Center.
Nu este recomandat să alegeți opțiunea Instalare pentru toți utilizatorii , deoarece aceasta acordă toate permisiunile (citire, creare, editare și ștergere) pe componentele și obiectele pachetului oricărui utilizator care utilizează un profil de utilizator personalizat. |
| 11 |
Atribuiți un pachet de licențe pentru ca utilizatorii să lucreze cu Connects for Service Cloud Voice.
|
| 12 |
Alternativ, poți să apeși pe Configurare | Utilizatori | Utilizatori.. |
| 13 |
Căutați și selectați utilizatorul. |
| 14 |
Derulați în jos la Pachete gestionate. |
| 15 |
Faceți clic pe Atribuire licențe. |
| 16 |
Alegeți Webex Contact Center pentru pachetul Service Cloud Voice din listă. |
| 17 |
Faceţi clic pe Adăugare. |
| 18 |
Creați stările de prezență pentru a defini canalele de serviciu atribuite unor stări diferite. 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 |
Faceţi clic pe Nou. Creați cel puțin o stare pentru "Online" și una pentru "Ocupat".
|
Atribuiți 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 Setul de permisiuni pentru telefonia partenerului. |
| 3 |
Faceți clic pe Acces stări prezență serviciu. |
| 4 |
Dați clic pe Editați. |
| 5 |
În lista Prezențe serviciu disponibile, selectați stările de prezență create anterior și faceți clic pe Adăugare pentru a le asocia cu setul de permisiuni. Agenții cărora li se atribuie acest set de permisiuni se pot conecta la Omni-Channel cu oricare dintre stările de prezență puse la dispoziția lor. |
| 6 |
Faceți clic pe Salvare. |
| 7 |
Faceți clic pe Gestionare atribuiri în aceeași pagină. Apoi faceți clic pe Adăugare atribuire în colțul din dreapta sus, selectați utilizatorul dorit, faceți clic pe Următorul, selectați o opțiune de expirare pentru utilizatorii atribuiți (opțional) și apoi faceți clic pe Atribuire. Service Cloud Voice utilizează un domeniu extern pentru a opera cu înregistrarea VoiceCall. Următoarele adrese URL trebuie adăugate la "Setări site la distanță" în Configurare ( faceți clic aici pentru a deschide documentația oficială):
Exemplu: Cum se găsește adresa URL a instanței. |
| 8 |
Uită-te la adresa URL din bara de adrese a browserului tău după ce te conectezi. URL-ul instanței este partea dinaintea ".my.salesforce.com" sau ".salesforce.com" sau "lightning.force.com". De exemplu, dacă adresa URL este https://orgfarm-54a38e30ad-dev-ed.develop.my.salesforce-setup.com/, atunci "orgfarm-54a38e30ad-dev-ed.develop" este adresa URL a instanței. Exemplu: Adresa URL a organizației de origine: https://cisco.lightning.force.com Exemplu: adrese URL de adăugat:
|
| 9 |
Elementul utilitar Omni-Channel este obligatoriu î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 butonul Let's Do This care deschide pagina Configurați experiența agentului pentru Service Cloud Voice with Partner Telephony din portalul de ajutor Salesforce ( link direct). |
| 10 |
Din Setup, introduceți Partner Telephony Setup în caseta Quick Find (Găsire rapidă), apoi selectați Partner Telephony Setup (Configurare telefonie partener). |
| 11 |
Derulați în jos până la secțiunea 5 Mai multe setări vocale. |
| 12 |
Pentru a activa protecția clickjack pentru paginile Visualforce cu anteturile dezactivate în timp ce lucrați cu softphone-ul în 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ă adresa URL a 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: MyDomainName--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 la lista Domenii de încredere pentru cadrele în linie, selectând Pagini Visualforce ca tip IFrame. Exemplu: MyDomainName.lightning.force.com
Dacă nu aveți un My Domain implementat în organizația dvs., formatul adresei URL este diferit. Dacă aveți un My Domain implementat și domeniile îmbunătățite nu sunt activate în organizația dvs., formatul adresei URL este diferit. Dacă domeniile îmbunătățite nu sunt activate, setarea Stabilizare adrese URL în Visualforce, Experience Builder, Site.com studio și fișiere de conținut My Domain afectează, de asemenea, acest format. Pentru detalii, consultați Formatele adreselor URL ale domeniului meu în Ajutor Salesforce. Setări de protecție clickjack și domenii de încredere pentru Lightning Experience
|
| 13 |
Pentru a afișa comenzile de înregistrare în timpul apelurilor, agenții au nevoie de Pentru a-l atribui, adăugați-l la setul de permisiuni creat în pasul Stări prezență .
|
Configurație
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 Contact Center pentru a sprijini integrarea cu mai mulți furnizori de sistem CTI.
Importul centrului de contact
| 1 |
Din Configurare, introduceți Centre de contact pentru telefonia parteneră în caseta Găsire rapidă, apoi selectați Centre de contact pentru telefonia partenerilor. Se afișează lista centrelor de contact existente (dacă există).
|
| 2 |
Faceți clic pe Creare centru de contact în partea dreaptă a paginii. |
| 3 |
Selectați Webex Contact Center ca furnizor de telefonie. Apoi faceți clic pe Înainte.
Se deschide un browser de fișiere.
|
| 4 |
|
| 5 |
Faceți clic pe Deschidere. Fișierul este importat.
|
| 6 |
Verificați dacă centrul dvs. de contact este afișat în vizualizarea listă Centre de contact.
|
Configurarea centrului de contact
| 1 |
Din Configurare, introduceți Centre de contact pentru telefonia parteneră în caseta Găsire rapidă, apoi selectați Centre de contact pentru telefonia partenerilor. | ||||||||||||||||||||||||||||||
| 2 |
Faceți clic pe Centrul de contact importat anterior. | ||||||||||||||||||||||||||||||
| 3 |
Dați clic pe Editați.
| ||||||||||||||||||||||||||||||
| 4 |
În partea de jos a paginii Centru de contact, faceți clic pe butonul Adăugare sub secțiunea Utilizatori centru de contact. | ||||||||||||||||||||||||||||||
| 5 |
Faceți clic pe + lângă utilizatorii care au acces la Centrul de contact deschis. În această listă apar numai utilizatorii care au |
Personaliza
Aplicație client externă pentru integrarea Webex Contact Center
Configurarea aplicației client extern pentru Webex Contact Center Salesforce Connector
Pentru a utiliza Service Cloud Voice la maximum, fluxul de apeluri Contact Center poate fi adaptat pentru a crea înregistrarea apelului vocal și pentru a executa un flux omnicanal Salesforce î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 (cod din 2 litere) [AU]:CH Numele statului sau provinciei (numele complet) [Some-State]: Numele localității (de exemplu, orașul) []: Numele organizației (de exemplu, compania) [Internet Widgits Pty Ltd]: Nume unitate organizațională (de exemplu, secțiune) []: Nume comun (de exemplu, server FQDN sau numele DVS.) []: Adresa de e-mail []: my-api-user@my-example-org.com Introduceți următoarele atribute "suplimentare" care vor fi trimise împreună cu solicitarea de certificat O parolă de provocare []:<parolă> Un nume opțional de companie []: 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 conectorul Salesforce din Webex Control Hub
Set de permisiuni pentru utilizatorul integrării SCV
Următorul set de permisiuni acordă acces la clasele Apex utilizate de Connects for SCV pentru integrarea cu fluxurile Contact Center IVR și Webex Contact Center pentru Salesforce pentru SCV.
Următorul este un exemplu de configurație și descrie permisiunile minime necesare pentru ca integrarea Contact Center / IVR să funcționeze.
- Din Configurare, navigați la Utilizatori | Seturi de permisiuni.
- Faceți clic pe butonul Nou .
- Introduceți o etichetă, de exemplu: IVR Acces la clasele SCV Apex
- API Numele este completat automat
- Licență: Nici unul
- Faceți clic pe butonul Salvare .
- Se deschide noul set de permisiuni.
- Navigați la Apex Class Access.
- Faceți clic pe butonul Editare și adăugați următoarele clase Apex:
- cisco_wxcc_scv. Rutare serviciu
- Navigați la Permisiuni de sistem.
- Faceți clic pe butonul Editare și activați următoarele permisiuni:
- Servicii Apex REST
- API activat
Acces minim - Profilul API Numai integrări
Acest profil este utilizat pentru integrarea cu Webex Contact Center for Salesforce for SCV pentru a crea înregistrări de apeluri vocale și a executa Omni-Flow din fluxul IVR.
Următorul este un exemplu de configurație și descrie permisiunile minime necesare pentru ca integrarea Contact Center / IVR să funcționeze.
Aceasta este o clonă din profilul Acces minim - API Numai integrări.
- Din Configurare, navigați la Utilizatori | Profiluri.
- În lista Profiluri, căutați Integrare Acces minim profil - API Numai.
- Faceți clic pe numele profilului pentru a deschide profilul Acces minim - API Numai integrări.
- În profilul Acces minim - Numai integrări API, faceți clic pe butonul Clonare .
- Introduceți un nou nume de profil, de exemplu: Integrare SCV.
- Faceți clic pe butonul Salvare .
- Se deschide noul profil.
- Verificați dacă profilul dvs. Acces minim - API Numai integrări are toate permisiunile eliminate din profilul propriu-zis.
- Navigați la Permisiuni de sistem.
- Asigurați-vă că sunt activate următoarele permisiuni:
- API activat
- API Numai utilizator
Utilizator integrare SCV
Următorul este un exemplu de configurație și descrie permisiunile minime necesare pentru ca integrarea Contact Center / IVR să funcționeze. Pentru utilizatorul de integrare SCV nu este necesară nicio licență Salesforce Cloud Voice sau Webex Contact Center pentru licența Salesforce for SCV.
- Din Configurare, navigați la Utilizatori | Utilizatorii.
- Faceți clic pe butonul Utilizator nou.
- Introduceți Prenume, Nume și toate celelalte câmpuri obligatorii.
- Licență utilizator: Integrare Salesforce
- Profil: selectați profilul creat în pasul anterior ("SCV Integration profile", clonă a profilului Minimum Access - API Only Integrations)
- Faceți clic pe butonul Salvare .
- Deschideți noua înregistrare Utilizator.
- Atribuiți setul de permisiuni creat anterior ("IVR Acces la clasele SCV Apex").
- Atribuiți setul de permisiuni Salesforce # API Integration.
Creați aplicația client extern Salesforce
Crearea unei noi aplicații client externe
Există două opțiuni pentru a vă conecta datele Salesforce cu aplicații terțe. Atât aplicațiile conectate , cât și aplicațiile client externe 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 utilizată de Cisco Webex Contact Center:
- Din Configurare, navigați la Aplicații | Aplicații client externe | Manager de aplicații client extern.
- Faceți clic pe Aplicație client extern nouă.
- Aplicație client extern – Informații de bază
- Nume aplicație client extern: WxCC - SCV
- API Nume: WxCC_SCV
- E-mail de contact: < e-mailul >
- Stare distribuție: selectați Local

Aplicație client extern - API (Activare setări OAuth)
- Selectați: Activați OAuth
- Setări aplicație
- URL de apelare inversă: http://localhost:1717/OauthRedirect ca exemplu de URL de apelare inversă
- OAuth Scopuri
- Selectați domeniile OAuth:
- Gestionați datele utilizatorilor prin API-uri (API)
- Efectuați solicitări în orice moment (refresh_token, offline_access)

Activarea fluxului
- Selectați: Activați fluxul purtătorului JWT
- Faceți clic pe Încărcare fișiere și încărcați
fișierul server.crtcare conține certificatul digital.

Securitate
Debifați opțiunea Solicitați secret pentru fluxul serverului web.

- Faceți clic pe butonul Creare .
- Schimbați în Tab Politici și apoi faceți clic pe butonul Editare .
- Politici—Politici OAuth
- Politicile pluginurilor
- Utilizatori permiși: selectați Utilizatorii aprobați de administrator sunt preautorizați
- Confirmați modificarea
- Autorizarea aplicației
- Politica de reîmprospătare a tokenului: selectați Expiră imediat reîmprospătare token
- IP Relaxare: selectați Impuneți restricțiile IP

- Politicile pluginurilor
- Politici — Politici pentru aplicații
- Pagina de pornire — niciuna
- Selectare seturi de permisiuni—Atribuiți setul de permisiuni creat anterior ("IVR Acces la clasele SCV Apex")

- Faceți clic pe Salvare.
- Treceți la Tab Settings.
-
Secțiunea Setări OAuth, faceți clic pe butonul Cheie și secret consumator; așteptați e-mailul și verificați-vă identitatea. Un nou browser Tab deschide un ecran cu detalii despre consumatori.

- Faceți clic pe Copiere și salvați cheia de consum. Cheia de consum este utilizată ulterior pentru a crea conectorul Salesforce pe Webex Contact Center Control Hub.

-
Webex Contact Center Configurare și script pentru a crea înregistrări de apeluri 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 apelului vocal în Service Cloud Voice imediat ce apelul ajunge în centrul de contact.
Un Omni-Flow opțional poate fi executat pentru deciziile de rutare și automatizare în Salesforce.
Pentru detalii despre API-urile utilizate, consultați Service Cloud Voice API Wrapper.
Cerințe preliminare
Pentru a utiliza Service Cloud Voice API Wrapper, trebuie configurată o aplicație client externă Salesforce pentru integrarea IVR.
Configurați conectorul Salesforce în Webex Control Hub
Configurați conectorii de integrare Salesforce pentru Webex Contact Center așa cum este descris în articolul de la https://help.webex.com/en-us/article/7fuy63/SetUp-Integration-Connectors-for-Webex-Contact-Center#id_133211.
| 1 |
Conectați-vă la organizația client la https://admin.webex.com și navigați la Servicii > Contact Center > Setări > Integrări > Conectori. |
| 2 |
Pe cardul Salesforce, faceți clic pe Configurare sau pe 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ă din conectorul centrului de contact din hubul Webex și certificatul din aplicația client extern din Salesforce. Sfat pentru depanare După ce faceți clic pe OK și conectorul nu se salvează:
|
Webex Contact Center Fluxul principal
| Variabilă de debit | Descriere |
|---|---|
| Variabilă de flux pentru înregistrarea apelurilor vocale ID | Unic ID pentru a identifica apelul. Necesar pentru a crea înregistrarea apelului vocal. Format: wxcc_<Interacțiune ID> Exemplu: wxcc_fc4ec7d8-4c91-49aa-b764-081fbba344a8
|
| Variabilă locală pentru ora de începere a apelului |
Se utilizează pentru a crea înregistrarea apelului vocal și pentru actualizarea apelului vocal.
|
| Variabilă locală pentru numele cozii/ID |
Returnat de Execute Omni Flow, utilizat pentru rutarea apelurilor. Această variabilă este necesară numai atunci când utilizați Execute Omni Flow
|
| Variabila locală pentru Nume agent/ID |
Returnat de Execute Omni Flow, utilizat pentru rutarea apelurilor. Această variabilă este necesară numai atunci când utilizați Execute Omni Flow
|
Prezentare generală a fluxului principal

- Generare cheie de apel furnizor
- Setarea orei de începere a apelului
- Solicitare HTTP: Crearea înregistrării apelurilor vocale
- Evaluarea răspunsului HTTP pentru înregistrarea Creare apel vocal
- Tratarea erorilor pentru înregistrarea Creare apel vocal
- Solicitare HTTP: Executați Omni Flow
- Evaluați răspunsul HTTP pentru Execute Omni Flow
- Tratarea erorilor pentru Execute Omni Flow
- Continuați cu dirijarea apelurilor
| Fluxul | Descriere |
|---|---|
| Generare cheie de apel furnizor |
Fiecare apel gestionat în Service Cloud Voice creează o înregistrare a apelului vocal în Salesforce și necesită o ID unică numită cheie de apel a furnizorului. Pentru înregistrările de apeluri vocale create în Webex Contact Center, cheia de apel a 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:
|
| Setarea orei de începere a apelului |
Marcajul temporal UTC al 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: Crearea înregistrării apelurilor vocale |
Acest pas este obligatoriu pentru fiecare apel. După crearea înregistrării Apel vocal, înregistrarea Apel vocal ID trebuie transmisă împreună cu apelul către agent într-o variabilă, împreună cu cheia de apel a furnizorului. Configurați variabila utilizată în configurația Contact Center din Service Cloud Voice. |
| Setări solicitare HTTP |
|
Solicitare HTTP: Crearea înregistrării apelurilor vocale
Acest pas este obligatoriu pentru fiecare apel. După crearea înregistrării Apel vocal, înregistrarea Apel vocal ID trebuie transmisă împreună cu apelul către agent într-o variabilă, împreună cu cheia de apel a furnizorului. Configurați variabila utilizată în configurația Contact Center din Service Cloud Voice.
Setări solicitare HTTP
- Etichetă activitate: CreateVoiceCall
- Utilizare punct final autentificat: Activat
- Conector: Salesforce Connector creat în pasul anterior
- Solicitați calea:
/services/apexrest/cisco_wxcc_scv/voice/v1/createVoiceCall - Metoda: POST
- Solicitare tip conținut: Aplicație/JSON
Corpul solicitării
Atunci când creați înregistrarea Apel vocal, puteți, de asemenea, să actualizați câmpurile particularizate din înregistrarea Apel vocal cu date despre apeluri. Mai jos sunt două exemple ale corpului solicitării, unul cu toate câmpurile obligatorii, dar fără actualizarea câmpurilor particularizate și unul cu câmpuri particularizate.
Fără actualizarea câmpurilor particularizate 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 de actualizare a câmpurilor particularizate 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\": \"<valoare3>\"}" }
Parametri
| Numele proprietății | Valoare |
|---|---|
| callCenterDevName | Nume dezvoltator centru de contact |
| certDevName | API Numele certificatului (așa cum este configurat în Contact Center) |
| vendorCallKey | Apel unic ID: {{SCV_VendorCallKey}}
|
| spre | CalledNumber/DNIS: {{NewPhoneContact.DNIS}}
|
| din | NumărApel/ANI: {{NewPhoneContact.ANI}}
|
| startTime | Marcaj temporal UTC{{SCV_CallStartTime}}( a se seta imediat după ce apelul este acceptat în script) |
| callAttributes |
Reprezintă câmpuri suplimentare standard și particularizate în înregistrarea apelului vocal, unde fiecare pereche cheie-valoare corespunde unui câmp standard sau particularizat și valorilor sale. Exemplu:
|
Setări de analiză
- Tip de conținut: JSON
- Variabilă de ieșire: SCV_VoiceCallRecordId
- Expresie cale:
$.data.voiceCallId
Înregistrarea apelului vocal ID, pentru a fi transmisă agentului.
Evaluarea răspunsului HTTP pentru înregistrarea Creare apel vocal
Verificați starea HTTP a solicitării http Creare apel vocal:
- Etichetă: statusCodeCreateVoiceCall
- Variabila: CreateVoiceCall.httpStatusCode
Dacă codul de stare == 200 = > cu succes altfel = > solicitarea nu a reușit, tratarea erorilor
Tratarea erorilor pentru înregistrarea Creare apel vocal
Doar pentru demo / depanare, redați mesajul în funcție de codul de stare http.
Dacă Create Voice Call a reușit, continuați cu Execute Omni Flow. În caz contrar, continuați cu rutarea apelurilor.
Solicitare HTTP: Executați Omni Flow (pas opțional)
Utilizați Executare Omni-Flow atunci când doriți:
- Rulați sarcini automate, de exemplu, căutați sau creați înregistrări și legați înregistrările cu înregistrarea apelului vocal
- Căutați înregistrări și faceți screen-pop
- Sincronizați cozile Salesforce și Cisco
- Permiteți Service Cloud Voice să ia decizia de rutare
Această solicitare returnează întotdeauna "coada" sau "agentul" către locul unde trebuie direcționat apelul.
După executarea acestei solicitări, asigurați-vă că trimiteți Clear Routing dacă apelantul închide înainte de a primi răspuns de la un agent. Consultați Webex Contact Center Fluxul de evenimente.
Setări solicitare HTTP
- Etichetă activitate: ExecuteOmniFlow
- Utilizare punct final autentificat: Activat
- Conector: Salesforce Connector creat în pasul anterior
- Solicitați calea:
/services/apexrest/cisco_wxcc_scv/voice/v1/executeOmniFlow - Metoda: POST
- Solicitare tip conținut: Aplicație/JSON
Corpul solicitării
În afară de câmpurile obligatorii, puteți transmite date suplimentare ca variabile de intrare către Omni-Flow. Mai jos sunt două exemple de corp de solicitare. Primul fără parametri suplimentari de debit, numai câmpuri obligatorii, al doilea cu două variabile de intrare.
Exemplu cu parametrii Omni-Flow:
{ "callCenterDevName": "<Contact Center API name>", "certDevName": "<cert dev name>", "voiceCallId": "{{SCV_VoiceCallRecordId}}", "dialedNumber": "{{NewPhoneContact.DNIS}}", "flowDevName": "<flow API name>", "fallbackQueue": "<nume coadă de rezervă>" }
Exemplu de actualizare a câmpurilor particularizate din înregistrarea apelurilor vocale:
{ "callCenterDevName": "<Contact Center API name>", "certDevName": "<cert dev name>", "voiceCallId": "{{SCV_VoiceCallRecordId}}", "dialedNumber": "{{NewPhoneContact.DNIS}}", "flowDevName": "<flow API name>", "fallbackQueue": "<nume coadă de rezervă>", "flowInputParameters": { "param1": "value1", "param2": "value2" } }
Parametri
| Numele proprietății | Valoare |
|---|---|
| callCenterDevName | Nume dezvoltator centru de contact |
| certDevName | API Numele certificatului (așa cum este configurat în Contact Center) |
| voiceCallId | ID înregistrării apelului vocal, creată la pasul anterior: {{SCV_VoiceCallRecordId}}
|
| NumărFormat | CalledNumber/DNIS: {{NewPhoneContact.DNIS}}
|
| flowDevName | Numele dezvoltatorului Omni-Flow de executat |
| fallbackCoadă de așteptare | Coadă ID sau Coadă API numele cozii de rezervă Salesforce |
| flowInputParameters |
Intrări suplimentare la fluxul omnicanal (pereche cheie-valoare). Exemplu:
|
Setări de analiză
Coadă
- Tip de conținut: JSON
- Variabilă de ieșire: SCV_OmniFlowQueue
- expresie cale:
$.data.queue
"Coada" returnată de la Execute Omni-Flow poate fi utilizată pentru rutare.
Agent- Tip de conținut: JSON
- Variabilă de ieșire: SCV_OmniFlowAgent
- Expresie cale:
$.data.agent
"Agentul" returnat de la Execute Omni-Flow, poate fi folosit pentru rutare.
Evaluați răspunsul HTTP pentru Execute Omni Flow
Verificați starea HTTP a solicitării http Executare Omni Flow:
- Etichetă: statusCodeExecuteOmniFlow
- Variabila: ExecuteOmniFlow.httpStatusCode
Dacă codul de stare == 200 = > cu succes altfel = > cererea a eșuat, tratarea erorilor.
Tratarea erorilor pentru Execute Omni Flow
Doar pentru demo / depanare, redați mesajul în funcție de codul de stare http.
Dacă Execute Omni Flow a avut succes, variabilele SCV_OmniFlowQueue și SCV_OmniFlowAgent nu sunt setate. Decizia de rutare în fluxul de apeluri.
Continuați cu dirijarea 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 și agentul.
Webex Contact Center Fluxul evenimentelor
Dacă apelantul închide apelul înainte ca un agent să răspundă la el, trebuie să actualizăm Service Cloud Voice și să terminăm apelul.
- Dacă s-a utilizat Executare Omni-Flow, trimiteți Ștergere rutare pentru a șterge Rutare serviciu în așteptare (PSR)
- Trimiteți Actualizare apel vocal, pentru a actualiza orele de început și de sfârșit în înregistrarea apelurilor vocale și pentru a modifica starea de la Nou la Finalizat

- ContactTelefon încheiat - Acest eveniment este declanșat atunci când un apel live este deconectat și toți participanții sunt eliminați.
- Solicitare HTTP: Ștergeți rutarea
- Solicitare HTTP: Actualizare apel vocal
Solicitare HTTP: Ștergeți rutarea
- Etichetă: ClearRouting
- Utilizare punct final autentificat: Activat
- Conector: Salesforce Connector creat în pasul anterior
- Solicitare cale:
/servicii/apexrest/cisco_wxcc_scv/voce/v1/clearRouting - Metoda: POST
Solicitare tip conținut: Aplicație/JSON
Corpul solicitării
{ "callCenterDevName": "<Contact Center API name>", "certDevName": "<cert dev name>", "voiceCallId": "{{SCV_VoiceCallRecordId}}" }
Parametri
| Numele proprietății | Valoare |
|---|---|
| callCenterDevName | Nume dezvoltator centru de contact |
| certDevName | API Numele certificatului (așa cum este configurat în Contact Center) |
| voiceCallId | ID înregistrării apelului vocal, creată în pasul anterior: SCV_VoiceCallRecordId |
Setări de analiză
Nici unul.
Solicitare HTTP: Actualizare apel vocal
- Casa de discuri: UpdateVoiceCall
- Utilizare punct final autentificat: Activat
- Conector: Salesforce Connector creat în pasul anterior
- Solicitați calea:
/services/apexrest/cisco_wxcc_scv/voice/v1/updateVoiceCall - Metoda: POST
- Solicitare tip conținut: Aplicație/JSON
Corpul solicitării
{ "callCenterDevName": "<Contact Center API name>", "certDevName": "<cert dev name>", "voiceCallId": "{{SCV_VoiceCallRecordId}}", "startTime": "{{SCV_CallStartTime}}", "endTime": "{{now() | replace({'[UTC]': ''})}}", "disconnectReason": { "value": "Abandonat în coadă", "isError": true } }
Parametri
| Numele proprietății | Valoare |
|---|---|
| callCenterDevName | Nume dezvoltator centru de contact |
| certDevName | API Numele certificatului (așa cum este configurat în Contact Center) |
| voiceCallId | ID înregistrării apelului vocal, creată în pasul anterior: SCV_VoiceCallRecordId |
| startTime | Marcajul temporal UTC al începerii apelului{{SCV_CallStartTime}}( așa cum este utilizat pentru a crea înregistrarea apelului vocal) |
| Timp de sfârșit | Marcajul temporal UTC curent '{{now() |
| disconnectReason | Motivul deconectării apelului. Proprietatea isError trebuie setată la true pentru a se afișa corect. |
Setări de analiză
Nici unul.
Referinţe
- Crearea unei chei private și a unui certificat digital autosemnat
- Configurați aplicația conectată pentru Webex Contact Center Salesforce Connector
- Configurați conectorii de integrare pentru Webex Contact Center - Salesforce
- Cisco Webex Contact Center Ghid de configurare și administrare > Designerul de flux
- Integrare Telefonie REST API
Traducere lingvistică
(Opțional) Activați atelierul de lucru pentru traduceri
Această setare este aplicabilă numai dacă utilizați setările de limbă pentru traducere.
| 1 |
Accesați Configurați → atelier de lucru pentru traduceri → Setări limbă pentru traducere. |
| 2 |
Faceți clic pe Activare pentru a selecta limba de traducere.
|
(Opțional) Activați limbile doar pentru platformă
Această setare este aplicabilă numai pentru alte limbi decât EN-US.
| 1 |
Accesați Configurarea setărilor companiei → → setărilor de limbă. |
| 2 |
Alegeți limbile necesare. |
| 3 |
Bifați următoarele casete de selectare:
|
| 4 |
Salvați modificările.
|
Activați limba și selectați utilizatorul (sarcina)
| 1 |
Accesați Configurați → atelier de lucru pentru traduceri → Setări limbă pentru 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 Configurarea → etichete personalizate. |
| 2 |
Selectați numele etichetei personalizate pentru a o deschide.
|
| 3 |
În lista Traduceri asociate, faceți clic pe Nou |
| 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. |
Permisiuni Salesforce cerute de funcția utilizatorului
Setul de permisiuni pentru agenți Webex Contact Center SCV conține toate permisiunile necesare pentru a funcționa cu gadgetul Webex Contact Center și integrările dezvoltate pentru agenți.
Apex Class Access (secțiune)
- cisco_wxcc_scv. CiscoScvWxcc
- cisco_wxcc_scv. ServiceResponseHandler
- cisco_wxcc_scv. Rutare serviciu
- cisco_wxcc_scv. TelefonieIntegrationHandler
Acces tip metadate particularizat (secțiune)
- cisco_wxcc_scv. Conexiune WxCC
Acces pagină Visualforce (secțiune)
- cisco_wxcc_scv. CiscoScvLoginWxCC
- cisco_wxcc_scv. CiscoScvMainWxCC
- cisco_wxcc_scv. CiscoScvOAuthRedirect
- cisco_wxcc_scv. CiscoScvSwLoader
Service Cloud Voice API Wrapper
Cerințe preliminare
Pentru a utiliza Service Cloud Voice API Wrapper, trebuie configurată o aplicație client externă Salesforce pentru integrarea IVR.
Utilizați Service Cloud Voice API Wrapper
Service Cloud Voice (SCV) pentru Salesforce utilizează integrarea telefonică REST API 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ă autorizarea JWT și utilizarea metodei HTTP PATCH, care momentan nu este acceptată de Cisco IP Interactive Voice Response (IVR).
Pentru a simplifica utilizarea integrării telefonice REST API pentru SCV într-un sistem IVR (nu numai), a fost pus la dispoziție un nou set de API-uri, care împachetează Salesforce API existent și sunt accesibile direct din Salesforce Org unde este instalat pachetul Webex Contact Center for Service Cloud Voice.
Service Cloud Voice API Wrapper elimină necesitatea autentificării unui simbol JWT, implementează verificări suplimentare asupra datelor solicitate de Salesforce API și îmbunătățește obiectele de răspuns.
Recuperați Access_Token
Executați o cerere POST la https://<your-domain-name>.my.salesforce.com/services/oauth2/token
Trimiterea următorilor parametri în organism:
{ "grant_type": "client_credentials", "client_id": "<cheia de consum a aplicației conectate>", "client_secret": "<secretul consumatorului al aplicației conectate>" } Dacă solicitarea are succes, va fi returnat următorul răspuns JSON: { "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 adresă URL corectă a instanței: https://abc-123.my.salesforce.com
Utilizarea oricărui alt domeniu ca URL de instanță (adică https://abc-123.lightning.force.com ) are ca rezultat o stare neautorizată 401 cu un cod de eroare INVALID_SESSION_ID returnat.
Creare 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 într-un context în timp real, ceea ce înseamnă că ar trebui să invocați acest API numai atunci când este inițiat un apel. Acest API poate fi, de asemenea, utilizat pentru a crea înregistrări VoiceCall pentru apeluri de transfer și conferință, prin includerea parametrului parentVoiceCallId în sarcina de solicitare.
Punct final URI
<instance_url>/services/apexrest/cisco_wxcc_scv/voice/v1/createVoiceCall
Metoda HTTP
POST
Anteturi
Autorizație: Purtător <access_token>
Tip de conținut: 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": "Previzualizare", "coadă": "coadă123" }
Răspuns (cu succes)
{ "data": { "voiceCallId": "00X000012345abc" }, "errors": null, "success": true }
Răspuns (cu erori)
{ "data": null, "errors": ["Mesaj de eroare 1", "Mesaj de eroare 2"], "success": false }
Actualizare apel vocal
Actualizează Apelul vocal după încheierea apelului. Utilizați acest API pentru a actualiza parametrii legați de apeluri care nu sunt disponibili în timpul etapei de creare a apelurilor vocale. Actualizarea VoiceCall API este o operație asincronă. Nu puteți interoga starea apelului API.
Acest punct final 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 apeluri abandonate sau pierdute sau pentru orice alt scenariu în care un apel vocal nu a fost deja creat.
Punct final URI
<instance_url>/services/apexrest/cisco_wxcc_scv/voice/v1/updateVoiceCall
Metoda HTTP
POST
Anteturi
Autorizație: Purtător <access_token>
Tip de conținut: 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 } }
O descriere detaliată a parametrilor acceptați de această solicitare poate fi găsită în documentația oficială Salesforce în secțiunea "Parametri".
Răspuns (cu succes)
{ "data": { "status": "în așteptare" }, "erori": null, "success": true }
Actualizarea VoiceCall API este o operație asincronă. Nu puteți interoga starea apelului API.
Răspuns (cu erori)
{ "data": null, "errors": ["Mesaj de eroare 1", "Mesaj de eroare 2"], "success": false }
Executați Omni-flow
Execută fluxul omnicanal pentru a ruta apelurile. Acesta transmite apelul ID (Salesforce VoiceCallId sau ContactId al furnizorului de telefonie) ca parametri pentru flux și returnează instrucțiunile de rutare a agentului sau a cozii de așteptare în fluxul de contacte. În mod implicit, Service Cloud Voice utilizează fluxul omnicanal (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 așteptare ca parametri de intrare pentru acest apel API.
Service Cloud Voice utilizează această ordine de prioritate pentru a dirija apelurile:
- Utilizează setările Flux omnicanal și Coadă de rezervă pentru canalul de telefon care corespunde numărului format. Fluxul are prioritate. Dacă fluxul eșuează, se utilizează coada de rezervă.
- Utilizează parametrii flowDevName și fallbackQueue specificați în apelul Execute Omniflow API.
Punct final URI
<instance_url>/services/apexrest/cisco_wxcc_scv/voice/v1/executeOmniFlow
Metoda HTTP
POST
Anteturi
Autorizație: Purtător <access_token>
Tip de conținut: application/json
Parametri
{ "callCenterDevName": "contactCenterDevName123", "certDevName": "certDevName123", "voiceCallId": "00X000012345abc", "dialedNumber": "+18445791189", "flowDevName": "Route_VoiceCall", "fallbackQueue": "00G111222333444", "flowInputParameters": { "Input1": "one", "Input2": "two" } }
- Parametrul voiceCallId este Salesforce voiceCallId sau contactul furnizorului de telefonie ID.
- O descriere detaliată a parametrilor acceptați de această solicitare poate fi găsită în documentația oficială Salesforce în secțiunea "Parametri".
Răspuns (cu succes)
{ "data": { "coadă": "informații coadă", "agent": "informații agent" }, "erori": null, "succes": adevărat }
AGENT_INFO și QUEUE_INFO corespund câmpului ExternalId din CallCenterRoutingMap
Răspuns (cu erori)
{ "data": null, "errors": ["Mesaj de eroare 1", "Mesaj de eroare 2"], "success": false }
Rutare clară
Șterge înregistrarea PendingServiceRouting (PSR) pentru un apel vocal. Acest API nu trebuie apelat pentru majoritatea scenariilor; înregistrarea PSR este ștearsă automat atunci când apelul nu mai este direcționat. Cu toate acestea, există unele scenarii, cum ar fi apelurile pierdute sau abandonate atunci când utilizați sistemele de telefonie partenere, unde trebuie să apelați în mod explicit acest API pentru a șterge înregistrarea PSR.
Punct final URI
<instance_url>/servicii/apexrest/cisco_wxcc_scv/voce/v1/clearRouting
Metoda HTTP
POST
Anteturi
Autorizație: Purtător <access_token>
Tip de conținut: application/json
Parametri
{ "callCenterDevName": "contactCenterDevName123", "certDevName": "certDevName123", "voiceCallId": "00X000012345abc" }
- Parametrul voiceCallId este Salesforce voiceCallId sau contactul furnizorului de telefonie ID.
- O descriere detaliată a parametrilor acceptați de această solicitare poate fi găsită în documentația oficială Salesforce în secțiunea "Parametri".
Răspuns (cu succes)
{ "data": { "status": "Succes" }, "erori": null, "success": true }
Răspuns (cu erori)
{ "data": null, "errors": ["Mesaj de eroare 1", "Mesaj de eroare 2"], "success": false }
Traduceri numere de telefon
Diferitele interacțiuni dintre Service Cloud Voice și Webex Contact Center depind de traducerile numerelor de telefon. Datorită diferențelor internaționale și aplicațiilor specifice clienților, este necesar un instrument personalizabil pentru a transfera numerele 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, hashtagurilor (#), asteriscurilor (*), virgulelor (,) și semnelor plus (+). De asemenea, elimină prima apariție a lui (0). Acest lucru se va face ÎNAINTE ca traducerile numărului dvs. de telefon să fie aplicate.
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 evitate barele oblice inverse, de ex. \d+ devine \\d+.
{"Eliminați toate caracterele, cu excepția cifrelor":"[1,17]->[^\\d]+","La numărul intern":"[7,17]->(\\d{7})(\\d{4})->$2"}
Numele câmpului nu este utilizat din punct de vedere tehnic. Este acolo pentru a adăuga un șir lizibil pentru om pentru a identifica rapid scopul acestei reguli. Numele bune sunt, de exemplu: Eliminați toate zerourile inițiale, Adăugați plus de început etc.
Crearea regulilor de 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 expresiilor regulate complexe este adesea greoaie. Prin urmare, am adăugat o sintaxă suplimentară pentru a face configurarea cât mai ușoară posibil.
Figura de mai jos prezintă sintaxa generală a unei reguli de traducere a unui număr de telefon:
Predicatul
Predicatul este folosit 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 caractere (inclusiv marginile + spațiile) se potrivesc.
Predicatele se potrivesc întotdeauna cu lungimea originală a numărului. Acest lucru ajută la simplificarea configurației prin reducerea riscului de coliziune a regulilor pentru numerele interne / externe.
Model
Modelul specifică formatul numărului cu care se va potrivi.
Modelul de mai sus afirmă că numărul trebuie să fie format numai din cifre și le selectează.
Selectorul
Selectorii definesc formatul final al numărului. Dacă trebuie adăugate caractere / cifre care nu au fost prezente inițial, acesta este locul pentru a face acest lucru.
Selectorul este ultimul pas în construirea numărului. Pe baza rezultatului modelului, selectorul construiește noul număr.
Exemplul 1
Următorul exemplu arată cum să transferați 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ă numărul. Pentru numerele cu lungimea cuprinsă între 1 și 17 caractere, orice altceva în afară de cifre ar fi eliminat. Deoarece nu există nicio cifră prezentă, nimic nu se schimbă.
A doua regulă se aplică numerelor care au exact 10 caractere (inițial). 0319175200 se potrivește și, prin urmare, se aplică regula. 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}) și așa mai departe.
Selectorul accesează apoi grupurile de modele pentru a defini noul șir numeric. Aceasta înseamnă că $2 face referire la primul (\d{2}) și, prin urmare, conține 31.
Exemplul 2
Următorul exemplu arată cum se transferă un număr primit de la Contact Center în formatul +14693150217 în formatul US E164 +1 469 315 0217.
Acest exemplu utilizează două reguli de traducere (1. și 2.)
- Acest număr are exact 12 caractere, deci se aplică regula "Adăugați spații la numerele SUA".
- (\+1) spune că numărul trebuie să înceapă cu +1. Dacă numărul are 12 caractere, dar nu începe cu un +1, regula este anulată și nu se schimbă nimic.
- (\d{3}) spune că +1 trebuie urmat de 3 cifre.
- (\d{3}) spune că ultimele 3 cifre trebuie urmate de alte 3 cifre.
- (\d{4}) spune că ultimele 3 cifre trebuie urmate de 4 cifre.
Dacă oricare dintre acestea nu se potrivește, numărul nu va fi modificat.
Deci, toate regulile se aplică la "+14693150217". Prin urmare, numărul este modificat cu "$1 $2 $3 $4":
- $1 se referă la grup (\+1), numărul de trimis la Service Cloud Voice arată ca +1.
- $2 se referă la primul dintre cele două (\d{3}), numărul de trimis la Service Cloud Voice arată ca +1 469.
- $3 se referă la al doilea dintre cele două (\d{3}), numărul de trimis la Service Cloud Voice arată ca +1 469 315.
- $4 se referă la ultimul grup (\d{4}), numărul de trimis la Service Cloud Voice 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 ar fi tradus în: +1-469-315-0217
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 internațional din SUA î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.
Exemplul 3
Următorul exemplu arată cum să transferați 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, deci 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 caractere, dar nu începe cu +49, regula este anulată și nu se schimbă nimic.
- (\d{3}) spune că +49 trebuie urmat de 3 cifre.
- (\d{4}) spune că ultimele 3 cifre trebuie urmate de 4 cifre.
- (\d{3}) spune că ultimele 4 cifre trebuie urmate de 3 cifre.
Dacă oricare dintre acestea nu se potrivește, numărul nu va fi modificat.
Deci, toate regulile se aplică la "+491515555531". Prin urmare, numărul este modificat cu "$1 $2 $3 $4":
- $1 se referă la grup (\+49), numărul de trimis la Service Cloud Voice arată ca +49.
- $2 se referă la primul dintre cele două (\d{3}), numărul de trimis la Service Cloud Voice arată ca +49 151.
- $3 se referă la al doilea dintre cele două (\d{4}), numărul de trimis la Service Cloud Voice arată ca +49 151 5555.
- $4 se referă la ultimul grup (\d{3}), numărul de trimis la Service Cloud Voice arată ca +49 151 5555 531.
Același lucru este valabil și pentru regula unu. Puteți utiliza piesa de schimb $1 $2 $3 $4 pentru a alege ce să utilizați din număr.
Mai multe exemple de traduceri Regex
| Descriere | Traduceri Regex |
|---|---|
| Eliminați toate caracterele, cu excepția cifrelor | [1,17]->[^\d]+ |
| Eliminați toate caracterele, cu excepția cifrelor & + | [1,17]->[^+\d]+ |
| Descriere | Traduceri Regex |
|---|---|
| Eliminare +1 | [12,12]->(.{ 1})(\d{1})(\d{10})->$3 |
| Eliminare +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 |
| Eliminare +XX | [10,14]->(^\++)(\d{2})(\d+)->$3 |
| Descriere | Traduceri Regex |
|---|---|
| Scoateți + și înlocuiți-l cu zerouri US E164 | [10,12]->(.{ 1})(\d{1})(\d{10})-> 001 $3 |
| Eliminați +1 și înlocuiți-l cu zerouri US E164 | [10,12]->(^\+1+)(\d+)-> 001$2 |
| Scoateți + și înlocuiți-l cu zerouri DE E164 | [12,15]->(.{ 1})(\d{2})(\d{10})-> 0049 $3 |
| Scoateți +49 și înlocuiți-l cu zerouri DE E164 | [10,12]->(^\+49+)(\d+)-> 0049$2 |
| Scoateți + și înlocuiți-l cu zerouri CH E164 | [10,13]->(.{ 1})(\d{2})(\d{9})-> 0041 $3 |
| Scoateți +41 și înlocuiți-l cu zerouri CH E164 | [10,12]->(^\+41+)(\d+)-> 0041$2 |
| Descriere | Traduceri Regex |
|---|---|
| Numărul SUA cu spațiu | [12,17]->(\d{1})(\d{3})(\d{3})(\d{4})->+1 $2 $3 $4 |
| Numărul 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ărul CH cu spațiu | [12,17]->(\d{2})(\d{2})(\d{3})(\d{2})(\d{2})->+41 $2 $3 $4 |
| Numărul CH cu spațiu | [12,17]->(\+41)(\d{2})(\d{3})(\d{2})(\d{2})->$1 $2 $3 $4 |
Configurarea paginii VoiceCall
Configurarea paginii de înregistrare a apelurilor vocale
Pagina de înregistrare a apelurilor vocale este preconfigurată în mod implicit, cu un aspect cu 3 coloane și următoarele componente:
- Acțiuni și recomandări
- Note de apel
- Detalii apel
- Înregistrări
Componentele pot fi eliminate sau adăugate liber la pagină, în funcție de nevoile afacerii. De asemenea, pot fi utilizate diferite aspecte de pagină, dar unele componente, cum ar fi playerul de înregistrare a apelurilor și corpul conversației, pot încăpea numai pe zonele medii și mari ale șablonului.
Afișarea componentei Motiv concluzionare
Componenta Motiv concluzionare trebuie să fie afișată în timpul apelului și în timpul concluzionării.
Adăugați componenta Cisco Motiv concluzionare la pagina înregistrării apelurilor vocale:
- Glisați componenta web Cisco Wrap-Up Reason Lightning din zona particularizată a listei Lightning Components în pagina de înregistrare VoiceCall.
- Faceți clic pe Salvare.
- Faceți clic pe Activare.
- Faceți clic pe Atribuire ca valoare implicită a organizației.
- Faceți clic pe Salvare.
- Faceți clic din nou pe Salvare , apoi faceți clic pe Săgeată înapoi pentru a reveni la pagină.
Componenta Cisco Motiv concluzionare se va afișa automat în timpul apelului și în timpul concluzionării:
Dacă este adăugată la pagină, componenta Cisco Motiv concluzionare este afișată pentru fiecare apel, chiar dacă nu este configurată nicio încheiere în Cisco Contact Center.
Afișarea playerului de înregistrare a apelurilor
Playerul 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 înregistrare apeluri la pagina de înregistrare a apelurilor vocale:
- Glisați componenta web Lightning a playerului de înregistrare a apelurilor în pagina de înregistrare a apelurilor vocale
- Dați clic pe Salvați.
- Faceți clic pe Activare.
- Faceți clic pe Atribuire ca valoare implicită a organizației.
- Dați clic pe Salvați.
- Faceți clic din nou pe Salvare , apoi faceți clic pe Săgeată înapoi pentru a reveni la pagină.
Webex Administratori
Configurarea fluxului
Fereastră Pop
Un nod "Screen Pop" este disponibil în fluxul Webex Contact Center. Poate fi folosit pentru a declanșa un ecran pop-up în Service Cloud Voice sau într-o fereastră separată.
Informații suplimentare despre această funcție pot fi găsite în documentația Designerului de flux.
Ecran pop-up într-o fereastră separată
Pentru a deschide fereastra pop-up într-o fereastră separată, trebuie furnizată o adresă URL absolută în nodul "Ecran pop-up". QueryParameters vor fi adăugați ca parametri de căutare la adresa URL.
Sunt acceptate următoarele moduri:
- Noul browser Tab - Deschide întotdeauna un browser nou Tab.
- Browser existent Tab - În prima fereastră pop-up de pe ecranul Tab al browserului existent, se deschide un nou browser Tab. Acel Tab va fi Tab dedicat pentru apariția ulterioară a ecranului Tab al browserului existent și adresa URL va fi reîmprospătată în browserul respectiv Tab.
- În interiorul desktopului - este tratat în același mod ca browserul nou Tab.
Pagina deschisă în prezent poate împiedica o redirecționare. În acest caz, se deschide un ecran pop-up Tab Browser existent într-un browser nou Tab.





