Voordat u de configuratiestappen volgt, moet u eerst naar het release-opmerkingen gaan en de nieuwste versie van het Webex App Salesforce-pakket downloaden.

Vereisten

Salesforce Enterprise-editie

Voor deze integratie is minimaal Salesforce Enterprise-editie. Zie Salesforce Editions voor meer informatie.

Mijn domein in Salesforce-organisatie

U moet Mijn domein in uw organisatie implementeren als u Lightning-onderdelen wilt gebruiken. Zie de documentatie van Mijn domein Salesforce voor meer informatie.

Gebruikerstoegang in Control Hub

U moet gebruikerstoegang tot integraties in uw organisatie configureren.

• 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.

Zie Gebruikerstoegang tot integraties configureren voor meer informatie.

Calling

• Webex Calling wordt volledig ondersteund voor inkomende en uitgaande gesprekken voor gespreksbeheer binnen Salesforce.

• Bellen in Webex (Unified CM) wordt gedeeltelijk ondersteund. Alleen uitgaande gesprekken openen een pop-up voor logboekregistratie in Salesforce. Voor binnenkomende gesprekken wordt de Webex-app bel, maar Salesforce kan het gesprek niet onderscheppen, dus de pop-up van de logboekregistratie wordt niet weergegeven.

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. Klik op Nieuw.

   

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. Click Allow.
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. Bijvoorbeeld:

   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.

Wanneer er een nieuw pakket beschikbaar is, volgt u de stappen in De Webex-app installeren in Salesforce. U hoeft de oude versie niet eerst te verwijderen en de geconfigureerde instellingen gaan niet verloren.

Zie de Webex Salesforce-integratie voor informatie over de nieuwe installatiepakketten en release-opmerkingen.

To enable or disable call history:

1. Ga naar Webex-beheerder.
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. Zie https://developer.salesforce.com/docs/atlas.en-us.platform_events.meta/platform_events/platform_event_limits.htm voor meer informatie.

Via het Webex Webinars Import Webinar-gegevensconfiguratiepaneel kunnen bevoegde Salesforce-gebruikers webex-webinar-genodigden, registranten en deelnemers rechtstreeks importeren in Salesforce-objecten zoals leads en contactpersonen.

De interface voor het importeren van webinargegevens is beschikbaar op de Webex-beheerpagina :

Zodra het importeren van de webinar is ingeschakeld, kunnen bevoegde gebruikers Webex-webinargegevens importeren met de widget Webex Webinars :

Rechten van Webex-webinar toewijzen aan Salesforce-gebruikers

Voordat uw gebruikers toegang hebben tot de importfunctionaliteit van de Webex-webinar, moet u aan elke gebruiker de Webex-importbeheerdersrechten toewijzen.

Toestemmingen toewijzen aan een gebruiker:

1. Navigeren om Salesforce te integreren met de Webex-app.
2. Kies het tabblad Beheren onder aan het artikel en vouw Toegang verlenen uit:

   

3. Volg de instructies om de Webex Import Admin-toestemming toe te voegen aan uw Salesforce-gebruikersaccounts.

De tijdbereikweergave van de Webex-webinar configureren

Het weergegeven tijdbereik van Webex-webinars configureren:

1. Klik op de knop Salesforce-apps, voer Webex in het zoekveld in en kies vervolgens Webex-beheerder:

   

2. Zoek het deelvenster Webex-webinars en voer het aantal dagen in waarvoor u afgelopen en aankomende webinars wilt weergeven in de startpagina van de Webex-webinarswidget:

   

Ga verder met het configureren van de veldtoewijzingen voor het importeren van de Webex-webinar.

Veldtoewijzingen voor het importeren van Webex-webinar configureren

Via de Webex Webinar-instellingen voor importeren definieert u toewijzingen tussen Salesforce-objecten en webinarobjectvelden. U kunt bijvoorbeeld de voor- en achternaam van een Salesforce-contactobject aan de parallelle veldnamen voor webinar-genodigden, geregistreerde personen en deelnemers wijden: firstName and lastName.

De instellingen voor het importeren van de Webex-webinar configureren:

1. Schuif op de Webex-beheerpagina omlaag naar het deelvenster Webinar-gegevens importeren:

   

2. Kies een Salesforce-object uit de vervolgkeuzelijst Object :

   

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

   • Contactpersonen
   • 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. In de interface primaire sleutelselectie kiest u een uniek veld als primaire sleutel en gebruikt u de pijl naar rechts om deze naar de geselecteerde lijst te verplaatsen:

   

   For the Primary key, choose an available field that will be unique to each record. U hebt bijvoorbeeld veel contactpersonen met de voornaam Mark, maar elke contactpersoon heeft een uniek e-mailadres.

4. In de interface voor veldtoewijzing van gegevens kiest u een veld uit het Salesforce-object dat u hebt geselecteerd en wijs het toe aan een overeenkomstig veld voor het webinarobject. Gebruik de knop + nieuw veld om indien nodig extra velden toe te voegen.

   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. U kunt velden die u hebt toegevoegd met het pictogram prullenbak rechts naast het veld verwijderen.
6. Klik op Opslaan wanneer u klaar bent en klik op Opslaan in het bevestigingsvenster nadat u uw primaire sleutel hebt geverifieerd:

   

   De toewijzingen worden weergegeven in het bijgewerkte deelvenster:

   

   U kunt objecttoewijzingen verwijderen met het prullenbakpictogram, waardoor een extra bevestigingsdialoogvenster wordt weergegeven, of bestaande toewijzingen wijzigen met het potloodpictogram.

   U kunt altijd hier terugkeren en de primaire sleutel wijzigen, maar hiermee wordt de primaire sleutel niet bijgewerkt voor records die al in het systeem zijn geïmporteerd. Dit kan leiden tot dubbele waarden. Wijzig dus de primaire sleutels naar één enkele bestemming.

Zodra u de veldtoewijzingen van de webinar hebt geconfigureerd, kiest u wie toegang heeft tot de functionaliteit voor het importeren van webinargegevens.

Webinargegevens importeren inschakelen voor uw Salesforce-gebruikers

Als de toewijzingen voor het webinarveld zijn vastgelegd, kunt u kiezen wie toegang heeft tot de functie voor het importeren van webinargegevens. De opties omvatten wereldwijde toegang voor gebruikersaccount met de juiste machtigingen, individuele gebruikersaccounts en gebruikers die lid zijn van bepaalde Salesforce-profielen.

Webinargegevens importeren voor alle gebruikers inschakelen

Als u het importeren van webinargegevens voor iedereen in uw Salesforce-organisatie wilt inschakelen, schakelt u het volgende in om het importeren van webinars voor alle profielen/ gebruikers in te schakelen:

Webinargegevens importeren voor geselecteerde gebruikers of profielen inschakelen

U kunt webinargegevens importeren voor geselecteerde individuele gebruikers of voor specifieke sets gebruikers die overeenkomen met een bepaalde Salesforce-gebruikersprofiel.

Webinargegevens importeren voor geselecteerde gebruikers of profielen inschakelen:

1. Zorg ervoor dat Webinar-import voor alle profielen/gebruikers inschakelen is uitgeschakeld:

   

2. Selecteer in de vervolgkeuzepagina Webinar importeren alleen voor deze profielen/gebruikers inschakelen Profiel of Gebruiker:

   

   • Om een profiel toe te voegen, selecteert u Profiel, klikt u in het zoektekstvak en kiest u een Salesforce-rol uit de vervolgkeuzelijst. Klik op Toevoegen om de rol toe te voegen:

     

   • Als u een afzonderlijke gebruiker wilt toevoegen, selecteert u Gebruiker en voert u een gebruikersnaam in het tekstvak in. Klik op Toevoegen om de gebruiker toe te voegen:

     

   Als u een gebruiker of profiel wilt verwijderen, klikt u op het pictogram Prullenbak naast de vermelding.