- Hjem
- /
- Artikkel
Webex Contact Center for Salesforce Service Cloud Voice integrerer Ciscos robuste CCaaS (Contact Center as a Service) med Salesforces CRM, slik at bedrifter kan administrere omnikanal kundeinteraksjoner (tale, digital) i Salesforce-grensesnittet ved hjelp av Webex AI for virtuelle agenter, transkripsjon og intelligent ruting, og transformere agenter til "superagenter" med enhetlige data for bedre kundeopplevelser.
Oversikt
Webex kontaktsenter for Salesforce Service Cloud Voice
Webex Contact Center for Service Cloud Voice er en ferdig integrasjonsløsning som bringer kraften til Webex Contact Center inn i Salesforce Service Cloud Voice Omni-kanal agentkonsoll.
Før du fortsetter med installasjonen, se følgende avsnitt:
for å lære om forutsetninger og begrensninger for Salesforce Service Cloud Voice og sørge for at Salesforce-organisasjonen din er klar til å aktivere og installere Webex Contact Center for Service Cloud Voice -pakken.
Forutsetninger og begrensninger
Forutsetninger (underemne)
Brukergrensesnitt: Service Cloud Voice er bare tilgjengelig i Salesforce Lightning Experience.
Service Cloud Voice er tilgjengelig i disse utgavene.
- Bedrift
- Ubegrenset
- Utvikler
Lisenser
-
Kunder må kjøpe den nye tilleggslisensen for A-SF-VOICE per pålogget agent i tillegg til Flex 3 Standard- eller Premium-lisensene for Webex Contact Center. For mer informasjon, se bestillingsveiledningen for Flex 3.
- Salesforce Voice for partnertelefoni
Før du aktiverer Voice, må du konfigurere de nødvendige tjenestene i organisasjonen din.
- Naviger til Firmainformasjon > Tillatelsessettlisens
- Se etter Service Cloud Voice-bruker (partnertelefoni).
Alle utviklerutgaver leveres nå med 5 partnertelefonilisenser tilgjengelig for testing.
- Se etter Service Cloud Voice-bruker (partnertelefoni).
- Alternativt kan du bekrefte dette ved å gå til Salesforce-oppsett og søke etter «stemme» i venstre sidefelt.
- Hvis «Partnertelefonikontaktsentre» vises, har du SCV-lisensen.
- Hvis alternativet «Partnertelefoni-kontaktsentre» ikke er synlig, så «Aktiver Service Cloud Voice» ved å følge trinnene nedenfor.
- Gå til Salesforce-oppsett, søk og velg «Partnertelefonioppsett» og sett knappen til «Aktiver Service Cloud Voice».
- Aktiver Omnikanal slik at agentene dine kan ringe og motta anrop.
- Gå til Salesforce-oppsett, søk og velg «Partnertelefonioppsett» og sett knappen til «Aktiver Service Cloud Voice».
Aktiver Omnikanal
Hvis Omnikanal allerede er aktivert i organisasjonen din, hopper du over dette trinnet.
- Fra Oppsett skriver du inn Omnikanal-innstillinger i Hurtigsøk-feltet, og deretter velger du Omnikanal-innstillinger.


- Velg Aktiver Omnikanal.
- Klikk på Lagre.
Begrensninger
- Tale er bare tilgjengelig i Lightning Experience.
- Voice støttes på Service Cloud og Sales Cloud som en tilleggslisens.
- Voice støttes ikke på Salesforce Mobile eller på iPad Safari.
- Tale støttes bare i nettleserne Google Chrome, Microsoft Edge (Chromium) og Mozilla Firefox. Informasjonskapsler må være aktivert for å tillate enkel pålogging (SSO).
- Standardnavigasjon støttes ikke.
- Telefoni er strengt regulert, så sjekk med Salesforce-representanten din om tilgjengeligheten av Voice i din region.
Krav
Inaktive koder
Finn tomgangskoder
| 1 |
Logg inn på administrasjonsportalen. |
| 2 |
Naviger til Kontaktsenter > DESKTOP-OPPLEVELSE > Idle/Wrap-up Koder. |
| 3 |
Sørg for at inaktivkodene vises, ellers klikker du på rullegardinknappen for filter og velger Inaktivkode øverst på siden. |
| 4 |
Klikk på en inaktiv kode for å åpne detaljvisningen. Der finner du Idle-kode-ID-en.
ID-ene kan kopieres og deretter brukes til konfigurasjonen Tilordning av tilstedeværelsestilstand. En av ID-ene må brukes som Standard Cisco Ikke Klar Årsak. |
Integrere
Installasjon
Før du fortsetter med installasjonen, se delen Forutsetninger og begrensninger for å lære om forutsetninger og begrensninger for Salesforce Service Cloud.
Installer og konfigurer Webex kontaktsenter for Service Cloud Voice
Når en Service Cloud Voice for Partner Telephony -lisens er anskaffet, vises siden Partner Telephony Setup i Oppsett-menyen.
Mer informasjon finner du i Salesforces offisielle referanse ( direkte lenke).
| 1 |
Fra Oppsett skriver du inn |
| 2 |
Aktiver Slå på tale med partnertelefoni. Siden Partnertelefonikontaktsentre vises i Oppsett -menyen. Hvis du planlegger å distribuere pakken i en Salesforce-sandkasse, må du erstatte |
Installer pakken
For å installere pakken:
| 1 |
Åpne den medfølgende lenken til pakken for å starte installasjonen. |
| 2 |
Logg inn på Salesforce-organisasjonen der pakken skal installeres. |
| 3 |
I installasjonsveiviseren velger du sikkerhetsalternativet "Installer kun for administratorer" (1) og klikker på Installer (2). Bestem hvilke brukere som får bestemte tillatelser til objektene og komponentene som følger med Webex Contact Center for Service Cloud Voice-pakken. I tillegg, gi dem disse tillatelsene. Tillatelsessettene som følger med Webex Contact Center for Service Cloud Voice-pakken hjelper denne prosessen. Veiviser for pakkeinstallasjon – Velkomstskjermen vises: |
| 4 |
Gi følgende tillatelsessett til minst én bruker, slik at du kan opprette kontaktsenteret: |
| 5 |
Klikk på Oppsett | Brukere | Brukere. |
| 6 |
Søk og velg en bruker. |
| 7 |
Bla ned til «Tildeling av tillatelsessett». |
| 8 |
Klikk på Rediger oppgaver |
| 9 |
For Kontaktsenteradministratorer: tilordne tillatelsessettet Kontaktsenteradministrator (partnertelefoni).
|
| 10 |
For Kontaktsenteragenter: Tildel tillatelsessettet Kontaktsenteragent (partnertelefoni) og tillatelsessettet for Webex kontaktsenter SCV-agent.
Det anbefales ikke å velge alternativet Installer for alle brukere, da dette gir alle tillatelser (lese, opprette, redigere og slette) på pakkekomponentene og objektene til alle brukere som bruker en tilpasset brukerprofil. |
| 11 |
Tildel en pakkelisens for brukere slik at de kan jobbe med Connects for Service Cloud Voice.
|
| 12 |
Alternativt kan du klikke på Oppsett | Brukere | Brukere.. |
| 13 |
Søk og velg bruker. |
| 14 |
Bla ned til Administrerte pakker. |
| 15 |
Klikk på Tildel lisenser. |
| 16 |
Velg Webex Contact Center for Service Cloud Voice-pakken fra listen. |
| 17 |
Klikk på Legg til. |
| 18 |
Opprett Tilstedeværelsesstatuser for å definere hvilke tjenestekanaler som er tilordnet forskjellige statuser. Agenter kan logge på Omnikanal med forskjellige statuser avhengig av hva slags arbeid de har rett til å motta. |
| 19 |
Fra Oppsett skriver du inn |
| 20 |
Klikk på Ny. Opprett minst én status for «Pålogget» og én for «Opptatt».
|
Tilordne tilstedeværelsesstatus(er) til agenter
| 1 |
Skriv inn Tillatelsessett i Hurtigsøk-feltet i Oppsett, og velg deretter Tillatelsessett. |
| 2 |
Klikk for å åpne Tillatelsessett for partnertelefoni. |
| 3 |
Klikk på Tilgang til statuser for tjenestetilstedeværelse. |
| 4 |
Klikk på Rediger. |
| 5 |
I listen Tilgjengelige tjenestetilstedeværelser velger du tilstedeværelsesstatusen(e) som ble opprettet tidligere, og klikker på Legg til for å knytte dem til tillatelsessettet. Agenter som er tildelt dette tillatelsessettet, kan logge på Omni-Channel med hvilken som helst av tilstedeværelsesstatusene som er tilgjengelige for dem. |
| 6 |
Klikk på Lagre. |
| 7 |
Klikk på Administrer oppgaver på samme side. Klikk deretter på Legg til tildeling øverst til høyre, velg ønsket bruker, klikk på Neste, velg et Utløpsalternativ for de tilordnede brukerne (valgfritt) og klikk deretter på Tildel. Service Cloud Voice bruker et eksternt domene til å operere med VoiceCall-oppføringen. Følgende URL-er må legges til i «Innstillinger for eksternt nettsted» i oppsettet ( klikk her for å åpne den offisielle dokumentasjonen):
Eksempel: Slik finner du URL-en til en instans. |
| 8 |
Se på URL-en i adressefeltet i nettleseren din etter at du har logget inn. Instans-URL-en er delen før «.my.salesforce.com» eller «.salesforce.com» eller «lightning.force.com». Hvis for eksempel URL-adressen din er https://orgfarm-54a38e30ad-dev-ed.develop.my.salesforce-setup.com/,, er «orgfarm-54a38e30ad-dev-ed.develop» URL-adressen til forekomsten din. Eksempel: URL for opprinnelsesorganisasjon: https://cisco.lightning.force.com Eksempel: URL som skal legges til:
|
| 9 |
Omnikanal-verktøyet kreves i Lightning Service Console-appen for at agenten skal kunne bruke Service Cloud Voice.
Den offisielle referansen fra Salesforce finner du ved å klikke på knappen La oss gjøre dette som åpner siden Konfigurer agentopplevelsen for Service Cloud Voice med partnertelefoni i Salesforce hjelpeportal ( direkte lenke). |
| 10 |
Fra Oppsett skriver du inn Oppsett av partnertelefoni i Hurtigsøk-feltet, og deretter velger du Oppsett av partnertelefoni. |
| 11 |
Bla ned til seksjon 5 Flere stemmeinnstillinger. |
| 12 |
For å aktivere clickjack-beskyttelse for Visualforce-sider med overskrifter deaktivert mens du arbeider med softphone-en i Lightning Experience, må du legge til domenene som softphone-en og de tilpassede verktøylinjene lastes inn fra som klarerte domener, i tillegg til URL-adressen til Salesforce-forekomsten. Disse innstillingene og listen over klarerte domener finner du under Oppsett | Sikkerhet | Øktinnstillinger. For å hente riktig Visualforce-domene, naviger til Oppsett | Tilpasset kode | Visualforce-sider og klikk på Forhåndsvisningsknappen for Eksempel: MyDomainName--cisco_wxcc_scv.vf.force.com For å hente domenet for Salesforce-instansen, kopier URL-en som vises i nettleserens URL-linje og legg den til i listen Liste over klarerte domener for innebygde rammer ved å velge Visualforce-sider som IFrame-type. Eksempel: MyDomainName.lightning.force.com Hvis du ikke har et Mitt domene distribuert i organisasjonen din, er URL-formatet ditt annerledes. Hvis du har distribuert et Mitt domene og forbedrede domener ikke er aktivert i organisasjonen din, er URL-formatet ditt annerledes. Hvis forbedrede domener ikke er aktivert, påvirker også innstillingen Stabiliser URL-er i Visualforce, Experience Builder, Site.com Studio og innholdsfiler Mitt domene dette formatet. Hvis du vil ha mer informasjon, kan du se URL-formater for mitt domene i Salesforce-hjelpen. Innstillinger for Clickjack-beskyttelse og klarerte domener for Lightning Experience |
| 13 |
For å kunne vise opptakskontrollene under samtaler, trenger agenter apptillatelsen For å tilordne den, legg den til i tillatelsessettet som ble opprettet i trinnet Tilstedeværelsesstatuser.
|
Konfigurasjon
Kontaktsenter
En definisjonsfil for kontaktsenter spesifiserer et sett med felt og verdier som brukes til å definere et kontaktsenter i Salesforce for et bestemt CTI-system. Salesforce bruker definisjonsfiler for kontaktsenter for å støtte integrasjonen med flere CTI-systemleverandører.
Du finner mer informasjon i Salesforces offisielle dokumentasjon ( direkte lenke).
Importer kontaktsenteret
Last ned den nyeste versjonen av kontaktsenteret her.
Oppgradering fra Beta: Denne veiledningen beskriver en ren installasjon av General Availability (GA)-utgivelsen av Webex Contact Center-integrasjonen for Salesforce Service Cloud Voice.
Hvis du oppgraderer fra en betaversjon av integrasjonen, må du ikke bruke en eksisterende Partner Contact Center-oppføring på nytt. I stedet:
- Importer XML-filen for Partner Contact Center som følger med GA-utgivelsen.
- Opprett en ny Partner Contact Center-oppføring ved hjelp av den importerte XML-filen.
- Oppdater konfigurasjonen din for å bruke det nyopprettede partnerkontaktsenteret.
XML-filen for GA Partner Contact Center inneholder oppdaterte konfigurasjonsverdier, inkludert riktig koblings-URL og andre metadata. Gjenbruk av en Partner Contact Center-oppføring som er opprettet fra Beta XML kan beholde utdaterte konfigurasjonsverdier og forhindre at integrasjonen fungerer som den skal.
| 1 |
I Oppsett skriver du inn Partnertelefonikontaktsentre i Hurtigsøk -boksen, og deretter velger du Partnertelefonikontaktsentre. Listen over eksisterende (hvis noen) kontaktsentre vises.
|
| 2 |
Klikk på Opprett kontaktsenter på høyre side av siden. |
| 3 |
Velg Webex kontaktsenter som telefonleverandør. Klikk deretter på Neste. En filutforsker åpnes.
|
| 4 |
Velg |
| 5 |
Klikk på Åpne. Filen importeres.
|
| 6 |
Sjekk om kontaktsenteret ditt vises i listevisningen for kontaktsentre. |
Konfigurer kontaktsenteret
| 1 |
I Oppsett skriver du inn Partnertelefonikontaktsentre i Hurtigsøk -boksen, og deretter velger du Partnertelefonikontaktsentre. | ||||||||||||||||||||||||||||||
| 2 |
Klikk på kontaktsenteret som ble importert tidligere. | ||||||||||||||||||||||||||||||
| 3 |
Klikk på Rediger.
| ||||||||||||||||||||||||||||||
| 4 |
Nederst på siden Kontaktsenter klikker du på knappen Legg til under seksjonen Kontaktsenterbrukere. | ||||||||||||||||||||||||||||||
| 5 |
Klikk + ved siden av brukerne som har tilgang til det åpne kontaktsenteret. Bare brukere som har tillatelsen |
Tilpass
Ekstern klientapp for Webex kontaktsenterintegrasjon
Konfigurer den eksterne klientappen for Webex Contact Center Salesforce Connector
For å bruke Service Cloud Voice fullt ut, kan samtaleflyten i Contact Center tilpasses for å opprette taleanropsoppføringen og utføre en Salesforce Omni-Channel-flyt mens samtalen er på IVR-en.
Opprett sertifikat
Sørg for at du allerede har opprettet et digitalt sertifikat i henhold til organisasjonens sikkerhetspolicy.
For å generere et digitalt sertifikat, se Salesforce-dokumentasjonen 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 => Sertifikat for Salesforce External Client-appen
server.nøkkel => Privat nøkkel for Salesforce Connector i Webex Control Hub
Tillatelsessett for SCV-integrasjonsbrukeren
Følgende tillatelsessett gir tilgang til Apex-klasser som brukes av Connects for SCV for integrering med Contact Center IVR-flyter og Webex Contact Center for Salesforce for SCV.
Følgende er et eksempel på konfigurasjon og beskriver minimumskravene til tillatelser for kontaktsenteret. / IVR-integrasjon skal fungere.
- Fra Oppsett, naviger til Brukere | Tillatelsessett.
- Klikk på Ny -knappen.
- Skriv inn en etikett, for eksempel: IVR-tilgang til SCV Apex-klasser
- API-navnet fylles ut automatisk
- Tillatelse: Ingen
- Klikk på Lagre -knappen.
- Det nye tillatelsessettet åpnes.
- Naviger til Apex-klassetilgang.
- Klikk på Rediger -knappen og legg til følgende Apex-klasser:
- cisco_wxcc_scv.ServiceRouting
- Naviger til Systemtillatelser.
- Klikk på Rediger -knappen og aktiver følgende tillatelser:
- Apex REST-tjenester
- API-aktivert
Minimumstilgang – Kun API-integrasjonsprofil
Denne profilen brukes til å integrere med Webex Contact Center for Salesforce for SCV for å opprette taleanropsoppføringer og kjøre Omni-Flow fra IVR-flyten.
Følgende er et eksempel på konfigurasjon og beskriver minimumskravene til tillatelser for kontaktsenteret. / IVR-integrasjon skal fungere.
Dette er en klon fra profilen Minimum Access - API Only Integrations.
- Fra Oppsett, naviger til Brukere | Profiler.
- I Profiler-listen søker du etter Profilen Minimumstilgang – Kun API-integrasjoner.
- Klikk på profilnavnet for å åpne profilen Minimumstilgang - Kun API-integrasjoner.
- På profilen Minimumstilgang - Kun API-integrasjoner klikker du på knappen Klon.
- Skriv inn et nytt profilnavn, for eksempel: SCV-integrasjon.
- Klikk på Lagre -knappen.
- Den nye profilen åpnes.
- Bekreft at alle tillatelser er fjernet fra profilen din for Minimumstilgang – Kun API-integrasjoner.
- Naviger til Systemtillatelser.
- Sørg for at følgende tillatelser er aktivert:
- API-aktivert
- API-kun bruker
SCV-integrasjonsbruker
Følgende er et eksempel på konfigurasjon og beskriver minimumskravene til tillatelser for kontaktsenteret. / IVR-integrasjon skal fungere. Ingen Salesforce Service Cloud Voice-lisens eller Webex Contact Center for Salesforce for SCV-lisens er nødvendig for SCV-integrasjonsbrukeren.
- Fra Oppsett, naviger til Brukere | Brukere.
- Klikk på Ny bruker -knappen.
- Skriv inn fornavn, etternavn og alle andre obligatoriske felt.
- Brukerlisens: Salesforce-integrasjon
- Profil: velg profilen som ble opprettet i forrige trinn («SCV-integrasjonsprofil», klon av Minimum Access - API Only Integrations-profilen)
- Klikk på Lagre -knappen.
- Åpne den nye brukeroppføringen.
- Tildel tillatelsessettetsom ble opprettet tidligere («IVR-tilgang til SCV Apex-klasser»).
- Tildel tillatelsessettlisensen Salesforce API-integrasjon.
Opprett en ekstern klientapp for Salesforce
Opprett en ny ekstern klientapp
Det finnes to alternativer for å koble Salesforce-dataene dine til tredjepartsapplikasjoner. BådeTilkoblede apperogEksterne klientapperer rammeverk for å integrere data. Eksterne klientapper er neste generasjon av tilkoblede apper.
Slik konfigurerer du Salesforce External Client-appen som brukes av Cisco Webex Contact Center:
- Fra Oppsettnavigerer du tilApper | Eksterne klientapper | Appbehandling for ekstern klient.
- Klikk påNy ekstern klientapp.
- Ekstern klientapp – grunnleggende informasjon
- Navn på ekstern klientapp: WxCC - SCV
- API-navn: WxCC_SCV
- Kontakt e-post: < your email >
- Distribusjonsstatus: velg Lokal

Ekstern klientapp – API (aktiver OAuth-innstillinger)
- Velge: Aktiver OAuth
- Appinnstillinger
- Tilbakeringing URL: http://localhost:1717/OauthRedirect as en eksempel-URL for tilbakeringing
- OAuth-omfang
- Velg OAuth-omfang:
- Administrer brukerdata via API-er (api)
- Utfør forespørsler når som helst (refresh_token, offline_access)

Flytaktivering
- Velge: Aktiver JWT-bærerflyt
- Klikk på Last opp filer og last opp
server.crt-filen som inneholder det digitale sertifikatet ditt.

Sikkerhet
Fjern merket for alternativet Krev hemmelighet for webserverflyten.

- Klikk påOpprett-knappen.
- Endre til Faneregler og klikk deretter påRediger-knappen.
- Retningslinjer – OAuth-retningslinjer
- Programvarepolicyer
- Tillatte brukere: utvalgte administratorgodkjente brukere er forhåndsautorisert
- Bekreft endringen
- Appautorisasjon
- Retningslinjer for oppdatering av token: velg Oppdateringstoken utløper umiddelbart
- IP-avslapping: velg Håndhev IP-begrensninger

- Programvarepolicyer
- Retningslinjer – Appens retningslinjer
- Startside – ingen
- Velg tillatelsessett – Tildel tillatelsessettet som ble opprettet tidligere («IVR-tilgang til SCV Apex-klasser»)

- Klikk på Lagre.
- Endre til faneinnstillinger.
-
I seksjonen OAuth-innstillinger klikker du påForbrukernøkkel og Hemmelig-knappen. Vent på e-post og bekreft identiteten din. En ny nettleserfane åpner en skjerm med forbrukerdetaljer.

- Klikk på Kopier og lagreForbrukernøkkelen. Forbrukernøkkelen brukes senere til å opprette Salesforce Connector på Webex Contact Center Control Hub.

-
Webex kontaktsenterkonfigurasjon og skript for å opprette taleanropsoppføringer
For å få full verdi av Salesforce Service Cloud Voice, må samtaleflyten i Webex Contact Center endres for å opprette Voice-anropsoppføringen i Service Cloud Voice så snart samtalen kommer inn i kontaktsenteret.
En valgfri Omni-Flow kan kjøres for rutebeslutninger og automatisering i Salesforce.
Hvis du vil ha mer informasjon om de brukte API-ene, kan du se Service Cloud Voice API Wrapper.
Forutsetninger
For å kunne bruke Service Cloud Voice API Wrapper, må en Salesforce ekstern klientapp for IVR-integrasjon konfigureres.
Konfigurer Salesforce-koblingen i Webex Control Hub
Konfigurer Salesforce-integrasjonskoblingene for Webex kontaktsenter som beskrevet i artikkelen på https://help.webex.com/en-us/article/7fuy63/Set-Up-Integration-Connectors-for-Webex-Contact-Center#id_133211.
| 1 |
Logg inn på kundeorganisasjonen din på https://admin.webex.com og gå til Tjenester > Kontaktsenter > Leietakerinnstillinger > Integrations>Connectors. |
| 2 |
Klikk på Konfigurer eller Legg til kobling på Salesforce-kortet.
VIKTIG: OPPRETTHOLD SIKKERHETEN VED Å ROTERE HEMMELIGHETER MED PERIODISK GANG Sørg for at du regelmessig roterer den private nøkkelen og sertifikatet ditt for å holde integrasjonene dine sikre. Oppdater den private nøkkelen i kontaktsenterkoblingen i Webex Hubog sertifikatet i den eksterne klientappen i Salesforce. Feilsøkingstips Etter at du klikker på Ferdig, og koblingen ikke lagrer:
|
Webex kontaktsenterets hovedflyt
| Flytvariabel | Beskrivelse |
|---|---|
| Flytvariabel for oppførings-ID for taleanrop | Unik ID for å identifisere samtalen. Kreves for å opprette taleanropsoppføringen. Format: wxcc_<Interaction Id> Eksempel: wxcc_fc4ec7d8-4c91-49aa-b764-081fbba344a8
|
| Lokal variabel for samtalens starttidspunkt |
Brukes til å opprette taleanropsoppføringen og ved oppdatering av taleanropet.
|
| Lokal variabel for kø name/id |
Returnert av Utfør Omni Flow, brukt for samtaleruting. Denne variabelen er bare nødvendig når du bruker Execute Omni Flow
|
| Lokal variabel for Agent name/id |
Returnert av Utfør Omni Flow, brukt for samtaleruting. Denne variabelen er bare nødvendig når du bruker Execute Omni Flow
|
Oversikt over hovedstrøm

- Generer leverandøranropsnøkkel
- Angi starttidspunkt for samtale
- HTTP-forespørsel: Opprett taleanropsoppføring
- Evaluer HTTP-svar for oppretting av taleanropsoppføring
- Feilhåndtering for oppretting av taleanropsoppføring
- HTTP-forespørsel: Utfør Omni Flow
- Evaluer HTTP-respons for å kjøre Omni-flyt
- Feilhåndtering for Utfør Omni Flow
- Fortsett med samtaleruting
| Strømme | Beskrivelse |
|---|---|
| Generer leverandøranropsnøkkel |
Hver samtale som håndteres i Service Cloud Voice oppretter en taleanropsoppføring i Salesforce og krever en unik ID kalt leverandøranropsnøkkel. For taleanropsoppføringer som er opprettet i Webex kontaktsenter, må leverandøranropsnøkkelen defineres i WxCC-flyten og deretter sendes sammen med anropet til agenten ved hjelp av en flytvariabel. Verdien for vendorCallKey må overholde følgende regler:
|
| Angi starttidspunkt for samtale |
UTC-tidsstempel for starttidspunktet for samtalen. Dette tidsstempelet brukes til å opprette taleanropsoppføringen og til å oppdatere taleanropsoppføringen hvis innringeren legger på før den blir rutet til agenten.
|
| HTTP-forespørsel: Opprett taleanropsoppføring |
Dette trinnet er nødvendig for hver samtale. Etter at taleanropsoppføringen er opprettet, må taleanropsoppførings-ID-en sendes med anropet til agenten i en variabel, sammen med leverandøranropsnøkkelen. Konfigurer variabelen som brukes i kontaktsenterkonfigurasjonen i Service Cloud Voice. |
| HTTP-forespørselsinnstillinger |
|
HTTP-forespørsel: Opprett taleanropsoppføring
Dette trinnet er nødvendig for hver samtale. Etter at taleanropsoppføringen er opprettet, må taleanropsoppførings-ID-en sendes med anropet til agenten i en variabel, sammen med leverandøranropsnøkkelen. Konfigurer variabelen som brukes i kontaktsenterkonfigurasjonen i Service Cloud Voice.
HTTP-forespørselsinnstillinger
- Aktivitetsetikett: Opprett taleanrop
- Bruk autentisert endepunkt: Aktivert
- Kontakt: Salesforce Connector opprettet i forrige trinn
- Forespørselssti:
/services/apexrest/cisco_wxcc_scv/voice/v1/createVoiceCall - Metode: STOLPE
- Forespørselsinnholdstype: Application/JSON
Forespørselstekst
Når du oppretter taleanropsoppføringen, kan du også oppdatere egendefinerte felt i taleanropsoppføringen med samtaledata. Nedenfor er to eksempler på forespørselsteksten, ett med alle obligatoriske felt, men uten oppdatering av egendefinerte felt, og ett med egendefinerte felt.
Uten å oppdatere egendefinerte felt i taleanropsoppføringen:
{
"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å oppdatering av egendefinerte felt i taleanropsoppføringen:
{
"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\": \"\"}"
}
Parametere
| Eiendomsnavn | Verdi |
|---|---|
| callCenterDevName | Navn på utvikler av kontaktsenter |
| certDevName | API-navn på sertifikat (som konfigurert i kontaktsenteret) |
| leverandørCallKey | Unik anrops-ID: {{SCV_VendorCallKey}} |
| til | CalledNumber/DNIS: {{NewPhoneContact.DNIS}} |
| fra | CallingNumber/ANI: {{NewPhoneContact.ANI}} |
| starttid | UTC-tidsstempel {{SCV_CallStartTime}} (skal settes rett etter at kallet er akseptert i skriptet) |
| kalleattributter |
Representerer ekstra standard- og tilpassede felt i taleanropsoppføringen, der hvert nøkkelverdipar tilsvarer et standard- eller tilpasset felt og dets verdier. Eksempel: |
Parse-innstillinger
- Innholdstype: JSON
- Utgangsvariabel: SCV_Talesamtaleoppførings-ID
- Stiuttrykk:
$.data.voiceCallId
Oppførings-ID for taleanrop, som skal sendes til agenten.
Evaluer HTTP-svar for oppretting av taleanropsoppføring
Sjekk HTTP-statusen for http-forespørselen om å opprette taleanrop:
- Etikett: statusKodeOpprettStemmeanrop
- Variabel: OpprettVoiceCall.httpStatusCode
Hvis statuskode == 200 => vellykket ellers => forespørsel mislyktes, feilhåndtering
Feilhåndtering for oppretting av taleanropsoppføring
For demonstrasjon / kun feilsøking, spill av melding avhengig av http-statuskode.
Hvis opprett taleanrop var vellykket, fortsett med Utfør Omni Flow. Ellers fortsett med samtaleruting.
HTTP-forespørsel: Utfør Omni Flow (valgfritt trinn)
Bruk Utfør Omni-Flow når du vil:
- kjøre automatiserte oppgaver, for eksempel søke etter eller opprette poster, og koble postene til taleanropsposten
- søk etter poster og lag skjermvisning
- synkronisere Salesforce- og Cisco-køer
- la Service Cloud Voice ta rutingsbeslutningen
Denne forespørselen returnerer alltid «køen» eller «agenten» dit samtalen må rutes.
Etter at du har utført denne forespørselen, må du sende Clear Routing hvis den som ringer legger på før vedkommende blir besvart av en agent. Se Webex kontaktsenterhendelsesflyt.
HTTP-forespørselsinnstillinger
- Aktivitetsetikett: UtførOmniFlow
- Bruk autentisert endepunkt: Aktivert
- Kontakt: Salesforce Connector opprettet i forrige trinn
- Forespørselssti:
/services/apexrest/cisco_wxcc_scv/voice/v1/executeOmniFlow - Metode: STOLPE
- Forespørselsinnholdstype: Application/JSON
Forespørselstekst
I tillegg til de obligatoriske feltene kan du sende tilleggsdata som inputvariabler til Omni-Flow. Nedenfor er to eksempler på forespørselsteksten. Først uten ytterligere flytparametere, kun obligatoriske felt, den andre med to inndatavariabler.
Eksempel med Omni-Flow-parametere:
{
"callCenterDevName": "",
"certDevName": "",
"voiceCallId": "{{SCV_VoiceCallRecordId}}",
"dialedNumber": "{{NewPhoneContact.DNIS}}",
"flowDevName": "",
"fallbackQueue": ""
}
Eksempel på oppdatering av egendefinerte felt i taleanropsoppføringen:
{
"callCenterDevName": "",
"certDevName": "",
"voiceCallId": "{{SCV_VoiceCallRecordId}}",
"dialedNumber": "{{NewPhoneContact.DNIS}}",
"flowDevName": "",
"fallbackQueue": "",
"flowInputParameters":
{
"param1": "value1",
"param2": "value2"
}
}
Parametere
| Eiendomsnavn | Verdi |
|---|---|
| callCenterDevName | Navn på utvikler av kontaktsenter |
| certDevName | API-navn på sertifikat (som konfigurert i kontaktsenteret) |
| stemmeanrops-ID | ID for taleanropsoppføringen, opprettet i forrige trinn: {{SCV_VoiceCallRecordId}} |
| oppringt nummer | CalledNumber/DNIS: {{NewPhoneContact.DNIS}} |
| flytDevNavn | Utviklernavnet til Omni-Flow som skal kjøres |
| reservekø | Kø-ID eller kø-API-navn for reservekøen i Salesforce |
| flytInndataParametere |
Ytterligere inndata til Omnikanal-flyten (nøkkelverdi-par). Eksempel: |
Parse-innstillinger
Kø
- Innholdstype: JSON
- Utgangsvariabel: SCV_OmniFlowQueue
- Stiuttrykk:
$.data.queue
«Kø» som returneres fra Execute Omni-Flow kan brukes til ruting.
Agent- Innholdstype: JSON
- Utgangsvariabel: SCV_OmniFlowAgent
- Stiuttrykk:
$.data.agent
«Agent» returnert fra Execute Omni-Flow, kan brukes til ruting.
Evaluer HTTP-respons for å kjøre Omni-flyt
Sjekk HTTP-statusen til http-forespørselen «Execute Omni Flow»:
- Etikett: statusKodeUtførOmniFlow
- Variabel: UtførOmniFlow.httpStatusCode
Hvis statuskode == 200 => vellykket ellers => forespørsel mislyktes, feilhåndtering.
Feilhåndtering for Utfør Omni Flow
For demonstrasjon / kun feilsøking, spill av melding avhengig av http-statuskode.
Hvis Execute Omni Flow var vellykket, er ikke variablene SCV_OmniFlowQueue og SCV_OmniFlowAgent angitt. Rutingbeslutning i samtaleflyt.
Fortsett med samtaleruting
Fortsett i samtaleflyten, rute samtalen til agenten. Bruk valgfritt SCV_OmniFlowQueue og SCV_OmniFlowAgent til å velge kø og agent.
Webex kontaktsenter-hendelsesflyt
Hvis den som ringer legger på før den blir besvart av en agent, må vi oppdatere Service Cloud Voice og avslutte samtalen.
- Hvis Utfør Omni-Flow ble brukt, send Fjern ruting for å slette den ventende tjenesterutingen (PSR)
- Send oppdatering av taleanrop, for å oppdatere start- og sluttidspunktene på taleanropsoppføringen og for å endre status fra Ny til Fullført

- PhoneContactEnded – Denne hendelsen utløses når en live-samtale kobles fra, og alle deltakere fjernes.
- HTTP-forespørsel: Fjern ruting
- HTTP-forespørsel: Oppdater taleanrop
HTTP-forespørsel: Fjern ruting
- Etikett: Fjern ruting
- Bruk autentisert endepunkt: Aktivert
- Kontakt: Salesforce Connector opprettet i forrige trinn
- Forespørselssti:
/services/apexrest/cisco_wxcc_scv/voice/v1/clearRouting - Metode: STOLPE
Forespørselsinnholdstype: Application/JSON
Forespørselstekst
{
"callCenterDevName": "",
"certDevName": "",
"voiceCallId": "{{SCV_VoiceCallRecordId}}"
}
Parametere
| Eiendomsnavn | Verdi |
|---|---|
| callCenterDevName | Navn på utvikler av kontaktsenter |
| certDevName | API-navn på sertifikat (som konfigurert i kontaktsenteret) |
| stemmeanrops-ID | ID for taleanropsoppføringen, opprettet i forrige trinn: SCV_Talesamtaleoppførings-ID |
Parse-innstillinger
Ingen.
HTTP-forespørsel: Oppdater taleanrop
- Etikett: Oppdater taleanrop
- Bruk autentisert endepunkt: Aktivert
- Kontakt: Salesforce Connector opprettet i forrige trinn
- Forespørselssti:
/services/apexrest/cisco_wxcc_scv/voice/v1/updateVoiceCall - Metode: STOLPE
- Forespørselsinnholdstype: Application/JSON
Forespørselstekst
{
"callCenterDevName": "",
"certDevName": "",
"voiceCallId": "{{SCV_VoiceCallRecordId}}",
"startTime": "{{SCV_CallStartTime}}",
"endTime": "{{now() | replace({'[UTC]': ''})}}",
"disconnectReason": { "value": "Abandoned in queue", "isError": true }
}
Parametere
| Eiendomsnavn | Verdi |
|---|---|
| callCenterDevName | Navn på utvikler av kontaktsenter |
| certDevName | API-navn på sertifikat (som konfigurert i kontaktsenteret) |
| stemmeanrops-ID | ID for taleanropsoppføringen, opprettet i forrige trinn: SCV_Talesamtaleoppførings-ID |
| starttid | UTC-tidsstempel for samtalestart {{SCV_CallStartTime}} (som brukt til å opprette taleanropsoppføringen) |
| sluttid | Gjeldende UTC-tidsstempel `{{now() |
| frakoblingÅrsak | Årsak til at samtalen ble frakoblet. Egenskapen isError må settes til true for at den skal vises riktig. |
Parse-innstillinger
Ingen.
Referanser
- Opprett en privat nøkkel og et selvsignert digitalt sertifikat
- Konfigurer tilkoblet app for Webex kontaktsenter Salesforce Connector
- Konfigurer integrasjonskoblinger for Webex kontaktsenter – Salesforce
- Veiledning for oppsett og administrasjon av Cisco Webex kontaktsenter > Flytdesigner
- REST API for telefoniintegrasjon
Språkoversettelse
(Valgfritt) Aktiver oversettelsesarbeidsbenken
Denne innstillingen gjelder bare hvis du bruker innstillinger for oversettelsesspråk.
| 1 |
Gå til Oppsett → Oversettelsesarbeidsbenk → Innstillinger for oversettelsesspråk. |
| 2 |
Klikk på Aktiver for å velge oversettelsesspråk. |
(Valgfritt) Aktiver plattformspråk
Denne innstillingen gjelder bare for andre språk enn EN-US.
| 1 |
Gå til Oppsett → Firmainnstillinger → Språkinnstillinger. |
| 2 |
Velg de nødvendige språkene. |
| 3 |
Merk av i følgende avmerkingsbokser:
|
| 4 |
Lagre endringene dine. |
Aktiver språket og velg brukeren (oppgaven)
| 1 |
Gå til Oppsett → Oversettelsesarbeidsbenk → Innstillinger for oversettelsesspråk. |
| 2 |
Velg språket og velg brukeren som skal oversette det. |
| 3 |
Lagre endringene dine. |
Flerspråklige innstillinger
Oversett tilpassede etiketter
| 1 |
Gå til Oppsett → Tilpassede etiketter. |
| 2 |
Velg navnet på den egendefinerte etiketten som skal åpnes.
|
| 3 |
I den relaterte oversettelseslisten klikker du på |
| 4 |
Velg språket du oversetter til. |
| 5 |
Skriv inn den oversatte verdien i feltet Oversettelsestekst. Denne teksten overstyrer verdien som er angitt i etikettens Verdi-felt når en brukers standardspråk er oversettelsesspråket. |
| 6 |
Lagre endringene dine. |
Salesforce-tillatelser kreves av brukerfunksjonen
Webex Contact Center SCV-agenttillatelsessettet inneholder alle tillatelser som kreves for å arbeide med Webex Contact Center-gadgeten og integrasjonene som er utviklet for agenter.
Apex-klassetilgang (seksjon)
- cisco_wxcc_scv.CiscoScvWxcc
- cisco_wxcc_scv.ServiceResponseHandler
- cisco_wxcc_scv.ServiceRouting
- cisco_wxcc_scv.TelephonyIntegrationHandler
Tilgang til tilpassede metadatatyper (seksjon)
- cisco_wxcc_scv.WxCC-tilkobling
Visualforce-sidetilgang (seksjon)
- cisco_wxcc_scv.CiscoScvLoginWxCC
- cisco_wxcc_scv.CiscoScvMainWxCC
- cisco_wxcc_scv.CiscoScvOAuthRedirect
- cisco_wxcc_scv.CiscoScvSwLoader
Service Cloud Voice API-omslag
Forutsetninger
For å kunne bruke Service Cloud Voice API Wrapper, må en Salesforce ekstern klientapp for IVR-integrasjon konfigureres.
Bruk Service Cloud Voice API-omslagspakken
Service Cloud Voice (SCV) for Salesforce bruker REST API-et for telefoniintegrasjon til å opprette og oppdatere VoiceCalls, kjøre Omni-Channel-flyter og slette PendingServiceRouting-oppføringer som er knyttet til et VoiceCall. Denne tjenesten krever JWT-autorisasjon og bruk av PATCH HTTP-metoden, som for øyeblikket ikke støttes av Cisco IP Interactive Voice Response (IVR).
For å forenkle bruken av telefonintegrasjons-REST-API-et for SCV i (ikke bare) et IVR-system, er et nytt sett med API-er gjort tilgjengelig, som omslutter det eksisterende Salesforce API-et og er tilgjengelige direkte fra Salesforce-organisasjonen der Webex Contact Center for Service Cloud Voice-pakken er installert.
Service Cloud Voice API Wrapperfjerner behovet for å autentisere et JWT-token, implementerer ytterligere kontroller av dataene som kreves av Salesforce API og forbedrer responsobjektene.
Hent Access_-tokenet
Utfør en POST forespørsel til https://<your-domain-name>.my.salesforce.com/services/oauth2/token
Sender følgende parametere 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": ""
}
Utfør forespørslene
Forekomst-URL-en må inneholde my.salesforce.com.
Eksempel på en korrekt forekomst-URL: https://abc-123.my.salesforce.com
Bruk av et annet domene som forekomst-URL (f.eks. https://abc-123.lightning.force.com ) resulterer i en 401 Uautorisert status med en INVALID_SESSION_ID errorCode returnert.
Opprett taleanrop (seksjon)
Oppretter en VoiceCall-oppføring som inneholder deltakerne (det vil si innringeren og mottakeren) for VoiceCall-oppføringen. Når du oppretter en VoiceCall-oppføring, opprettes det en samtale i Salesforce. Bruk kun dette API-et i sanntidskontekst, som betyr at du bare bør kalle dette API-et når et kall startes. Dette API-et kan også brukes til å opprette VoiceCall-oppføringer for overføring og konferansesamtaler ved å inkludere parentVoiceCallId-parameteren i forespørselsnyttelasten.
Endepunkt-URI
<instance_url>/services/apexrest/cisco_wxcc_scv/voice/v1/createVoiceCall
HTTP-metoden
STOLPE
Overskrifter
Autorisasjon: Bærer <access_token>
Innholdstype: application/json
Parametere
{
"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 feil)
{
"data": null,
"errors": ["Error message 1", "Error message 2"],
"success": false
} Oppdater taleanrop
Oppdaterer VoiceCall etter at samtalen er avsluttet. Bruk dette API-et til å oppdatere samtalerelaterte parametere som ikke er tilgjengelige under opprettelsesfasen av VoiceCall. Oppdaterings-API-et for VoiceCall er en asynkron operasjon. Du kan ikke spørre om statusen til API-kallet.
Dette endepunktet kan også brukes til å opprette et taleanrop selv etter at samtalen er avsluttet. Denne virkemåten er nyttig i scenarioer der du vil logge en post i Salesforce for avbrutte eller tapte anrop, eller for andre scenarioer der et VoiceCall ikke allerede er opprettet.
Endepunkt-URI
<instance_url>/services/apexrest/cisco_wxcc_scv/voice/v1/updateVoiceCall
HTTP-metoden
STOLPE
Overskrifter
Autorisasjon: Bærer <access_token>
Innholdstype: application/json
Parametere
{
"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 detaljert beskrivelse av parameterne som godtas av denne forespørselen finner du i Salesforces offisielle dokumentasjon under delen «Parametere».
Svar (vellykket)
{
"data": {
"status": "pending"
},
"errors": null,
"success": true
} Oppdaterings-API-et for VoiceCall er en asynkron operasjon. Du kan ikke spørre om statusen til API-kallet.
Svar (med feil)
{
"data": null,
"errors": ["Error message 1", "Error message 2"],
"success": false
} Utfør Omni-flow
Utfører Omnikanal-flyten for å rute anrop. Den sender anrops-ID-en (Salesforce VoiceCallId eller telefonileverandørens ContactId) som parametere til flyten og returnerer agent- eller kørutingsinstruksjonene til kontaktflyten. Som standard bruker Service Cloud Voice Omni-Channel-flyten (eller reservekøen) som er spesifisert for telefonkanalen som samsvarer med det oppringte nummeret. Hvis det oppringte nummeret ikke samsvarer med en eksisterende telefonkanal, kan du eventuelt angi et nytt oppringt nummer, en Omnikanal-flyt og en reservekø som inndataparametere for dette API-kallet.
Service Cloud Voice bruker denne prioritetsrekkefølgen for å rute anrop:
- Bruker innstillingene for Omnikanalflyt og reservekø for telefonkanalen som samsvarer med det oppringte nummeret. Flyten har forrang. Hvis flyten mislykkes, brukes reservekøen.
- Bruker flowDevName- og fallbackQueue-parameterne som er spesifisert i Execute Omniflow API-kallet.
Endepunkt-URI
<instance_url>/services/apexrest/cisco_wxcc_scv/voice/v1/executeOmniFlow
HTTP-metoden
STOLPE
Overskrifter
Autorisasjon: Bærer <access_token>
Innholdstype: application/json
Parametere
{
"callCenterDevName": "contactCenterDevName123",
"certDevName": "certDevName123",
"voiceCallId": "00X000012345abc",
"dialedNumber": "+18445791189",
"flowDevName": "Route_VoiceCall",
"fallbackQueue": "00G111222333444",
"flowInputParameters":
{
"Input1": "one",
"Input2": "two"
}
}
- voiceCallId-parameteren er Salesforce voiceCallId eller telefonileverandørens kontakt-ID.
- En detaljert beskrivelse av parameterne som godtas av denne forespørselen finner du i Salesforces offisielle dokumentasjon under delen «Parametere».
Svar (vellykket)
{
"data": {
"queue": "queue info",
"agent": "agent info"
},
"errors": null,
"success": true
} AGENT_INFO og QUEUE_INFO samsvarer med ExternalId-feltet i CallCenterRoutingMap
Svar (med feil)
{
"data": null,
"errors": ["Error message 1", "Error message 2"],
"success": false
} Tydelig ruting
Sletter PendingServiceRouting (PSR)-oppføringen for et taleanrop. Dette API-et trenger ikke å kalles i de fleste tilfeller; PSR-oppføringen slettes automatisk når kallet ikke lenger rutes. Det finnes imidlertid noen scenarier, som for tapte eller avbrutte anrop når du bruker partnertelefonisystemer, der du eksplisitt må kalle dette API-et for å slette PSR-posten.
Endepunkt-URI
<instance_url>/services/apexrest/cisco_wxcc_scv/voice/v1/clearRouting
HTTP-metoden
STOLPE
Overskrifter
Autorisasjon: Bærer <access_token>
Innholdstype: application/json
Parametere
{
"callCenterDevName": "contactCenterDevName123",
"certDevName": "certDevName123",
"voiceCallId": "00X000012345abc"
}
- voiceCallId-parameteren er Salesforce voiceCallId eller telefonileverandørens kontakt-ID.
- En detaljert beskrivelse av parameterne som godtas av denne forespørselen finner du i Salesforces offisielle dokumentasjon under delen «Parametere».
Svar (vellykket)
{
"data": {
"status": "Success"
},
"errors": null,
"success": true
} Svar (med feil)
{
"data": null,
"errors": ["Error message 1", "Error message 2"],
"success": false
} Oversettelser av telefonnumre
Ulike interaksjoner mellom Service Cloud Voice og Webex Contact Center avhenger av oversettelser av telefonnumre. På grunn av internasjonale forskjeller og kundespesifikke applikasjoner, er det nødvendig med et tilpassbart verktøy for å overføre telefonnumre fra format A til format B.
Webex Contact Center for Service Cloud Voice-løsningen fjerner automatisk alle tegn unntatt tall og emneknagger (#), stjerner (*), komma (,) og innledende plusstegn (+). Den fjerner også den første forekomsten av (0). Dette vil bli gjort FØR telefonnummeroversettelsene dine blir brukt.
Denne veiledningen beskriver hvordan du konfigurerer oversettelser av telefonnumre.
Felt
Oversettelser av telefonnumre lagres i navn-verdi-feltene. Dette lar deg konfigurere et ubegrenset antall regler per funksjon.
Konfigurasjonen lagres som en JSON-streng.
Merk at omvendte skråstreker må escapes, f.eks. \d+ blir \\d+.
{"Remove all characters but digits":"[1,17]->[^\\d]+","To internal number":"[7,17]->(\\d{7})(\\d{4})->$2"}
Feltet Navn brukes teknisk sett ikke. Den er der for å legge til en menneskelig lesbar streng for raskt å identifisere formålet med denne regelen. Gode navn er for eksempel: Fjern alle innledende nuller, Legg til innledende pluss osv.
Opprette oversettelsesregler
Regler leveres som regulære uttrykk. For å være mer nøyaktig: JavaScript-implementeringen av regulære uttrykk.
En god måte å starte på er å lese RegExp-dokumentet fra MDN-nettdokumentasjonen.
Likevel er det ofte tungvint å lage komplekse regulære uttrykk. Derfor har vi lagt til ekstra syntaks for å gjøre konfigurasjonen så enkel som mulig.
Figuren nedenfor viser den generelle syntaksen for en regel for oversettelse av telefonnummer:
Predikat
Predikatet brukes til å spesifisere et intervall som definerer lengden på tallet som skal samsvare.
Predikatet ovenfor spesifiserer at alle tall med en lengde mellom 7 og 11 tegn (inkludert kanter + mellomrom) samsvarer.
Predikater samsvarer alltid med den opprinnelige lengden på tallet. Dette bidrar til å forenkle konfigurasjonen ved å redusere risikoen for kollisjon mellom regler for interne / eksterne numre.
Mønster
Mønsteret angir formatet til tallet som skal samsvare.
Mønsteret ovenfor sier at tallet kun må bestå av sifre, og velger dem.
Velger
Selektorer definerer det endelige formatet til tallet. Hvis tegn / Hvis sifre som ikke opprinnelig var til stede må legges til, er dette stedet å gjøre det.
Selektoren er det siste trinnet i å bygge tallet. Basert på mønsterutgangen bygger velgeren opp det nye tallet.
Eksempel 1
Følgende eksempel viser hvordan du overfører et nummer mottatt fra kontaktsenteret i formatet 0319175200 til det sveitsiske E164-formatet. +41 31 917 52 00.
Dette eksemplet bruker to oversettelsesregler (1. og 2.)
Den første regelen i dette eksemplet endrer faktisk ikke tallet. For tall mellom 1 og 17 tegn vil alt annet enn sifre bli fjernet. Siden det ikke er noen ikke-sifret tilstedeværelse, endres ingenting.
Den andre regelen gjelder for tall som er nøyaktig 10 tegn lange (opprinnelig). 0319175200 samsvarer, og derfor blir regelen brukt. Mønsteret spesifiserer at tallet må starte med en gruppe på ett siffer (\d{1}), etterfulgt av en gruppe på to sifre (\d{2}), etterfulgt av en gruppe på tre sifre (\d{3}), og så videre.
Velgeren får deretter tilgang til mønstergruppene for å definere den nye tallstrengen. Dette betyr $2 refererer til den første (\d{2}) og inneholder derfor 31.
Eksempel 2
Følgende eksempel viser hvordan du overfører et nummer mottatt fra kontaktsenteret i formatet +14693150217 til det amerikanske E164-formatet +1 469 315 0217.
Dette eksemplet bruker to oversettelsesregler (1. og 2.)
- Dette tallet er nøyaktig 12 tegn langt, så regelen «Legg til mellomrom i amerikanske tall» brukes.
- (\+1) sier at tallet må starte med +1. Hvis nummeret er 12 tegn langt, men ikke starter med en +1, Regelen er opphevet og ingenting endres.
- (\d{3}) sier at +1 må etterfølges av 3 sifre.
- (\d{3}) sier at de siste 3 sifrene må etterfølges av ytterligere 3 sifre.
- (\d{4}) sier at de siste 3 sifrene må etterfølges av 4 sifre.
Hvis noe av dette ikke stemmer overens, vil ikke tallet bli endret.
Så alle reglene gjelder for “+14693150217”. Derfor endres tallet med “$1 $2 $3 $4”:
- $1 refererer til gruppen (\+1), nummeret som skal sendes til Service Cloud Voice ser slik ut +1.
- $2 refererer til den første av de to (\d{3}), nummeret som skal sendes til Service Cloud Voice ser slik ut +1 469.
- $3 refererer til den andre av de to (\d{3}), nummeret som skal sendes til Service Cloud Voice ser slik ut +1 469 315.
- $4 refererer til den siste gruppen (\d{4}), nummeret som skal sendes til Service Cloud Voice ser slik ut +1 469 315 0217.
Mellomrommene i erstatningsdelen av regelen “$1 $2 $3 $4” brukes direkte. Så hvis du bruker “$1-$2-$3-$4” tallet ville bli oversatt til: +1-469-315-0217
Og du har også lov til å fjerne grupper: [12, 12]->(\+1)(\d{3})(\d{3})(\d{4})->$2 $3 $4 vil bli oversatt til: 469 315 0217. [12, 12]->(\+1)(\d{3})(\d{3})(\d{4})-> $3 $4 vil bli oversatt til: 315 0217.
Det er også mulig å konvertere et internasjonalt amerikansk nummer til et lokalt nummer slik: [12, 12]->(\+1)(\d{3})(\d{3})(\d{4})->($2) $3-$4.
Så det innkommende nummeret “+14693150217” vil bli oversatt til: (469) 315-0217.
Eksempel 3
Følgende eksempel viser hvordan du overfører et nummer mottatt fra kontaktsenteret i formatet +491515555531 til det tyske E164-formatet +49 151 5555 531.
Dette eksemplet bruker to oversettelsesregler (1. og 2.)
- Dette tallet er nøyaktig 13 tegn langt, så regelen «Legg til mellomrom i tyske tall» gjelder.
- (\+49) sier at tallet må starte med +49. Hvis nummeret er 13 tegn langt, men ikke starter med en +49, Regelen er opphevet og ingenting endres.
- (\d{3}) sier at +49 må etterfølges av 3 sifre.
- (\d{4}) sier at de siste 3 sifrene må etterfølges av 4 sifre.
- (\d{3}) sier at de siste 4 sifrene må etterfølges av 3 sifre.
Hvis noe av dette ikke stemmer overens, vil ikke tallet bli endret.
Så alle reglene gjelder for “+491515555531”. Derfor endres tallet med “$1 $2 $3 $4”:
- $1 refererer til gruppen (\+49), nummeret som skal sendes til Service Cloud Voice ser slik ut +49.
- $2 refererer til den første av de to (\d{3}), nummeret som skal sendes til Service Cloud Voice ser slik ut +49 151.
- $3 refererer til den andre av de to (\d{4}), nummeret som skal sendes til Service Cloud Voice ser slik ut +49 151 5555.
- $4 refererer til den siste gruppen (\d{3}), nummeret som skal sendes til Service Cloud Voice ser slik ut +49 151 5555 531.
Det samme gjelder regel én. Du kan bruke reservedelen $1 $2 $3 $4 å velge hva du skal bruke fra tallet.
Flere eksempler på oversettelsesregeks
| Beskrivelse | Oversettelsesregeks |
|---|---|
| Fjern alle tegn unntatt sifre | [1,17]->[^\d]+ |
| Fjern alle tegn unntatt sifre & + | [1,17]->[^+\d]+ |
| Beskrivelse | Oversettelsesregeks |
|---|---|
| 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 | Oversettelsesregeks |
|---|---|
| Fjerne + og erstatt den med nuller US E164 | [10,12]->(.{1})(\d{1})(\d{10})-> 001 $3 |
| Fjerne +1 og erstatt den med nuller US E164 | [10,12]->(^\+1+)(\d+)-> 001$2 |
| Fjerne + og erstatt den med nuller DE E164 | [12,15]->(.{1})(\d{2})(\d{10})-> 0049 $3 |
| Fjerne +49 og erstatt den med nuller DE E164 | [10,12]->(^\+49+)(\d+)-> 0049$2 |
| Fjerne + og erstatt den med nuller CH E164 | [10,13]->(.{1})(\d{2})(\d{9})-> 0041 $3 |
| Fjerne +41 og erstatt den med nuller CH E164 | [10,12]->(^\+41+)(\d+)-> 0041$2 |
| Beskrivelse | Oversettelsesregeks |
|---|---|
| Amerikansk tall med mellomrom | [12,17]->(\d{1})(\d{3})(\d{3})(\d{4})->+1 $2 $3 $4 |
| Amerikansk tall med mellomrom | [12,17]->(\+1)(\d{3})(\d{3})(\d{4})->$1 $2 $3 $4 |
| DE-nummer med mellomrom | [12,17]->(\d{2})(\d{3})(\d{4})(\d{3})->+49 $2 $3 $4 |
| DE-nummer med mellomrom | [12,17]->(\+49)(\d{3})(\d{4})(\d{3})->$1 $2 $3 $4 |
| CH-nummer med mellomrom | [12,17]->(\d{2})(\d{2})(\d{3})(\d{2})(\d{2})->+41 $2 $3 $4 |
| CH-nummer med mellomrom | [12,17]->(\+41)(\d{2})(\d{3})(\d{2})(\d{2})->$1 $2 $3 $4 |
Konfigurasjon av taleanropssiden
Konfigurer VoiceCall-oppføringssiden
VoiceCall-oppføringssiden er forhåndskonfigurert som standard, med et oppsett med tre kolonner og følgende komponenter:
- Handlinger & anbefalinger
- Anropsnotater
- Anropsdetaljer
- Opptak
Komponenter kan fritt fjernes eller legges til siden, avhengig av forretningsbehov. Ulike sideoppsett kan også brukes, men noen komponenter, som samtaleopptaksspilleren og samtaleinnholdet, får bare plass på mellomstore og store områder i malen.
Vis komponenten for oppsummeringsårsak
Komponenten for avslutningsårsak må vises under samtalen og under avslutningen.
Legg til Cisco WrapUp Reason-komponenten på VoiceCall-oppføringssiden:
- Dra Cisco Wrap-Up Reason Lightning-webkomponenten fra det tilpassede området i Lightning-komponentlisten til siden for taleanropsoppføring.
- Klikk på Lagre.
- Klikk på Aktiver.
- Klikk på Tildel som organisasjonsstandard.
- Klikk på Lagre.
- Klikk på Lagre igjen, og klikk deretter på Tilbakepil for å gå tilbake til siden.
Komponenten Cisco Wrap-Up Reason vises automatisk under samtalen og under WrapUp:
Hvis komponenten Cisco Wrap-Up Reason legges til siden, vises den for hver samtale, også hvis ingen Wrap-Up er konfigurert i Cisco Contact Center.
Vis avspilleren for samtaleopptak
Avspilleren for samtaleopptak vises hvis en opptakslenke er lagret for det tilhørende taleanropet.
Følg disse trinnene for å legge til komponenten for samtaleopptaksspiller på siden for talesamtaleopptak:
- Dra Lightning-webkomponenten for samtaleopptaksspilleren til siden for talesamtaleopptak
- Klikk påLagre.
- Klikk påAktiver.
- Klikk påTildel som organisasjonsstandard.
- Klikk påLagre.
- Klikk påLagreigjen, og klikk deretter på Tilbake-pilen for å gå tilbake til siden.
Webex-administratorer
Flytkonfigurasjon
Skjermpop
En «Skjermbilde»-node er tilgjengelig i Webex Contact Center Flow. Den kan brukes til å utløse et skjermbilde i Service Cloud Voice eller i et separat vindu.
Mer informasjon om denne funksjonen finner du i Flow Designer-dokumentasjonen .
Skjermbilde i et separat vindu
For å åpne skjermbildet i et separat vindu må en absolutt URL oppgis i noden «Skjermbilde». queryParameters vil bli lagt til som søkeparametere i URL-en.
Følgende moduser støttes:
- Ny nettleserfane – Åpner alltid en ny nettleserfane.
- Eksisterende nettleserfane – På det første skjermbildet Eksisterende nettleserfane åpnes en ny nettleserfane. Den fanen vil være den dedikerte fanen for påfølgende skjermbilder av eksisterende nettleserfaner, og URL-adressen vil bli oppdatert i den spesifikke nettleserfanen.
- Inne i skrivebordet – Håndteres på samme måte som Ny nettleserfane.
Siden som for øyeblikket er åpne, kan forhindre en omdirigering. I så fall åpnes et popup-skjermbilde for en eksisterende nettleserfane i en ny nettleserfane.





