- Hjem
- /
- Artikel
Webex Contact Center til Salesforce Service Cloud Voice integrerer Ciscos robuste CCaaS (Contact Center as a Service) med Salesforces CRM, hvilket giver virksomheder mulighed for at administrere omnichannel -kundeinteraktioner (tale, digital) i Salesforce-grænsefladen ved hjælp af Webex AI til virtuelle agenter, transkription og intelligent routing, hvilket transformerer agenter til superagenter" med samlede data for bedre kundeoplevelser.
Overblik
Webex Kontaktcenter til Salesforce Service Cloud Voice
Webex Contact Center til Service Cloud Voice er en færdiglavet integrationsløsning, der bringer kraften fra Webex Contact Center ind i Salesforce Service Cloud Voice Omni-channel agentkonsollen.
Før du fortsætter med installationen, skal du læse følgende afsnit:
for at lære om forudsætninger og begrænsninger for Salesforce Service Cloud Voice og sikre, at din Salesforce-organisation er klar til at aktivere og installere Webex Contact Center til Service Cloud Voice -pakken.
Forudsætninger og begrænsninger
Forudsætninger (underemne)
Brugergrænseflader: Service Cloud Voice er kun tilgængelig i Salesforce Lightning Experience.
Service Cloud Voice er tilgængelig i disse udgaver.
- Virksomhed
- Ubegrænset
- Udvikler
Licenser
-
Kunder skal købe den nye A-SF-VOICE-tilføjelseslicens pr. logget agent ud over Flex 3 Standard- eller Premium-licenserne til Webex Contact Center. For yderligere information, se Flex 3 bestillingsvejledningen.
- Salesforce Voice til partnertelefoni
Før du aktiverer Voice, skal du konfigurere de nødvendige tjenester i din organisation.
- Naviger til Virksomhedsoplysninger > Tilladelsessætlicens
- Tjek efter Service Cloud Voice-bruger (Partnertelefoni).
Alle udviklerudgaver leveres nu med 5 partnertelefonilicenser, der er tilgængelige til test.
- Tjek efter Service Cloud Voice-bruger (Partnertelefoni).
- Alternativt kan du bekræfte dette ved at gå til Salesforce-opsætning og søge efter "stemme" i venstre sidebjælke.
- Hvis "Partnertelefonikontaktcentre" vises, har du SCV-licensen.
- Hvis "Partnertelefonikontaktcentre" ikke er synlig, skal du "Aktivere Service Cloud Voice" ved at følge nedenstående trin.
- Gå til Salesforce-opsætning, søg og vælg "Partnertelefoniopsætning", og slå knappen til "Aktiver Service Cloud Voice".
- Aktiver Omni-Channel, så dine agenter kan foretage og modtage opkald.
- Gå til Salesforce-opsætning, søg og vælg "Partnertelefoniopsætning", og slå knappen til "Aktiver Service Cloud Voice".
Aktivér Omni-Channel
Hvis Omni-Channel allerede er aktiveret i din organisation, skal du springe dette trin over.
- Fra Opsætning skal du skrive Omni-Channel-indstillinger i feltet Find hurtigt, og derefter vælge Omni-Channel-indstillinger.


- Vælg Aktiver Omni-Channel.
- Klik på Gem.
Begrænsninger
- Stemme er kun tilgængelig i Lightning Experience.
- Voice understøttes på Service Cloud og Sales Cloud som en tilføjelseslicens.
- Voice understøttes ikke på Salesforce Mobile eller på iPad Safari.
- Stemme understøttes kun i webbrowserne Google Chrome, Microsoft Edge (Chromium) og Mozilla Firefox. Cookies skal være aktiveret for at tillade single sign-on (SSO).
- Standardnavigation understøttes ikke.
- Telefoni er stærkt reguleret, så tjek med din Salesforce-repræsentant om tilgængeligheden af Voice i din region.
Krav
Inaktive koder
Find tomgangskoder
| 1 |
Log ind på administrationsportalen. |
| 2 |
Naviger til Kontaktcenter > DESKTOP-OPLEVELSE > Idle/Wrap-up Koder. |
| 3 |
Sørg for, at inaktive koder vises, ellers skal du klikke på rullemenuen for filter og vælge Inaktiv kode øverst på siden. |
| 4 |
Klik på en inaktiv kode for at åbne detaljevisningen. Der kan du finde Idle-kode-ID'et.
ID'erne kan kopieres og derefter bruges til konfigurationen Tilstedeværelsestilstandskortlægning. Et af ID'erne skal bruges som Standardårsag til Cisco ikke klar. |
Integrere
Installation
Før du fortsætter med installationen, skal du se afsnittet Forudsætninger og begrænsninger for at få mere at vide om forudsætninger og begrænsninger for Salesforce Service Cloud.
Installer og konfigurer Webex Contact Center til Service Cloud Voice
Når en Service Cloud Voice til Partnertelefoni -licens er anskaffet, vises siden Partnertelefoniopsætning i menuen Opsætning.
Yderligere information kan findes i Salesforces officielle reference ( direkte link).
| 1 |
Fra Opsætning skal du indtaste |
| 2 |
Aktiver Slå tale til med partnertelefoni. Siden Partnertelefonikontaktcentre vises i menuen Opsætning. Hvis du planlægger at implementere pakken i en Salesforce-sandbox, skal du erstatte |
Installer pakken
Sådan installeres pakken:
| 1 |
Åbn det medfølgende link til pakken for at starte installationen. |
| 2 |
Log ind på den Salesforce-organisation, hvor pakken skal installeres. |
| 3 |
I installationsguiden skal du vælge sikkerhedsindstillingen "Installer kun for administratorer" (1) og klikke på Installer (2). Bestem, hvilke brugere der får bestemte tilladelser til de objekter og komponenter, der følger med Webex Contact Center til Service Cloud Voice-pakken. Derudover skal du give dem disse tilladelser; tilladelsessættene, der følger med Webex Contact Center til Service Cloud Voice-pakken, hjælper med denne proces. Guide til pakkeinstallation – Velkomstskærmen vises: |
| 4 |
Giv følgende tilladelsessæt til mindst én bruger, så du kan oprette kontaktcenteret: |
| 5 |
Klik på Opsætning | Brugere | Brugere. |
| 6 |
Søg og vælg en bruger. |
| 7 |
Rul ned til "Tildelinger af tilladelsessæt". |
| 8 |
Klik på Rediger opgaver |
| 9 |
Til Kontaktcenteradministratorer: tildel tilladelsessættet Kontaktcenteradministrator (Partnertelefoni).
|
| 10 |
For Kontaktcenteragenter: Tildel tilladelsessættet Kontaktcenteragent (partnertelefoni) og tilladelsessættet Webex Kontaktcenter SCV-agent.
Det anbefales ikke at vælge indstillingen Installer for alle brugere, da dette giver alle tilladelser (læse, oprette, redigere og slette) på pakkekomponenterne og objekterne til enhver bruger, der bruger en brugerdefineret brugerprofil. |
| 11 |
Tildel en pakkelicens til brugere, så de kan arbejde med Connects for Service Cloud Voice.
|
| 12 |
Alternativt kan du klikke på Opsætning | Brugere | Brugere.. |
| 13 |
Søg og vælg bruger. |
| 14 |
Rul ned til Administrerede pakker. |
| 15 |
Klik på Tildel licenser. |
| 16 |
Vælg Webex Contact Center for Service Cloud Voice-pakken fra listen. |
| 17 |
Klik på Tilføj. |
| 18 |
Opret Tilstedeværelsesstatusser for at definere, hvilke servicekanaler der er tildelt forskellige statusser. Agenter kan logge ind på Omni-Channel med forskellige statusser afhængigt af den type arbejde, de er berettiget til at modtage. |
| 19 |
Fra Opsætning skal du indtaste |
| 20 |
Klik på Ny. Opret mindst én status for "Online" og én for "Optaget".
|
Tildel tilstedeværelsesstatus(er) til agenter
| 1 |
Skriv Tilladelsessæt i feltet Find hurtigt i Opsætning, og vælg derefter Tilladelsessæt. |
| 2 |
Klik for at åbne Partnertelefonitilladelsessæt. |
| 3 |
Klik på Statusser for tjenestetilstedeværelse Adgang. |
| 4 |
Klik på Rediger. |
| 5 |
På listen Tilgængelige tjenestetilstedeværelser skal du vælge den/de tilstedeværelsesstatus(er), der tidligere er oprettet, og klikke på Tilføj for at knytte dem til tilladelsessættet. Agenter, der er tildelt dette tilladelsessæt, kan logge ind på Omni-Channel med en hvilken som helst af de tilstedeværelsesstatusser, der er gjort tilgængelige for dem. |
| 6 |
Klik på Gem. |
| 7 |
Klik på Administrer opgaver på samme side. Klik derefter på Tilføj tildeling i øverste højre hjørne, vælg den ønskede bruger, klik på Næste, vælg en Udløbsmulighed for de tildelte brugere (valgfrit), og klik derefter på Tildel. Service Cloud Voice bruger et eksternt domæne til at arbejde med VoiceCall-posten. Følgende URL'er skal tilføjes til "Indstillinger for fjernwebsted" i opsætningen ( klik her for at åbne den officielle dokumentation):
Eksempel: Sådan finder du en instans-URL. |
| 8 |
Se URL'en i din browsers adresselinje efter du har logget ind. Instans-URL'en er delen før ".my.salesforce.com" eller ".salesforce.com" eller ".lightning.force.com". Hvis din URL for eksempel er https://orgfarm-54a38e30ad-dev-ed.develop.my.salesforce-setup.com/,, så er "orgfarm-54a38e30ad-dev-ed.develop" din instans-URL. Eksempel: URL til oprindelig organisation: https://cisco.lightning.force.com Eksempel: URL, der skal tilføjes:
|
| 9 |
Omni-Channel-hjælpeelementet er påkrævet i Lightning Service Console-appen for at agenten kan bruge Service Cloud Voice.
Den officielle reference fra Salesforce kan findes ved at klikke på knappen Lad os gøre dette, der åbner siden Konfigurer agentoplevelsen til Service Cloud Voice med partnertelefoni i Salesforce hjælpeportalen ( direkte link). |
| 10 |
Fra Opsætning skal du indtaste Opsætning af partnertelefoni i feltet Find hurtigt, og derefter vælge Opsætning af partnertelefoni. |
| 11 |
Rul ned til afsnit 5 Flere stemmeindstillinger. |
| 12 |
For at aktivere clickjack-beskyttelse for Visualforce-sider med deaktiverede overskrifter, mens du arbejder med softphonen i Lightning Experience, skal du tilføje de domæner, som softphonen og de brugerdefinerede værktøjslinjer indlæses fra, som betroede domæner, ud over Salesforce-instansens URL. Disse indstillinger og listen over domæner, du har tillid til, kan findes under Opsætning | Sikkerhed | Sessionsindstillinger For at hente det korrekte Visualforce-domæne skal du navigere til Opsætning | Brugerdefineret kode | Visualforce-sider og klikke på knappen Forhåndsvisning for Eksempel: MyDomainName--cisco_wxcc_scv.vf.force.com For at hente Salesforce-instansdomænet skal du kopiere den URL, der vises i browserens URL-linje, og føje den til listen Liste over betroede domæner til inline-rammer ved at vælge Visualforce-sider som IFrame-type. Eksempel: MyDomainName.lightning.force.com Hvis du ikke har et Mit domæne implementeret i din organisation, er dit URL-format anderledes. Hvis du har implementeret Mit domæne, og forbedrede domæner ikke er aktiveret i din organisation, er dit URL-format anderledes. Hvis forbedrede domæner ikke er aktiveret, påvirker indstillingen Stabiliser URL'er i Visualforce, Experience Builder, Site.com Studio og indholdsfiler Mit domæne også dette format. For detaljer, se URL-formater for mit domæne i Salesforce Hjælp. Indstillinger for Clickjack-beskyttelse og domæner, der er tillid til, til Lightning Experience |
| 13 |
For at kunne vise optagelseskontrollerne under opkald skal agenter have app-tilladelsen For at tildele den skal du føje den til det tilladelsessæt, der blev oprettet i trinnet Tilstedeværelsesstatusser.
|
Konfiguration
Kontaktcenter
En definitionsfil for kontaktcenter angiver et sæt felter og værdier, der bruges til at definere et kontaktcenter i Salesforce for et bestemt CTI-system. Salesforce bruger definitionsfiler for Contact Center til at understøtte integrationen med flere CTI-systemleverandører.
Yderligere information kan findes i Salesforces officielle dokumentation ( direkte link).
Importer kontaktcenteret
Download den seneste version af Kontaktcenteret her.
Opgradering fra Beta: Denne vejledning beskriver en ren installation af den generelle tilgængelighed (GA)-version af Webex Contact Center-integrationen til Salesforce Service Cloud Voice.
Hvis du opgraderer fra en betaversion af integrationen, må du ikke genbruge en eksisterende Partner Contact Center-post. I stedet:
- Importer XML-filen fra Partner Contact Center, der følger med GA-udgivelsen.
- Opret en ny Partner Contact Center-post ved hjælp af den importerede XML.
- Opdater din konfiguration for at bruge det nyoprettede Partnerkontaktcenter.
GA Partner Contact Center XML indeholder opdaterede konfigurationsværdier, herunder den korrekte Connector-URL og andre metadata. Genbrug af en Partner Contact Center-post, der er oprettet fra Beta XML, kan indeholde forældede konfigurationsværdier og forhindre integrationen i at fungere korrekt.
| 1 |
Skriv Partnertelefonikontaktcentre i feltet Søg hurtigt i Opsætning, og vælg derefter Partnertelefonikontaktcentre. Listen over eksisterende (hvis nogen) kontaktcentre vises.
|
| 2 |
Klik på Opret kontaktcenter i højre side af siden. |
| 3 |
Vælg Webex Kontaktcenter som din telefonudbyder. Klik derefter på Næste. En filbrowser åbnes.
|
| 4 |
Vælg den |
| 5 |
Klik på Åbn. Filen importeres.
|
| 6 |
Kontroller, om dit kontaktcenter vises i listevisningen over kontaktcentre. |
Konfigurer kontaktcenteret
| 1 |
Skriv Partnertelefonikontaktcentre i feltet Søg hurtigt i Opsætning, og vælg derefter Partnertelefonikontaktcentre. | ||||||||||||||||||||||||||||||
| 2 |
Klik på det kontaktcenter, der tidligere blev importeret. | ||||||||||||||||||||||||||||||
| 3 |
Klik på Rediger.
| ||||||||||||||||||||||||||||||
| 4 |
Nederst på siden Kontaktcenter skal du klikke på knappen Tilføj under afsnittet Kontaktcenterbrugere. | ||||||||||||||||||||||||||||||
| 5 |
Klik + ved siden af brugerne, der har adgang til det åbne Kontaktcenter. Kun brugere med tilladelsen |
Tilpas
Ekstern klientapp til Webex Contact Center-integration
Konfigurer den eksterne klientapp til Webex Contact Center Salesforce Connector
For at udnytte Service Cloud Voice fuldt ud kan Contact Center-opkaldsflowet tilpasses til at oprette Voice-opkaldsposten og udføre et Salesforce Omni-Channel-flow, mens opkaldet er på IVR'en.
Opret certifikat
Sørg for, at du allerede har oprettet et digitalt certifikat i henhold til din organisations sikkerhedspolitik.
For at generere et digitalt certifikat, se Salesforce-dokumentationen på https://developer.salesforce.com/docs/atlas.en-us.voice_pt_developer_guide.meta/voice_pt_developer_guide/voice_pt_generate_certificate.htm.
Eksempel
openssl genrsa -des3 -passout pass: -out server.pass.key 2048
openssl rsa -passin pass: -in server.pass.key -out server.key
rm server.pass.key
openssl req -new -key server.key -out server.csr
Country Name (2 letter code) [AU]:CH
State or Province Name (full name) [Some-State]:
Locality Name (eg, city) []:
Organization Name (eg, company) [Internet Widgits Pty Ltd]:
Organizational Unit Name (eg, section) []:
Common Name (e.g. server FQDN or YOUR name) []:
Email Address []: my-api-user@my-example-org.com
Please enter the following 'extra' attributes
to be sent with your certificate request
A challenge password []:
An optional company name []:
openssl x509 -req -sha256 -days 365 -in server.csr -signkey server.key -out server.crt
server.crt => Certifikat til Salesforce External Client-appen
server.nøgle => Privat nøgle til Salesforce Connector i Webex Control Hub
Tilladelsessæt for SCV-integrationsbrugeren
Følgende tilladelsessæt giver adgang til Apex-klasser, der bruges af Connects for SCV til integration med Contact Center IVR-flows og Webex Contact Center for Salesforce for SCV.
Følgende er et eksempel på en konfiguration, der beskriver de minimumskrav til tilladelser for kontaktcenteret. / IVR-integration til at fungere.
- Fra Opsætning skal du navigere til Brugere | Tilladelsessæt
- Klik på knappen Ny.
- Indtast en etiket, for eksempel: IVR-adgang til SCV Apex-klasser
- API-navnet udfyldes automatisk
- Licens: Ingen
- Klik på knappen Gem.
- Det nye tilladelsessæt åbnes.
- Naviger til Apex-klasseadgang.
- Klik på knappen Rediger og tilføj følgende Apex-klasser:
- cisco_wxcc_scv.ServiceRouting
- Naviger til Systemtilladelser.
- Klik på knappen Rediger og aktiver følgende tilladelser:
- Apex REST-tjenester
- API-aktiveret
Minimum adgang - Kun API-integrationsprofil
Denne profil bruges til at integrere med Webex Contact Center til Salesforce til SCV for at oprette stemmeopkaldsposter og udføre Omni-Flow fra IVR-flowet.
Følgende er et eksempel på en konfiguration, der beskriver de minimumskrav, der kræves for Kontaktcenteret. / IVR-integration til at fungere.
Dette er en klon fra profilen Minimum Access - API Only Integrations.
- Fra Opsætning skal du navigere til Brugere | Profiler.
- Søg efter profilen Minimum adgang - Kun API-integrationerpå profillisten.
- Klik på profilnavnet for at åbne profilen Minimum adgang - Kun API-integrationer.
- På profilen Minimum adgang - Kun API-integrationer skal du klikke på knappen Klon.
- Indtast et nyt profilnavn, for eksempel: SCV-integration.
- Klik på knappen Gem.
- Den nye profil åbnes.
- Bekræft, at din Minimum Access – API Only Integrations-profil har alle tilladelser fjernet fra selve profilen.
- Naviger til Systemtilladelser.
- Sørg for, at følgende tilladelser er aktiveret:
- API-aktiveret
- Kun API-bruger
SCV-integrationsbruger
Følgende er et eksempel på en konfiguration, der beskriver de minimumskrav, der kræves for Kontaktcenteret. / IVR-integration til at fungere. Der kræves ingen Salesforce Service Cloud Voice-licens eller Webex Contact Center til Salesforce til SCV-licens for SCV-integrationsbrugeren.
- Fra Opsætning skal du navigere til Brugere | Brugere.
- Klik på knappen Ny bruger.
- Indtast fornavn, efternavn og alle andre obligatoriske felter.
- Brugerlicens: Salesforce-integration
- Profil: vælg den profil, der blev oprettet i det forrige trin ("SCV-integrationsprofil", klon af Minimum Access - API Only Integrations-profilen)
- Klik på knappen Gem.
- Åbn den nye brugerpost.
- Tildel det tilladelsessæt der blev oprettet før ("IVR-adgang til SCV Apex-klasser").
- Tildel tilladelsessætlicensen Salesforce API-integration.
Opret ekstern Salesforce-klientapp
Opret en ny ekstern klientapp
Der er to muligheder for at forbinde dine Salesforce-data med tredjepartsapplikationer. BådeConnected AppsogExternal Client Appser frameworks til at integrere data. External Client Apps er den næste generation af forbundne apps.
Sådan konfigurerer du den eksterne Salesforce-klientapp, der bruges af Cisco Webex Contact Center:
- Fra Opsætningskal du navigere tilApps | Eksterne klientapps | Appadministrator for ekstern klient.
- Klik påNy ekstern klientapp.
- Ekstern klientapp – grundlæggende oplysninger
- Navn på ekstern klientapp: WxCC - SCV
- API-navn: WxCC_SCV
- Kontakt-e-mailadresse: < your email >
- Distributionsstat: vælg Lokal

Ekstern klientapp – API (Aktivér OAuth-indstillinger)
- Vælge: Aktivér OAuth
- App-indstillinger
- Tilbagekald URL: http://localhost:1717/OauthRedirect as en eksempel-URL til tilbagekald
- OAuth-områder
- Vælg OAuth-omfang:
- Administrer brugerdata via API'er (api)
- Udfør anmodninger når som helst (refresh_token, offline_access)

Flowaktivering
- Vælge: Aktivér JWT Bearer-flow
- Klik på Upload filer, og upload den
server.crtfil, der indeholder dit digitale certifikat.

Sikkerhed
Fjern markeringen i indstillingen Kræv hemmelighed for webserverflowet.

- Klik på knappenOpret.
- Skift til Fanebladet Politikker og klik derefter på knappenRediger.
- Politikker – OAuth-politikker
- Plugin-politikker
- Tilladte brugere: udvalgte administratorgodkendte brugere er forhåndsgodkendte
- Bekræft ændringen
- App-godkendelse
- Politik for opdatering af token: Vælg Opdateringstoken udløber med det samme
- IP-afslapning: vælg Håndhæv IP-begrænsninger

- Plugin-politikker
- Politikker – App-politikker
- Startside – ingen
- Vælg tilladelsessæt – Tildel det tilladelsessæt, der blev oprettet før ("IVR-adgang til SCV Apex-klasser")

- Klik på Gem.
- Skift til fanebladindstillinger.
-
I afsnittet OAuth-indstillinger skal du klikke på knappenForbrugernøgle og Hemmelighed; vent på e-mail, og bekræft din identitet. En ny browserfane åbner en skærm med forbrugeroplysninger.

- Klik på Kopier og gemForbrugernøglen. Forbrugernøglen bruges senere til at oprette Salesforce Connector på Webex Contact Center Control Hub.

-
Webex Contact Center-konfiguration og script til at oprette stemmeopkaldsposter
For at få den fulde værdi af Salesforce Service Cloud Voice skal opkaldsflowet i Webex Contact Center ændres for at oprette Voice-opkaldsposten i Service Cloud Voice, så snart opkaldet ankommer til Contact Center.
Et valgfrit Omni-Flow kan udføres til routingbeslutninger og automatisering i Salesforce.
For detaljer om de anvendte API'er, se Service Cloud Voice API Wrapper.
Forudsætninger
For at kunne bruge Service Cloud Voice API Wrapper skal en Salesforce ekstern klientapp til IVR-integration konfigureres.
Konfigurer Salesforce Connector i Webex Control Hub
Opsæt Salesforce Integration Connectors til Webex Contact Center som beskrevet i artiklen på https://help.webex.com/en-us/article/7fuy63/Set-Up-Integration-Connectors-for-Webex-Contact-Center#id_133211.
| 1 |
Log ind på din kundeorganisation på https://admin.webex.com og naviger til Tjenester > Kontaktcenter > Lejerindstillinger > Integrations>Connectors. |
| 2 |
Klik på Konfigurer eller Tilføj forbindelse på Salesforce-kortet.
VIGTIGT: OPRETHOLD SIKKERHEDEN VED PERIODISK AT SKIFTE HEMMELIGHEDER Sørg for regelmæssigt at rotere din private nøgle og dit certifikat for at holde dine integrationer sikre. Opdater den private nøgle i Kontaktcenter-connectoren i Webex Hubog certifikatet i den eksterne klientapp i Salesforce. Fejlfindingstip Når du klikker på Udført, og forbindelsen ikke gemmer:
|
Webex Kontaktcenter Hovedflow
| Flowvariabel | Beskrivelse |
|---|---|
| Flowvariabel for opkaldspost-ID | Unikt id til at identificere opkaldet. Kræves for at oprette taleopkaldsposten. Format: wxcc_<Interaction Id> Eksempel: wxcc_fc4ec7d8-4c91-49aa-b764-081fbba344a8
|
| Lokal variabel for opkaldets starttidspunkt |
Bruges til at oprette taleopkaldsposten og ved opdatering af taleopkaldet.
|
| Lokal variabel for kø name/id |
Returneret af Udfør Omni Flow, bruges til opkaldsrouting. Denne variabel er kun påkrævet, når du bruger Execute Omni Flow
|
| Lokal variabel for Agent name/id |
Returneret af Udfør Omni Flow, bruges til opkaldsrouting. Denne variabel er kun påkrævet, når du bruger Execute Omni Flow
|
Oversigt over hovedflow

- Generer leverandøropkaldsnøgle
- Indstil opkaldsstarttidspunkt
- HTTP-anmodning: Opret opkaldspost
- Evaluer HTTP-svar for Opret stemmeopkaldspost
- Fejlhåndtering for Opret taleopkaldspost
- HTTP-anmodning: Udfør Omni Flow
- Evaluer HTTP-svar for at udføre Omni-flow
- Fejlhåndtering for Execute Omni Flow
- Fortsæt med opkaldsrouting
| Flow | Beskrivelse |
|---|---|
| Generer leverandøropkaldsnøgle |
Hvert opkald, der håndteres i Service Cloud Voice, opretter en Voice Call-post i Salesforce og kræver et unikt ID kaldet Vendor Call Key. For stemmeopkaldsposter, der er oprettet i Webex Contact Center, skal leverandøropkaldsnøglen defineres i WxCC-flowet og derefter sendes sammen med opkaldet til agenten ved hjælp af en flowvariabel. Værdien vendorCallKey skal overholde følgende regler:
|
| Indstil opkaldsstarttidspunkt |
UTC-tidsstempel for opkaldets starttidspunkt. Dette tidsstempel bruges til at oprette taleopkaldsposten og til at opdatere taleopkaldsposten, hvis den, der ringer op, lægger på, før den bliver sendt videre til agenten.
|
| HTTP-anmodning: Opret opkaldspost |
Dette trin er påkrævet for hvert opkald. Når stemmeopkaldsposten er oprettet, skal stemmeopkaldspost-ID'et sendes med opkaldet til agenten i en variabel sammen med leverandøropkaldsnøglen. Konfigurer den anvendte variabel i Contact Center-konfigurationen i Service Cloud Voice. |
| HTTP-anmodningsindstillinger |
|
HTTP-anmodning: Opret opkaldspost
Dette trin er påkrævet for hvert opkald. Når stemmeopkaldsposten er oprettet, skal stemmeopkaldspost-ID'et sendes med opkaldet til agenten i en variabel sammen med leverandøropkaldsnøglen. Konfigurer den anvendte variabel i Contact Center-konfigurationen i Service Cloud Voice.
HTTP-anmodningsindstillinger
- Aktivitetsetiket: Opret taleopkald
- Brug godkendt slutpunkt: Aktiveret
- Stik: Salesforce Connector oprettet i forrige trin
- Anmodningssti:
/services/apexrest/cisco_wxcc_scv/voice/v1/createVoiceCall - Metode: POST
- Anmodningsindholdstype: Application/JSON
Anmodningstekst
Når du opretter stemmeopkaldsposten, kan du også opdatere brugerdefinerede felter i stemmeopkaldsposten med opkaldsdata. Nedenfor er to eksempler på anmodningsteksten, et med alle de obligatoriske felter, men uden opdatering af brugerdefinerede felter, og et med brugerdefinerede felter.
Uden at opdatere brugerdefinerede felter på stemmeopkaldsposten:
{
"callCenterDevName": "",
"certDevName": "",
"vendorCallKey": "{{SCV_VendorCallKey}}",
"to": "{{NewPhoneContact.DNIS}}",
"from": "{{NewPhoneContact.ANI}}",
"initiationMethod": "Inbound",
"startTime": "{{SCV_CallStartTime}}",
"participants": [
{
"participantKey": "{{NewPhoneContact.ANI}}",
"type" : "END_USER"
}
]
}
Eksempel på opdatering af brugerdefinerede felter i stemmeopkaldsposten:
{
"callCenterDevName": "",
"certDevName": "",
"vendorCallKey": "{{SCV_VendorCallKey}}",
"to": "{{NewPhoneContact.DNIS}}",
"from": "{{NewPhoneContact.ANI}}",
"initiationMethod": "Inbound",
"startTime": "{{SCV_CallStartTime}}",
"participants": [
{
"participantKey": "{{NewPhoneContact.ANI}}",
"type" : "END_USER"
}
],
"callAttributes": "{\"custfield1__c\": \"\",\"custfield2__c\": \"\",\"custfield3__c\": \"\"}"
}
Parametre
| Ejendommens navn | Værdi |
|---|---|
| callCenterDevName | Navn på udvikler af kontaktcenter |
| certDevName | API-navn på certifikat (som konfigureret i Kontaktcenter) |
| sælgeropkaldsnøgle | Unikt opkalds-id: {{SCV_VendorCallKey}} |
| til | CalledNumber/DNIS: {{NewPhoneContact.DNIS}} |
| fra | CallingNumber/ANI: {{NewPhoneContact.ANI}} |
| startTime | UTC-tidsstempel {{SCV_CallStartTime}} (skal indstilles lige efter at kaldet er accepteret i scriptet) |
| opkaldsattributter |
Repræsenterer yderligere standard- og brugerdefinerede felter i stemmeopkaldsposten, hvor hvert nøgleværdipar svarer til et standard- eller brugerdefineret felt og dets værdier. Eksempel: |
Parse-indstillinger
- Indholdstype: JSON
- Outputvariabel: SCV_VoiceCallRecordId
- Stiudtryk:
$.data.voiceCallId
Id for stemmeopkaldsoptagelse, der skal videregives til agenten.
Evaluer HTTP-svar for Opret stemmeopkaldspost
Kontroller HTTP-status for http-anmodningen "Opret taleopkald":
- Etiket: statusKodeOpretStemmeopkald
- Variabel: OpretStemmeopkald.httpStatuskode
Hvis statuskode == 200 => succesfuld ellers => anmodning mislykkedes, fejlhåndtering
Fejlhåndtering for Opret taleopkaldspost
Til demonstration / kun fejlfinding, afspil besked afhængigt af http-statuskode.
Hvis Opret taleopkald lykkedes, skal du fortsætte med Udfør Omni Flow. Ellers fortsæt med opkaldsrouting.
HTTP-anmodning: Udfør Omni Flow (valgfrit trin)
Brug Execute Omni-Flow, når du vil:
- køre automatiserede opgaver, for eksempel søge efter eller oprette poster, og linke posterne til stemmeopkaldsposten
- søg efter optegnelser og lav skærmbilleder
- synkroniser Salesforce- og Cisco-køer
- Lad Service Cloud Voice træffe beslutningen om routing
Denne anmodning returnerer altid "køen" eller "agenten" til det sted, hvor opkaldet skal dirigeres.
Efter at have udført denne anmodning, skal du sørge for at sende Ryd routing, hvis den, der ringer op, lægger på, før vedkommende bliver besvaret af en agent. Se Webex Kontaktcenter-begivenhedsflow.
HTTP-anmodningsindstillinger
- Aktivitetsetiket: UdførOmniFlow
- Brug godkendt slutpunkt: Aktiveret
- Stik: Salesforce Connector oprettet i forrige trin
- Anmodningssti:
/services/apexrest/cisco_wxcc_scv/voice/v1/executeOmniFlow - Metode: POST
- Anmodningsindholdstype: Application/JSON
Anmodningstekst
Udover de obligatoriske felter kan du sende yderligere data som inputvariabler til Omni-Flow. Nedenfor er to eksempler på anmodningsteksten. Først uden yderligere flowparametre, kun obligatoriske felter, den anden med to inputvariabler.
Eksempel med Omni-Flow-parametre:
{
"callCenterDevName": "",
"certDevName": "",
"voiceCallId": "{{SCV_VoiceCallRecordId}}",
"dialedNumber": "{{NewPhoneContact.DNIS}}",
"flowDevName": "",
"fallbackQueue": ""
}
Eksempel på opdatering af brugerdefinerede felter i en stemmeopkaldspost:
{
"callCenterDevName": "",
"certDevName": "",
"voiceCallId": "{{SCV_VoiceCallRecordId}}",
"dialedNumber": "{{NewPhoneContact.DNIS}}",
"flowDevName": "",
"fallbackQueue": "",
"flowInputParameters":
{
"param1": "value1",
"param2": "value2"
}
}
Parametre
| Ejendommens navn | Værdi |
|---|---|
| callCenterDevName | Navn på udvikler af kontaktcenter |
| certDevName | API-navn på certifikat (som konfigureret i Kontaktcenter) |
| stemmeopkalds-ID | ID for taleopkaldsposten, oprettet i forrige trin: {{SCV_VoiceCallRecordId}} |
| opkaldt nummer | CalledNumber/DNIS: {{NewPhoneContact.DNIS}} |
| flowDevName | Udviklernavn på den Omni-Flow, der skal udføres |
| reservekø | Kø-ID eller kø-API-navn på den alternative Salesforce-kø |
| flowInputParametre |
Yderligere input til Omni-Channel-flowet (nøgle-værdi-par). Eksempel: |
Parse-indstillinger
Kø
- Indholdstype: JSON
- Outputvariabel: SCV_OmniFlowQueue
- Stiudtryk:
$.data.queue
"Kø", der returneres fra Execute Omni-Flow, kan bruges til routing.
Agent- Indholdstype: JSON
- Outputvariabel: SCV_OmniFlowAgent
- Stiudtryk:
$.data.agent
"Agent" returneret fra Execute Omni-Flow, kan bruges til routing.
Evaluer HTTP-svar for at udføre Omni-flow
Kontroller HTTP-status for Execute Omni Flow http-anmodningen:
- Etiket: statusKodeUdførOmniFlow
- Variabel: UdførOmniFlow.httpStatusCode
Hvis statuskode == 200 => succesfuld ellers => anmodning mislykkedes, fejlhåndtering.
Fejlhåndtering for Execute Omni Flow
Til demonstration / kun fejlfinding, afspil besked afhængigt af http-statuskode.
Hvis Execute Omni Flow lykkedes, er variablerne SCV_OmniFlowQueue og SCV_OmniFlowAgent ikke angivet. Routingbeslutning i opkaldsflow.
Fortsæt med opkaldsrouting
Fortsæt i opkaldsflowet, og videresend opkaldet til agenten. Brug valgfrit SCV_OmniFlowQueue og SCV_OmniFlowAgent til at vælge kø og agent.
Webex Kontaktcenter-begivenhedsflow
Hvis den, der ringer op, lægger på, før en agent besvarer det, skal vi opdatere Service Cloud Voice og afslutte opkaldet.
- Hvis Execute Omni-Flow blev brugt, send Clear Routing for at slette den ventende servicerouting (PSR)
- Send opdatering af taleopkald for at opdatere start- og sluttidspunkterne på taleopkaldsposten og ændre status fra Ny til Færdig

- PhoneContactEnded – Denne hændelse udløses, når et liveopkald afbrydes, og alle deltagere fjernes.
- HTTP-anmodning: Ryd ruteplanlægning
- HTTP-anmodning: Opdater taleopkald
HTTP-anmodning: Ryd ruteplanlægning
- Etiket: Ryd ruteplanlægning
- Brug godkendt slutpunkt: Aktiveret
- Stik: Salesforce Connector oprettet i forrige trin
- Anmodningssti:
/services/apexrest/cisco_wxcc_scv/voice/v1/clearRouting - Metode: POST
Anmodningsindholdstype: Application/JSON
Anmodningstekst
{
"callCenterDevName": "",
"certDevName": "",
"voiceCallId": "{{SCV_VoiceCallRecordId}}"
}
Parametre
| Ejendommens navn | Værdi |
|---|---|
| callCenterDevName | Navn på udvikler af kontaktcenter |
| certDevName | API-navn på certifikat (som konfigureret i Kontaktcenter) |
| stemmeopkalds-ID | ID for taleopkaldsposten, oprettet i forrige trin: SCV_VoiceCallRecordId |
Parse-indstillinger
Ingen.
HTTP-anmodning: Opdater taleopkald
- Etiket: Opdater taleopkald
- Brug godkendt slutpunkt: Aktiveret
- Stik: Salesforce Connector oprettet i forrige trin
- Anmodningssti:
/services/apexrest/cisco_wxcc_scv/voice/v1/updateVoiceCall - Metode: POST
- Anmodningsindholdstype: Application/JSON
Anmodningstekst
{
"callCenterDevName": "",
"certDevName": "",
"voiceCallId": "{{SCV_VoiceCallRecordId}}",
"startTime": "{{SCV_CallStartTime}}",
"endTime": "{{now() | replace({'[UTC]': ''})}}",
"disconnectReason": { "value": "Abandoned in queue", "isError": true }
}
Parametre
| Ejendommens navn | Værdi |
|---|---|
| callCenterDevName | Navn på udvikler af kontaktcenter |
| certDevName | API-navn på certifikat (som konfigureret i Kontaktcenter) |
| stemmeopkalds-ID | ID for taleopkaldsposten, oprettet i forrige trin: SCV_VoiceCallRecordId |
| startTime | UTC-tidsstempel for opkaldsstart {{SCV_CallStartTime}} (som brugt til at oprette stemmeopkaldsposten) |
| endTime | Aktuel UTC-tidsstempel `{{now() |
| afbrydelseÅrsag | Årsag til afbrydelse af opkaldet. Egenskaben isError skal indstilles til true for at den vises korrekt. |
Parse-indstillinger
Ingen.
Referencer
- Opret en privat nøgle og et selvsigneret digitalt certifikat
- Konfigurer tilsluttet app til Webex Contact Center Salesforce Connector
- Opsæt integrationsforbindelser til Webex kontaktcenter - Salesforce
- Cisco Webex Kontaktcenter Opsætnings- og administrationsvejledning > Flowdesigner
- Telefoniintegration REST API
Sprogoversættelse
(Valgfrit) Aktivér Translation Workbench
Denne indstilling gælder kun, hvis du bruger indstillinger for oversættelsessprog.
| 1 |
Gå til Opsætning → Oversættelsesarbejdsbænk → Indstillinger for oversættelsessprog. |
| 2 |
Klik på Aktiver for at vælge oversættelsessprog. |
(Valgfrit) Aktivér kun platformsprog
Denne indstilling gælder kun for andre sprog end EN-US.
| 1 |
Gå til Opsætning → Firmaindstillinger → Sprogindstillinger. |
| 2 |
Vælg de ønskede sprog. |
| 3 |
Markér følgende afkrydsningsfelter:
|
| 4 |
Gem dine ændringer. |
Aktivér sproget og vælg brugeren (opgaven)
| 1 |
Gå til Opsætning → Oversættelsesarbejdsbænk → Indstillinger for oversættelsessprog. |
| 2 |
Vælg sproget, og vælg den bruger, der skal oversætte det. |
| 3 |
Gem dine ændringer. |
Flersprogede indstillinger
Oversæt brugerdefinerede etiketter
| 1 |
Gå til Opsætning → Brugerdefinerede etiketter. |
| 2 |
Vælg navnet på den brugerdefinerede etiket, der skal åbnes.
|
| 3 |
I den relaterede liste over oversættelser skal du klikke på |
| 4 |
Vælg det sprog, du oversætter til. |
| 5 |
Indtast den oversatte værdi i feltet Oversættelsestekst. Denne tekst tilsidesætter den værdi, der er angivet i etikettens Værdi-felt, når en brugers standardsprog er oversættelsessproget. |
| 6 |
Gem dine ændringer. |
Salesforce-tilladelser kræves af brugerfunktionen
Webex Contact Center SCV-agenttilladelsessættet indeholder alle de tilladelser, der kræves for at arbejde med Webex Contact Center-gadgeten og de integrationer, der er udviklet til agenter.
Apex-klasseadgang (afsnit)
- cisco_wxcc_scv.CiscoScvWxcc
- cisco_wxcc_scv.ServiceResponseHandler
- cisco_wxcc_scv.ServiceRouting
- cisco_wxcc_scv.TelephonyIntegrationHandler
Adgang til brugerdefinerede metadatatyper (afsnit)
- cisco_wxcc_scv.WxCC-forbindelse
Visualforce-sideadgang (afsnit)
- cisco_wxcc_scv.CiscoScvLoginWxCC
- cisco_wxcc_scv.CiscoScvMainWxCC
- cisco_wxcc_scv.CiscoScvOAuthRedirect
- cisco_wxcc_scv.CiscoScvSwLoader
Service Cloud Voice API-indpakning
Forudsætninger
For at kunne bruge Service Cloud Voice API Wrapper skal en Salesforce ekstern klientapp til IVR-integration konfigureres.
Brug Service Cloud Voice API-wrapperen
Service Cloud Voice (SCV) til Salesforce bruger Telephony Integration REST API til at oprette og opdatere VoiceCalls, udføre Omni-Channel-flows og slette PendingServiceRouting-poster, der er knyttet til et VoiceCall. Denne tjeneste kræver JWT-godkendelse og brug af PATCH HTTP-metoden, som i øjeblikket ikke understøttes af Cisco IP Interactive Voice Response (IVR).
For at forenkle brugen af telefoniintegrations-REST API'en til SCV i (ikke kun) et IVR-system er der blevet gjort et nyt sæt API'er tilgængelige, som omslutter den eksisterende Salesforce API og er tilgængelige direkte fra den Salesforce-organisation, hvor Webex Contact Center for Service Cloud Voice-pakken er installeret.
Service Cloud Voice API Wrapperfjerner behovet for at godkende et JWT-token, implementerer yderligere kontroller af de data, der kræves af Salesforce API'en, og forbedrer responsobjekterne.
Hent Access_-tokenet
Udfør en POST anmodning til https://<your-domain-name>.my.salesforce.com/services/oauth2/token
Sender følgende parametre i kroppen:
{
"grant_type": "client_credentials",
"client_id": "",
"client_secret": ""
}
If the request is successful, the following JSON response will be returned:
{
"access_token": "",
"instance_url": "",
"id": "https://login.salesforce.com/id//",
"token_type": "Bearer",
"issued_at": "",
"signature": ""
}
Udfør anmodningerne
Instans-URL'en skal indeholde my.salesforce.com.
Eksempel på en korrekt instans-URL: https://abc-123.my.salesforce.com
Brug af et andet domæne som instans-URL (f.eks. https://abc-123.lightning.force.com ) resulterer i en 401 Uautoriseret status med en INVALID_SESSION_ID-fejlkode returneret.
Opret taleopkald (afsnit)
Opretter en VoiceCall-post, der indeholder deltagerne (dvs. den, der ringer op, og modtageren) til VoiceCall-posten. Når du opretter en VoiceCall-post, oprettes der en samtale i Salesforce. Brug kun denne API i realtidskontekst, hvilket betyder, at du kun bør kalde denne API, når et kald initieres. Denne API kan også bruges til at oprette VoiceCall-poster til overførsel og telefonmøder ved at inkludere parentVoiceCallId-parameteren i anmodningsdataene.
Slutpunkts-URI
<instance_url>/services/apexrest/cisco_wxcc_scv/voice/v1/createVoiceCall
HTTP-metode
POST
Overskrifter
Bemyndigelse: Bærer <access_token>
Indholdstype: application/json
Parametre
{
"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"
}
Svar (vellykket)
{
"data": {
"voiceCallId": "00X000012345abc"
},
"errors": null,
"success": true
}
Svar (med fejl)
{
"data": null,
"errors": ["Error message 1", "Error message 2"],
"success": false
} Opdater taleopkald
Opdaterer VoiceCall, når opkaldet er afsluttet. Brug denne API til at opdatere opkaldsrelaterede parametre, der ikke er tilgængelige under oprettelsen af VoiceCall. Opdateringen af VoiceCall API'en er en asynkron operation. Du kan ikke forespørge om status for API-kaldet.
Dette slutpunkt kan også bruges til at oprette et VoiceCall, selv efter opkaldet er afsluttet. Denne funktionsmåde er nyttig i scenarier, hvor du vil logge en post i Salesforce for afbrudte eller mistede opkald, eller i ethvert andet scenarie, hvor et VoiceCall ikke allerede er oprettet.
Slutpunkts-URI
<instance_url>/services/apexrest/cisco_wxcc_scv/voice/v1/updateVoiceCall
HTTP-metode
POST
Overskrifter
Bemyndigelse: Bærer <access_token>
Indholdstype: application/json
Parametre
{
"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
}
} En detaljeret beskrivelse af de parametre, der accepteres af denne anmodning, kan findes i Salesforces officielle dokumentation under afsnittet "Parametre".
Svar (vellykket)
{
"data": {
"status": "pending"
},
"errors": null,
"success": true
} Opdateringen af VoiceCall API'en er en asynkron operation. Du kan ikke forespørge om status for API-kaldet.
Svar (med fejl)
{
"data": null,
"errors": ["Error message 1", "Error message 2"],
"success": false
} Udfør Omni-flow
Udfører Omni-Channel-flowet for at dirigere opkald. Den sender opkalds-ID'et (Salesforce VoiceCallId eller telefonileverandørens ContactId) som parametre til flowet og returnerer agent- eller køroutinginstruktionerne til kontaktflowet. Som standard bruger Service Cloud Voice det Omni-Channel-flow (eller den alternative kø), der er angivet for den telefonkanal, der matcher det opkaldte nummer. Hvis det opkaldte nummer ikke matcher en eksisterende telefonkanal, kan du eventuelt angive et nyt opkaldt nummer, et Omni-Channel-flow og en fallback-kø som inputparametre til dette API-kald.
Service Cloud Voice bruger denne prioritetsrækkefølge til at dirigere opkald:
- Bruger indstillingerne Omni-Channel Flow og Fallback Queue for den telefonkanal, der matcher det opkaldte nummer. Flyden har forrang. Hvis flowet fejler, bruges fallback-køen.
- Bruger parametrene flowDevName og fallbackQueue, der er angivet i Execute Omniflow API-kaldet.
Slutpunkts-URI
<instance_url>/services/apexrest/cisco_wxcc_scv/voice/v1/executeOmniFlow
HTTP-metode
POST
Overskrifter
Bemyndigelse: Bærer <access_token>
Indholdstype: application/json
Parametre
{
"callCenterDevName": "contactCenterDevName123",
"certDevName": "certDevName123",
"voiceCallId": "00X000012345abc",
"dialedNumber": "+18445791189",
"flowDevName": "Route_VoiceCall",
"fallbackQueue": "00G111222333444",
"flowInputParameters":
{
"Input1": "one",
"Input2": "two"
}
}
- Parameteren voiceCallId er Salesforce voiceCallId eller telefonileverandørens kontakt-id.
- En detaljeret beskrivelse af de parametre, der accepteres af denne anmodning, kan findes i Salesforces officielle dokumentation under afsnittet "Parametre".
Svar (vellykket)
{
"data": {
"queue": "queue info",
"agent": "agent info"
},
"errors": null,
"success": true
} AGENT_INFO og QUEUE_INFO svarer til feltet ExternalId i CallCenterRoutingMap
Svar (med fejl)
{
"data": null,
"errors": ["Error message 1", "Error message 2"],
"success": false
} Ryd ruteplanlægning
Sletter PendingServiceRouting (PSR)-posten for et taleopkald. Denne API behøver ikke at blive kaldt i de fleste scenarier; PSR-posten slettes automatisk, når kaldet ikke længere bliver dirigeret. Der er dog nogle scenarier, f.eks. ved mistede eller afbrudte opkald, når du bruger partnertelefonisystemer, hvor du eksplicit skal kalde denne API for at rydde PSR-posten.
Slutpunkts-URI
<instance_url>/services/apexrest/cisco_wxcc_scv/voice/v1/clearRouting
HTTP-metode
POST
Overskrifter
Bemyndigelse: Bærer <access_token>
Indholdstype: application/json
Parametre
{
"callCenterDevName": "contactCenterDevName123",
"certDevName": "certDevName123",
"voiceCallId": "00X000012345abc"
}
- Parameteren voiceCallId er Salesforce voiceCallId eller telefonileverandørens kontakt-id.
- En detaljeret beskrivelse af de parametre, der accepteres af denne anmodning, kan findes i Salesforces officielle dokumentation under afsnittet "Parametre".
Svar (vellykket)
{
"data": {
"status": "Success"
},
"errors": null,
"success": true
} Svar (med fejl)
{
"data": null,
"errors": ["Error message 1", "Error message 2"],
"success": false
} Oversættelser af telefonnumre
Forskellig interaktion mellem Service Cloud Voice og Webex Contact Center afhænger af oversættelser af telefonnumre. På grund af internationale forskelle og kundespecifikke anvendelser er der behov for et brugerdefineret værktøj til at overføre telefonnumre fra format A til format B.
Webex Contact Center for Service Cloud Voice-løsningen fjerner automatisk alle tegn undtagen tal og hashtags (#), stjerner (*), kommaer (,) og foranstillede plustegn (+). Den fjerner også den første forekomst af (0). Dette vil blive gjort FØR dine telefonnummeroversættelser anvendes.
Denne vejledning beskriver, hvordan man konfigurerer oversættelser af telefonnumre.
Felter
Oversættelser af telefonnumre gemmes i navn-værdi-felterne. Dette giver dig mulighed for at konfigurere et ubegrænset antal regler pr. funktion.
Konfigurationen gemmes som en JSON-streng.
Bemærk at omvendte skråstreger skal escapes, f.eks. \d+ bliver \\d+.
{"Remove all characters but digits":"[1,17]->[^\\d]+","To internal number":"[7,17]->(\\d{7})(\\d{4})->$2"}
Feltet Navn bruges teknisk set ikke. Den er der for at tilføje en menneskelig læsbar streng for hurtigt at identificere formålet med denne regel. Gode navne er for eksempel: Fjern alle foranstillede nuller, Tilføj foranstillede plustegn osv.
Oprettelse af oversættelsesregler
Regler leveres som regulære udtryk. For at være mere præcis: JavaScript-implementeringen af regulære udtryk.
En god måde at starte på er ved at læse RegExp-dokumentet fra MDN-webdokumentationen.
Ikke desto mindre er det ofte besværligt at oprette komplekse regulære udtryk. Derfor har vi tilføjet ekstra syntaks for at gøre konfigurationen så nem som muligt.
Figuren nedenfor viser den generelle syntaks for en regel for oversættelse af telefonnumre:
Prædikat
Prædikatet bruges til at angive et interval, der definerer længden af det tal, der skal matches.
Prædikatet ovenfor angiver, at alle tal med en længde mellem 7 og 11 tegn (inklusive kanter) + mellemrum) matcher.
Prædikater matcher altid den oprindelige længde af tallet. Dette hjælper med at forenkle konfigurationen ved at reducere risikoen for kollision af regler for interne / eksterne numre.
Mønster
Mønsteret angiver formatet på det nummer, der skal matche.
Mønsteret ovenfor angiver, at tallet kun skal bestå af cifre, og vælger dem.
Vælger
Selektorer definerer det endelige format af tallet. Hvis tegn / Hvis der skal tilføjes cifre, som ikke oprindeligt var til stede, er det her, det skal gøres.
Selektoren er det sidste trin i opbygningen af tallet. Baseret på mønsteroutputtet opbygger vælgeren det nye nummer.
Eksempel 1
Følgende eksempel viser, hvordan man overfører et nummer modtaget fra kontaktcenteret i formatet 0319175200 til det schweiziske E164-format. +41 31 917 52 00.
Dette eksempel bruger to oversættelsesregler (1. og 2.)
Den første regel i dette eksempel ændrer faktisk ikke tallet. For tal mellem 1 og 17 tegn i længden vil alt andet end cifre blive fjernet. Da der ikke er nogen ikke-ciffer til stede, ændrer intet sig.
Den anden regel gælder for tal, der oprindeligt er præcis 10 tegn lange. 0319175200 matcher, og derfor anvendes reglen. Mønsteret angiver, at tallet skal starte med en gruppe på ét ciffer (\d{1}), efterfulgt af en gruppe på to cifre (\d{2}), efterfulgt af en gruppe på tre cifre (\d{3}), og så videre.
Selektoren tilgår derefter mønstergrupperne for at definere den nye talstreng. Det betyder $2 refererer til den første (\d{2}) og indeholder derfor 31.
Eksempel 2
Følgende eksempel viser, hvordan man overfører et nummer modtaget fra kontaktcenteret i formatet +14693150217 til det amerikanske E164-format +1 469 315 0217.
Dette eksempel bruger to oversættelsesregler (1. og 2.)
- Dette nummer er præcis 12 tegn langt, så reglen "Tilføj mellemrum til amerikanske numre" anvendes.
- (\+1) siger, at tallet skal starte med +1. Hvis nummeret er 12 tegn langt, men ikke starter med en +1, Reglen er ophævet, og intet ændres.
- (\d{3}) siger at +1 skal efterfølges af 3 cifre.
- (\d{3}) siger, at de sidste 3 cifre skal efterfølges af yderligere 3 cifre.
- (\d{4}) siger, at de sidste 3 cifre skal efterfølges af 4 cifre.
Hvis noget af dette ikke stemmer overens, vil nummeret ikke blive ændret.
Så alle regler gælder for “+14693150217”. Derfor ændres tallet med “$1 $2 $3 $4”:
- $1 refererer til gruppen (\+1), Nummeret, der skal sendes til Service Cloud Voice, ser sådan ud +1.
- $2 henviser til den første af de to (\d{3}), nummeret, der skal sendes til Service Cloud Voice, ser sådan ud +1 469.
- $3 henviser til den anden af de to (\d{3}), nummeret, der skal sendes til Service Cloud Voice, ser sådan ud +1 469 315.
- $4 refererer til den sidste gruppe (\d{4}), nummeret, der skal sendes til Service Cloud Voice, ser sådan ud +1 469 315 0217.
Mellemrummene i erstatningsdelen af reglen “$1 $2 $3 $4” bruges direkte. Så hvis du bruger “$1-$2-$3-$4” tallet ville blive oversat til: +1-469-315-0217
Og du har også lov til at fjerne grupper: [12, 12]->(\+1)(\d{3})(\d{3})(\d{4})->$2 $3 $4 vil blive oversat til: 469 315 0217. [12, 12]->(\+1)(\d{3})(\d{3})(\d{4})-> $3 $4 vil blive oversat til: 315 0217.
Det er også muligt at konvertere et internationalt amerikansk nummer til et lokalt nummer, f.eks.: [12, 12]->(\+1)(\d{3})(\d{3})(\d{4})->($2) $3-$4.
Så det indgående nummer “+14693150217” vil blive oversat til: (469) 315-0217.
Eksempel 3
Følgende eksempel viser, hvordan man overfører et nummer modtaget fra Kontaktcenteret i formatet +491515555531 til det tyske E164-format +49 151 5555 531.
Dette eksempel bruger to oversættelsesregler (1. og 2.)
- Dette tal er præcis 13 tegn langt, så reglen "Tilføj mellemrum til tyske tal" anvendes.
- (\+49) siger, at tallet skal starte med +49. Hvis nummeret er 13 tegn langt, men ikke starter med en +49, Reglen er ophævet, og intet ændres.
- (\d{3}) siger at +49 skal efterfølges af 3 cifre.
- (\d{4}) siger, at de sidste 3 cifre skal efterfølges af 4 cifre.
- (\d{3}) siger, at de sidste 4 cifre skal efterfølges af 3 cifre.
Hvis noget af dette ikke stemmer overens, vil nummeret ikke blive ændret.
Så alle reglerne gælder for “+491515555531”. Derfor ændres tallet med “$1 $2 $3 $4”:
- $1 refererer til gruppen (\+49), Nummeret, der skal sendes til Service Cloud Voice, ser sådan ud +49.
- $2 refererer til den første af de to (\d{3}), nummeret, der skal sendes til Service Cloud Voice, ser sådan ud +49 151.
- $3 henviser til den anden af de to (\d{4}), nummeret, der skal sendes til Service Cloud Voice, ser sådan ud +49 151 5555.
- $4 refererer til den sidste gruppe (\d{3}), nummeret, der skal sendes til Service Cloud Voice, ser sådan ud +49 151 5555 531.
Det samme gælder for regel et. Du kan bruge reservedelen $1 $2 $3 $4 at vælge, hvad der skal bruges fra tallet.
Flere eksempler på oversættelsesregex
| Beskrivelse | Oversættelsesregex |
|---|---|
| Fjern alle tegn undtagen cifre | [1,17]->[^\d]+ |
| Fjern alle tegn undtagen cifre & + | [1,17]->[^+\d]+ |
| Beskrivelse | Oversættelsesregex |
|---|---|
| Fjerne +1 | [12,12]->(.{1})(\d{1})(\d{10})->$3 |
| Fjerne +1 | [10,12]->(^\+1+)(\d+)->$2 |
| Fjerne +49 | [10,15]->(^\+49+)(\d+)->$2 |
| Fjerne +49 | [10,15]->(.{1})(\d{2})(\d{9})->$3 |
| Fjerne +41 | [10,13]->(^\+41+)(\d+)->$2 |
| Fjerne +41 | [10,13]->(.{1})(\d{2})(\d{9})->$3 |
| Fjerne +XX | [10,14]->(^\++)(\d{2})(\d+)->$3 |
| Beskrivelse | Oversættelsesregex |
|---|---|
| Fjerne + og erstat det med nuller US E164 | [10,12]->(.{1})(\d{1})(\d{10})-> 001 $3 |
| Fjerne +1 og erstat det med nuller US E164 | [10,12]->(^\+1+)(\d+)-> 001$2 |
| Fjerne + og erstat det med nuller DE E164 | [12,15]->(.{1})(\d{2})(\d{10})-> 0049 $3 |
| Fjerne +49 og erstat det med nuller DE E164 | [10,12]->(^\+49+)(\d+)-> 0049$2 |
| Fjerne + og erstat det med nuller CH E164 | [10,13]->(.{1})(\d{2})(\d{9})-> 0041 $3 |
| Fjerne +41 og erstat det med nuller CH E164 | [10,12]->(^\+41+)(\d+)-> 0041$2 |
| Beskrivelse | Oversættelsesregex |
|---|---|
| Amerikansk nummer med mellemrum | [12,17]->(\d{1})(\d{3})(\d{3})(\d{4})->+1 $2 $3 $4 |
| Amerikansk nummer med mellemrum | [12,17]->(\+1)(\d{3})(\d{3})(\d{4})->$1 $2 $3 $4 |
| DE-nummer med mellemrum | [12,17]->(\d{2})(\d{3})(\d{4})(\d{3})->+49 $2 $3 $4 |
| DE-nummer med mellemrum | [12,17]->(\+49)(\d{3})(\d{4})(\d{3})->$1 $2 $3 $4 |
| CH-nummer med mellemrum | [12,17]->(\d{2})(\d{2})(\d{3})(\d{2})(\d{2})->+41 $2 $3 $4 |
| CH-nummer med mellemrum | [12,17]->(\+41)(\d{2})(\d{3})(\d{2})(\d{2})->$1 $2 $3 $4 |
Konfiguration af VoiceCall-side
Konfigurer VoiceCall-optagelsessiden
VoiceCall-optagelsessiden er som standard forudkonfigureret med et layout med 3 kolonner og følgende komponenter:
- Handlinger & anbefalinger
- Opkaldsnoter
- Opkaldsdetaljer
- Optagelser
Komponenter kan frit fjernes eller tilføjes til siden, afhængigt af forretningsbehov. Forskellige sidelayouts kan også bruges, men nogle komponenter, såsom opkaldsoptagelsesafspilleren og samtaleteksten, kan kun passe på mellemstore og store områder af skabelonen.
Vis komponenten Afslutningsårsag
Komponenten Afslutningsårsag skal vises under opkaldet og under Afslutning.
Tilføj Cisco WrapUp Reason-komponenten til VoiceCall-postsiden:
- Træk webkomponenten Cisco Wrap-Up Reason Lightning fra området Brugerdefineret på listen over Lightning-komponenter til siden VoiceCall-post.
- Klik på Gem.
- Klik på Aktivér.
- Klik på Tildel som organisationsstandard.
- Klik på Gem.
- Klik på Gem igen, og klik derefter på Tilbagepil for at vende tilbage til siden.
Komponenten Cisco Wrap-Up Reason vises automatisk under opkaldet og under WrapUp:
Hvis komponenten Cisco Wrap-Up Reason tilføjes til siden, vises den for hvert opkald, også hvis der ikke er konfigureret en Wrap-Up i Cisco Contact Center.
Vis afspilleren til opkaldsoptagelse
Opkaldsoptagelsesafspilleren vises, hvis der er gemt et optagelseslink til det tilsvarende taleopkald.
Følg disse trin for at tilføje komponenten Opkaldsoptagelsesafspiller til siden VoiceCall-optagelse:
- Træk Lightning-webkomponenten til opkaldsoptagelsesafspilleren til siden VoiceCall-optagelse
- Klik påGem.
- Klik påAktivér.
- Klik påTildel som organisationsstandard.
- Klik påGem.
- Klik påGemigen, og klik derefter på Tilbage-pilen for at vende tilbage til siden.
Webex-administratorer
Flowkonfiguration
Pop op-skærm
En "Screen popup"-node er tilgængelig i Webex Contact Center-flowet. Den kan bruges til at udløse et pop-up-skærmbillede i Service Cloud Voice eller i et separat vindue.
Yderligere information om denne funktion kan findes i Flow Designer-dokumentationen .
Skærm pop op i et separat vindue
For at åbne skærmpopup'en i et separat vindue skal en absolut URL angives i noden "Screen Pop". queryParameters vil blive tilføjet som søgeparametre til URL'en.
Følgende tilstande understøttes:
- Ny browserfane - Åbner altid en ny browserfane.
- Eksisterende browserfane - På det første skærmbillede, der vises med Eksisterende browserfane, åbnes en ny browserfane. Den fane vil være den dedikerede fane til efterfølgende skærmbilleder af eksisterende browserfaner, og URL'en vil blive opdateret i den specifikke browserfane.
- Inde i skrivebordet - Håndteres på samme måde som Ny browserfane.
Den aktuelt åbne side kan forhindre en omdirigering. I så fald åbnes et pop-up-skærmbillede af typen Eksisterende browserfane i en ny browserfane.





