In diesem Artikel
dropdown icon
Übersicht
    Webex Contact Center für Salesforce Service Cloud Voice
    Voraussetzungen und Einschränkungen
    Lizenzen
    Omni-Channel aktivieren
    Beschränkungen
dropdown icon
Anforderungen
    Leerlauf-Codes
dropdown icon
Integrieren
    Installation
    Webex Contact Center für Service Cloud Voice installieren und konfigurieren
    Weisen Sie den Agenten den/die Anwesenheitsstatus zu.
dropdown icon
Konfiguration
    Kontaktcenter
    Importieren Sie das Kontaktcenter
    Konfigurieren Sie das Contact Center
dropdown icon
Anpassen
    Externe Client-App für die Webex Contact Center-Integration
    Webex Contact Center-Konfiguration und Skript zur Erstellung von Sprachanrufprotokollen
Funktion „Vom Benutzer benötigte Salesforce-Berechtigungen“
dropdown icon
Service Cloud Voice API Wrapper
    Voraussetzungen
    Verwenden Sie den Service Cloud Voice API Wrapper
    Rufe das Access_Token ab
    Führe die Anfragen aus
    Sprachanruf erstellen (Abschnitt)
    Sprachanruf aktualisieren
    Omni-Flow ausführen
    Klare Routenführung
dropdown icon
Telefonnummernübersetzungen
    Übersetzungsregeln erstellen
dropdown icon
Konfiguration der VoiceCall-Seite
    Konfigurieren der VoiceCall-Aufzeichnungsseite
    Zeigen Sie die Komponente „Zusammenfassungsgrund“ an.
    Anrufaufzeichnungsplayer anzeigen
dropdown icon
Webex-Administratoren
    Flusskonfiguration
Webex Contact Center mit Salesforce Service Cloud Voice integrieren
list-menuIn diesem Artikel
list-menuFeedback?

Webex Contact Center für Salesforce Service Cloud Voice integriert Ciscos robuste CCaaS - Lösung (Contact Center as a Service) mit dem CRM von Salesforce und ermöglicht es Unternehmen , Omnichannel-Kundeninteraktionen (Sprache, digital) innerhalb der Salesforce-Oberfläche zu verwalten. Dabei kommt Webex AI für virtuelle Agenten, Transkription und intelligentes Routing zum Einsatz, wodurch Agenten durch einheitliche Daten zu „ Super-Agenten“ für ein besseres Kundenerlebnis werden.

Übersicht

Webex Contact Center für Salesforce Service Cloud Voice

Webex Contact Center für Service Cloud Voice ist eine sofort einsatzbereite Integrationslösung, die die Leistungsfähigkeit von Webex Contact Center in die Omni-Channel-Agentenkonsole von Salesforce Service Cloud Voice bringt.

Bevor Sie mit der Installation fortfahren, lesen Sie bitte den folgenden Abschnitt:

um mehr über die Voraussetzungen und Einschränkungen von Salesforce Service Cloud Voice zu erfahren und sicherzustellen, dass Ihre Salesforce-Organisation bereit ist, das Webex Contact Center für Service Cloud Voice Paket zu aktivieren und zu installieren.

Voraussetzungen und Einschränkungen

Voraussetzungen (Unterthema)

Benutzeroberflächen: Service Cloud Voice ist nur in Salesforce Lightning Experience verfügbar.

Service Cloud Voice ist in diesen Editionen verfügbar.

  • Enterprise
  • Unbegrenzt
  • Entwickler

Lizenzen

  • Kunden müssen zusätzlich zu den Flex 3 Standard- oder Premium-Lizenzen für Webex Contact Center die neue A-SF-VOICE-Zusatzlizenz pro angemeldetem Agenten erwerben. Weitere Informationen finden Sie im Flex 3 Bestellleitfaden.

  • Salesforce Voice für Partnertelefonie

Bevor Sie Voice aktivieren, müssen Sie die erforderlichen Dienste in Ihrer Organisation einrichten.

  • Navigieren Sie zu Unternehmensinformationen > Berechtigungssatzlizenz
    • Prüfen Sie, ob Service Cloud Voice User (Partner Telephony).

      Alle Developer Editions enthalten jetzt 5 Partner-Telefonie-Lizenzen zum Testen.

  • Alternativ können Sie dies überprüfen, indem Sie zu Salesforce Setup gehen und in der linken Seitenleiste nach "voice" suchen.

    • Wenn "Partner Telephony Contact Centers" angezeigt wird, besitzen Sie die SCV-Lizenz.
    • Wenn die Option " Partner Telephony Contact Centers" nicht sichtbar ist, aktivieren SieService Cloud Voice durch Befolgen Sie die nachstehenden Schritte.
      • Gehen Sie zu Salesforce Setup und suchen und wählen Sie "Partner Telephony Setup" aus und schalten Sie die Schaltfläche auf "Enable Service Cloud Voice"um.

      • Aktivieren Sie Omni-Channel, damit Ihre Agenten Anrufe tätigen und entgegennehmen können.

Omni-Channel aktivieren

Wenn Omni-Channel in Ihrer Organisation bereits aktiviert ist, überspringen Sie diesen Schritt.

  1. Geben Sie unter „Setup“ im Feld „Schnellsuche“ Omni-Channel-Einstellungen ein und wählen Sie dann Omni-Channel-Einstellungenaus.

  2. Wählen Sie Omni-Channel aktivieren.
  3. Klicken Sie auf Speichern.

Beschränkungen

  • Die Sprachfunktion ist nur in Lightning Experience verfügbar.
  • Voice wird auf Service Cloud und Sales Cloud als Zusatzlizenz unterstützt.
  • Sprachsteuerung wird auf Salesforce Mobile und auf dem iPad Safari nicht unterstützt.
  • Die Sprachsteuerung wird nur von den Webbrowsern Google Chrome, Microsoft Edge (Chromium) und Mozilla Firefox unterstützt. Cookies müssen aktiviert sein, um Single Sign-On (SSO) zu ermöglichen.
  • Die Standardnavigation wird nicht unterstützt.
  • Die Telefonie ist stark reguliert. Erkundigen Sie sich daher bei Ihrem Salesforce-Ansprechpartner nach der Verfügbarkeit von Voice in Ihrer Region.

Anforderungen

Leerlauf-Codes

Leerlaufcodes finden

Um Leerlaufcodes festzulegen, befolgen Sie diese Schritte:
1

Melden Sie sich im Managementportal an.

2

Navigieren Sie zu Kontaktcenter > DESKTOP-ERLEBNIS > Idle/Wrap-up Codes.

3

Stellen Sie sicher, dass die Leerlaufcodes angezeigt werden. Klicken Sie andernfalls auf die Dropdown-Schaltfläche „ Filter“ und wählen Sie oben auf der Seite „Leerlaufcode “ aus.

4

Klicken Sie auf einen Leerlaufcode, um die Detailansicht zu öffnen. Dort finden Sie die Leerlaufcode-ID.

Die IDs können kopiert und dann für die Presence State Mapping Konfiguration verwendet werden. Eine der IDs muss als Standard-Cisco-Nicht-Bereit-Grundverwendet werden.

Integrieren

Installation

Bevor Sie mit der Installation fortfahren, lesen Sie bitte den Abschnitt Voraussetzungen und Einschränkungen, um mehr über die Voraussetzungen und Einschränkungen von Salesforce Service Cloud zu erfahren.

Webex Contact Center für Service Cloud Voice installieren und konfigurieren

Wenn eine Service Cloud Voice for Partner Telephony Lizenz erworben wird, erscheint die Seite Partner Telephony Setup im Setup-Menü.

Weitere Informationen finden Sie in der offiziellen Salesforce-Referenz ( direkter Link).

1

Geben Sie unter Setup Partner Telephony Setup in das Feld Schnellsuche ein und wählen Sie dann Partner-Telefonie-Setupaus.

2

Aktivieren Sprachsteuerung mit Partnertelefonie aktivieren.

Die Seite Partner-Telefonie-Kontaktzentren wird im Menü Setup angezeigt.

Wenn Sie das Paket in einer Salesforce-Sandbox bereitstellen möchten, ersetzen Sie den Teil login.salesforce.com des Installationslinks durch test.salesforce.com. Beachten Sie, dass dieses Paket aus Ihrer Sandbox-Organisation entfernt wird, sobald Sie eine neue Sandbox-Kopie erstellen.

Installieren Sie das Paket

So installieren Sie das Paket:

1

Öffnen Sie den bereitgestellten Link des Pakets, um die Installation zu starten.

2

Melden Sie sich bei der Salesforce-Organisation an, in der das Paket installiert werden soll.

3

Wählen Sie im Installationsassistenten die Sicherheitsoption "Nur für Administratoren installieren" (1) und klicken Sie auf Installieren (2).

Ermitteln Sie, welche Benutzer bestimmte Berechtigungen für die Objekte und Komponenten erhalten, die im Webex Contact Center for Service Cloud Voice-Paket enthalten sind. Erteilen Sie ihnen außerdem diese Berechtigungen; die im Webex Contact Center for Service Cloud Voice-Paket enthaltenen Berechtigungssätze unterstützen diesen Prozess.

Paketinstallationsassistent – Willkommensbildschirm wird angezeigt:

Das Installationspaket ist nicht direkt über Salesforce AppExchange zugänglich. Kunden müssen die Schaltfläche „Jetzt herunterladen“ im AppExchange-Eintrag verwenden, wodurch sich ein Kontaktformular öffnet, um den Installationslink und die Cisco-Aktivierung anzufordern.

4

Weisen Sie mindestens einem Benutzer die folgenden Berechtigungssätze zu, damit Sie das Contact Center erstellen können:

Contact Center Admin (Partner Telephony).
5

Klicken Sie auf Setup | Benutzer | Benutzer.

6

Suchen und einen Benutzer auswählen.

7

Scrollen Sie nach unten zu „Berechtigungssatzzuweisungen“.

8

Klicken Sie auf Aufgaben bearbeiten

9

Für Contact Center Administratoren: Weisen Sie die Berechtigungsgruppe Contact Center Admin (Partner Telephony) zu.

10

Für Contact Center Agents: Weisen Sie die Berechtigungssätze Contact Center Agent (Partner Telephony) und Webex Contact Center SCV Agent zu.

Es wird nicht empfohlen, die Option Für alle Benutzer installieren auszuwählen, da dadurch alle Berechtigungen (Lesen, Erstellen, Bearbeiten und Löschen) für die Paketkomponenten und -objekte an jeden Benutzer mit einem benutzerdefinierten Benutzerprofil vergeben werden.

11

Weisen Sie Benutzern eine Paketlizenz für die Arbeit mit Connects für Service Cloud Voice zu.

  • Klicken Sie auf Setup | Apps | Paketierung | Installierte Pakete.
  • Klicken Sie auf Lizenzen verwalten neben dem kürzlich installierten Webex Contact Center für Service Cloud Voice.
  • Klicken Sie auf Benutzer hinzufügen.
  • Wählen Sie die Benutzer aus, denen die Lizenz zugewiesen werden soll, und klicken Sie auf Hinzufügen.

12

Alternativ können Sie auf Setup | Benutzer | Benutzer.klicken.

13

Benutzer suchen und auswählen.

14

Scrollen Sie nach unten zu Managed Packages.

15

Klicken Sie auf Lizenzen zuweisen.

16

Wählen Sie aus der Liste das Webex Contact Center für Service Cloud Voice Paket aus.

17

Klicken Sie auf Hinzufügen.

18

Erstellen Sie die Präsenzstatus, um festzulegen, welche Servicekanäle den verschiedenen Status zugeordnet sind. Agenten können sich mit unterschiedlichen Status bei Omni-Channel anmelden, je nachdem, welche Art von Arbeit ihnen zusteht.

19

Geben Sie unter „Setup“ im Feld „Schnellsuche“ Presence Statuses ein und wählen Sie dann Anwesenheitsstatusaus.

20

Klicken Sie auf Neu. Erstellen Sie mindestens einen Status für „Online“ und einen für „Beschäftigt“.

  • Erstellen Sie einen dedizierten Anwesenheitsstatus „Beschäftigt“ für RONA. Mithilfe der Präsenzkonfiguration kann der Omni-Channel-Status automatisch auf einen festgelegten Status gesetzt werden, sobald ein RONA auf der CTI-Seite oder innerhalb von Salesforce auftritt.
  • Wenn Sie einen RONA-Status innerhalb der Anwesenheitskonfiguration konfigurieren , stellen Sie sicher, dass Sie nicht die Standard-Anwesenheitskonfiguration verwenden. Aktuell ruft Webex Contact Center for Service Cloud Voice den in der Standardkonfiguration festgelegten RONA-Status nicht ab.

Weisen Sie den Agenten den/die Anwesenheitsstatus zu.

1

Geben Sie unter „Setup“ im Feld „Schnellsuche“ den Begriff „Berechtigungssätze“ ein und wählen Sie dann „Berechtigungssätze“ aus.

2

Klicken Sie hier, um die Berechtigungssätze für Partnertelefonie zu öffnen.

3

Klicken Sie auf Servicepräsenzstatus Zugriff.

4

Klicken Sie auf Bearbeiten.

5

Wählen Sie in der Liste Verfügbare Dienstpräsenzen die zuvor erstellten Präsenzstatus aus und klicken Sie auf Hinzufügen, um sie dem Berechtigungssatz zuzuordnen. Agenten, denen diese Berechtigungsgruppe zugewiesen ist, können sich mit jedem der ihnen zur Verfügung stehenden Anwesenheitsstatus bei Omni-Channel anmelden.

6

Klicken Sie auf „Speichern“.

7

Klicken Sie auf derselben Seite auf Aufgaben verwalten. Klicken Sie dann oben rechts auf Zuweisung hinzufügen, wählen Sie den gewünschten Benutzer aus, klicken Sie auf Weiter, wählen Sie eine Ablaufoption für die zugewiesenen Benutzer (optional) und klicken Sie dann auf Zuweisen.

Service Cloud Voice verwendet eine externe Domäne für die Arbeit mit dem VoiceCall-Datensatz. Die folgenden URLs müssen in den „Einstellungen für Remote-Sites“ unter Setup hinzugefügt werden ( Klicken Sie hier, um die offizielle Dokumentation zu öffnen):

Beispiel: So finden Sie die Instanz-URL.

8

Schauen Sie sich die URL in der Adressleiste Ihres Browsers nach dem Einloggen an. Die Instanz-URL ist der Teil vor ".my.salesforce.com" oder ".salesforce.com" oder "lightning.force.com". Wenn Ihre URL beispielsweise https://orgfarm-54a38e30ad-dev-ed.develop.my.salesforce-setup.com/, lautet, dann ist "orgfarm-54a38e30ad-dev-ed.develop" Ihre Instanz-URL.

Beispiel:

URL der Ursprungsorganisation: https://cisco.lightning.force.com

Beispiel: URL zum Hinzufügen:

  • https://cisco.my.salesforce-scrt.com

9

Das Omni-Channel-Utility-Element ist in der Lightning Service Console App erforderlich, damit der Agent Service Cloud Voice nutzen kann.

  • Geben Sie unter „Setup“ im Feld „Schnellsuche“ die Option „Apps“ ein und wählen Sie dann „App-Manager“ aus.
  • Klicken Sie auf die Dropdown-Liste neben der Service Console-App oder der App, die Sie verwenden möchten, und klicken Sie dann auf Bearbeiten.
  • Klicken Sie unter App-Einstellungen auf Hilfsprogramme (nur Desktop).
  • Klicken Sie auf „Hilfselement hinzufügen“.
  • Suchen Sie im Modal-Fenster nach Omni-Channel.
  • Klicken Sie auf Omni-Channel.
  • Klicken Sie auf Speichern und beenden Sie den App-Manager.

Die offizielle Referenz von Salesforce finden Sie, indem Sie auf die Schaltfläche Let's Do This klicken, die die Seite Configure the Agent Experience for Service Cloud Voice with Partner Telephony im Salesforce Help Portal öffnet ( direkter Link).

10

Geben Sie unter Setup Partner Telephony Setup in das Feld Schnellsuche ein und wählen Sie dann Partner Telephony Setupaus.

11

Scrollen Sie nach unten zum Abschnitt 5 Weitere Spracheinstellungen.

12

Um den Clickjacking-Schutz für Visualforce-Seiten mit deaktivierten Headern während der Arbeit mit dem Softphone in Lightning Experience zu aktivieren, müssen Sie zusätzlich zur Salesforce-Instanz-URL die Domänen, von denen das Softphone und die benutzerdefinierten Symbolleisten geladen werden, als vertrauenswürdige Domänen hinzufügen.

Diese Einstellungen und die Liste der vertrauenswürdigen Domänen finden Sie unter Setup | Sicherheit | Sitzungseinstellungen.

Um die richtige Visualforce-Domäne abzurufen, navigieren Sie zu Setup | Benutzerdefinierter Code | Visualforce-Seiten und klicken Sie auf die Schaltfläche Vorschau für CiscoScvMainWxCC. Salesforce kann je nach Konfiguration der Salesforce-Organisation automatisch auf eine andere URL weiterleiten. Kopieren Sie die URL und fügen Sie sie der Trusted Domains for Inline Frames -Liste hinzu, indem Sie als IFrame-Typ „Visualforce Pages“ auswählen.

Beispiel: MyDomainName--cisco_wxcc_scv.vf.force.com

Um die Salesforce-Instanzdomäne zu erhalten, kopieren Sie die in der Adressleiste des Browsers angezeigte URL und fügen Sie sie der Liste Trusted Domains for Inline Frames List hinzu, wobei Sie Visualforce Pages als IFrame-Typ auswählen.

Beispiel: MyDomainName.lightning.force.com

Wenn Sie in Ihrer Organisation keine „Meine Domäne“ bereitgestellt haben, ist Ihr URL-Format anders. Wenn Sie eine My Domain bereitgestellt haben und erweiterte Domains in Ihrer Organisation nicht aktiviert sind, ist Ihr URL-Format anders. Wenn erweiterte Domänen nicht aktiviert sind, wirkt sich die Einstellung „URLs in Visualforce, Experience Builder, Site.com Studio und Inhaltsdateien stabilisieren – Meine Domäne“ ebenfalls auf dieses Format aus. Weitere Einzelheiten finden Sie unter Meine Domain-URL-Formate in der Salesforce-Hilfe.

Einstellungen für Clickjack-Schutz und vertrauenswürdige Domains für Lightning Experience

13

Um die Aufzeichnungssteuerung während Anrufen anzeigen zu können, benötigen Agenten die App-Berechtigung Control Call Recording.

Um es zuzuweisen, fügen Sie es dem Berechtigungssatz hinzu, der im Schritt Präsenzstatus erstellt wurde.

  • Öffnen Sie den Berechtigungssatz.
  • Klicken Sie auf den Link App-Berechtigungen.
  • Click the Bearbeiten Schaltfläche.
  • Fügen Sie die Berechtigung „Call Center Anrufaufzeichnung steuern “ hinzu und speichern Sie.

Konfiguration

Kontaktcenter

Eine Contact Center-Definitionsdatei legt eine Reihe von Feldern und Werten fest, die zur Definition eines Contact Centers in Salesforce für ein bestimmtes CTI-System verwendet werden. Salesforce verwendet Contact Center-Definitionsdateien, um die Integration mit verschiedenen CTI-Systemanbietern zu unterstützen.

Weitere Informationen finden Sie in der offiziellen Dokumentation von Salesforce ( direkter Link).

Importieren Sie das Kontaktcenter

Laden Sie hier die neueste Version des Contact Centers herunter.

Upgrade von der Beta-Version: Dieser Leitfaden beschreibt eine Neuinstallation der allgemein verfügbaren (GA) Version der Webex Contact Center-Integration für Salesforce Service Cloud Voice.

Wenn Sie von einer Beta-Version der Integration aktualisieren, verwenden Sie keinen bestehenden Partner Contact Center-Datensatz wieder. Stattdessen:

  1. Importieren Sie die mit der GA-Version mitgelieferte Partner Contact Center XML-Datei.
  2. Erstellen Sie einen neuen Partner Contact Center-Datensatz mithilfe der importierten XML-Datei.
  3. Aktualisieren Sie Ihre Konfiguration, um das neu erstellte Partner Contact Center zu verwenden.

Die GA Partner Contact Center XML-Datei enthält aktualisierte Konfigurationswerte, einschließlich der korrekten Connector-URL und anderer Metadaten. Die Wiederverwendung eines aus Beta-XML erstellten Partner Contact Center-Datensatzes kann dazu führen, dass veraltete Konfigurationswerte beibehalten werden und die Integration nicht ordnungsgemäß funktioniert.

1

Geben Sie unter Setup Partner Telephony Contact Centers in das Feld Quick Find ein und wählen Sie dann Partner Telephony Contact Centersaus.

Es wird eine Liste der gegebenenfalls vorhandenen Contact Center angezeigt.
2

Klicken Sie auf der rechten Seite auf Kontaktcenter erstellen.

3

Wählen Sie Webex Contact Center als Ihren Telefonieanbieter aus. Klicken Sie anschließend auf Weiter.

Ein Dateibrowser öffnet sich.
4

Wählen Sie die .xml -Datei aus, die Ihre Contact-Center-Definition enthält.

5

Klicken Sie auf Öffnen.

Die Datei wurde importiert.
6

Prüfen Sie, ob Ihr Contact Center in der Listenansicht der Contact Center angezeigt wird.

Konfigurieren Sie das Contact Center

1

Geben Sie unter Setup Partner Telephony Contact Centers in das Feld Quick Find ein und wählen Sie dann Partner Telephony Contact Centersaus.

2

Klicken Sie auf das zuvor importierte Contact Center.

3

Klicken Sie auf Bearbeiten.

Tabelle 1: Kontaktdaten
FeldBeschreibung
Anzeigename Dies ist der Name des Kontaktcenters, das in der Liste der verfügbaren Kontaktcenter erscheint. Dieselbe Contact Center-Definitionsdatei (.xml) kann mehrfach importiert und mit unterschiedlichen Anzeigenamen versehen werden.
Öffentlicher Schlüssel

Zur Nutzung der Sprachfunktionen wird ein Zertifikat mit öffentlichem und privatem Schlüssel benötigt. Um einen privaten Schlüssel zu erhalten, können Sie ein selbstsigniertes Zertifikatgenerieren, ein von einer Zertifizierungsstelle signiertes Zertifikat generieren oder direkt Java-Keystore-Dateien (JKS) oder Bouncy Castle FIPS-Keystore-Dateien (BCFKS) über die Schaltfläche Aus Keystore importieren importieren.

Sobald das Zertifikat generiert wurde:

  • Klicken Sie auf die Bezeichnung Zertifikat.
  • Klicken Sie auf Zertifikat herunterladen.
  • Öffnen Sie das heruntergeladene Zertifikat mit einem Texteditor.
  • Kopieren Sie den Inhalt in das Feld Öffentlicher Schlüssel des Kontaktcenters.

Erforderlich Ja

Eindeutiger Name des Zertifikats

Die Unique Name des selbstsignierten Zertifikats, das für den öffentlichen Schlüsselerstellt wurde.

Erforderlich Ja

Bereitschaftsstatus-ID
  • Öffnen Sie die Seite Anwesenheitsstatus in den Einstellungen.
  • Klicken Sie auf den Online-Statusund kopieren Sie die zugehörige Salesforce-ID aus der URL-Leiste.
  • Fügen Sie die ID in dieses Feld ein.

Erforderlich Ja

Nicht bereit Status-ID
  • Öffnen Sie die Seite Anwesenheitsstatus in den Einstellungen.
  • Klicken Sie auf den Status "Beschäftigt" und kopieren Sie die zugehörige Salesforce-ID aus der URL-Leiste.
  • Fügen Sie die ID in dieses Feld ein.

Erforderlich Ja

Standardmäßig ist Cisco nicht bereit. Grund

Cisco Leerlaufcode-ID, die als Standard-Leerlaufcode verwendet wird, falls für einen bestimmten Anwesenheitsstatus keine Zuordnung angegeben ist.

Erforderlich Ja

Informationen zur Überprüfung der konfigurierten Leerlaufcode-IDs finden Sie im Abschnitt Leerlaufcodes.

Anwesenheitszustandskartierung

Wird verwendet, um die Salesforce Omni Presence-Status den Cisco-Statuscodes „Bereit“ und „Nicht bereit“ zuzuordnen.

Die Statuswerte Idle Code müssen hinzugefügt werden:

  • Öffnen Sie die Seite Anwesenheitsstatus in den Einstellungen.
  • Klicken Sie auf einen der Status "Beschäftigt " und kopieren Sie dessen Salesforce-ID aus der URL-Leiste. Anwesenheitsstatus-IDs beginnen mit 0N5. zum Beispiel 0N51X0000000AUT.
  • Fügen Sie die ID in dieses Feld ein, gefolgt von einem Komma und der Cisco-Leerlaufcode-ID.
  • Eine oder mehrere Busy Zuordnungen können durch Kommatrennung hinzugefügt werden.

Um Synchronisationsprobleme zu vermeiden, muss die Default Not Ready ID auch in der Zuordnung konfiguriert werden.

Wenn Sie innerhalb der Präsenzkonfiguration [] Status für ] Ablehnen und Push-Timeoutkonfiguriert haben, fügen Sie diese auch der Zuordnung mit einem entsprechenden Cisco-Status "Nicht bereit" hinzu.

Format:

  • Vielbeschäftigte Kartierung: busyPresenceID1,ciscoAuxCodeID1
  • Standardmäßige Nicht-Bereit-Zuordnung: defaultNotReadyPresenceID,ciscoDefaultNotReadyAuxCodeID
  • Online-Kartendienst: onlinePresenceId,0

Trennen Sie die einzelnen vollständigen Zuordnungen durch ein Semikolon.

Erforderlich Ja

Hier ist ein Beispiel für ausgefüllte Leerlaufcodes für Mittagessen, Besprechung, Pause.

Anrufvariable für Sprachanruf-ID

Die Anrufvariable, die zum Speichern der ID des aktuellen Sprachanrufs verwendet wird. Es dient dazu, den Anrufstatus korrekt zu aktualisieren.

Format: Variablenname, wie er im Webex Contact Center Flow konfiguriert ist. Zum Beispiel SCV_VoiceCallRecordId

Erforderlich Ja

Standardwert: SCV_VoiceCallRecordId

Wenn Sie die Voice Call-Datensatz-ID und den Vendor Call Key zu einer Flow-Variablen kombiniert haben, können Sie deren Namen in diesem Feld konfigurieren. Siehe auch Flow-Variable für Voice Call-Datensatz-ID und Vendor Call Key.

Rufvariable für den Anbieter-Rufschlüssel

Die Anrufvariable, die zum Speichern des Anbieter-Anrufschlüssels des aktuellen Sprachanrufs verwendet wird. Es dient dazu, den richtigen Sprachanrufdatensatz zu öffnen.

Format: Variablenname, wie er im Webex Contact Center Flow konfiguriert ist. Zum Beispiel SCV_VendorCallKey

Erforderlich Ja

Standardwert: SCV_VendorCallKey

Wenn Sie die Voice Call-Datensatz-ID und den Vendor Call Key zu einer Flow-Variablen kombiniert haben, können Sie dieses Feld leer lassen und den Namen der Flow-Variable mit der Voice Call-Datensatz-ID und dem Vendor Call Key im Feld "Call Variable for Voice Call Id" konfigurieren. Siehe auch Flow-Variable für Voice Call Datensatz-ID und Vendor Call Key.

Übersetzung der Telefonnummer

Regeln zur Übersetzung von Telefonnummern, die auf die Nummer angewendet werden, bevor sie gewählt wird.

Siehe Telefonnummernübersetzungen

Erforderlich Nein

Webex Contact Center Region

Der Tenant wird verwendet, um die Webex Contact Center-Region zu bestimmen. Sie ist in der URL des Webex Contact Center Portals, des Entwicklerportals oder des Desktops zu finden. Zum Beispiel verwendet devportal.wxcc-eu2.cisco.com die Region eu2.

Format: eu2

Erforderlich Ja

Webex Contact Center-Regionen und zugehörige Zeichenketten:

  • USA: us1
  • Kanada: ca1
  • Vereinigtes Königreich: eu1
  • Deutschland: eu2
  • Australien: anz1
  • Singapur: sg1
  • Japan: jp1
Webex Contact Center WebRTC-Domäne

Die Domäne wird verwendet, um die korrekte WebRTC-Verbindung herzustellen. Verwenden Sie den Standort Ihres Webex Contact Center-Mandanten:

  • USA: rtw.prod-us1.rtmsprod.net
  • ANZ: rtw.prod-as1.rtmsprod.net
  • CA: rtw.prod-ca1.rtmsprod.net
  • JP: rtw.prod-ja1.rtmsprod.net
  • EU1: rtw.prod-uk1.rtmsprod.net
  • EU2: rtw.prod-gm1.rtmsprod.net

Erforderlich Ja, für WebRTC.

WCCAI-Transkription aktivieren

Dient zum Aktivieren oder Deaktivieren der WCCAI-Transkription.

Format: True oder False

Erforderlich Nein

Standardwert: False

Link zum Speichern der Aufnahme

Dient dazu, den Link zur Webex-Anrufaufzeichnung im Sprachanrufprotokoll zu speichern.

Format: True oder False

Erforderlich Nein

Standardwert: True

4

Klicken Sie unten auf der Seite Contact Centerunter dem Abschnitt Contact Center Users [] auf die Schaltfläche Hinzufügen.

5

Klicken + neben den Benutzern, die Zugriff auf das geöffnete Contact Center haben.

In dieser Liste erscheinen nur Benutzer, denen die Berechtigung Contact Center Agent (Partner Telephony) zugewiesen ist und die noch keinem anderen Contact Center zugeordnet wurden.

Anpassen

Externe Client-App für die Webex Contact Center-Integration

Konfigurieren der externen Client-App für den Webex Contact Center Salesforce Connector

Um Service Cloud Voice optimal zu nutzen, kann der Anrufablauf des Contact Centers so angepasst werden, dass ein Voice-Call-Datensatz erstellt und ein Salesforce Omni-Channel-Flow ausgeführt wird, während sich der Anruf im IVR-System befindet.

Zertifikat erstellen

Stellen Sie sicher, dass Sie gemäß den Sicherheitsrichtlinien Ihrer Organisation bereits ein digitales Zertifikat erstellt haben.

Informationen zur Erstellung eines digitalen Zertifikats finden Sie in der Salesforce-Dokumentation unter https://developer.salesforce.com/docs/atlas.en-us.voice_pt_developer_guide.meta/voice_pt_developer_guide/voice_pt_generate_certificate.htm.

Beispiel

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 => Zertifikat für die externe Salesforce-Client-App

server.key => Privater Schlüssel für den Salesforce Connector im Webex Control Hub

Berechtigungssatz für den SCV-Integrationsbenutzer

Das folgende Berechtigungsset gewährt Zugriff auf Apex-Klassen, die von Connects for SCV für die Integration mit Contact Center IVR-Abläufen und Webex Contact Center für Salesforce for SCV verwendet werden.

Nachfolgend finden Sie eine Beispielkonfiguration und eine Beschreibung der minimal erforderlichen Berechtigungen für das Contact Center. / Die IVR-Integration soll funktionieren.

  • Navigieren Sie unter „Setup“ zu Benutzer |Berechtigungssätze .
  • Klicken Sie auf die Schaltfläche Neu.
    • Geben Sie eine Bezeichnung ein, zum Beispiel: IVR-Zugriff auf SCV Apex-Klassen
    • Der API-Name wird automatisch ausgefüllt.
    • Lizenz: Keine
    • Klicken Sie auf die Schaltfläche Speichern.
  • Das neue Berechtigungsset wird geöffnet.
  • Navigieren Sie zu Apex Class Access.
  • Klicken Sie auf die Schaltfläche Bearbeiten und fügen Sie die folgenden Apex-Klassen hinzu:
    • cisco_wxcc_scv.ServiceRouting
  • Navigieren Sie zu Systemberechtigungen.
  • Klicken Sie auf die Schaltfläche Bearbeiten und aktivieren Sie die folgenden Berechtigungen:
    • Apex REST-Dienste
    • API aktiviert

Minimaler Zugriff – Profil für reine API-Integrationen

Dieses Profil dient zur Integration mit Webex Contact Center für Salesforce für SCV, um Sprachanrufdatensätze zu erstellen und Omni-Flow aus dem IVR-Ablauf auszuführen.

Nachfolgend finden Sie eine Beispielkonfiguration und eine Beschreibung der minimal erforderlichen Berechtigungen für das Contact Center. / Die IVR-Integration soll funktionieren.

Dies ist ein Klon des Profils „Minimaler Zugriff – Nur API-Integrationen“.

  • Navigieren Sie unter „Einstellungen“ zu Benutzer | Profile.
  • Suchen Sie in der Profilliste nach dem Profil Minimaler Zugriff – Nur API-Integrationen.
  • Klicken Sie auf den Profilnamen, um das Profil Minimum Access - API Only Integrations zu öffnen.
  • Klicken Sie im Profil Minimaler Zugriff - Nur API-Integrationen auf die Schaltfläche Klonen.
  • Geben Sie einen neuen Profilnamen ein, zum Beispiel: SCV-Integration.
  • Klicken Sie auf die Schaltfläche Speichern.
  • Das neue Profil wird geöffnet.
  • Überprüfen Sie, ob aus Ihrem Profil „Minimaler Zugriff – Nur API-Integrationen“ alle Berechtigungen entfernt wurden.
  • Navigieren Sie zu Systemberechtigungen.
  • Stellen Sie sicher, dass die folgenden Berechtigungen aktiviert sind:
    • API aktiviert
    • Nur API-Benutzer

SCV-Integrationsbenutzer

Nachfolgend finden Sie eine Beispielkonfiguration und eine Beschreibung der minimal erforderlichen Berechtigungen für das Contact Center. / Die IVR-Integration soll funktionieren. Für den SCV-Integrationsbenutzer ist keine Salesforce Service Cloud Voice-Lizenz oder Webex Contact Center für Salesforce für SCV-Lizenz erforderlich.

  • Navigieren Sie unter „Setup“ zu Benutzer | Benutzer.
  • Klicken Sie auf die Schaltfläche Neuer Benutzer.
    • Geben Sie Vorname, Nachname und alle anderen Pflichtfelder ein.
    • Benutzerlizenz: Salesforce-Integration
    • Profil: Wählen Sie das im vorherigen Schritt erstellte Profil aus („SCV-Integrationsprofil“, Klon des Profils „Minimaler Zugriff – Nur API-Integrationen“).
  • Klicken Sie auf die Schaltfläche Speichern.
  • Öffnen Sie den neuen Benutzerdatensatz.
  • Weisen Sie das zuvor erstellte Berechtigungssetzu („IVR-Zugriff auf SCV-Apex-Klassen“).
  • Weisen Sie die Berechtigungssatzlizenz Salesforce API-Integrationzu.
Erstellen einer externen Salesforce-Client-App
Erstellen Sie eine neue externe Client-App

Es gibt zwei Möglichkeiten, Ihre Salesforce-Daten mit Anwendungen von Drittanbietern zu verbinden. SowohlConnected Appsals auchExternal Client Appssind Frameworks zur Datenintegration. External Client Apps stellen die nächste Generation von Connected Apps dar.

So konfigurieren Sie die externe Salesforce-Client-App, die von Cisco Webex Contact Center verwendet wird:

  1. Navigieren Sie von SetupzuApps | Externe Client-Apps | Externer Client-App-Manager.
  2. Klicken Sie aufNeue externe Client-App.
  3. Externe Client-App – Grundlegende Informationen
    • Name der externen Client-App: WxCC - SCV
    • API-Name: WxCC_SCV
    • Kontakt-E-Mail: < your email >
    • Vertriebsstatus: Lokal auswählen

    Grundlegende Informationen

    Externe Client-App – API (OAuth-Einstellungen aktivieren)

    • Wählen: OAuth aktivieren
    • App-Einstellungen
    • Rückruf URL: http://localhost:1717/OauthRedirect as eine Beispiel-Callback-URL
    • OAuth Scopes
    • OAuth-Bereiche auswählen:
    • Benutzerdaten über APIs (API) verwalten
    • Führe Anfragen jederzeit aus (refresh_token, offline_access)

    API (OAuth-Einstellungen aktivieren)

    Flow-Aktivierung

    • Wählen: JWT Bearer Flow aktivieren
    • Klicken Sie auf „Dateien hochladen“ und laden Sie dieserver.crt-Datei hoch, die Ihr digitales Zertifikat enthält.

    Floe-Aktivierung

    Sicherheit

    Deaktivieren Sie die Option Geheimnis für den Webserver-Flow erforderlich.

    Sicherheit

  4. Klicken Sie auf die SchaltflächeErstellen.
  5. Wechseln Sie zur Registerkarte Richtlinien und klicken Sie dann auf die SchaltflächeBearbeiten.
  6. Richtlinien – OAuth-Richtlinien
    • Plugin-Richtlinien
      • Zulässige Benutzer: Ausgewählte, vom Administrator genehmigte Benutzer sind vorautorisiert.
      • Änderung bestätigen
    • App-Autorisierung
      • Richtlinie zur Aktualisierung von Token: Sofort ablaufendes Aktualisierungstoken auswählen
      • IP-Relaxierung: Wählen Sie „IP-Beschränkungen erzwingen“.

    OAuth-Richtlinien

  7. Richtlinien – App-Richtlinien
    • Startseite – keine
    • Berechtigungssätze auswählen – Weisen Sie den zuvor erstellten Berechtigungssatz zu („IVR-Zugriff auf SCV-Apex-Klassen“)

    App-Richtlinien

  8. Klicken Sie auf Speichern.
  9. Wechseln Sie zu den Registerkarteneinstellungen.
    • Im Abschnitt „OAuth-Einstellungen“ klicken Sie auf die Schaltflächen„ Consumer Key “ und „ Secret“ . Warten Sie auf die E-Mail und bestätigen Sie Ihre Identität. Es öffnet sich ein neuer Browser-Tab mit einer Seite, die Kundendaten anzeigt.

      OAuth-Einstellungen

    • Klicken Sie auf Kopieren und speichern Sie denConsumer Key. Der Verbraucherschlüssel wird später verwendet, um den Salesforce Connector im Webex Contact Center Control Hub zu erstellen. 

      Name der externen Client-App

Webex Contact Center-Konfiguration und Skript zur Erstellung von Sprachanrufprotokollen

Um den vollen Nutzen von Salesforce Service Cloud Voice zu erzielen, muss der Anrufablauf im Webex Contact Center so angepasst werden, dass der Voice Call-Datensatz in Service Cloud Voice erstellt wird, sobald der Anruf im Contact Center eingeht.

Für Routing-Entscheidungen und Automatisierung in Salesforce kann optional ein Omni-Flow ausgeführt werden.

Für Details zu den verwendeten APIs siehe Service Cloud Voice API Wrapper.

Voraussetzungen

Um den Service Cloud Voice API Wrapper nutzen zu können, muss eine Salesforce External Client App für die IVR-Integration konfiguriert werden.

Konfigurieren Sie den Salesforce Connector im Webex Control Hub.

Richten Sie die Salesforce Integration Connectors für Webex Contact Center wie im Artikel unter https://help.webex.com/en-us/article/7fuy63/Set-Up-Integration-Connectors-for-Webex-Contact-Center#id_133211beschrieben ein.

1

Melden Sie sich bei Ihrer Kundenorganisation unter https://admin.webex.com an und navigieren Sie zu Services. > Kontaktzentrum > Mandanteneinstellungen > Integrations>Connectors.

2

Klicken Sie auf der Salesforce-Karte auf „Konnektor einrichten“ oder „Konnektor hinzufügen“.

  • Client-ID: Externer Client-App-Verbraucherschlüssel
  • Salesforce-E-Mail-Adresse: Salesforce-Benutzername der „SCV-Integration“ (siehe SCV-Integrationsbenutzer)
  • URL: für den Produktiveinsatz https://login.salesforce.com oder wenn Sie eine einrichten dev/sandbox verwenden https://test.salesforce.com
  • Privater Schlüssel: Inhalt der Datei server.key

WICHTIG: SICHERHEIT DURCH REGELMÄSSIGE ROTATION DER GEHEIMNISSE GEWÄHRLEISTEN

Achten Sie darauf, Ihren privaten Schlüssel und Ihr Zertifikat regelmäßig zu wechseln, um die Sicherheit Ihrer Integrationen zu gewährleisten.

Aktualisieren Sie den privaten Schlüssel im Contact Center Connector in Webex Hubund das Zertifikat in der External Client App in Salesforce.

Tipp zur Fehlerbehebung

Nachdem Sie auf „Fertig“ geklickt haben und die Verbindung nicht gespeichert wird:

  • Prüfen Sie, ob Sie Leerzeichen haben. before/after Ihre Einträge.
  • Stellen Sie sicher, dass Ihr privater Schlüssel (server.key) mit Ihrem server.crtübereinstimmt. Wenn Sie mehrere Organisationen einrichten und die Zertifikate wechseln, funktionieren diese nicht.
  • Stellen Sie sicher, dass Ihre Server.key-Datei mit einem Punkt beginnt. ----- Begin RSA Private Key -----

Webex Contact Center Hauptablauf

Tabelle 2. Flussvariable
DurchflussvariableBeschreibung
Flow-Variable für die Sprachanruf-Datensatz-ID Eindeutige ID zur Identifizierung des Anrufs. Erforderlich zum Erstellen des Sprachanrufprotokolls.

Format: wxcc_<Interaction Id>

Beispiel: wxcc_fc4ec7d8-4c91-49aa-b764-081fbba344a8

  • Name: SCV_VendorCallKey
  • Typ: String
  • Agenten sichtbar machen: Aktiviert
Lokale Variable für die Aufrufstartzeit

Wird verwendet, um den Sprachanrufdatensatz zu erstellen und beim Aktualisieren des Sprachanrufs.

  • Name: SCV_Anrufstartzeit
  • Typ: String
  • Agenten sichtbar machen: Nein
Lokale Variable für die Warteschlange name/id

Wird von Execute Omni Flowzurückgegeben und für das Anruf-Routing verwendet.

Diese Variable wird nur benötigt, wenn Sie „Omni Flow ausführen“ verwenden.

  • Name: SCV_OmniFlowQueue
  • Typ: String
  • Agenten sichtbar machen: Nein
Lokale Variable für Agent name/id

Wird von Execute Omni Flowzurückgegeben und für das Anruf-Routing verwendet.

Diese Variable wird nur benötigt, wenn Sie „Omni Flow ausführen“ verwenden.

  • Name: SCV_OmniFlowAgent
  • Typ: String
  • Agenten sichtbar machen: Nein

Hauptflussübersicht

  1. Lieferantenanrufschlüssel generieren
  2. Anrufstartzeit festlegen
  3. HTTP-Anfrage: Sprachanrufaufzeichnung erstellen
  4. Auswertung der HTTP-Antwort für das Erstellen eines Sprachanrufdatensatzes
  5. Fehlerbehandlung für das Erstellen eines Sprachanrufdatensatzes
  6. HTTP-Anfrage: Omni Flow ausführen
  7. Auswertung der HTTP-Antwort für die Ausführung des Omni-Flows
  8. Fehlerbehandlung für Execute Omni Flow
  9. Weiter mit der Anrufweiterleitung
Tabelle 3. Hauptstrom
FlussBeschreibung
Lieferantenanrufschlüssel generieren

Jeder in Service Cloud Voice abgewickelte Anruf erzeugt einen Voice Call-Datensatz in Salesforce und erfordert eine eindeutige ID namens Vendor Call Key. Bei Sprachanrufdatensätzen, die im Webex Contact Center erstellt werden, muss der Anbieteranrufschlüssel im WxCC-Flow definiert und dann zusammen mit dem Anruf über eine Flow-Variable an den Agenten übergeben werden.

Der Wert vendorCallKey muss den folgenden Regeln entsprechen:

  • Der Wert muss sein < = 255 Zeichen lang.
  • Der Wert darf alphanumerische Zeichen sowie Unterstrich (_), Bindestrich (-) und Punkt (.) enthalten.
  • Der Wert muss mit einem Buchstaben beginnen, darf keine Leerzeichen enthalten, nicht mit einem Unterstrich enden und darf keine zwei aufeinanderfolgenden Unterstriche enthalten.

  • Aktivitätsbezeichnung: Generate_VendorCallKey
  • Variablenname: SCV_VendorCallKey
  • Variablentyp: String
  • Variablenwert - Sollwert: wxcc_{{NewPhoneContact.InteractionId}}

Anrufstartzeit festlegen

UTC-Zeitstempel des Anrufbeginns. Dieser Zeitstempel wird verwendet, um den Sprachanrufdatensatz zu erstellen und um den Sprachanrufdatensatz zu aktualisieren, wenn der Anrufer auflegt, bevor er an den Agenten weitergeleitet wird.

  • Aktivitätsbezeichnung: Anrufstartzeit festlegen
  • Variable: SCV_Anrufstartzeit
  • Variablenwert - Sollwert: {{now() | replace({'[UTC]': ''})}}
HTTP-Anfrage: Sprachanrufaufzeichnung erstellen

Dieser Schritt ist für jeden Anruf erforderlich. Nachdem der Sprachanrufdatensatz erstellt wurde, muss die Sprachanrufdatensatz-ID zusammen mit dem Anruf an den Agenten in einer Variablen übergeben werden, zusammen mit dem Anbieteranrufschlüssel. Konfigurieren Sie die verwendete Variable in der Contact Center-Konfiguration in Service Cloud Voice.

HTTP-Anfrageeinstellungen
  • Aktivitätsbezeichnung: CreateVoiceCall
  • Authentifizierten Endpunkt verwenden: Aktiviert
  • Anschluss: Der Salesforce Connector wurde im vorherigen Schritt erstellt.
  • Anfragepfad: /services/apexrest/cisco_wxcc_scv/voice/v1/createVoiceCall
  • Methode: POST
  • Anfrageinhaltstyp: Application/JSON

HTTP-Anfrage: Sprachanrufaufzeichnung erstellen

Dieser Schritt ist für jeden Anruf erforderlich. Nachdem der Sprachanrufdatensatz erstellt wurde, muss die Sprachanrufdatensatz-ID zusammen mit dem Anruf an den Agenten in einer Variablen übergeben werden, zusammen mit dem Anbieteranrufschlüssel. Konfigurieren Sie die verwendete Variable in der Contact Center-Konfiguration in Service Cloud Voice.

HTTP-Anfrageeinstellungen

  • Aktivitätsbezeichnung: CreateVoiceCall
  • Authentifizierten Endpunkt verwenden: Aktiviert
  • Anschluss: Der Salesforce Connector wurde im vorherigen Schritt erstellt.
  • Anfragepfad: /services/apexrest/cisco_wxcc_scv/voice/v1/createVoiceCall
  • Methode: POST
  • Anfrageinhaltstyp: Application/JSON

Anfragetext

Beim Erstellen des Sprachanrufdatensatzes können Sie auch benutzerdefinierte Felder im Sprachanrufdatensatz mit Anrufdaten aktualisieren. Nachfolgend finden Sie zwei Beispiele für den Anfragetext: eines mit allen erforderlichen Feldern, aber ohne Aktualisierung der benutzerdefinierten Felder, und eines mit benutzerdefinierten Feldern.

Ohne Aktualisierung benutzerdefinierter Felder im Sprachanrufdatensatz:

{
  "callCenterDevName": "",
  "certDevName": "",
  "vendorCallKey": "{{SCV_VendorCallKey}}",
  "to": "{{NewPhoneContact.DNIS}}",
  "from": "{{NewPhoneContact.ANI}}",
  "initiationMethod": "Inbound",
  "startTime": "{{SCV_CallStartTime}}",
  "participants": [
    {
      "participantKey": "{{NewPhoneContact.ANI}}",
      "type" : "END_USER"
    }
  ]
}

Beispiel für die Aktualisierung benutzerdefinierter Felder im Sprachanrufdatensatz:

{
  "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\": \"\"}"
}

Parameter
Name der Immobilie Wert
Name des Callcenter-Entwicklers Name des Entwicklers des Kontaktcenters
certDevName API-Name des Zertifikats (wie im Contact Center konfiguriert)
vendorCallKey Eindeutige Anrufer-ID: {{SCV_VendorCallKey}}
an CalledNumber/DNIS: {{NewPhoneContact.DNIS}}
von CallingNumber/ANI: {{NewPhoneContact.ANI}}
startTime UTC-Zeitstempel {{SCV_CallStartTime}} (wird direkt nach der Annahme des Aufrufs im Skript festgelegt)
Anrufattribute

Stellt zusätzliche Standard- und benutzerdefinierte Felder im Sprachanrufprotokoll dar, wobei jedes Schlüssel-Wert-Paar einem Standard- oder benutzerdefinierten Feld und seinen Werten entspricht.

Beispiel:

custfield1__c, custfield2__c, custfield3__c: API-Name des benutzerdefinierten Felds im Voice Call-Objekt

value1, value2, value3: Wert für das benutzerdefinierte Feld

Parse-Einstellungen
  • Inhaltstyp: JSON
  • Ausgabevariable: SCV_VoiceCallRecordId
  • Pfadausdruck: $.data.voiceCallId

Sprachanruf-ID, die an den Agenten weitergeleitet werden soll.

Auswertung der HTTP-Antwort für das Erstellen eines Sprachanrufdatensatzes

Überprüfen Sie den HTTP-Status der HTTP-Anfrage „Sprachanruf erstellen“:

  • Etikett: statusCodeCreateVoiceCall
  • Variable: CreateVoiceCall.httpStatusCode

Wenn Statuscode == 200 => sonst erfolgreich => Anfrage fehlgeschlagen, Fehlerbehandlung

Fehlerbehandlung für das Erstellen eines Sprachanrufdatensatzes

Zur Demo / Nur für Debugging, Wiedergabe der Nachricht abhängig vom HTTP-Statuscode.

Wenn das Erstellen eines Sprachanrufs erfolgreich war, fahren Sie mit dem Ausführen des Omni-Flows fort. Andernfalls fahren Sie mit der Anrufweiterleitung fort.

HTTP-Anfrage: Omni Flow ausführen (optionaler Schritt)

Verwenden Sie „Omni-Flow ausführen“, wenn Sie Folgendes möchten:

  • Führen Sie automatisierte Aufgaben aus, z. B. das Suchen oder Erstellen von Datensätzen, und verknüpfen Sie die Datensätze mit dem Sprachanrufdatensatz.
  • Suche nach Datensätzen und führe Screen-Pops durch.
  • Salesforce- und Cisco-Warteschlangen synchronisieren
  • Service Cloud Voice trifft die Routing-Entscheidung.

Diese Anfrage gibt immer die "Warteschlange" oder den "Agenten" zurück, an den der Anruf weitergeleitet werden soll.

Nach Ausführung dieser Anfrage stellen Sie sicher, dass Sie Clear Routing senden, falls der Anrufer auflegt, bevor ein Agent den Anruf entgegennimmt. Siehe Webex Contact Center Event Flow.

HTTP-Anfrageeinstellungen

  • Aktivitätsbezeichnung: ExecuteOmniFlow
  • Authentifizierten Endpunkt verwenden: Aktiviert
  • Anschluss: Der Salesforce Connector wurde im vorherigen Schritt erstellt.
  • Anfragepfad: /services/apexrest/cisco_wxcc_scv/voice/v1/executeOmniFlow
  • Methode: POST
  • Anfrageinhaltstyp: Application/JSON

Anfragetext

Neben den Pflichtfeldern können Sie zusätzliche Daten als Eingabevariablen an den Omni-Flow übergeben. Nachfolgend finden Sie zwei Beispiele für den Anfragetext. Die erste Version ohne zusätzliche Ablaufparameter, nur mit erforderlichen Feldern; die zweite Version mit zwei Eingabevariablen.

Beispiel mit Omni-Flow-Parametern:

{
  "callCenterDevName": "",
  "certDevName": "",
  "voiceCallId": "{{SCV_VoiceCallRecordId}}",
  "dialedNumber": "{{NewPhoneContact.DNIS}}",
  "flowDevName": "",
  "fallbackQueue": ""
}

Beispiel für die Aktualisierung der benutzerdefinierten Felder in einem Sprachanrufdatensatz:

{
  "callCenterDevName": "",
  "certDevName": "",
  "voiceCallId": "{{SCV_VoiceCallRecordId}}",
  "dialedNumber": "{{NewPhoneContact.DNIS}}",
  "flowDevName": "",
  "fallbackQueue": "",
  "flowInputParameters": 
  {
    "param1": "value1",
    "param2": "value2"
  }
}

Parameter
Name der Immobilie Wert
Name des Callcenter-Entwicklers Name des Entwicklers des Kontaktcenters
certDevName API-Name des Zertifikats (wie im Contact Center konfiguriert)
Sprachanruf-ID ID des im vorherigen Schritt erstellten Sprachanrufdatensatzes: {{SCV_VoiceCallRecordId}}
gewählte Nummer CalledNumber/DNIS: {{NewPhoneContact.DNIS}}
flowDevName Name des Entwicklers des auszuführenden Omni-Flows
Fallback-Warteschlange Warteschlangen-ID oder Warteschlangen-API-Name der Salesforce-Fallback-Warteschlange
flowInputParameters

Zusätzliche Eingaben für den Omni-Channel-Ablauf (Schlüssel-Wert-Paar).

Beispiel:

param1, param2: Name des Omni-Flow-Eingabeparameters

value1, value2: Wert für den Parameter

Parse-Einstellungen

Warteschlange

  • Inhaltstyp: JSON
  • Ausgabevariable: SCV_OmniFlowQueue
  • Pfadausdruck: $.data.queue

Die von Execute Omni-Flow zurückgegebene "Queue" kann für das Routing verwendet werden.

Agent
  • Inhaltstyp: JSON
  • Ausgabevariable: SCV_OmniFlowAgent
  • Pfadausdruck: $.data.agent

Der von Execute Omni-Flow zurückgegebene "Agent" kann für das Routing verwendet werden.

Auswertung der HTTP-Antwort für die Ausführung des Omni-Flows

Überprüfen Sie den HTTP-Status der Execute Omni Flow-HTTP-Anfrage:

  • Etikett: statusCodeExecuteOmniFlow
  • Variable: ExecuteOmniFlow.httpStatusCode

Wenn Statuscode == 200 => sonst erfolgreich => Anfrage fehlgeschlagen, Fehlerbehandlung.

Fehlerbehandlung für Execute Omni Flow

Zur Demo / Nur für Debugging, Wiedergabe der Nachricht abhängig vom HTTP-Statuscode.

Wenn Execute Omni Flow erfolgreich war, werden die Variablen SCV_OmniFlowQueue und SCV_OmniFlowAgent nicht gesetzt. Routing-Entscheidung im Anrufablauf.

Weiter mit der Anrufweiterleitung

Im Gesprächsablauf fortfahren, Anruf an den Agenten weiterleiten. Optional können Sie SCV_OmniFlowQueue und SCV_OmniFlowAgent verwenden, um Warteschlange und Agent auszuwählen.

Webex Contact Center Ereignisablauf

Wenn der Anrufer auflegt, bevor ein Agent den Anruf entgegennimmt, müssen wir Service Cloud Voice aktualisieren und den Anruf beenden.

  • Wenn Execute Omni-Flow verwendet wurde, senden Sie Clear Routing, um das Pending Service Routing (PSR) zu löschen.
  • Senden Sie eine Aktualisierung des Sprachanrufs, um die Start- und Endzeit des Sprachanrufdatensatzes zu aktualisieren und den Status von „Neu“ auf „Abgeschlossen“ zu ändern.

  1. PhoneContactEnded - Dieses Ereignis wird ausgelöst, wenn ein laufendes Gespräch beendet wird und alle Teilnehmer entfernt werden.
  2. HTTP-Anfrage: Klare Weiterleitung
  3. HTTP-Anfrage: Sprachanruf aktualisieren
HTTP-Anfrage: Klare Weiterleitung

  • Etikett: Klare Weiterleitung
  • Authentifizierten Endpunkt verwenden: Aktiviert
  • Anschluss: Der Salesforce Connector wurde im vorherigen Schritt erstellt.
  • Anfragepfad: /services/apexrest/cisco_wxcc_scv/voice/v1/clearRouting
  • Methode: POST

Anfrageinhaltstyp: Application/JSON

Anfragetext

{
  "callCenterDevName": "",
  "certDevName": "",
  "voiceCallId": "{{SCV_VoiceCallRecordId}}"
}

Parameter

Name der ImmobilieWert
Name des Callcenter-Entwicklers Name des Entwicklers des Kontaktcenters
certDevName API-Name des Zertifikats (wie im Contact Center konfiguriert)
Sprachanruf-ID ID des im vorherigen Schritt erstellten Sprachanrufdatensatzes: SCV_VoiceCallRecordId

Parse-Einstellungen

Keine.

HTTP-Anfrage: Sprachanruf aktualisieren

  • Etikett: Sprachanruf aktualisieren
  • Authentifizierten Endpunkt verwenden: Aktiviert
  • Anschluss: Der Salesforce Connector wurde im vorherigen Schritt erstellt.
  • Anfragepfad: /services/apexrest/cisco_wxcc_scv/voice/v1/updateVoiceCall
  • Methode: POST
  • Anfrageinhaltstyp: Application/JSON

Anfragetext

{
  "callCenterDevName": "",
  "certDevName": "",
  "voiceCallId": "{{SCV_VoiceCallRecordId}}",
  "startTime": "{{SCV_CallStartTime}}",
  "endTime": "{{now() | replace({'[UTC]': ''})}}",
  "disconnectReason": { "value": "Abandoned in queue", "isError": true }
}

Parameter

Name der ImmobilieWert
Name des Callcenter-Entwicklers Name des Entwicklers des Kontaktcenters
certDevName API-Name des Zertifikats (wie im Contact Center konfiguriert)
Sprachanruf-ID ID des im vorherigen Schritt erstellten Sprachanrufdatensatzes: SCV_VoiceCallRecordId
startTime UTC-Zeitstempel des Anrufbeginns {{SCV_CallStartTime}} (wie er zur Erstellung des Sprachanrufdatensatzes verwendet wurde)
endTime Aktueller UTC-Zeitstempel `{{now()
Trennungsgrund Grund für die Beendigung des Gesprächs. Die Eigenschaft isError muss auf true gesetzt werden, damit sie korrekt angezeigt wird.

Parse-Einstellungen

Keine.

Referenzen

Sprachübersetzung

(Optional) Übersetzungs-Workbench aktivieren

Diese Einstellung ist nur anwendbar, wenn Sie die Übersetzungseinstellungen verwenden.

1

Gehen Sie zu Setup → Translation Workbench → Translation Language Settings.

2

Klicken Sie auf Aktivieren, um die Übersetzungssprache auszuwählen.

(Optional) Plattformspezifische Sprachen aktivieren

Diese Einstellung gilt nur für andere Sprachen als EN-US.

1

Gehen Sie zu Einstellungen → Unternehmenseinstellungen → Spracheinstellungen.

2

Wählen Sie die benötigten Sprachen aus.

3

Wählen Sie die folgenden Kontrollkästchen aus:

  • Endbenutzersprachen aktivieren – Hilfe und Einrichtung sind nicht in die Endbenutzersprachen übersetzt
  • Plattformspezifische Sprachen aktivieren – für plattformspezifische Sprachen werden keine Standardübersetzungen bereitgestellt.
4

Speichern Sie Ihre Änderungen.

Sprache aktivieren und Benutzer (Aufgabe) auswählen.
1

Gehen Sie zu Setup → Translation Workbench → Translation Language Settings.

2

Wählen Sie die Sprache und den Benutzer aus, der sie übersetzen soll.

3

Speichern Sie Ihre Änderungen.

Mehrsprachige Einstellungen
Benutzerdefinierte Bezeichnungen übersetzen
1

Gehen Sie zu Einstellungen → Benutzerdefinierte Etiketten.

2

Wählen Sie den Namen des benutzerdefinierten Labels aus, um es zu öffnen.

3

Klicken Sie in der zugehörigen Übersetzungsliste auf New, um eine neue Übersetzung einzugeben, oder auf Bearbeiten (neben der Sprache), um eine Übersetzung zu bearbeiten.

4

Wählen Sie die Zielsprache aus.

5

Geben Sie den übersetzten Wert in das Feld „Übersetzungstext“ ein. Dieser Text überschreibt den im Feld „Wert“ der Bezeichnung angegebenen Wert, wenn die Standardsprache des Benutzers die Übersetzungssprache ist.

6

Speichern Sie Ihre Änderungen.

Funktion „Vom Benutzer benötigte Salesforce-Berechtigungen“

Das Webex Contact Center SCV Agenten-Berechtigungsset enthält alle Berechtigungen, die für die Arbeit mit dem Webex Contact Center Gadget und den für Agenten entwickelten Integrationen erforderlich sind.

Zugriff auf Apex-Klassen (Abschnitt)

  • cisco_wxcc_scv.CiscoScvWxcc
  • cisco_wxcc_scv.ServiceResponseHandler
  • cisco_wxcc_scv.ServiceRouting
  • cisco_wxcc_scv.TelephonyIntegrationHandler

Zugriffe auf benutzerdefinierte Metadatentypen (Abschnitt)

  • cisco_wxcc_scv.WxCC-Verbindung

Visualforce-Seitenzugriff (Abschnitt)

  • cisco_wxcc_scv.CiscoScvLoginWxCC
  • cisco_wxcc_scv.CiscoScvMainWxCC
  • cisco_wxcc_scv.CiscoScvOAuthRedirect
  • cisco_wxcc_scv.CiscoScvSwLoader

Service Cloud Voice API Wrapper

Voraussetzungen

Um den Service Cloud Voice API Wrapper nutzen zu können, muss eine Salesforce External Client App für die IVR-Integration konfiguriert werden.

Verwenden Sie den Service Cloud Voice API Wrapper

Service Cloud Voice (SCV) für Salesforce verwendet die Telephony Integration REST API, um VoiceCalls zu erstellen und zu aktualisieren, Omni-Channel-Flows auszuführen und PendingServiceRouting-Datensätze zu löschen, die einem VoiceCall zugeordnet sind. Dieser Dienst erfordert eine JWT-Autorisierung und die Verwendung der PATCH-HTTP-Methode, die derzeit von Cisco IP Interactive Voice Response (IVR) nicht unterstützt wird.

Um die Nutzung der Telephony Integration REST API für SCV (nicht nur) in einem IVR-System zu vereinfachen, wurde ein neuer Satz von APIs bereitgestellt, die die bestehende Salesforce-API umschließen und direkt von der Salesforce-Organisation aus zugänglich sind, in der das Webex Contact Center for Service Cloud Voice-Paket installiert ist.

Der Service Cloud Voice API Wrapperbeseitigt die Notwendigkeit der Authentifizierung eines JWT-Tokens, implementiert zusätzliche Prüfungen der von der Salesforce API benötigten Daten und verbessert die Antwortobjekte.

Rufe das Access_Token ab

Führe eine POST Anfrage aus https://<your-domain-name>.my.salesforce.com/services/oauth2/token

Folgende Parameter werden im Nachrichtentext gesendet:

{
 "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": ""
 }

Führe die Anfragen aus

Die Instanz-URL muss my.salesforce.com enthalten.

Beispiel einer korrekten Instanz-URL: https://abc-123.my.salesforce.com

Die Verwendung einer anderen Domain als Instanz-URL (z. B. https://abc-123.lightning.force.com ) führt zu einem 401 Unauthorized-Status mit dem Rückgabewert INVALID_SESSION_ID errorCode.

Sprachanruf erstellen (Abschnitt)

Erstellt einen VoiceCall-Datensatz, der die Teilnehmer (d. h. Anrufer und Empfänger) für den VoiceCall-Datensatz enthält. Wenn Sie einen VoiceCall-Datensatz erstellen, wird in Salesforce eine Konversation angelegt. Diese API darf nur in einem Echtzeitkontext verwendet werden, das heißt, sie sollte nur dann aufgerufen werden, wenn ein Anruf initiiert wird. Diese API kann auch verwendet werden, um VoiceCall-Datensätze für Weiterleitungen und Konferenzgespräche zu erstellen, indem der Parameter parentVoiceCallId in die Anfragenutzlast aufgenommen wird.

Endpunkt-URI

<instance_url>/services/apexrest/cisco_wxcc_scv/voice/v1/createVoiceCall

HTTP-Methode

POST

Überschriften

Genehmigung: Träger <access_token>

Inhaltstyp: application/json

Parameter

{
 "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"
 }

Eine detaillierte Beschreibung der von dieser Anfrage akzeptierten Parameter finden Sie in der offiziellen Salesforce- Dokumentation im Abschnitt „Parameter “ .

Antwort (erfolgreich)

{
 "data": {
 "voiceCallId": "00X000012345abc"
 },
 "errors": null,
 "success": true
 }

Antwort (mit Fehlern)

 
{
 "data": null,
 "errors": ["Error message 1", "Error message 2"],
 "success": false
 }

Sprachanruf aktualisieren

Aktualisiert VoiceCall nach Beendigung des Anrufs. Nutzen Sie diese API, um anrufbezogene Parameter zu aktualisieren, die während der Erstellungsphase des VoiceCalls nicht verfügbar sind. Die Update VoiceCall API ist ein asynchroner Vorgang. Der Status des API-Aufrufs kann nicht abgefragt werden.

Dieser Endpunkt kann auch verwendet werden, um einen VoiceCall zu erstellen, selbst nachdem der Anruf beendet wurde. Dieses Verhalten ist nützlich in Szenarien, in denen Sie einen Datensatz in Salesforce für abgebrochene oder verpasste Anrufe protokollieren möchten, oder in jedem anderen Szenario, in dem noch kein VoiceCall erstellt wurde.

Endpunkt-URI

<instance_url>/services/apexrest/cisco_wxcc_scv/voice/v1/updateVoiceCall

HTTP-Methode

POST

Überschriften

Genehmigung: Träger <access_token>

Inhaltstyp: application/json

Parameter

{
 "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
 }
 }

Eine detaillierte Beschreibung der von dieser Anfrage akzeptierten Parameter finden Sie in der offiziellen Salesforce - Dokumentation im Abschnitt „Parameter“.

Antwort (erfolgreich)

{
 "data": {
 "status": "pending"
 },
 "errors": null,
 "success": true
 }

Die Update VoiceCall API ist ein asynchroner Vorgang. Der Status des API-Aufrufs kann nicht abgefragt werden.

Antwort (mit Fehlern)

{
 "data": null,
 "errors": ["Error message 1", "Error message 2"],
 "success": false
 }

Omni-Flow ausführen

Führt den Omni-Channel-Ablauf zur Anrufweiterleitung aus. Es übergibt die Anruf-ID (Salesforce VoiceCallId oder ContactId des Telefonieanbieters) als Parameter an den Ablauf und gibt die Agenten- oder Warteschlangen-Routing-Anweisungen an den Kontaktablauf zurück. Standardmäßig verwendet Service Cloud Voice den Omni-Channel-Flow (oder die Fallback-Warteschlange), der für den Telefonkanal festgelegt ist, der der gewählten Nummer entspricht. Wenn die gewählte Nummer keinem vorhandenen Telefonkanal entspricht, können Sie optional eine neue gewählte Nummer, einen Omni-Channel-Ablauf und eine Ausweichwarteschlange als Eingabeparameter für diesen API-Aufruf festlegen.

Service Cloud Voice verwendet diese Prioritätsreihenfolge für die Anrufweiterleitung:

  1. Verwendet die Einstellungen für Omni-Channel Flow und Fallback Queue für den Telefonkanal, der der gewählten Nummer entspricht. Der Ablauf hat Vorrang. Falls der Ablauf fehlschlägt, wird die Ausweichwarteschlange verwendet.
  2. Verwendet die im Execute Omniflow API-Aufruf angegebenen Parameter flowDevName und fallbackQueue.

Endpunkt-URI

<instance_url>/services/apexrest/cisco_wxcc_scv/voice/v1/executeOmniFlow

HTTP-Methode

POST

Überschriften

Genehmigung: Träger <access_token>

Inhaltstyp: application/json

Parameter

{
  "callCenterDevName": "contactCenterDevName123",
  "certDevName": "certDevName123",
  "voiceCallId": "00X000012345abc",
  "dialedNumber": "+18445791189",
  "flowDevName": "Route_VoiceCall",
  "fallbackQueue": "00G111222333444",
  "flowInputParameters":
  {
    "Input1": "one",
    "Input2": "two"
  }
}

  • Der Parameter voiceCallId ist die Salesforce-Sprachanruf-ID oder die Kontakt-ID des Telefonieanbieters.
  • Eine detaillierte Beschreibung der von dieser Anfrage akzeptierten Parameter finden Sie in der offiziellen Salesforce - Dokumentation im Abschnitt „Parameter“.

Antwort (erfolgreich)

{
  "data": {
    "queue": "queue info",
    "agent": "agent info"
  },
  "errors": null,
  "success": true
}

AGENT_INFO und QUEUE_INFO entsprechen dem Feld ExternalId in der CallCenterRoutingMap.

Antwort (mit Fehlern)

{
 "data": null,
 "errors": ["Error message 1", "Error message 2"],
 "success": false
 }

Klare Routenführung

Löscht den PendingServiceRouting (PSR)-Datensatz für einen Sprachanruf. Diese API muss in den meisten Fällen nicht aufgerufen werden; der PSR-Datensatz wird automatisch gelöscht, wenn der Anruf nicht mehr weitergeleitet wird. Es gibt jedoch einige Szenarien, wie z. B. verpasste oder abgebrochene Anrufe bei der Verwendung von Partner-Telefonsystemen, in denen Sie diese API explizit aufrufen müssen, um den PSR-Datensatz zu löschen.

Endpunkt-URI

<instance_url>/services/apexrest/cisco_wxcc_scv/voice/v1/clearRouting

HTTP-Methode

POST

Überschriften

Genehmigung: Träger <access_token>

Inhaltstyp: application/json

Parameter

{
 "callCenterDevName": "contactCenterDevName123",
 "certDevName": "certDevName123",
 "voiceCallId": "00X000012345abc"
 }

  • Der Parameter voiceCallId ist die Salesforce-Sprachanruf-ID oder die Kontakt-ID des Telefonieanbieters.
  • Eine detaillierte Beschreibung der von dieser Anfrage akzeptierten Parameter finden Sie in der offiziellen Salesforce - Dokumentation im Abschnitt „Parameter“.

Antwort (erfolgreich)

{
 "data": {
 "status": "Success"
 },
 "errors": null,
 "success": true
 }

Antwort (mit Fehlern)

{
 "data": null,
 "errors": ["Error message 1", "Error message 2"],
 "success": false
 }

Telefonnummernübersetzungen

Verschiedene Interaktionen zwischen Service Cloud Voice und Webex Contact Center hängen von der Übersetzung von Telefonnummern ab. Aufgrund internationaler Unterschiede und kundenspezifischer Anwendungen ist ein anpassbares Tool erforderlich, um Telefonnummern vom Format A in das Format B zu übertragen.

Die Webex Contact Center for Service Cloud Voice-Lösung entfernt automatisch alle Zeichen außer Zahlen und Hashtags. (#), Sternchen (*), Kommas (,) und führende Pluszeichen (+). Außerdem wird das erste Vorkommen von (0) entfernt. Dies wird VOR der Anwendung Ihrer Telefonnummernübersetzungen durchgeführt.

Diese Anleitung beschreibt, wie Sie die Übersetzung von Telefonnummern konfigurieren.

Felder

Die Übersetzungen von Telefonnummern werden in Name-Wert-Feldern gespeichert. Dies ermöglicht es Ihnen, eine unbegrenzte Anzahl von Regeln pro Funktion zu konfigurieren.

Die Konfiguration wird als JSON-Zeichenkette gespeichert.

Beachten Sie, dass Backslashes maskiert werden müssen, z. B. \d+ wird \\d+.

{"Remove all characters but digits":"[1,17]->[^\\d]+","To internal number":"[7,17]->(\\d{7})(\\d{4})->$2"}

Das Feld „Name“ wird technisch gesehen nicht verwendet. Es dient dazu, eine für Menschen lesbare Zeichenkette hinzuzufügen, um den Zweck dieser Regel schnell zu erkennen. Gute Namen sind zum Beispiel: Entferne alle führenden Nullen, Füge ein führendes Pluszeichen hinzu usw.

Übersetzungsregeln erstellen

Die Regeln werden als reguläre Ausdrücke bereitgestellt. Um genauer zu sein: Die JavaScript-Implementierung regulärer Ausdrücke.

Ein guter Einstieg ist das Lesen des RegExp-Dokuments in den MDN-Webdokumenten.

Dennoch ist die Erstellung komplexer regulärer Ausdrücke oft umständlich. Deshalb haben wir zusätzliche Syntax hinzugefügt, um die Konfiguration so einfach wie möglich zu gestalten.

Die folgende Abbildung zeigt die allgemeine Syntax einer Regel zur Übersetzung von Telefonnummern:

Prädikat

Das Prädikat dient zur Angabe eines Intervalls, das die Länge der abzugleichenden Zahl definiert.

Das obige Prädikat legt fest, dass alle Zahlen mit einer Länge zwischen 7 und 11 Zeichen (einschließlich Ränder) + Leerzeichen) übereinstimmen.

Prädikate entsprechen immer der ursprünglichen Länge der Zahl. Dies vereinfacht die Konfiguration, indem das Risiko von Regelkonflikten für interne Zwecke reduziert wird. / externe Nummern.

Muster

Das Muster gibt das Format der abzugleichenden Zahl an.

Das obige Muster besagt, dass die Zahl nur aus Ziffern bestehen darf und wählt diese aus.

Wähler

Selektoren definieren das endgültige Format der Zahl. Wenn Zeichen / Es müssen Ziffern hinzugefügt werden, die ursprünglich nicht vorhanden waren; hier ist der richtige Ort dafür.

Der Selektor ist der letzte Schritt beim Erstellen der Zahl. Auf Basis des ausgegebenen Musters erstellt der Selektor die neue Nummer.

Beispiel 1

Das folgende Beispiel zeigt, wie eine vom Contact Center im Format 0319175200 empfangene Nummer in das Schweizer E164-Format umgewandelt wird. +41 31 917 52 00.

Dieses Beispiel verwendet zwei Übersetzungsregeln (1. und 2.)

Die erste Regel in diesem Beispiel ändert die Zahl tatsächlich nicht. Bei Zahlen mit einer Länge zwischen 1 und 17 Zeichen werden alle Zeichen außer Ziffern entfernt. Da keine Nicht-Ziffern vorhanden sind, ändert sich nichts.

Die zweite Regel gilt für Zahlen, die (ursprünglich) genau 10 Zeichen lang sind. 0319175200 entspricht dieser Regel, daher findet sie Anwendung. Das Muster legt fest, dass die Zahl mit einer einstelligen Zifferngruppe beginnen muss. (\d{1}), gefolgt von einer Zweiergruppe von Ziffern (\d{2}), gefolgt von einer Gruppe von drei Ziffern (\d{3}), und so weiter.

Der Selektor greift dann auf die Mustergruppen zu, um die neue Zahlenfolge zu definieren. Das heisst $2 bezieht sich auf das erste (\d{2}) und enthält daher 31.

Beispiel 2

Das folgende Beispiel zeigt, wie eine vom Contact Center erhaltene Nummer im folgenden Format übertragen wird: +14693150217 zum US-amerikanischen E164-Format +1 469 315 0217.

Dieses Beispiel verwendet zwei Übersetzungsregeln (1. und 2.)

  1. Diese Zahl ist genau 12 Zeichen lang, daher gilt die Regel „US-Zahlen mit Leerzeichen versehen“.
  2. (\+1) besagt, dass die Zahl mit beginnen muss +1. Wenn die Zahl 12 Zeichen lang ist, aber nicht mit einem Buchstaben beginnt +1, Die Regel wird aufgehoben, aber es ändert sich nichts.
  3. (\d{3}) besagt, dass +1 müssen 3 Ziffern folgen.
  4. (\d{3}) besagt, dass auf die letzten 3 Ziffern weitere 3 Ziffern folgen müssen.
  5. (\d{4}) besagt, dass auf die letzten 3 Ziffern 4 Ziffern folgen müssen.

Sollte eine dieser Angaben nicht übereinstimmen, wird die Nummer nicht geändert.

Also gelten alle Regeln für “+14693150217”. Daher ändert sich die Zahl um “$1 $2 $3 $4”:

  1. $1 bezieht sich auf die Gruppe (\+1), Die Nummer, die an Service Cloud Voice gesendet werden soll, sieht folgendermaßen aus: +1.
  2. $2 bezieht sich auf das erste der beiden (\d{3}), die Nummer, die an Service Cloud Voice gesendet werden soll, sieht folgendermaßen aus: +1 469.
  3. $3 bezieht sich auf das zweite der beiden (\d{3}), die Nummer, die an Service Cloud Voice gesendet werden soll, sieht folgendermaßen aus: +1 469 315.
  4. $4 bezieht sich auf die letzte Gruppe (\d{4}), die Nummer, die an Service Cloud Voice gesendet werden soll, sieht folgendermaßen aus: +1 469 315 0217.

Die Leerzeichen im Ersetzungsteil der Regel “$1 $2 $3 $4” werden direkt verwendet. Wenn Sie also verwenden “$1-$2-$3-$4” Die Zahl würde wie folgt übersetzt werden: +1-469-315-0217

Und Sie dürfen auch Gruppen entfernen: [12, 12]->(\+1)(\d{3})(\d{3})(\d{4})->$2 $3 $4 wird übersetzt in: 469 315 0217. [12, 12]->(\+1)(\d{3})(\d{3})(\d{4})-> $3 $4 wird übersetzt in: 315 0217.

Es ist auch möglich, eine internationale US-Nummer in eine lokale Nummer umzuwandeln, zum Beispiel: [12, 12]->(\+1)(\d{3})(\d{3})(\d{4})->($2) $3-$4.

Dann die eingehende Nummer “+14693150217” wird übersetzt in: (469) 315-0217.

Beispiel 3

Das folgende Beispiel zeigt, wie eine vom Contact Center erhaltene Nummer im folgenden Format übertragen wird: +491515555531 zum deutschen E164-Format +49 151 5555 531.

Dieses Beispiel verwendet zwei Übersetzungsregeln (1. und 2.)

  1. Diese Zahl ist genau 13 Zeichen lang, daher gilt die Regel „Deutsche Zahlen mit Leerzeichen versehen“.
  2. (\+49) besagt, dass die Zahl mit beginnen muss +49. Wenn die Zahl 13 Zeichen lang ist, aber nicht mit einem Buchstaben beginnt +49, Die Regel wird aufgehoben, aber es ändert sich nichts.
  3. (\d{3}) besagt, dass +49 müssen 3 Ziffern folgen.
  4. (\d{4}) besagt, dass auf die letzten 3 Ziffern 4 Ziffern folgen müssen.
  5. (\d{3}) besagt, dass auf die letzten 4 Ziffern 3 Ziffern folgen müssen.

Sollte eine dieser Angaben nicht übereinstimmen, wird die Nummer nicht geändert.

Alle Regeln gelten also für “+491515555531”. Daher ändert sich die Zahl um “$1 $2 $3 $4”:

  1. $1 bezieht sich auf die Gruppe (\+49), Die Nummer, die an Service Cloud Voice gesendet werden soll, sieht folgendermaßen aus: +49.
  2. $2 bezieht sich auf das erste der beiden (\d{3}), die Nummer, die an Service Cloud Voice gesendet werden soll, sieht folgendermaßen aus: +49 151.
  3. $3 bezieht sich auf das zweite der beiden (\d{4}), die Nummer, die an Service Cloud Voice gesendet werden soll, sieht folgendermaßen aus: +49 151 5555.
  4. $4 bezieht sich auf die letzte Gruppe (\d{3}), die Nummer, die an Service Cloud Voice gesendet werden soll, sieht folgendermaßen aus: +49 151 5555 531.

Das Gleiche gilt für Regel eins. Sie können das Ersatzteil verwenden. $1 $2 $3 $4 aus der Zahl auszuwählen, was verwendet werden soll.

Weitere Beispiele für reguläre Ausdrücke zur Übersetzung

Beschreibung Übersetzungsregex
Entferne alle Zeichen außer Ziffern [1,17]->[^\d]+
Entferne alle Zeichen außer Ziffern & + [1,17]->[^+\d]+
Beschreibung Übersetzungsregex
Entfernen +1 [12,12]->(.{1})(\d{1})(\d{10})->$3
Entfernen +1 [10,12]->(^\+1+)(\d+)->$2
Entfernen +49 [10,15]->(^\+49+)(\d+)->$2
Entfernen +49 [10,15]->(.{1})(\d{2})(\d{9})->$3
Entfernen +41 [10,13]->(^\+41+)(\d+)->$2
Entfernen +41 [10,13]->(.{1})(\d{2})(\d{9})->$3
Entfernen +XX [10,14]->(^\++)(\d{2})(\d+)->$3
Beschreibung Übersetzungsregex
Entfernen + und ersetzen Sie es durch Nullen US E164 [10,12]->(.{1})(\d{1})(\d{10})-> 001 $3
Entfernen +1 und ersetzen Sie es durch Nullen US E164 [10,12]->(^\+1+)(\d+)-> 001$2
Entfernen + und ersetzen Sie es durch Nullen DE E164 [12,15]->(.{1})(\d{2})(\d{10})-> 0049 $3
Entfernen +49 und ersetzen Sie es durch Nullen DE E164 [10,12]->(^\+49+)(\d+)-> 0049$2
Entfernen + und ersetzen Sie es durch Nullen CH E164 [10,13]->(.{1})(\d{2})(\d{9})-> 0041 $3
Entfernen +41 und ersetzen Sie es durch Nullen CH E164 [10,12]->(^\+41+)(\d+)-> 0041$2
Beschreibung Übersetzungsregex
US-Nummer mit Leerzeichen [12,17]->(\d{1})(\d{3})(\d{3})(\d{4})->+1 $2 $3 $4
US-Nummer mit Leerzeichen [12,17]->(\+1)(\d{3})(\d{3})(\d{4})->$1 $2 $3 $4
DE-Nummer mit Leerzeichen [12,17]->(\d{2})(\d{3})(\d{4})(\d{3})->+49 $2 $3 $4
DE-Nummer mit Leerzeichen [12,17]->(\+49)(\d{3})(\d{4})(\d{3})->$1 $2 $3 $4
CH-Nummer mit Leerzeichen [12,17]->(\d{2})(\d{2})(\d{3})(\d{2})(\d{2})->+41 $2 $3 $4
CH-Nummer mit Leerzeichen [12,17]->(\+41)(\d{2})(\d{3})(\d{2})(\d{2})->$1 $2 $3 $4

Konfiguration der VoiceCall-Seite

Konfigurieren der VoiceCall-Aufzeichnungsseite

Die VoiceCall-Aufzeichnungsseite ist standardmäßig vorkonfiguriert und verfügt über ein 3-spaltiges Layout sowie die folgenden Komponenten:

  • Aktionen & Empfehlungen
  • Anrufprotokolle
  • Anrufdetails
  • Aufzeichnungen

Komponenten können je nach Geschäftsbedarf frei von der Seite entfernt oder hinzugefügt werden. Es können auch unterschiedliche Seitenlayouts verwendet werden, aber einige Komponenten, wie der Anrufaufzeichnungsplayer und der Gesprächstext, passen nur auf mittlere und große Bereiche der Vorlage.

Zeigen Sie die Komponente „Zusammenfassungsgrund“ an.

Die Komponente „Grund für die Zusammenfassung“ muss während des Anrufs und während der Zusammenfassung angezeigt werden.

Fügen Sie die Cisco-Komponente „Grund für die Abschlussbesprechung“ zur VoiceCall-Aufzeichnungsseite hinzu:

  1. Ziehen Sie die Lightning-Webkomponente Cisco Wrap-Up Reason aus dem Bereich "Benutzerdefiniert" der Lightning-Komponentenliste auf die Seite "VoiceCall Record".
  2. Klicken Sie auf Speichern.
  3. Klicken Sie auf Aktivieren.
  4. Klicken Sie auf Als Organisationsstandard zuweisen.
  5. Klicken Sie auf Speichern.
  6. Klicken Sie erneut auf Speichern und anschließend auf den Zurück-Pfeil, um zur Seite zurückzukehren.

Die Komponente „ Grund für die Cisco-Wiederaufnahme “ wird während des Anrufs und während der Nachbearbeitung automatisch angezeigt:

Wenn die Komponente „Cisco Wrap-Up Reason“ zur Seite hinzugefügt wird, wird sie für jeden Anruf angezeigt, auch wenn in Cisco Contact Center kein Wrap-Up konfiguriert ist.

Anrufaufzeichnungsplayer anzeigen

Der Anrufaufzeichnungsplayer wird angezeigt, wenn für den entsprechenden Sprachanruf ein Aufzeichnungslink gespeichert wurde.

Führen Sie diese Schritte aus, um die Komponente „Anrufaufzeichnungsplayer“ zur Seite „Sprachanrufaufzeichnung“ hinzuzufügen:

  1. Ziehen Sie die Lightning-Webkomponente „Anrufaufzeichnungsplayer“ auf die Seite „Sprachanrufaufzeichnung“.
  2. Klicken Sie aufSpeichern.
  3. Klicken Sie aufAktivieren.
  4. Klicken Sie aufAls Organisationsstandard zuweisen.
  5. Klicken Sie aufSpeichern.
  6. Klicken Sie erneut aufSpeichernund anschließend auf den Zurück-Pfeil, um zur Seite zurückzukehren.

Webex-Administratoren

Flusskonfiguration

Bildschirm-Pop-up

Im Webex Contact Center Flow ist ein „Screen Pop“-Knoten verfügbar. Es kann verwendet werden, um ein Popup-Fenster innerhalb von Service Cloud Voice oder in einem separaten Fenster auszulösen.

Weitere Informationen zu dieser Funktion finden Sie in der Flow Designer-Dokumentation .

Bildschirm-Pop in einem separaten Fenster

Um das Screen-Pop-up in einem separaten Fenster zu öffnen, muss im Knoten „Screen Pop“ eine absolute URL angegeben werden. Die queryParameters werden als Suchparameter an die URL angehängt.

Folgende Modi werden unterstützt:

  • Neuer Browser-Tab - Öffnet immer einen neuen Browser-Tab.
  • Vorhandener Browser-Tab - Beim ersten Popup des Fensters "Vorhandener Browser-Tab" wird ein neuer Browser-Tab geöffnet. Dieser Tab dient als fester Tab für alle nachfolgenden Pop-ups des bestehenden Browser-Tabs, und die URL wird innerhalb dieses spezifischen Browser-Tabs aktualisiert.
  • Innerhalb des Desktops - Wird auf die gleiche Weise behandelt wie Neuer Browser-Tab.

Die aktuell geöffnete Seite kann eine Weiterleitung verhindern. In diesem Fall öffnet sich ein Fenster des bestehenden Browser-Tabs in einem neuen Browser-Tab.

War dieser Artikel hilfreich für Sie?
War dieser Artikel hilfreich für Sie?