Bevor Sie die Konfigurationsschritte befolgen, müssen Sie zuerst zur Software-Dokumentation gehen und die neueste Version des Webex App Salesforce-Pakets herunterladen.

Anforderungen

Salesforce Unternehmens-Ausgabe

Diese Integration erfordert ein Minimum an Salesforce-Unternehmens-Ausgabe. Weitere Informationen finden Sie unter Salesforce-Ausgaben .

Meine Domäne in Salesforce-Organisation

Sie müssen "Meine Domäne" in Ihrer Organisation bereitstellen, wenn Sie Lightning-Komponenten verwenden möchten. Weitere Informationen finden Sie in der Dokumentation "Meine Domäne Salesforce ".

Benutzerzugriff im Control Hub

Sie müssen den Benutzerzugriff auf Integrationen in Ihrer Organisation konfigurieren.

• Without Pro Pack—When you have the basic Control Hub, you can choose to allow or deny access to all integrations for all of your users.

• With Pro Pack—With Pro Pack, you have advanced functionality to manage access to integrations for users.

Weitere Informationen finden Sie unter Benutzerzugriff auf Integrationen konfigurieren.

Calling

• Webex Calling eingehende und ausgehende Anrufe für die Anrufsteuerung in Salesforce werden vollständig unterstützt.

• Anrufe in Webex (Unified CM) werden teilweise unterstützt. Nur ausgehende Anrufe eröffnen ein Anmelde-Pop-up bei Salesforce. Bei eingehenden Klingeln klingelt die Webex-App, aber Salesforce kann den Anruf nicht abfangen, sodass das Protokollierungs-Popup nicht angezeigt wird.

If you're working with Webex for Salesforce version 1.18 or earlier, before you can work with Webex Calling within Salesforce, you'll need to configure a Salesforce authorization. Follow the sections in this article to get up and running.

These procedures apply to customers using version 1.18 and earlier of the Webex Salesforce integration. See the updated instructions for versions 1.19 and later: Configure a Salesforce authorization (1.19 and later) in the Install and administer tab

1. Create a Connected App

To create a new Connected App:

1. In Setup, search for App Manager and then choose New Connected App.

   

2. Enter a Connected App Name, for example, MyExampleApp.
3. Enter a Contact Email address.
4. Check Enable OAuth Settings.
5. Specify a placeholder Callback URL (we’ll update this later), for example, https://localhost/placeholder.

   

6. Scroll down and choose the following OAuth Scopes:
   • Full access (full)
   • Perform requests at any time (refresh_token, offline_access)

   

   The Perform requests at any time scope allows Named Credentials to refresh your access token when a session expires.

7. Scroll to the bottom of the page and click Save and then click Continue.
8. In the next page, scroll to API (Enable OAuth Settings) and click Manage Consumer Details.

   

   You may need to reauthenticate with Salesforce.

9. Make a note of the Consumer Key and the Consumer Secret.

   

2. Create an Auth Provider

Next you'll need to create an authentication provider, which facilitates the authentication with your Salesforce organization.

To create an auth provider:

1. In Setup, search for Auth and select Auth. Providers. Klicken Sie auf Neu.

   

2. Select Salesforce as the Provider Type.
3. Enter a name for the Auth provider, for example, ApexMDTAPI.
4. Paste in the Consumer Key and Consumer Secret you saved when configuring your Connected app.
5. Enter the following scopes in Default Scopes, full refresh_token offline_access.
6. Leave everything else blank and click Save.

   

7. Copy the Callback URL from the Salesforce Configuration section.

   

8. Edit your Connected App and replace the placeholder URL with the Callback URL you copied from the Salesforce Configuration above.

   

9. Save your Connected App.

   You may need to wait up to 10 minutes to allow the settings to take effect and propagate throughout Salesforce’s infrastructure.

3. Create a named credential

You'll then need to create a named credential.

To create a named credential:

1. In Setup, search for Named and select Named Credentials. Click New Legacy.

   

2. Enter the following value for Label, ApexMDTAPI.
3. For the URL, enter your organization’s instance URL, for example, https://na1.salesforce.com, or, if you are using My Domain, your fully qualified My Domain domain name, for example, https://mycompany.my.salesforce.com.
4. For Identity Type, choose Named Principal.
5. For Authentication Protocol choose OAuth 2.0.
6. For Authentication Provider, choose the auth provider you created earlier.
7. For Scope, enter, full refresh_token offline_access.
8. Enable Start Authentication Flow on Save.

   

9. In Callout Options, enable Allow Merge Fields in HTTP Body and then click Save.

   

10. You’ll be prompted to login to your organization. After you login, you’ll see an Allow Access dialog. Klicken Sie auf Erlauben.
11. You’ll then be redirected the Named Credential Screen and the Authenticated Status will indicate Authenticated as your-email@domain.com.

4. Create your site in the Webex Admin Screen

Finally, continue to the next topic in the Calling tab, Create site for calling, below.

Please follow the naming conventions above during site configuration.

For Webex for Salesforce integrations version 1.19 and later, follow the instructions in this article to remove any existing Webex Connected App for authorizations, named credentials, and auth providers, and then create a new Webex Connected App for Salesforce authorization.

These procedures apply to customers using version 1.19 and later of the Webex Salesforce integration. For instructions for versions 1.18 and earlier, see Configure a Salesforce authorization (1.18 and later) in the Install and administer tab

Remove any existing Webex Connected apps, named credentials, and auth providers

If you have previously created a Webex Connected App authorizations, named credential, or auth provider, you’ll need to remove them before continuing. Otherwise, continue to Create a new Webex Connected App below.

Remove your existing Webex Connected app:

1. In the upper right corner of your Salesforce landing page, select the gear icon and choose Setup.
2. In the Quick Find text box enter App Manager and select it from the list.
3. Scroll to your Webex Connected App in the list, click the down arrow icon at the right of the entry and choose View.
4. Select Delete and then select Delete again when asked to confirm.

Remove any existing Webex Named Credentials:

1. In the Quick Find text box enter Named Credentials and select it from the list.
2. 2. Click the down arrow at the right of the Webex named credentials entry and choose Delete.
3. 3. Choose Delete again when asked to confirm.

Remove any existing Webex Auth Providers:

1. In the Quick Find text box enter Auth. Providers and select it from the list.
2. Select the Del link at the beginning of the Webex auth provider entry.
3. Select OK when asked to confirm.

Continue to the next section to create a new Webex Connected App for Salesforce authorization.

Create a new Webex Connected App for Salesforce authorization

To create a new Webex Connected App for Salesforce authorization:

1. In the upper right corner of your Salesforce landing page, select the gear icon and choose Setup.
2. Retrieve your domain URL: in Quick Find, search for and select Domains, and save the URL from My Domain.

1. In the Quick Find text box enter App Manager and select it from the list.
2. Enter a Connected App Name, for example, Webex Salesforce Authorization.
3. Enter an email address for Contact Email.
4. Check Enable OAuth Settings.
5. Enter two callback URLs using the URL you retrieved earlier, one per line, and adding /apex/ webexsfdcauth and /apex/ cisco_webex__webexsfdcauth as suffixes. Beispiel:

   https://my-company.my.salesforce.com/apex/webexsfdcauth

   https://my-company.my.salesforce.com/apex/cisco_webex__webexsfdcauth

6. Choose the following scopes from the Available OAuth Scopes list in Selected OAuth Scopes:
   • Full access (full)
   • Perform requests at any time (refresh_token, offline_access)
7. Uncheck Require Proof Key for Code Exchange (PKCE) Extension for Supported Authorization Flows.
8. Save the Connected App and make a note of the generated Consumer Key and Consumer Secret for later use.

Wenn ein neues Paket verfügbar ist, befolgen Sie die Schritte unter Installieren der Webex-App in Salesforce. Sie müssen die alte Version nicht zuerst deinstallieren, und die konfigurierten Einstellungen gehen dadurch nicht verloren.

Informationen zu den neuen Installationspaketen und zum Downloaden finden Sie in der Webex Salesforce-Software-Dokumentation.

To enable or disable call history:

1. Gehen Sie zu Webex Admin.
2. Scroll down to Webex Call History.
3. Switch the toggle to the desired setting, either enabled or disabled.

   When enabled, Call History is available to all users and profiles.

For CUCM and Broadworks users, the following functionality is unsupported:

• Receiving inbound calls in the Salesforce global dialer (Webex App will still receive inbound calls)
• Viewing call durations in the Salesforce call log window after successfully placing an outbound call
• Ending calls via the button in the Salesforce call log window after successfully placing an outbound call
• Automatically populating call durations in the Salesforce call log window after ending an outbound call

For all Salesforce integrations, note the following limitation:

• Salesforce enforces an event count limitation (25,000) which may cause integrations to fail under heavy usage. Salesforce packages are available to increase that limit. Weitere Informationen finden Sie unter https://developer.salesforce.com/docs/atlas.en-us.platform_events.meta/platform_events/platform_event_limits.htm.

Über den Webex Webinars Import Webinar Data Configuration Panel können autorisierte Salesforce-Benutzer eingeladene Webex Webinar-Teilnehmer, registrierte Personen und Teilnehmer direkt in Salesforce-Objekte wie Leads und Kontakte importieren.

Die Konfigurationsoberfläche "Webinar-Daten importieren" ist auf der Webex Admin-Seite verfügbar:

Nach aktivierung des Webinar-Imports können autorisierte Nutzer Webex Webinar-Daten mit dem Webex Webinars-Widget importieren:

Zuweisen von Webex Webinar-Berechtigungen an Salesforce-Nutzer

Bevor Ihre Benutzer auf die Webex Webinar-Import-Funktionalität zugreifen können, müssen Sie jedem Benutzer die Webex Import Admin-Berechtigung zuweisen.

So weisen Sie einem Benutzer Berechtigungen zu:

1. Navigieren Sie zu Salesforce in die Webex-App integrieren.
2. Wählen Sie die Registerkarte Verwalten im unteren Bereich des Artikels und erweitern Sie dann Zugriff bereitstellen:

   

3. Befolgen Sie die Anweisungen, um die Webex Import Admin-Berechtigung zu Ihren Salesforce-Benutzerkonten hinzuzufügen.

Konfigurieren der Webex Webinar-Zeitbereichsanzeige

So konfigurieren Sie den Zeitraum, der für die angezeigten Webex-Webinare angezeigt wird:

1. Klicken Sie auf die Schaltfläche Salesforce-Apps, geben Sie Webex in das Suchfeld ein und wählen Sie webex Admin:

   

2. Finden Sie den Webex Webinars-Bereich und geben Sie die Anzahl der Tage ein, für die Sie vergangene und künftige Webinare auf der Startseite des Webex Webinars Widgets anzeigen möchten:

   

Setzen Sie die Konfiguration der Feldzuordnungen für den Webex-Webinar-Import fort.

Konfigurieren von Feldzuordnungen für den Webex-Webinar-Import

Mit den Webex Webinar-Importeinstellungen können Sie Zuordnungen zwischen Salesforce-Objekten und Webinar-Objektfeldern definieren. Sie können beispielsweise den Parallelen Feldnamen für eingeladene Webinar-Teilnehmer, registrierte Personen und Teilnehmer Vor- und Nachname eines Salesforce-Kontaktobjekts zuordnen: firstName and lastName.

So konfigurieren Sie Die Einstellungen für den Webex-Webinar-Import:

1. Scrollen Sie auf der Webex Admin-Seite nach unten zum Bereich Webinar-Daten importieren:

   

2. Wählen Sie ein Salesforce-Objekt aus der Dropdown-Liste Objekt aus:

   

   For the Object, you can choose from the following standard Salesforce objects in addition to any available configured Custom objects:

   • Kontakte
   • Leads

   Choose the Insert New Records for every Webinar toggle if you want all imported Webinar participants to be created as new object records, unless they have already been imported for the same Webinar (based on the selected primary key). Existing records will not be updated, even if the primary key matches, unless they are imported for the same Webex Webinar.

   For those standard objects, you can choose to link them to your Salesforce campaigns as:

   • Campaign Members: Imported Leads and Contacts are available in a target Salesforce Campaign's Campaign Members section, which is a standard Salesforce feature. (Available in version 1.16 and later)
   • Webex Webinar Campaign Members: Imported Leads and Contacts are available in a target Salesforce Campaign's Webex Webinar Campaign Members section, which is a custom Webex feature.
   • Both Campaign Members and Webex Webinar Campaign Members: Imported Leads and Contacts are available in both locations within a Salesforce Campaign. (Available in version 1.16 and later)

   Any other Custom object you choose from the list will be imported into the target Salesforce Campaign's Webex Webinar Campaign Members section.

3. Wählen Sie in der Auswahlschnittstelle für den primären Schlüssel ein eindeutiges Feld als Primärschlüssel aus, und verschieben Sie es mit dem Rechtspfeil in die Ausgewählte Liste:

   

   For the Primary key, choose an available field that will be unique to each record. Beispielsweise haben Sie viele Kontakte mit dem Vornamen Mark, aber jeder Kontakt hat eine eindeutige E-Mail-Adresse.

4. Wählen Sie in der Schnittstelle Datenfeld-Zuordnung ein Feld aus dem ausgewählten Salesforce-Objekt aus und ordnen Sie es einem entsprechenden Feld für das Webinar-Objekt zu. Verwenden Sie die Schaltfläche + Neues Feld , um nach Bedarf weitere Felder hinzuzufügen.

   All Salesforce object fields must be mapped to corresponding webinar fields as shown above.

   Only standard questions from Webex webinar registration forms can be mapped to Salesforce fields. Custom Webex webinar questions are not supported.

5. Sie können Felder entfernen, die Sie über das Papierkorbsymbol hinzugefügt haben, um rechts neben dem Feld zu klicken.
6. Klicken Sie auf Speichern, wenn Sie fertig sind, und klicken Sie, nachdem Sie Ihren Primärschlüssel verifiziert haben, im Bestätigungsdialogfeld auf Speichern:

   

   Die Zuordnungen werden im aktualisierten Bereich angezeigt:

   

   Sie können Objektzuordnungen über das Papierkorbsymbol löschen, das ein zusätzliches Bestätigungsdialogfeld enthält, oder vorhandene Zuordnungen mithilfe des Stiftsymbols ändern.

   Sie können jederzeit hierher zurückkehren und den Primärschlüssel ändern. Dadurch wird jedoch der Primärschlüssel für bereits im System importierte Datensätze nicht aktualisiert. Dies kann zu Duplikaten führen, d. a. ändern Sie primärer Schlüssel primär.

Nachdem Sie die Webinar-Feldzuordnungen konfiguriert haben, wählen Sie aus, wer Zugriff auf die Webinar-Datenimportfunktion hat.

Aktivieren Sie den Webinar-Datenimport für Ihre Salesforce-Nutzer

Wenn die Webinar-Feldzuordnungen eingerichtet wurden, können Sie wählen, wer Zugriff auf die Webinar-Datenimportfunktion hat. Zu den Optionen zählen der globale Zugriff Benutzerkonto Benutzer mit den richtigen Berechtigungen, individuellen Benutzerkonten und Benutzern, die Mitglieder bestimmter Salesforce-Profile sind.

Webinar-Datenimport für alle Nutzer aktivieren

Um den Webinar-Datenimport für alle In Ihrer Salesforce-Organisation zu aktivieren, aktivieren Sie Webinar-Import für alle Profile/Benutzer aktiviert aktivieren:

Webinar-Datenimport für ausgewählte Nutzer oder Profile aktivieren

Sie können den Webinar-Datenimport für ausgewählte einzelne Nutzer oder für bestimmte Benutzergruppen aktivieren, die mit einem bestimmten Salesforce-Benutzerprofil.

So aktivieren Sie den Webinar-Datenimport für ausgewählte Nutzer oder Profile:

1. Stellen Sie sicher , dass Webinar-Import für alle Profile/Benutzer aktiviert ist:

   

2. Wählen Sie im Dropdown-Dropdown zum Aktivieren des Webinar-Imports nur für diese Profile/Benutzer die Option Profil oder Benutzer:

   

   • Um ein Profil hinzuzufügen, wählen Sie Profilaus, und klicken Sie in das Suchtextfeld und wählen Sie eine Salesforce-Rolle aus der Drop-down-Liste. Klicken Sie auf Hinzufügen, um die Rolle hinzuzufügen:

     

   • Um einen einzelnen Benutzer hinzuzufügen, wählen Sie Benutzer aus, und geben Sie einen Benutzernamen in das Textfeld ein. Klicken Sie auf Hinzufügen, um den Nutzer hinzuzufügen:

     

   Um einen Benutzer oder ein Profil zu löschen, klicken Sie auf den Papierkorb und anschließend auf den Eintrag.