Înainte de a urma pașii de configurare, trebuie mai întâi să accesați notele de lansare și să descărcați cea mai recentă versiune a pachetului Salesforce webex App.

Cerințe

Salesforce Enterprise Edition

Această integrare necesită un minim de Salesforce Enterprise Edition. Consultați Salesforce Editions pentru mai multe informații.

Domeniul meu în organizația Salesforce

Trebuie să implementați Domeniul meu în organizația dvs., dacă doriți să utilizați componente Lightning. Consultați documentația My Domain Salesforce pentru mai multe informații.

Accesul utilizatorilor în Control Hub

Trebuie să configurați accesul utilizatorilor la integrările din organizația dvs.

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

Consultați Configurarea accesului utilizatorilor la integrări pentru mai multe informații.

Calling

• Apelarea Webex este pe deplin acceptată pentru apelurile de intrare și de ieșire pentru controlul apelurilor în cadrul Salesforce.

• Apelarea în Webex (UNIFIED CM) este parțial acceptată. Numai apelurile de ieșire deschid o fereastră pop-up de logare în Salesforce. Pentru intrare, aplicația Webex sună, dar Salesforce nu poate intercepta apelul, astfel încât fereastra pop-up de înregistrare în jurnal nu apare.

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. Faceți clic pe Nou.

   

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. De exemplu:

   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.

Când este disponibil un pachet nou, urmați pașii din Instalarea aplicației Webex în Salesforce. Nu trebuie să dezinstalați mai întâi versiunea veche și nu veți pierde setările configurate.

Pentru a vedea informații despre noile pachete de instalare și unde să le descărcați, consultați notelede lansare a integrării Webex Salesforce.

To enable or disable call history:

1. Accesați 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. Pentru mai multe informații, consultați https://developer.salesforce.com/docs/atlas.en-us.platform_events.meta/platform_events/platform_event_limits.htm.

Utilizând panoul de configurare a datelor webinariilor Webex Importați webinarii, utilizatorii autorizați Salesforce pot importa invitații de webinar Webex, solicitanții înregistrării și participanții direct în obiecte Salesforce, cum ar fi clienți potențiali și persoane de contact.

Interfața de configurare Import date webinar este disponibilă de pe pagina Webex Admin :

Odată ce importul webinarului este activat, utilizatorii autorizați pot importa date de webinar Webex utilizând widgetul Webinars Webex:

Atribuirea permisiunilor pentru webinarul Webex utilizatorilor Salesforce

Înainte ca utilizatorii să poată accesa funcționalitatea de import a webinarului Webex, va trebui să atribuiți fiecăruia permisiunea Webex Import Admin .

Pentru a atribui permisiuni unui utilizator:

1. Navigați la Integrarea Salesforce cu Aplicația Webex.
2. Alegeți fila Gestionare din partea de jos a articolului, apoi extindeți Oferiți acces:

   

3. Urmați instrucțiunile pentru a adăuga permisiunea Webex Import Admin la conturile de utilizator Salesforce.

Configurarea afișării intervalului de timp al webinarului Webex

Pentru a configura intervalul de timp al webinariilor Webex afișate:

1. Faceți clic pe butonul Aplicații Salesforce, introduceți Webex în câmpul de căutare, apoi alegeți Webex Admin:

   

2. Găsiți panoul Webinars Webex și introduceți numărul de zile pentru care doriți să afișați webinarii anterioare și viitoare în widget-ul webinariilor Webex de pe pagina de pornire:

   

Continuați să configurați mapările de câmp de import ale webinarului Webex.

Configurarea mapărilor de câmpuri de import ale webinarului Webex

Utilizând setările de import ale webinarului Webex, definiți mapările între obiectele Salesforce și câmpurile de obiecte Webinar. De exemplu, puteți mapa numele și prenumele unui obiect Persoană de contact Salesforce la numele câmpurilor paralele pentru invitații la webinar, solicitanții înregistrării și participanți: firstName and lastName.

Pentru a configura setările de import ale webinarului Webex:

1. În pagina Webex Admin , defilați în jos până la panoul Import date webinar:

   

2. Alegeți un obiect Salesforce din lista verticală Obiect :

   

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

   • Contacte
   • 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. În interfața de selectare a cheii primare, alegeți un câmp unic ca cheie primară și utilizați săgeata din dreapta pentru a-l muta în lista Selectat :

   

   For the Primary key, choose an available field that will be unique to each record. De exemplu, este posibil să aveți multe contacte cu prenumele Mark, dar fiecare persoană de contact va avea o adresă de e-mail unică.

4. În interfața Mapare câmp date, alegeți un câmp din obiectul Salesforce pe care l-ați selectat și mapați-l la un câmp corespunzător pentru obiectul webinar. Utilizați butonul + Câmp nou pentru a adăuga câmpuri suplimentare, după cum este necesar.

   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. Puteți elimina câmpurile pe care le-ați adăugat utilizând pictograma coș de gunoi adiacentă câmpului din dreapta.
6. Faceți clic pe Salvare când ați terminat și, după ce ați verificat cheia principală, faceți clic pe Salvare în caseta de dialog de confirmare:

   

   Mapările sunt afișate în panoul actualizat:

   

   Puteți șterge mapările obiectelor utilizând pictograma coș de gunoi, care va afișa un dialog de confirmare suplimentar sau puteți modifica mapările existente utilizând pictograma creion.

   Puteți oricând să reveniți aici și să modificați cheia primară, dar acest lucru nu va actualiza cheia primară pentru înregistrările deja importate în sistem. Ca urmare, acest lucru poate duce la duplicate, deci modificați cheile primare cu prudență.

După ce ați configurat mapările câmpurilor de webinar, alegeți cine are acces la funcționalitatea de import a datelor webinarului.

Activarea importării datelor din webinar pentru utilizatorii Salesforce

Cu mapările de câmp webinar stabilite, puteți alege apoi cine are acces la caracteristica de import a datelor webinarului. Opțiunile includ acces global pentru fiecare cont de utilizator cu permisiunile corecte, conturi de utilizator individuale și utilizatori care sunt membri ai anumitor profiluri Salesforce.

Activați importul de date webinar pentru toți utilizatorii

Pentru a activa importarea datelor din webinar pentru toate persoanele din organizația Salesforce, comutați Activați importul webinarului pentru toate profilurile/utilizatorii la Activat:

Activarea importului de date webinar pentru utilizatorii sau profilurile selectate

Puteți activa importul de date din webinar pentru utilizatorii individuali selectați sau pentru anumite seturi de utilizatori care corespund unui anumit profil de utilizator Salesforce.

Pentru a activa importul de date webinar pentru utilizatorii sau profilurile selectate:

1. Asigurați-vă că activați importul webinarului pentru toate profilurile/utilizatorii este dezactivat:

   

2. Din lista verticală Activați importul webinarului numai pentru aceste profiluri/utilizatori, selectați Profil sau Utilizator:

   

   • Pentru a adăuga un profil, selectați Profilși faceți clic în caseta text de căutare și alegeți un rol Salesforce din lista verticală. Faceți clic pe Adăugare pentru a adăuga rolul:

     

   • Pentru a adăuga un utilizator individual, selectați Utilizator și introduceți un nume de utilizator în caseta text. Faceți clic pe Adăugare pentru a adăuga utilizatorul:

     

   Pentru a șterge un utilizator sau un profil, faceți clic pe pictograma coș de gunoi adiacentă intrării.