Antes de seguir as etapas de configuração, você deve primeiro ir ao notas de versão e baixar a versão mais recente do pacote da Salesforce do aplicativoWebex.

Requisitos

Gerente de Edição Empresarial

Essa integração requer um mínimo de equipes de Edição Empresarial. Consulte As edições do Salesforce para obter mais informações.

Meu domínio na salesforce org

Você deve implantar Meu domínio na sua organização se você quiser usar componentes Lightning. Consulte a documentação do Meu domínio salesforce para mais informações.

Acesso do usuário no Control Hub

Você deve configurar o acesso do usuário a integrações na sua organização.

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

Consulte Configurar o acesso do usuário a integrações para obter mais informações.

Calling

• Webex Calling é totalmente suportado para chamadas de entrada e saída para controle de chamadas dentro do Salesforce.

• A chamada no Webex (Unified CM) é parcialmente suportada. Somente chamadas de saída abrem um pop-up de registro no Salesforce. Para entrada, o aplicativo Webex tocará, mas o Salesforce não poderá interceptá-la, por isso o pop-up de registro não aparece.

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. Clique em Novo.

   

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. Por exemplo:

   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.

Quando um novo pacote estiver disponível, siga as etapas em Instalar o aplicativo Webex na Salesforce. Você não precisa primeiro desinstalar a versão antiga e você não perderá suas configurações configuradas.

Para ver informações sobre os novos pacotes de instalação e onde baixá-los, consulte a integração do Webex Salesforce notas de versão.

To enable or disable call history:

1. Vá para a administração Webex.
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. Para obter mais informações, consulte https://developer.salesforce.com/docs/atlas.en-us.platform_events.meta/platform_events/platform_event_limits.htm.

Usando o painel de configuração de Dados do Webinar Webex Webinar, os usuários autorizados do Salesforce podem importar convidados, inscritos e convidados diretamente para objetos da Salesforce, como contatos e contatos.

A interface de configuração da Importação de Dados do Webinar está disponível na página de administração Webex :

Uma vez que a importação do webinar seja habilitada, os usuários autorizados podem importar dados do webinar Webex usando o widget dos Webinars Webex:

Atribuir permissões do Webex webinar para usuários do Salesforce

Antes que seus usuários possam acessar a funcionalidade de importação do webinar Webex, você precisará atribuir a permissão de Administração de Importação Webex para cada um deles.

Para atribuir permissões a um usuário:

1. Navegue para integrar o Salesforce com o aplicativo Webex.
2. Escolha a guia Gerenciar na parte inferior do artigo e expanda Fornecer acesso:

   

3. Siga as instruções para adicionar a permissão de Administração de importação Webex às suas contas de usuário do Salesforce.

Configurar a exibição do intervalo de tempo do webinar Webex

Para configurar o intervalo de tempo dos webinars Webex exibidos:

1. Clique no botão Aplicativos do Salesforce, insira o Webex no campo de pesquisa e escolha Administração Webex:

   

2. Encontre o painel webinars Webex e insira o número de dias para os quais você deseja exibir webinars passados e futuros no widget dos webinars Webex na página inicial:

   

Continue configurando os mapeamentos do campo de importação do Webex webinar.

Configurar mapeamentos de campo de importação de webinar Webex

Usando as configurações de importação do Webex webinar, você define mapeamentos entre objetos Salesforce e campos de objetos Webinar. Por exemplo, você pode mapear os primeiros e últimos nomes de um objeto de Contato da Salesforce para os nomes de campo paralelo para convidados, inscritos e convidados do campo de webinar: firstName and lastName.

Para configurar configurações de importação de webinar Webex:

1. Na página de Administração do Webex , role para baixo até o painel Importar dados do webinar:

   

2. Escolha um objeto salesforce na lista de drop-down do objeto:

   

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

   • Contatos
   • 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. Na interface de seleção de chave primária, escolha um campo exclusivo como uma chave primária e use a seta para a direita para movê-lo para a lista Selecionada:

   

   For the Primary key, choose an available field that will be unique to each record. Por exemplo, você pode ter muitos contatos com o primeiro nome Mark, mas cada contato terá um endereço de e-mail exclusivo.

4. Na interface de mapeamento do campo de dados, escolha um campo do objeto Salesforce que você selecionou e mapeie-o para um campo correspondente para o objeto webinar. Use o botão + Novo Campo para adicionar campos adicionais, conforme necessário.

   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. Você pode remover campos que você adicionou usando o ícone de lixeira que é adjacente ao campo à direita.
6. Clique em Salvar quando terminar e, depois de verificar sua chave principal, clique em Salvar na caixa de diálogo de confirmação:

   

   Os mapeamentos são exibidos no painel atualizado:

   

   Você pode excluir os mapeamentos de objetos usando o ícone da lixeira, que exibirá uma caixa de diálogo de confirmação adicional ou modificar os mapeamentos existentes usando o ícone do lápis.

   Você pode sempre retornar aqui e alterar a chave primária, mas isso não atualizará a chave primária para registros já importados no sistema. Como resultado, isso pode levar a duplicados, então modifique as teclas principais exclusivamente.

Depois de configurar os mapeamentos de campo do webinar, escolha quem tem acesso à funcionalidade de importação de dados do webinar.

Permita a importação de dados do webinar para os usuários do Salesforce

Com os mapeamentos de campo do webinar estabelecidas, você pode escolher quem tem acesso ao recurso de importação de dados do webinar. As opções incluem acesso global para todas conta de usuário e com as permissões corretas, contas de usuários individuais e usuários que são membros de perfis específicos do Salesforce.

Ativar a importação de dados do webinar para todos os usuários

Para permitir a importação de dados de webinar para todos na organização do Salesforce, alterne a alternância para Habilitar importação de webinar para todos os perfis/ usuários para habilitada:

Habilitar importação de dados webinar para usuários ou perfis selecionados

Você pode permitir a importação de dados webinar para usuários individuais selecionados ou para conjuntos específicos de usuários que correspondem a um serviço específico do Salesforce perfil do usuário.

Para habilitar a importação de dados do webinar para usuários ou perfis selecionados:

1. Certifique-se de que a adoção da importação do webinar para todos os perfis/usuários está desativada:

   

2. Da opção Habilitar importação do webinar apenas para esses Perfis/Usuários, selecione Perfil ou Usuário:

   

   • Para adicionar um perfil, selecione Perfil, clique na caixa de texto de pesquisa e escolha uma função do Salesforce no lista suspensa. Clique em Adicionar para adicionar a função:

     

   • Para adicionar um usuário individual, selecione Usuário e insira um nome de usuário na caixa de texto. Clique em Adicionar para adicionar o usuário:

     

   Para excluir um usuário ou perfil, clique no ícone da lixeira adjacente à entrada.