- Start
- /
- Artikel
Webex Contact Center voor Salesforce Service Cloud Voice integreert Cisco de robuuste CCaaS (Contact Center as a Service) met de CRM van Salesforce, waardoor bedrijven omnichannel klantinteracties (spraak, digitaal) binnen de Salesforce-interface kunnen beheren, met behulp van Webex AI voor virtuele agenten, omzettingen en intelligente routering, waardoor agenten in superagenten met gebundelde data kunnen worden omgezet voor betere ervaringen van klanten.
Overzicht
Webex Contact Center voor Salesforce Service Cloud Voice
Webex Contact Center voor Service Cloud Voice is een out-of-the-box integratieoplossing die de kracht van Webex Contact Center brengt in de Salesforce Service Cloud Voice Omni-channel agentconsole.
Zie het volgende gedeelte voordat u verder gaat met de installatie:
Om te weten te komen over de voordelen en beperkingen van Salesforce Service Cloud Voice en om ervoor te zorgen dat uw Salesforce Org gereed is omWebex Contact Center voor het Service Cloud Voice-pakket in te schakelen en te installeren .
Pre-de-tijd en beperkingen
Pre-Den Haag (subonderwerp)
Gebruikersinterfaces: Service Cloud Voice is alleen beschikbaar in Salesforce Lightning Experience.
Service Cloud Voice is beschikbaar in deze edities.
- Onderneming
- Onbeperkt
- Ontwikkelaar
Licenties
-
Klanten moeten de nieuwe A-SF-VOICE-add-on licentie per aangemelde agent aanschaffen naast de Flex 3 Standard- of Premium-licentie voor Webex Contact Center. Zie voor meer informatie de Flex 3 bestelgids.
- Salesforce Voice voor Partner Telephony
Voordat u TURN op Spraak, moet u de vereiste services in uw organisatie instellen.
- Navigeer naar Bedrijfsgegevens > Machtigingenet-licentie
- Schakel het vakje in op Service Cloud Voice User (Partner Telephony).
Op alle Developer Editions zijn nu 5 Telefonielicenties voor partners beschikbaar voor tests.
- Schakel het vakje in op Service Cloud Voice User (Partner Telephony).
- U kunt dit ook verifiëren door naar Salesforce Setup te gaan en te zoeken naar "spraak" in de linker zijbalk.
- Als de tekst 'Partner Telephony Contact Centers' wordt weergegeven, hebt u de SCV-licentie.
- If "Partner Telephony Contact Centers" -optie is niet zichtbaar en selecteer "Service Cloud Voice inschakelen" door de onderstaande stappen te volgen.
- Ga naar Salesforce Setup, zoek en selecteer "Partner Telephony Setup" (Telefonie-partner instellen) en schakel de knop in om Service Cloud Voice in te schakelen.
- Schakel omni-channel in om uw agenten in staat te stellen oproepen te plaatsen en te ontvangen.
- Ga naar Salesforce Setup, zoek en selecteer "Partner Telephony Setup" (Telefonie-partner instellen) en schakel de knop in om Service Cloud Voice in te schakelen.
Omni-channel inschakelen
Als Omni-Channel al is ingeschakeld in uw organisatie, slaat u deze stap over.
- Voer bij Instellen Omni-channelinstellingen in het vak Snel zoeken in en selecteer Omni-channelinstellingen.


- Selecteer Omni-channel inschakelen.
- Klik op Opslaan.
Beperkingen
- Spraak is alleen beschikbaar in De Lightning Experience.
- Spraak wordt ondersteund op Service Cloud en Sales Cloud als add-on licentie.
- Spraak wordt niet ondersteund op Salesforce Mobile of iPad Safari.
- Spraak wordt alleen ondersteund door de webbrowsers Google Chrome, Microsoft Edge (Één dag) en Mozilla Firefox. Cookies moeten worden ingeschakeld om eenmalige aanmelding (SSO) toe te staan.
- Standaardnavigatie wordt niet ondersteund.
- Voor telefonie is strenge regelgeving, dus vraag uw Salesforce-vertegenwoordiger na over de beschikbaarheid van spraak in uw regio.
Raadpleeg de limieten en beperkingen van Service Cloud Voice en de installatie- en configuratiehandleiding.
Vereisten
Codes voor niet-actief
Inactieve codes zoeken
| 1 |
Meld u aan bij de Beheerportal. |
| 2 |
Navigeer naar Contact Center > DESKTOP EXPERIENCE > Idle/Afrondingscodes. |
| 3 |
Zorg ervoor dat de codes voor niet-actief worden weergegeven. Anders klikt u op de vervolgkeuzelijst filter en selecteert u boven aan de pagina de code voor Niet-actief. |
| 4 |
Klik op een code voor niet-actief om de detailweergave te openen. Daar vind je de Inactieve code ID.
De id's kunnen worden gekopieerd en vervolgens worden gebruikt voor de configuratie voor Het toewijzen van de Presence-status. Een van de id's moet worden gebruikt als standaardnummer Cisco reden niet gereed. |
INTEGREREN
Installatie
Voordat u verder gaat met de installatie, raadpleegt u Het gedeelte Pre-Ina en Beperkingen voor informatie over de pre-aan-werking en beperkingen van Salesforce Service Cloud.
Webex Contact Center installeren en configureren voor Service Cloud Voice
Wanneer een Service Cloud Voice for Partner Telephony-licentie is verkregen, wordt de pagina Telefonie-installatie partner weergegeven in het menu Instellen.
Meer informatie vindt u in de officiële referentie van Salesforce ( rechtstreekse link).
| 1 |
Voer
|
| 2 |
Schakel TURN in op Spraak met telefonie van partners. De pagina Contact Centers voor partnertelefonie wordt weergegeven in het menu Instellen .
Als u van plan bent om het pakket in een Salesforce-sandbox te implementeren, vervangt u het |
Het pakket installeren
Ga als volgende te werk om het pakket te installeren:
| 1 |
Open de meegeleverde koppeling van het pakket om de installatie te starten. |
| 2 |
Meld u aan bij de Salesforce organisatie waar het pakket moet worden geïnstalleerd. |
| 3 |
Kies in de installatiewizard de beveiligingsoptie "Alleen installeren voor beheerders" (1) en klik op Installeren (2). Bepaal welke gebruikers bepaalde machtigingen krijgen voor de objecten en componenten die worden geleverd bij de Webex Contact Center voor Het Service Cloud Voice-pakket. Geef ze ook deze bevoegdheden; de machtigingenets die worden geleverd bij de Webex Contact Center voor het pakket Service Cloud Voice, helpen dit proces. Wizard pakketinstallatie – Welkomstscherm verschijnt: |
| 4 |
Geef de volgende machtigingenets aan ten minste één gebruiker, zodat u het contactcentrum kunt maken:
|
| 5 |
Klik op Instellen | Gebruikers | Gebruikers. |
| 6 |
Een gebruiker zoeken en een gebruiker selecteren. |
| 7 |
Scroll naar beneden naar "Permission Set Assignments". |
| 8 |
Klik op Toewijzingen bewerken |
| 9 |
Voor contactcentrumbeheerders: wijs de machtigingenet Contact Center Admin (Telefonie partner) toe.
|
| 10 |
Voor agenten van contactcentra: wijs de machtigingenet voor contactcentrumagent (telefoniepartner) en Webex Contact Center SCV-machtigingenet toe.
Het is niet raadzaam de optie Installeren voor alle gebruikers te kiezen, omdat hiermee alle bevoegdheden (lezen, maken, bewerken en verwijderen) voor de pakketcomponenten en objecten worden verleend aan gebruikers die een aangepast gebruikersprofiel gebruiken. |
| 11 |
Wijs een pakketlicentie toe voor gebruikers om te werken met Connection voor Service Cloud Voice.
|
| 12 |
U kunt ook op Instellen | Gebruikers | Gebruikers.. |
| 13 |
Zoek en selecteer gebruiker. |
| 14 |
Scroll naar beneden naar Beheerde pakketten. |
| 15 |
Klik op Licenties toewijzen. |
| 16 |
Kies Webex Contact Center voor het pakket Service Cloud Voice uit de lijst. |
| 17 |
Klik op Toevoegen. |
| 18 |
Maak de Aanwezigheidsstatussen om te definiëren welke servicekanalen aan verschillende statussen worden toegewezen. Agenten kunnen zich bij Omni-Channel aanmelden met verschillende statussen, afhankelijk van het soort werk dat ze mogen ontvangen. |
| 19 |
Voer
|
| 20 |
Klik op Nieuw. Maak ten minste één status voor 'Online' en één status voor 'Bezet'.
|
De aanwezigheidsstatus(sen) toewijzen aan agenten
| 1 |
Typ vanuit Setup Machtigingenets in het vak Snel zoeken en selecteer vervolgens Machtigingenets. |
| 2 |
Klik hier om de Machtigingsset voor partnertelefonie te openen. |
| 3 |
Klik op Toegang Serviceaanwezigheid statussen. |
| 4 |
Klik op Bewerken. |
| 5 |
Selecteer in de lijst Beschikbare serviceaanwezigheidsstatus (sen) de eerder gemaakte aanwezigheidsstatus(sen) en klik op Toevoegen om deze te koppelen aan de machtigingenet. Agenten die zijn toegewezen aan deze machtigingenet, kunnen zich bij Omni-Channel aanmelden wanneer een van de aanwezigheidsstatussen voor hen beschikbaar zijn gesteld. |
| 6 |
Klik op Opslaan. |
| 7 |
Klik op Toewijzingen beheren op dezelfde pagina. Klik vervolgens op Opdracht toevoegen in de rechterbovenhoek, selecteer de gewenste gebruiker, klik op Volgende, selecteer een verloopoptie voor de toegewezen gebruikers (optioneel) en klik vervolgens op Toewijzen. Service Cloud Voice maakt gebruik van een extern domein voor het opnemen van het spraakoproeprecord. De volgende URL's moeten worden toegevoegd aan de "Instellingen externe site" in Setup ( klik hier om de officiële documentatie te openen):
Voorbeeld: instantie-URL vinden. |
| 8 |
Bekijk de URL in de adresbalk van de browser na het aanmelden. De instantie-URL is het gedeelte voorafgaand aan ".my.salesforce.com" of ".salesforce.com" of "lightning.force.com". Als uw URL bijvoorbeeld https://orgfarm-54a38e30ad-dev-ed.develop.my.salesforce-setup.com/ is, is "orgfahrt-54a38e30ad-dev-ed.develop" uw instantie-URL. Voorbeeld: Oorspronkelijke org-URL: https://cisco.lightning.force.com Voorbeeld: URL's die moeten worden toegevoegd:
|
| 9 |
Het omni-channel hulpprogramma is in de Lightning Service Console-app vereist voor het gebruik van Service Cloud Voice.
De officiële referentie van Salesforce is te vinden door op de knop Let's do this te klikken. Hiermee opent u de pagina Het configureren van agentervaring voor Service Cloud Voice met partnertelefonie in de Salesforce Help Portal ( directe koppeling). |
| 10 |
Voer bij Instellen in het vak Snel zoeken partnertelefonieinstelling in en selecteer Vervolgens Partnertelefonie instellen. |
| 11 |
Scroll naar sectie 5 Meer spraakinstellingen. |
| 12 |
Om click aan te nemen op Visualforce-pagina's met headers die zijn uitgeschakeld terwijl u met de softphone in Lightning Experience werkt, dient u naast de URL van Salesforce-instanties de domeinen en de aangepaste werkbalken als vertrouwde domeinen toe te voegen. Deze instellingen en de lijst Vertrouwde domeinen vindt u onder Instellingen | Beveiliging | Sessie-instellingen. Voor het ophalen van het juiste Visualforce-domein gaat u naar Setup | Aangepaste code | Visualforce-pagina's en klik op de knop Voorbeeld voor Voorbeeld: Mijndomeinnaam--cisco_wxcc_scv.vf.force.com Om het Salesforce Instance-domein te verkrijgen, kopieert u de URL die in de URL-balk van de browser wordt weergegeven en voegt u deze toe aan de lijst Vertrouwde domeinen voor inline frames die Visualforce-pagina's selecteren als IFrame-type. Voorbeeld: MyDomainName.lightning.force.com
Als u geen Mijn domein in uw organisatie hebt geïmplementeerd, is uw URL-indeling anders. Als u een Mijn domein geïmplementeerd hebt en uitgebreide domeinen niet zijn ingeschakeld in uw organisatie, is uw URL-indeling anders. Als uitgebreide domeinen niet zijn ingeschakeld, is de URL's van In Enen in Visualforce, Experience Builder, Site.com studio en inhoudsbestanden Mijn domein ook van invloed op deze indeling. Zie URL-indelingen van Mijn domein in Salesforce Help voor meer informatie. Klik op de instellingen Click aan de bescherming en vertrouwde domeinen voor De Ervaring van Lightning
|
| 13 |
Om de opnameknoppen tijdens gesprekken weer te kunnen geven, hebben agenten de Om deze toe te wijzen, voegt u de gebruiker toe aan de machtigingenet die in de stap Presence-statussen is gemaakt.
|
Configuratie
Contactcenter
Een contactcentrumdefinitiebestand geeft een reeks velden en waarden aan die worden gebruikt om een contactcenter in Salesforce te definiëren voor een bepaald CTI-systeem. Salesforce gebruikt Contact Center definitie bestanden om de integratie met meerdere CTI systeem leveranciers te ondersteunen.
Contactcenter importeren
| 1 |
Voer bij het instellen partnertelefoniecontactcenters in het vak Snel zoeken in en selecteer vervolgens Contactcenters voor Partnertelefonie. De lijst met bestaande (indien van toepassing) contactcentra wordt weergegeven.
|
| 2 |
Klik op Contactcentrum maken aan de rechterkant van de pagina. |
| 3 |
Selecteer Webex Contact Center als telefonieprovider. Klik vervolgens op Volgende.
Er wordt een bestandsbrowser geopend.
|
| 4 |
Selecteer het |
| 5 |
Klik op Openen. Het bestand wordt geïmporteerd.
|
| 6 |
Controleer of uw contactcenter in de lijstweergave contactcenters wordt weergegeven.
|
Contact center configureren
| 1 |
Voer bij het instellen partnertelefoniecontactcenters in het vak Snel zoeken in en selecteer vervolgens Contactcenters voor Partnertelefonie. | ||||||||||||||||||||||||||||||
| 2 |
Klik op het contactcentrum dat eerder geïmporteerd is. | ||||||||||||||||||||||||||||||
| 3 |
Klik op Bewerken.
| ||||||||||||||||||||||||||||||
| 4 |
Klik onder aan de pagina Contactcentrum op de knop Toevoegen onder het gedeelte Gebruikers van contactcentrum. | ||||||||||||||||||||||||||||||
| 5 |
Klik op + naast de gebruikers die toegang hebben tot het geopende contactcentrum. Alleen gebruikers met |
Aanpassen
Externe client-toepassing voor Webex Contact Center-integratie
Configureer de externe client-app voor Webex Contact Center Salesforce Connector
Om Service Cloud Voice volledig te gebruiken, kan de Contact Center-gespreksstroom worden aangepast om de spraakopname te maken en een Salesforce Omni-Channel-flow uit te voeren terwijl het gesprek op de IVR is.
Certificaat maken
Controleer of u al een digitaal certificaat hebt opgesteld volgens het beveiligingsbeleid van uw organisatie.
Voor het genereren van een digitaal certificaat kunt u de Salesforce-documentatie raadplegen op https://developer.salesforce.com/docs/atlas.en-us.voice_pt_developer_guide.meta/voice_pt_developer_guide/voice_pt_generate_certificate.htm.
Voorbeeld
openssl genrsa -des3 -passout pass:<password> -uit server.pass.key 2048 openssl RSA -passin passin pass:<password> -in server.pass.key -uit server.key rm server.pass.key openssl req -new -key server.key-out server.CSR Landnaam (2 letter code) [AU]:CH Staat of Provincienaam (volledige naam) [Sommige-staat]: Locatienaam (bijv. plaats) []: Organisatienaam (bijv. bedrijf) [Internet Widgits Pty Ltd]: Naam organisatie-eenheid (bijv. sectie) []: Algemene naam (bijv. server FQDN of UW naam) []: E-mailadres []: my-api-user@my-example-org.com Voer de volgende 'extra' attributen in die met uw certificaatverzoek moeten worden verzonden Een uitdagingswachtwoord []:<password> Een optionele bedrijfsnaam []: openssl x509 -req -sha256 -dagen 365 -in server.CSR -signkey server.key -uit server.crt
server.crt => Certificate for the Salesforce External Client App
server.key => privésleutel voor de Salesforce Connector in Webex Control Hub
Machtigingen ingesteld voor de SCV-integratiegebruiker
De volgende machtigingenet verleent toegang tot Apex-klassen die door Connects voor SCV worden gebruikt voor de integratie met Contact Center IVR stromen en Webex Contact Center voor Salesforce voor SCV.
Hieronder volgt een voorbeeldconfiguratie en worden de minimaal vereiste machtigingen voor contactcentrum/ IVR-integratie beschreven.
- Navigeer vanuit Setup naar Gebruikers | Machtigingenets.
- Klik op de knop Nieuw .
- Voer een label in, bijvoorbeeld: IVR Toegang tot SCV Apex Classes
- API Naam wordt automatisch ingevuld
- Licentie: Geen
- Klik op De knop Opslaan .
- De nieuwe Machtigingenet wordt geopend.
- Navigeer naar Apex Class Access.
- Klik op de knop Bewerken en voeg de volgende Apex-klassen toe:
- cisco_wxcc_scv. ServiceRouting
- Navigeer naar Systeemmachtigingen.
- Klik op bewerken en schakel de volgende machtigingen in:
- Apex REST Services
- API ingeschakeld
Minimale toegang - profiel API alleen integratie
Dit profiel wordt gebruikt voor de integratie met Webex Contact Center voor Salesforce voor SCV om spraakoproepenrecords te maken en omni-flow uit te voeren vanuit de IVR-flow.
Hieronder ziet u een voorbeeldconfiguratie en worden de minimaal vereiste machtigingen voor contactcentrum/ IVR-integratie beschreven.
Dit is een kloon uit het profiel Minimale toegang - API Alleen integraties.
- Navigeer vanuit Setup naar Gebruikers | Profielen.
- Zoek in de lijst Profielen naar het veld Minimale toegang profiel - API Alleen integraties.
- Klik op de profielnaam om het profiel API Alleen integraties te openen.
- Klik bij Minimale toegang - API alleen integraties , op de knop Klonen .
- Voer een nieuwe profielnaam in, bijvoorbeeld: SCV Integration.
- Klik op de knop Opslaan .
- Het nieuwe profiel wordt geopend.
- Controleer of bij uw minimale toegang – API alleen integraties alle machtigingen uit het profiel zelf zijn verwijderd.
- Navigeer naar Systeemmachtigingen.
- Zorg dat de volgende machtigingen zijn ingeschakeld:
- API ingeschakeld
- API Alleen gebruiker
SCV-integratie-gebruiker
Hieronder volgt een voorbeeldconfiguratie en worden de minimaal vereiste machtigingen voor contactcentrum/ IVR-integratie beschreven. Er is geen Salesforce Service Cloud Voice-licentie of Webex Contact Center voor Salesforce voor SCV-licentie nodig voor de SCV Integration-gebruiker.
- Navigeer vanuit Setup naar Gebruikers | Gebruikers.
- Klik op de knop Nieuwe gebruiker .
- Voer de voornaam, achternaam en alle andere verplichte velden in.
- Gebruikerslicentie: Salesforce-integratie
- Profiel: selecteer het profiel dat bij de vorige stap is gemaakt ("SCV-integratieprofiel", klonen van Minimale toegang - API Alleen integraties-profiel)
- Klik op de knop Opslaan .
- Het record van de nieuwe gebruiker openen.
- Wijs de Machtigingenet toe die eerder is gemaakt ("IVR Toegang tot SCV Apex-klassen").
- Wijs de Permission Set license Salesforce API Integration toe.
De Salesforce Externe client app maken
Een nieuwe externe client-toepassing maken
Er zijn twee opties om uw Salesforce-gegevens te koppelen met applicaties van derden. Zowel Connected Apps als External Client Apps zijn raamwerken voor de integratie van gegevens. Externe client-apps zijn de volgende generatie verbonden apps.
Ga als volgt te werk om de Salesforce External Client App die door Cisco Webex Contact Center wordt gebruikt, te configureren:
- Navigeer vanuit Setup naar Apps | Externe client-toepassingen | Extern client-appbeheer.
- Klik op Nieuwe externe client-toepassing.
- Externe client-toepassing: Basisinformatie
- Naam externe client-toepassing: WxCC - SCV
- API Naam: WxCC_SCV
- E-mail contactpersoon: < uw e-mail>
- Verdelingsstatus: selecteer Lokaal

Externe client-toepassing—API (OAuth-instellingen inschakelen)
- Selecteer: OAuth inschakelen
- App-instellingen
- Terugbel-URL: http://localhost:1717/OauthRedirect als voorbeeld van terugbel-URL
- OAuth-bereik
- Selecteer OAuth-bereik:
- Gebruikersgegevens beheren via API's (API)
- Verzoeken op elk gewenst moment uitvoeren (refresh_token, offline_access)

Flow Enablement
- Selecteer: JWT Bearer flow inschakelen
- Klik op Bestanden uploaden en upload het
bestand server.crtdat uw digitale certificaat bevat.

Beveiliging
Schakel het selectievakje Vereist geheim voor de optie Webserverstroom uit.

- Klik op De knop Maken .
- Wijzig de Tab Policies (beleid Tab ) en klik vervolgens op Bewerken .
- Beleid— OAuth-beleid
- Beleid voor invoegtoepassingen
- Toegestane gebruikers: selecteer Door De beheerder goedgekeurde gebruikers zijn vooraf geautoriseerd
- De wijziging bevestigen
- App-autorisatie
- Beleid voor Token vernieuwen: selecteer Direct verlopen, vernieuwingstoken
- IP Ontspanning: selecteer beperkingen van IP afdwingen

- Beleid voor invoegtoepassingen
- Beleid- App-beleid
- Startpagina: geen
- Selecteer Machtigingenets: wijs de Machtigingenset toe die eerder is gemaakt ("IVR Toegang tot SCV Apex Classes")

- Klik op Opslaan.
- Wijzig de status Tab Instellingen.
-
Sectie OAuth-instellingen, klik op de knop Consumentensleutel en geheim ; wacht op e-mail en verifieer uw identiteit. In de nieuwe browser Tab wordt een scherm met gegevens van de consument geopend.

- Klik op De consumentensleutel kopiëren en opslaan. De consumer key wordt later gebruikt voor het creëren van de Salesforce Connector op Webex Contact Center Control Hub.

-
Webex Contact Center-configuratie en script om records van spraakoproepen te maken
Om de volledige waarde van Salesforce Service Cloud Voice te verkrijgen, moet de gespreksstroom in Webex Contact Center worden aangepast om het spraakgesprek op te nemen in Service Cloud Voice zodra het gesprek in het contact center binnenkomt.
Voor routing-beslissingen en automatisering in Salesforce kan een optionele Omni-Flow worden uitgevoerd.
Raadpleeg Service Cloud Voice API Wrapper voor meer informatie over de gebruikte API's.
Pre-Ina
Om Service Cloud Voice API Wrapper te kunnen gebruiken, moet er een Salesforce External Client App voor IVR-integratie zijn geconfigureerd.
De Salesforce Connector in Webex Control Hub configureren
Configureer de Salesforce Integration Connectors voor Webex Contact Center zoals wordt beschreven in het artikel bij https://help.webex.com/en-us/article/7fuy63/SetUp-Integration-Connectors-for-Webex-Contact-Center#id_133211.
| 1 |
Meld u aan bij uw klantorganisatie op nummer https://admin.webex.com en ga naar Services > Contact center > Tenantinstellingen > Integrations>Connectors. |
| 2 |
Klik op de Salesforce-kaart op Connector instellen of Toevoegen.
BELANGRIJK: DE BEVEILIGING IN STAND HOUDEN DOOR REGELMATIG ROTERENDE GEHEIMEN Zorg ervoor dat u regelmatig de privésleutel en het certificaat roteert om de integratie veilig te houden. Werk de Private Key in de Contact Center Connector in Webex Hub en het certificaat in de Externe Client app in Salesforce bij. Tip voor het oplossen van problemen Als u op Gereed hebt geklikt en de connector niet wordt opgeslagen:
|
Webex Contact Center Hoofdstroom
| Stroomvariabele | Beschrijving |
|---|---|
| Stroomvariabele voor opnemen van spraakgesprekken ID | Uniek ID om de oproep te identificeren. Vereist voor het maken van de opname van het spraakgesprek. Indeling: wxcc_<Interaction ID> Voorbeeld: wxcc_fc4ec7d8-4c91-49aa-b764-081fbba344a8
|
| Lokale variabele voor de begintijd van het gesprek |
Wordt gebruikt voor het maken van een opname voor het spraakgesprek en bij het bijwerken van het spraakgesprek.
|
| Lokale variabele voor wachtrijnaam/ID |
Geretourneerd door Omni Flow uitvoeren, gebruikt voor oproeproutering. Deze variabele is alleen vereist bij het gebruik van Omni-flow uitvoeren
|
| Lokale variabele voor agentnaam/ID |
Geretourneerd door Omni Flow uitvoeren, gebruikt voor oproeproutering. Deze variabele is alleen vereist bij het gebruik van Omni-flow uitvoeren
|
Overzicht van hoofdstroom

- Sleutel leveranciersoproepen genereren
- Begintijd gesprek instellen
- HTTP-verzoek: Spraakoproepenrecord maken
- HTTP-reactie evalueren voor het maken van spraakoproepenrecord
- Fout tijdens verwerking voor opname spraakoproepen maken
- HTTP-verzoek: Omni-flow uitvoeren
- HTTP-reactie evalueren voor omni-flow uitvoeren
- Fout bij verwerking voor Omni-flow uitvoeren
- Gespreksroutering voortzetten
| Stroom | Beschrijving |
|---|---|
| Sleutel leveranciersoproepen genereren |
Elke oproep die in Service Cloud Voice wordt afgehandeld, maakt een spraakoproepenrecord in Salesforce aan en vereist een uniek ID, genaamd Vendor Call Key. Voor spraakoproepenrecords die zijn gemaakt in Webex Contact Center, moet de Sleutel leveranciersgesprek worden gedefinieerd in de WxCC-flow en vervolgens samen met het gesprek worden doorgegeven aan de agent op basis van een stroomvariabele. De vendorCallKey-waarde moet voldoen aan de volgende regels:
|
| Begintijd gesprek instellen |
UTC-tijdstempel van de begintijd van het gesprek. Dit tijdstempel wordt gebruikt om de spraakoproeprecord te maken en de record van het spraakgesprek bij te werken als de beller ophangt voordat deze naar de agent wordt gerouteerd.
|
| HTTP-verzoek: Spraakoproepenrecord maken |
Deze stap is voor elk gesprek vereist. Nadat de record van de spraakoproepen is gemaakt, moet de record van de spraakoproepen ID het gesprek worden doorgegeven aan de agent in een variabele, samen met de vendor call key. Configureer de gebruikte variabele in de Contact Center-configuratie in Service Cloud Voice. |
| Instellingen HTTP-verzoeken |
|
HTTP-verzoek: Spraakoproepenrecord maken
Deze stap is voor elk gesprek vereist. Nadat de record voor het spraakgesprek is gemaakt, moet de record ID van de spraakoproepen worden doorgegeven aan de agent in een variabele, samen met de gesprekssleutel van de leverancier. Configureer de gebruikte variabele in de Contact Center-configuratie in Service Cloud Voice.
Instellingen HTTP-verzoeken
- Activiteitslabel: CreateVoiceCall
- Geverifieerd eindpunt gebruiken: ingeschakeld
- Connector: Salesforce Connector die in de vorige stap is gemaakt
- Verzoekpad:
/services/apexrest/cisco_wxcc_scv/spraak/v1/createVoiceCall - Methode: POST
- Inhoudstype aanvraag: Toepassing/JSON
Body verzoek
Als u een record voor het spraakgesprek maakt, kunt u ook de aangepaste velden in de record van het spraakgesprek bijwerken met gespreksgegevens. Hieronder ziet u twee voorbeelden van de berichttekst van de aanvraag, één met alle vereiste velden maar zonder aangepaste velden bij te werken en één met aangepaste velden.
Zonder aangepaste velden voor het opnemen van spraakgesprekken bij te werken:
{ "callCenterDevName": "<Contact Center API name>", "certDevName": "<cert dev name>", "vendorCallKey": "{SCV_VendorCallKey}}", "to": "{NewPhoneContact.DNIS}}", "from": "{{NewPhoneContact.ANI}}", "initiationMethod": "Inbound", "startTime": "{SCV_CallStartTime}}", "participants": [ { "participantKey": "{NewPhoneContact.ANI}}", "type" : "END_USER" } ] }
Voorbeeld voor het bijwerken van aangepaste velden voor het opnemen van spraakoproepen:
{ "callCenterDevName": "<Contact Center API name>", "certDevName": "<cert dev name>", "vendorCallKey": "{SCV_VendorCallKey}}", "to": "{NewPhoneContact.DNIS}}", "from": "{{NewPhoneContact.ANI}}", "initiationMethod": "Inbound", "startTime": "{SCV_CallStartTime}}", "participants": [ { "participantKey": "{NewPhoneContact.ANI}}", "type" : "END_USER" } ], "callAttributes": "{\"custfield1__c\": \"<value1>\",\"custfield2__c\": \"custfield1__c\". <waarde2>\",\" custfield3__c\": \"<waarde3>\"}" }
Parameters
| Naam van eigenschap | Waarde |
|---|---|
| callCenterDevName | Naam contactcenter-ontwikkelaar |
| certDevName | API Naam van certificaat (zoals geconfigureerd in Contact Center) |
| vendorCallKey | Unieke oproep ID: {SCV_VendorCallKey}}
|
| naar | GebeldNummer/DNIS: {NewPhoneContact.DNIS}}
|
| van | Bellend nummer/ANI: {{NewPhoneContact.ANI}}
|
| beginTijd | UTC timestamp {{SCV_CallStartTime}} (direct instellen nadat het gesprek in het script is geaccepteerd) |
| callAttributen |
Geeft de aanvullende standaard- en aangepaste velden weer voor het opnemen van spraakoproepen, waarbij elk sleutelwaardepaar overeenkomt met een standaard of aangepast veld en de waarden daarvan. Voorbeeld:
|
Instellingen ontleed
- Inhoudstype: JSON
- Uitvoervariabele: SCV_VoiceCallRecordId
- Path Expressie:
$.data.voiceCallId
Opname spraakoproepen ID, die aan de agent moet worden doorgegeven.
HTTP-reactie evalueren voor het maken van spraakoproepenrecord
Controleer de HTTP-status van het http-verzoek spraakoproepen maken:
- Label: statusCodeCreateVoiceCall
- Variabele: CreateVoiceCall.httpStatusCode
Als statuscode == 200 => geslaagd, anders => aanvraag is mislukt, fout verwerking
Fout tijdens verwerking voor opname spraakoproepen maken
Speel een bericht af afhankelijk van de http-statuscode voor demo's of foutopsporing.
Als Het maken van spraakoproepen is geslaagd, gaat u verder met Omni Flow uitvoeren. Anders gaat u verder met de gespreksroutering.
HTTP-verzoek: Omni-flow uitvoeren (optionele stap)
Gebruik de Omni-Flow uitvoeren als u:
- Automatische taken uitvoeren, bijvoorbeeld records zoeken of maken, en records koppelen aan het opnemen van spraakgesprekken
- Zoeken naar records en screen-pop-up uitvoeren
- salesforce- en Cisco-wachtrijen synchroniseren
- Service Cloud Voice de routeringsbeslissing laten maken
Met deze aanvraag wordt altijd de 'wachtrij' of 'agent' teruggestuurd waarnaar het gesprek moet worden gerouteerd.
Zorg dat u na het uitvoeren van dit verzoek een wisroutering verzendt als de beller ophangt voordat hij of zij wordt beantwoord door een agent. Zie Webex Contact Center Gebeurtenisstroom.
Instellingen HTTP-verzoeken
- Activiteitslabel: ExecuteOmniFlow
- Geverifieerd eindpunt gebruiken: ingeschakeld
- Connector: Salesforce Connector die in de vorige stap is gemaakt
- Verzoekpad:
/services/apexrest/cisco_wxcc_scv/voice/v1/executeOmniFlow - Methode: POST
- Inhoudstype aanvraag: Toepassing/JSON
Body verzoek
Naast de vereiste velden, kunt u extra gegevens als invoervariabelen doorgeven aan de omni-flow. Hieronder staan twee voorbeelden van de berichttekst van het verzoek. Eerst zonder aanvullende stroomparameters, alleen vereiste velden, de tweede met twee invoervariabelen.
Voorbeeld met Omni-Flow-parameters:
{ "callCenterDevName": "<ContactCenter API naam>", "certDevName": "<cert dev name>", "voiceCallId": "{SCV_VoiceCallRecordId}}", "dialedNumber": "{NewPhoneContact.DNIS}}", "flowDevName": "<flow API name>", "fallbackQueue": "<backwachtrij naam>" }
Voorbeeld bij het bijwerken van de aangepaste velden voor het opnemen van spraakoproepen:
{ "callCenterDevName": "<Contact Center API name>", "certDevName": "<cert dev name>", "voiceCallId": "{SCV_VoiceCallRecordId}}", "dialedNumber": "{NewPhoneContact.DNIS}", "flowDevName": "<flow API name>", "fallbackQueue": "<fallback queue name>", "flowInputParameters": { "param1": "value1", "param2": "value2" }
Parameters
| Naam van eigenschap | Waarde |
|---|---|
| callCenterDevName | Naam contactcenter-ontwikkelaar |
| certDevName | API Naam van certificaat (zoals geconfigureerd in Contact Center) |
| spraakOproepId | ID van de record voor spraakgesprekken, gemaakt in de vorige stap: {{SCV_VoiceCallRecordId}}
|
| gekozenNummer | GebeldNummer/DNIS: {NewPhoneContact.DNIS}}
|
| flowDevName | Naam ontwikkelaar van de Omni-Flow die moet worden uitgevoerd |
| terugvalwachtrij | Wachtrij ID of Wachtrij API naam van de salesforce-wachtrij |
| flowInputParameters |
Extra ingangen voor de omni-channel flow (sleutel-waardepaar). Voorbeeld:
|
Instellingen ontleed
Wachtrij
- Inhoudstype: JSON
- Uitvoervariabele: SCV_OmniFlowQueue
- Padexpressie:
$.data.queue
"Wachtrij" die wordt geretourneerd van omni-flow uitvoeren kan voor routering worden gebruikt.
Agent- Inhoudstype: JSON
- Uitvoervariabele: SCV_OmniFlowAgent
- Padexpressie:
$.data.agent
"Agent" die wordt geretourneerd van Omni-Flow uitvoeren, kan voor routering worden gebruikt.
HTTP-reactie evalueren voor omni-flow uitvoeren
Controleer de HTTP-status van het Omni Flow-http-verzoek uitvoeren:
- Label: statusCodeExecuteOmniFlow
- Variabele: ExecuteOmniFlow.httpStatusCode
Als statuscode == 200 => geslaagd, anders => aanvraag is mislukt, foutverwerking.
Fout bij verwerking voor Omni-flow uitvoeren
Speel een bericht af afhankelijk van de http-statuscode voor demo's of foutopsporing.
Als het uitvoeren van Omni Flow met succes is uitgevoerd, worden variabelen SCV_OmniFlowQueue en SCV_OmniFlowAgent niet ingesteld. Routeringsbeslissing in gespreksstroom.
Gespreksroutering voortzetten
Ga verder in gespreksstroom en routeer gesprek naar agent. Optioneel, gebruikt u SCV_OmniFlowQueue en SCV_OmniFlowAgent om wachtrij en agent te selecteren.
Webex Contact Center gebeurtenisstroom
Als de beller het gesprek beëindigt voordat het door een agent wordt beantwoord, moeten we Service Cloud Voice bijwerken en de oproep beëindigen.
- Als Omni-Flow uitvoeren wordt gebruikt, verzendt u Wis-routering om de PSR (Pending Service Routing) te verwijderen
- De spraakoproep bijwerken om de begin- en eindtijd van de opname van het spraakgesprek bij te werken en de status te wijzigen van Nieuw in Voltooid

- PhoneContactEnded: deze gebeurtenis wordt geactiveerd wanneer de verbinding wordt verbroken en alle deelnemers worden verwijderd.
- HTTP-verzoek: Routering wissen
- HTTP-verzoek: Spraakoproep bijwerken
HTTP-verzoek: Routering wissen
- Label: ClearRouting
- Geverifieerd eindpunt gebruiken: ingeschakeld
- Connector: Salesforce Connector die in de vorige stap is gemaakt
- Verzoekpad:
/services/apexrest/cisco_wxcc_scv/spraak/v1/clearRouting - Methode: POST
Inhoudstype aanvraag: Toepassing/JSON
Body verzoek
{ "callCenterDevName": "<Contact Center API name>", "certDevName": "<cert dev name>", "voiceCallId": "{{SCV_VoiceCallRecordId}}" }
Parameters
| Naam van eigenschap | Waarde |
|---|---|
| callCenterDevName | Naam contactcenter-ontwikkelaar |
| certDevName | API Naam van certificaat (zoals geconfigureerd in Contact Center) |
| spraakOproepId | ID van de record voor spraakgesprekken, gemaakt in de vorige stap: SCV_VoiceCallRecordId |
Instellingen ontleed
Geen.
HTTP-verzoek: Spraakoproep bijwerken
- Label: UpdateVoiceCall
- Geverifieerd eindpunt gebruiken: ingeschakeld
- Connector: Salesforce Connector die in de vorige stap is gemaakt
- Verzoekpad:
/services/apexrest/cisco_wxcc_scv/spraak/v1/updateOproep - Methode: POST
- Inhoudstype aanvraag: Toepassing/JSON
Body verzoek
{ "callCenterDevName": "<Contact Center API name>", "certDevName": "<cert dev name>", "voiceCallId": "{SCV_VoiceCallRecordId}}", "startTime": "{SCV_CallStartTime}}", "endTime": "{{now() | replace({'[UTC]': ''})}", "disconnectReden": { "value": "Abandoned in queue", "isError": true } }
Parameters
| Naam van eigenschap | Waarde |
|---|---|
| callCenterDevName | Naam contactcenter-ontwikkelaar |
| certDevName | API Naam van certificaat (zoals geconfigureerd in Contact Center) |
| spraakOproepId | ID van de record voor spraakgesprekken, gemaakt in de vorige stap: SCV_VoiceCallRecordId |
| beginTijd | UTC-tijdstempel van het starten van gesprek{{SCV_CallStartTime}} (zoals gebruikt voor het maken van het spraakgespreksrecord) |
| eindtijd | Huidige UTC-tijdstempel '{now() |
| Verbinding verbrekenReden | Reden voor de verbinding met de verbinding. De eigenschap isError moet worden ingesteld op waar voor een correcte weergave. |
Instellingen ontleed
Geen.
Verwijzingen
- Een privésleutel en een zelf ondertekend digitaal certificaat maken
- Verbonden app configureren voor Webex Contact Center Salesforce Connector
- Integratie-connectors instellen voor Webex Contact Center - Salesforce
- Installatie- en beheerhandleiding > Cisco Webex Contact Center Flow Designer
- Telephony Integration REST API
Taalvertaling
(Optioneel) Vertaalwerkbank inschakelen
Deze instelling is alleen van toepassing als u instellingen voor vertaaltaal gebruikt.
| 1 |
Ga naar → werkbank voor vertaling → instellen. |
| 2 |
Klik op Inschakelen om een vertaaltaal te selecteren.
|
(Optioneel) Alleen platformtalen inschakelen
Deze instelling is alleen van toepassing op andere talen dan EN-US.
| 1 |
Ga naar → Bedrijfsinstellingen → Taalinstellingen instellen. |
| 2 |
Kies de vereiste talen. |
| 3 |
Schakel de volgende selectievakjes in:
|
| 4 |
Sla uw wijzigingen op.
|
De taal activeren en de gebruiker selecteren (taak)
| 1 |
Ga naar → werkbank voor vertaling → instellen. |
| 2 |
Kies de taal en selecteer de gebruiker die deze wil vertalen. |
| 3 |
Sla uw wijzigingen op.
|
Instellingen voor meerdere talen
Aangepaste labels vertalen
| 1 |
Ga naar Aangepaste labels → instellen. |
| 2 |
Selecteer de naam van het aangepaste label dat u wilt openen.
|
| 3 |
Klik in de lijst gerelateerde vertalingen op |
| 4 |
Selecteer de taal waarnaar u vertaalt.
|
| 5 |
Voer in het veld Tekst omzetten de vertaalde waarde in. Deze tekst overschrijft de waarde die in het veld Waarde van het label is opgegeven als de standaardtaal van de gebruiker de vertaling is. |
| 6 |
Sla uw wijzigingen op. |
Salesforce-machtigingen vereist door gebruikersfunctie
De machtigingenet Webex Contact Center SCV-agent bevat alle machtigingen die vereist zijn om te werken met de gadget Webex Contact Center en de integraties die voor agenten zijn ontwikkeld.
Toegang tot Apex Class (sectie)
- cisco_wxcc_scv. CiscoScvWxcc
- cisco_wxcc_scv. ServiceResponseHandler
- cisco_wxcc_scv. ServiceRouting
- cisco_wxcc_scv. TelefonieIntegrationHandler
Toegangen aangepast metagegevenstype (sectie)
- cisco_wxcc_scv. WxCC-verbinding
Visualforce Page Access (sectie)
- cisco_wxcc_scv. CiscoScvAanmeldenWxCC
- cisco_wxcc_scv. CiscoScvMainWxCC
- cisco_wxcc_scv. CiscoScvOAuthRedirect
- cisco_wxcc_scv. CiscoScvSwLader
Service Cloud Voice API Wrapper
Pre-Ina
Om Service Cloud Voice API Wrapper te kunnen gebruiken, moet er een Salesforce External Client app voor IVR integratie zijn geconfigureerd.
Gebruik de Service Cloud Voice API Wrapr
Service Cloud Voice (SCV) voor Salesforce maakt gebruik van Telephony Integration REST API om spraakoproepen te maken en bij te werken, omni-channel stromen uit te voeren en records van In behandelingServiceRouting te verwijderen die samenhangen met een voicecall. Voor deze service is JWT-autorisatie vereist en het gebruik van de PATCH HTTP-methode, die momenteel niet wordt ondersteund door Cisco IP Interactive Voice Response (IVR).
Om het gebruik van de Telephony Integration REST API voor SCV in (niet alleen) een IVR-systeem te vereenvoudigen, is een nieuwe set API's beschikbaar gesteld die de bestaande Salesforce API omwikkelen en rechtstreeks toegankelijk zijn vanuit de Salesforce Org waar het Webex Contact Center voor Service Cloud Voice is geïnstalleerd.
Service Cloud Voice API Wrapper verwijdert de noodzaak van het verifiëren van een JWT-token, implementeert aanvullende controles op de gegevens die nodig zijn voor de Salesforce API en verbetert de antwoordobjecten.
De Access_Token ophalen
EenPOST aanvraag uitvoeren naar https://<your-domain-name>.my.salesforce.com/services/oauth2/token
De volgende parameters worden in de berichttekst verzonden:
{ "grant_type": "client_credentials", "client_id": "<consumersleutel van de verbonden app>", "client_secret": "<consumer van de verbonden app>" } Als de aanvraag is geslaagd, wordt het volgende JSON-antwoord geretourneerd: { "access_token": "<our-access-token>", "instance_url": "<your-org-base-url>", "ID": "https://login.salesforce.com/id/<id>/<id>", "token_type": "Bearer", "issued_at": "<timestamp>", "signature": "<unique-signature-code>" }
De verzoeken uitvoeren
De instantie-URL moet my.salesforce.com bevatten.
Voorbeeld van een juiste url van een correct exemplaar: https://abc-123.my.salesforce.com
Als u een ander domein gebruikt als instance-URL (d.e. https://abc-123.lightning.force.com ) resulteert in een 401 niet-geautoriseerde status met een INVALID_SESSION_ID foutmeldingCode geretourneerd.
Spraakoproep maken (sectie)
Maakt een spraakoproeprecord met de deelnemers (dat wil gezegd de beller en de ontvanger) voor de opname van het spraakoproepgesprek. Wanneer u een VoiceCall-record maakt, wordt er een gesprek tot stand gebracht in Salesforce. Gebruik deze API alleen in een real-time context. Dit betekent dat u deze API alleen kunt aanroepen wanneer een gesprek wordt gestart. Deze API kan ook worden gebruikt om spraakoproepenrecords voor doorverbinden en telefonische vergaderingen te maken door de parameter parentVoiceCallId in het verzoek en doorverbinden op te nemen.
Eindpunt URI
<instance_url>/services/apexrest/cisco_wxcc_scv/spraak/v1/createVoiceCall
HTTP-methode
POST
Headers
Autorisatie: Drager <access_token>
Inhoud-Type: toepassing/json
Parameters
{ "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-56g44 aan 24ew", "callOrigin": "Preview", "queue": "queue123" }
Reactie (geslaagd)
{ "data": { "voiceCallId": "00X000012345abc" }, "errors": null, "success": true }
Reactie (met fouten)
{ "data": null, "errors": ["Foutmelding 1", "Foutmelding 2"], "succes": onwaar }
Spraakoproep bijwerken
Hiermee werkt u het spraakgesprek bij nadat het gesprek is beëindigd. Gebruik deze API om parameters bij te werken die niet beschikbaar zijn tijdens het maken van een spraakoproep. Het bijwerken van Spraakoproep API is een asynchrone bewerking. U kunt de status van API-gesprek niet opvragen.
Dit eindpunt kan ook worden gebruikt om een VoiceCall op te zetten nadat de oproep is beëindigd. Dit gedrag is handig in scenario's waarbij u een record in Salesforce wilt vastleggen voor verlaten of gemiste oproepen, of voor elk ander scenario waarbij een voicecall nog niet is gemaakt.
Eindpunt URI
<instance_url>/services/apexrest/cisco_wxcc_scv/voice/v1/updateVoiceCall
HTTP-methode
POST
Headers
Autorisatie: Drager <access_token>
Inhoud-Type: toepassing/json
Parameters
{ "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\":\"overige waarde\}", "disconnectReden": { "value": "TELECOM_PROBLEM", "isError": true }
Een uitgebreide beschrijving van de parameters die in dit verzoek worden geaccepteerd, vindt u in de officiële documentatie van Salesforce onder de sectie "Parameters".
Reactie (geslaagd)
{ "data": { "status": "in behandeling" }, "errors": null, "success": true }
Het bijwerken van Spraakoproep API is een asynchrone bewerking. U kunt de status van gesprek met API niet opvragen.
Reactie (met fouten)
{ "data": null, "errors": ["Foutmelding 1", "Foutmelding 2"], "succes": onwaar }
Omni-flow uitvoeren
Voert de omni-channelstroom uit om gesprekken te routeren. Deze geeft de oproep ID (Salesforce VoiceCallId of ContactId telefonieleverancier) door als parameters voor de stroom en retourneert de agent- of wachtrijrouteringsinstructies naar de contactstroom. Service Cloud Voice maakt standaard gebruik van de omni-channelstroom (of terugvalwachtrij) die is opgegeven voor het telefoonkanaal dat overeenkomt met het gekozen nummer. Als het gekozen nummer niet overeenkomt met een bestaand telefoonkanaal, kunt u optioneel een nieuw gekozen nummer, een omni-channelstroom en een terugvalwachtrij instellen als invoerparameters voor dit gesprek nr API.
Service Cloud Voice gebruikt deze prioriteitsvolgorde om gesprekken te routeren:
- Gebruikt de instellingen voor de omni-channelstroom en terugvalwachtrij voor het telefoonkanaal dat overeenkomt met het gekozen nummer. De stroom krijgt voorrang. Als de stroom wegvalt, wordt de terugvalwachtrij gebruikt.
- Gebruikt de parameters voor flowDevName en terugvalwachtrij die zijn opgegeven in het Omniflow-gesprek API uitvoeren.
Eindpunt URI
<instance_url>/services/apexrest/cisco_wxcc_scv/voice/v1/executeOmniFlow
HTTP-methode
POST
Headers
Autorisatie: Drager <access_token>
Inhoud-Type: toepassing/json
Parameters
{ "callCenterDevName": "contactCenterDevName123", "certDevName": "certDevName123", "voiceCallId": "00X000012345abc", "dialedNumber": "+18445791189", "flowDevName": "Route_VoiceCall", "fallbackQueue": "00G111222333444", "flowInputParameters": { "Input1": "één", "Input2": "twee" }
- De voiceCallId-parameter is de Salesforce-spraakOproepId of het contact ID van de telefoonleverancier.
- Een uitgebreide beschrijving van de parameters die in dit verzoek worden geaccepteerd, vindt u in de officiële documentatie van Salesforce onder de sectie "Parameters".
Reactie (geslaagd)
{ "data": { "queue": "queue info", "agent": "agent info" }, "errors": null, "success": true }
AGENT_INFO en QUEUE_INFO komen overeen met het veld ExternalId in de OproepCenterRoutingMap
Reactie (met fouten)
{ "data": null, "errors": ["Foutmelding 1", "Foutmelding 2"], "succes": onwaar }
Routering wissen
Hiermee verwijdert u de record PendingServiceRouting (PSR) voor een spraakoproep. Dit API hoeft voor de meeste scenario's niet te worden gebeld; de PSR-record wordt automatisch verwijderd als het gesprek niet meer wordt gerouteerd. Er zijn echter enkele scenario's, zoals voor gemiste of verlaten oproepen bij gebruik van telefoniesystemen van partners waarbij u deze API expliciet moet bellen om het PSR-record te wissen.
Eindpunt URI
<instance_url>/services/apexrest/cisco_wxcc_scv/spraak/v1/clearRouting
HTTP-methode
POST
Headers
Autorisatie: Drager <access_token>
Inhoud-Type: toepassing/json
Parameters
{ "callCenterDevName": "contactCenterDevName123", "certDevName": "certDevName123", "voiceCallId": "00X000012345abc" }
- De voiceCallId-parameter is de Salesforce-spraakOproepId of het contactnummer ID van de telefoonleverancier.
- Een uitgebreide beschrijving van de parameters die in dit verzoek worden geaccepteerd, vindt u in de officiële documentatie van Salesforce onder de sectie "Parameters".
Reactie (geslaagd)
{ "data": { "status": "Succes" }, "errors": null, "success": true }
Reactie (met fouten)
{ "data": null, "errors": ["Foutmelding 1", "Foutmelding 2"], "succes": onwaar }
Telefoonnummers vertalen
De verschillende interacties tussen Service Cloud Voice en Webex Contact Center zijn afhankelijk van vertalingen van telefoonnummers. Vanwege internationale verschillen en klantspecifieke applicaties is een aanpasbaar hulpmiddel nodig om telefoonnummers door te schakelen van indeling A naar indeling B.
Bij de oplossing Webex Contact Center for Service Cloud Voice worden alle tekens behalve cijfers, hekjes (#), sterretjes (*), komma's (,) en plustekens (+) automatisch verwijderd. Hiermee verwijdert u ook de eerste vermelding van (0). Dit doet u VOORDAT de vertalingen van telefoonnummers worden toegepast.
In deze handleiding wordt beschreven hoe u vertalingen van telefoonnummers configureert.
Velden
Vertalingen van telefoonnummers worden opgeslagen in de velden Naam-Waarde. Hiermee kunt u een onbeperkt aantal regels per functie configureren.
De configuratie wordt opgeslagen als een JSON-string.
Houd er rekening mee dat backslashes moeten worden escapet, bijvoorbeeld .d+ wordt \\d+.
{"Alle tekens behalve cijfers verwijderen":"[1,17]->[^\\d]+","Aan intern nummer":"[7,17]->(\\d{7})(\\d{4})->$2"}
De veldnaam wordt technisch niet gebruikt. Hierin kunt u een leesbare tekstreeks toevoegen zodat u snel het doel van deze regel kunt herkennen. Goede namen zijn bijvoorbeeld: Verwijder alle voorloop nullen, voeg leiding plus enzovoort toe.
Vertaalregels maken
Regels worden geleverd als Gewone expressies. Om nauwkeuriger te zijn: de JavaScript-implementatie van reguliere uitdrukkingen.
Een goede manier om te beginnen is door het RegExp-document te lezen uit de MDN-webdocuments.
Toch is het vaak omslachtig om complexe reguliere expressies te maken. Daarom hebben we extra syntaxis toegevoegd om de configuratie zo eenvoudig mogelijk te maken.
In de onderstaande afbeelding ziet u de algemene syntaxis van een vertaalregel voor telefoonnummers:
Predikaat
Het predicaat wordt gebruikt om een interval op te geven waarin de lengte van het nummer wordt gedefinieerd.
Het predicaat hierboven geeft aan dat alle cijfers met een lengte tussen 7 en 11 tekens (inclusief de randen + spaties) overeenkomen.
Predicaten komen altijd overeen met de oorspronkelijke lengte van het nummer. Dit helpt bij het vereenvoudigen van de configuratie, doordat het risico van botsingsregels voor interne/externe nummers wordt verminderd.
Patroon
Het patroon bepaalt de indeling van het nummer dat overeenkomt.
In het bovenstaande patroon wordt aangegeven dat het getal uit alleen cijfers moet bestaan en dat het deze selecteert.
Selector
Selectors bepalen de uiteindelijke indeling van het nummer. Als er tekens/cijfers moeten worden toegevoegd die er nog niet waren, is dit de plaats waar u dit moet doen.
De selectie is de laatste stap in het opbouwen van het nummer. Op basis van het patroon wordt het nieuwe nummer opgebouwd door de selector.
Voorbeeld 1
Het volgende voorbeeld toont hoe u een nummer dat is ontvangen van het contactcenter doorschakelt in de indeling 0319175200 naar de Zwitserse E164-indeling +41 31 917 52 00.
In dit voorbeeld worden twee vertaalregels gebruikt (1. en 2.)
De eerste regel in dit voorbeeld verandert eigenlijk niet het aantal. Voor cijfers met een lengte van 1 tot 17 worden al andere dan cijfers verwijderd. Omdat er geen niet-cijfers aanwezig zijn, verandert er niets.
De tweede regel is van toepassing op cijfers die exact 10 tekens lang zijn (oorspronkelijk). 0319175200 komt overeen en daarom wordt de regel toegepast. Het patroon geeft aan dat het nummer moet beginnen met een groep van één cijfer (\d{1}), gevolgd door een groep van twee cijfers (\d{2}), gevolgd door een groep van drie cijfers (\d{3}), enzovoort.
De selector opent vervolgens de patroongroepen om de nieuwe reeks nummers te definiëren. Dit betekent $2 verwijst naar de eerste (\d{2}) en bevat daarom 31.
Voorbeeld 2
Het volgende voorbeeld toont hoe u een nummer dat is ontvangen van het Contact Center, doorschakelt in de indeling +14693150217 naar de US E164-indeling +1 469 315 0217.
In dit voorbeeld worden twee vertaalregels gebruikt (1. en 2.)
- Dit nummer is precies 12 tekens lang, dus de regel "Spaties toevoegen aan US-nummers" wordt toegepast.
- (\+1) zegt dat het nummer moet beginnen met +1. Als het nummer 12 tekens lang is, maar niet begint met een +1, wordt de regel geannuleerd en wordt er niets gewijzigd.
- (\d{3}) zegt dat +1 moet worden gevolgd door 3 cijfers.
- (\d{3}) zegt dat de laatste 3 cijfers moeten worden gevolgd door nog eens 3 cijfers.
- (\d{4}) zegt dat de laatste 3 cijfers moeten worden gevolgd door 4 cijfers.
Als een van deze waarden niet overeenkomt, wordt het nummer niet gewijzigd.
Dus, alle regels zijn van toepassing op "+14693150217". Daarom wordt het nummer gewijzigd met "$1 $2 $3 $4":
- $1 verwijst naar de groep (\+1), het nummer dat naar Service Cloud Voice wordt verzonden, ziet er als +1 uit.
- $2 verwijst naar de eerste van twee (\d{3}), ziet het nummer dat naar Service Cloud Voice wordt verzonden er als +1 469 uit.
- $3 verwijst naar de tweede van twee (\d{3}), ziet het nummer dat naar Service Cloud Voice wordt verzonden er als +1 469 315.
- $4 verwijst naar de laatste groep (\d{4}), ziet het nummer dat naar Service Cloud Voice wordt verzonden er als +1 469 315 0217.
De spaties in het vervangende gedeelte van regelnummer $1 $2 $3 $4" worden direct gebruikt. Dus als u "$1-$2-$3-$4" gebruikt, zou het nummer worden vertaald als: +1-469-315-0217
U kunt ook groepen verwijderen: [12, 12]->(\+1)(\d{3})(\d{3})(\d{4})->$2 $3 $4 wordt vertaald naar: 469 315 0217. [12, 12]->(\+1)(\d{3})(\d{3})(\d{4})-> $3 $4 wordt vertaald in: 315 0217.
Het is ook mogelijk om een internationaal nummer in de VS te converteren naar een lokale nummer zoals: [12, 12]->(\+1)(\d{3})(\d{3})(\d{4})->($2) $3-$4.
Het binnenkomende nummer "+14693150217" wordt vertaald naar: (469) 315-0217.
Voorbeeld 3
Het volgende voorbeeld toont hoe u een nummer dat is ontvangen van het contactcenter doorschakelt in de indeling +491515555531 naar de Duitse E164-indeling +49 151 5555 531.
In dit voorbeeld worden twee vertaalregels gebruikt (1. en 2.)
- Dit nummer is precies 13 tekens lang, dus de regel "Spaties toevoegen aan Duitse nummers" wordt toegepast.
- (\+49) zegt dat het nummer moet beginnen met +49. Als het nummer 13 tekens lang is, maar niet begint met een +49, wordt de regel geannuleerd en wordt er niets gewijzigd.
- (\d{3}) zegt dat +49 moet worden gevolgd door 3 cijfers.
- (\d{4}) zegt dat de laatste 3 cijfers moeten worden gevolgd door 4 cijfers.
- (\d{3}) zegt dat de laatste 4 cijfers moeten worden gevolgd door 3 cijfers.
Als een van deze waarden niet overeenkomt, wordt het nummer niet gewijzigd.
Alle regels zijn dus van toepassing op "+491515555531". Daarom wordt het nummer gewijzigd met "$1 $2 $3 $4":
- $1 verwijst naar de groep (\+49), het nummer dat naar Service Cloud Voice wordt verzonden, ziet er als +49 uit.
- $2 verwijst naar de eerste van twee (\d{3}), ziet het nummer dat naar Service Cloud Voice wordt verzonden er als +49 151 uit.
- $3 verwijst naar de tweede van twee (\d{4}), ziet het nummer dat naar Service Cloud Voice wordt verzonden er als +49 151 5555.
- $4 verwijst naar de laatste groep (\d{3}), het nummer dat naar Service Cloud Voice wordt verzonden, ziet er als +49 151 5555 531.
Voor regel één geldt hetzelfde. U kunt het vervangende onderdeel $1 $2 $3 $4 gebruiken om te kiezen wat u in het nummer wilt gebruiken.
Meer voorbeelden van Regex vertaling
| Beschrijving | Regex-omzetting |
|---|---|
| Alle tekens behalve cijfers verwijderen | [1.17]->[^\d]+ |
| Alle tekens behalve cijfers verwijderen & + | [1.17]->[^+\d]+ |
| Beschrijving | Regex-omzetting |
|---|---|
| +1 verwijderen | [12.12]->(.{ 1})(\d{1})(\d{10})->$ 3 |
| +1 verwijderen | [10,12]->(^\+1+)(\d+)->$ 2 |
| +49 verwijderen | [10,15]->(^\+49+)(\d+)->$ 2 |
| +49 verwijderen | [10,15]->(.{ 1})(\d{2})(\d{9})->$ 3 |
| +41 verwijderen | [10,13]->(^\+41+)(\d+)->$ 2 |
| +41 verwijderen | [10,13]->(.{ 1})(\d{2})(\d{9})->$ 3 |
| +XX verwijderen | [10,14]->(^\++)(\d{2})(\d+)->$ 3 |
| Beschrijving | Regex-omzetting |
|---|---|
| Verwijder + en vervang dit door nullen US E164 | [10.12]->(.{ 1})(\d{1})(\d{10})-> 001 $3 |
| Verwijder +1 en vervang deze door nullen US E164 | [10,12]->(^\+1+1+)(\d+)-> 001$2 |
| Verwijder + en vervang deze door nullen DE E164 | [12.15]->(.{ 1})(\d{2})(\d{10})-> 0049 $3 |
| Verwijder +49 en vervang deze door nullen DE E164 | [10,12]->(^\+49+)(\d+)-> 0049$2 |
| Verwijder + en vervang deze door nullen CH E164 | [10,13]->(.{ 1})(\d{2})(\d{9})-> 0041 $3 |
| Verwijder +41 en vervang deze door nullen CH E164 | [10,12]->(^\+41+)(\d+)-> 0041$2 |
| Beschrijving | Regex-omzetting |
|---|---|
| Nummer VS met spatie | [12.17]->(\d{1})(\d{3})(\d{3})(\d{4})->+1 $2 $3 $4 |
| Nummer VS met spatie | [12,17]->(\+1)(\d{3})(\d{3})(\d{4})->$ 1 $2 $3 $4 |
| DE-nummer met spatie | [12,17]->(\d{2})(\d{3})(\d{4})(\d{3})->+49 $2 $3 $4 |
| DE-nummer met spatie | [12.17]->(\+49)(\d{3})(\d{4})(\d{3})->$ 1 $2 $3 $4 |
| CH-nummer met spatie | [12.17]->(\d{2})(\d{2})(\d{3})(\d{2})(\d{2})->+41 $2 $3 $4 |
| CH-nummer met spatie | [12.17]->(\+41)(\d{2})(\d{3})(\d{2})(\d{2})->$1 $2 $3 $4 |
Configuratie spraakoproepenpagina
De pagina Gesprek opnemen spraakoproepen configureren
De pagina Spraakoproepen opnemen wordt standaard vooraf geconfigureerd, met een lay-out met 3 kolommen en de volgende onderdelen:
- Acties en aanbevelingen
- Gespreksopmerkingen
- Gespreksgegevens
- Opnamen
Onderdelen kunnen vrij worden verwijderd of aan de pagina worden toegevoegd, afhankelijk van de behoeften van het bedrijf. Er kunnen ook verschillende pagina-indelingen worden gebruikt, maar sommige onderdelen, zoals de gespreksopnamespeler en gesprektekst, passen alleen op middelgrote en grote gedeelten van de sjabloon.
De component Reden voor afronding weergeven
De component Reden afronden moet worden weergegeven tijdens het gesprek en tijdens het afronden.
Voeg het onderdeel Cisco Reden afronden toe aan de pagina Spraakoproepen opnemen:
- Sleep de Cisco webcomponent Lightning afronden van het gedeelte Aangepast van de lijst Lightning-componenten naar de pagina Spraakoproepen opnemen.
- Klik op Opslaan.
- Klik op Activeren.
- Klik op Toewijzen als Organisatiestandaard.
- Klik op Opslaan.
- Klik nogmaals op Opslaan en klik vervolgens op pijl Terug om terug te keren naar de pagina.
De Cisco component Reden afronden wordt automatisch weergegeven tijdens het gesprek en tijdens het afronden:
Als deze op de pagina worden toegevoegd, wordt de component Cisco Reden afronding voor elk gesprek weergegeven, ook als er geen afronding is geconfigureerd in Cisco Contact Center.
De Gespreksopnamespeler weergeven
De gespreksopnamespeler wordt weergegeven als een opnamekoppeling voor het bijbehorende spraakgesprek is opgeslagen.
Voer deze stappen uit om de component Call Recording Player toe te voegen aan de pagina VoiceCall Record:
- Sleep de lightning-webcomponent Van de Call Recording Player naar de pagina VoiceCall Opnemen
- Klik op Opslaan.
- Klik op Activeren.
- Klik op Toewijzen als Organisatiestandaard.
- Klik op Opslaan.
- Klik nogmaals op Opslaan en klik vervolgens op pijl Terug om terug te keren naar de pagina.
Webex Beheerders
Flow-configuratie
Pop-upscherm
Het knooppunt Pop-scherm is beschikbaar in de stroom Webex Contact Center. Het kan worden gebruikt om een pop-upscherm te activeren in Service Cloud Voice of in een apart venster.
Meer informatie over deze functie vindt u in de documentatie Flow Designer.
Schermpop-up in een afzonderlijk venster
Als u het scherm wilt openen in een afzonderlijk venster, moet u een absolute URL opgeven in het knooppunt Pop-upvenster. De queryParameters worden als zoekparameters aan de URL toegevoegd.
De volgende modi worden ondersteund:
- Nieuwe browser Tab : opent altijd een nieuwe browser Tab.
- Bestaande browser Tab : op de eerste bestaande browser Tab pop-upvenster wordt een nieuwe browser Tab geopend. Dat Tab is de speciale Tab voor volgende bestaande browserTab pop-upvensters en de URL wordt binnen die specifieke browser vernieuwd Tab.
- Inside Desktop - wordt op dezelfde manier behandeld als De nieuwe browser Tab.
De geopende pagina kan voorkomen dat deze wordt omgeleid. In dat geval wordt het schermpopvenster Bestaande browser Tab geopend in een nieuwe browser Tab.





