Antes de continuar, certifique-se de atender aos seguintes pré-requisitos:

• O usuário que está executando a configuração deve ser administrador da organização Salesforce na qual a integração será instalada.

• Essa integração requer no mínimo o Salesforce Enterprise Edition. Consulte Salesforce Editions para obter mais informações.

• A organização deve ter o Webex configurado com as licenças corretas para a funcionalidade necessária, incluindo mensagens, reuniões e chamadas.
• Todos os usuários que usam a integração devem ter acesso ao Salesforce e as licenças necessárias do Salesforce.
• Todos os usuários devem ter as licenças Webex necessárias para usar funcionalidades específicas do Webex, como e de dentro do Salesforce. Webex Meetings Webex Calling

  CUCM e Broadworks são suportados com funcionalidade parcial. Consulte Limitações de chamadas na guia Chamadas para obter mais detalhes.

• Essa integração está disponível para o Salesforce Lightning.

  Você deve implantar Meu domínio em sua organização se quiser usar componentes do Lightning. Consulte a documentação do My Domain Salesforce para obter mais informações.

• Você deve configurar o acesso do usuário às integrações em sua organização.

  • Sem o Pro Pack — Quando você tem o Control Hub básico, você pode optar por permitir ou negar acesso a todas as integrações para todos os seus usuários.

  • Com o Pro Pack — Com o Pro Pack, você tem funcionalidades avançadas para gerenciar o acesso às integrações para os usuários.

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

Para versões da integração Webex Salesforce posteriores à 1.14, agora você pode atualizar usando o Salesforce Exchange.

Para instalar a integração Webex via Salesforce Exchange:

1. Navegue até o aplicativo Webex para Salesforce no AppExchange.
2. Selecione Adquira agora.
3. Selecione a organização conectada na qual você deseja instalar a integração.
4. Instale o aplicativo somente para administradores.
5. Continue com Autorizar a integração Webex na guia Instalar e administrar.

Antes de seguir as etapas de configuração, você deve primeiro acessar as notas de lançamento e baixar a versão mais recente do pacote Webex App Salesforce.

Requisitos

Edição Salesforce Enterprise

Essa integração requer no mínimo o Salesforce Enterprise Edition. Consulte Salesforce Editions para obter mais informações.

Meu domínio na Salesforce org

Você deve implantar Meu domínio em sua organização se quiser usar componentes do Lightning. Consulte a documentação do My Domain Salesforce para obter mais informações.

Acesso do usuário no Control Hub

Você deve configurar o acesso do usuário às integrações em sua organização.

• Sem o Pro Pack — Quando você tem o Control Hub básico, você pode optar por permitir ou negar acesso a todas as integrações para todos os seus usuários.

• Com o Pro Pack — Com o Pro Pack, você tem funcionalidades avançadas para gerenciar o acesso às integrações para os usuários.

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

Chamando

• Webex Callingé totalmente compatível com chamadas de entrada e saída para controle de chamadas no Salesforce.

• A chamada em Webex (Unified CM) é parcialmente suportada. Somente chamadas externas abrem um pop-up de registro no Salesforce. Para entrada, o aplicativo Webex toca, mas o Salesforce não pode interceptar a chamada, então o pop-up de registro não aparece.

Se você estiver trabalhando com o Webex para Salesforce versão 1.18 ou anterior, antes de poder trabalhar com Webex Calling o Salesforce, você precisará configurar uma autorização do Salesforce. Siga as seções deste artigo para começar a trabalhar.

1. Crie um aplicativo conectado

Para criar um novo aplicativo conectado:

1. Em Configuração, pesquise por Aplicativo cliente externo.

   

2. Em Aplicativo cliente externo, escolha Configurações.
3. Ative o botão de alternância para Permitir a criação de aplicativos conectados. Se o novo botão do aplicativo conectado já estiver ativado, não há necessidade de uma nova ação. Você pode criar um novo aplicativo conectado.

   

4. Para criar um novo aplicativo conectado, clique no botão Novo aplicativo conectado e insira os detalhes necessários.

   

5. Insira um nome de aplicativo conectado, por exemplo, MyExampleApp.
6. Insira um endereço de e-mail de contato.
7. Marque Ativar configurações de OAuth.
8. Especifique um espaço reservado para URL de retorno de chamada (atualizaremos isso posteriormente), por exemplo, https://localhost/placeholder.

   

9. Role para baixo e escolha os seguintes escopos do OAuth:
   • Acesso total (completo)
   • Execute solicitações a qualquer momento (refresh_token, offline_access)

   

   O escopo Executar solicitações a qualquer momento permite que as Credenciais Nomeadas atualizem seu token de acesso quando uma sessão expirar.

10. Role até a parte inferior da página, clique em Salvar e, em seguida, clique em Continuar.
11. Na próxima página, vá até API (Ativar configurações do OAuth) e clique em Gerenciar detalhes do consumidor.

    

    Talvez você precise se autenticar novamente com o Salesforce.

12. Anote a Chave do Consumidor e o Segredo do Consumidor.

    

2. Crie um provedor de autenticação

Em seguida, você precisará criar um provedor de autenticação, o que facilita a autenticação com sua organização Salesforce.

Para criar um provedor de autenticação:

1. Em Configuração, pesquise por Autenticação e selecione Autenticação. Provedores. Clique em Novo.

   

2. Selecione Salesforce como o tipo de provedor.
3. Insira um nome para o provedor de autenticação, por exemplo, ApexMDTAPI.
4. Cole a chave do consumidor e o segredo do consumidor que você salvou ao configurar seu aplicativo conectado.
5. Insira os seguintes escopos em Escopos padrão, full refresh_token offline_access.
6. Deixe todo o resto em branco e clique em Salvar.

   

7. Copie o URL de retorno de chamada da seção Configuração do Salesforce.

   

8. Edite seu aplicativo conectado e substitua o URL do espaço reservado pelo URL de retorno de chamada que você copiou da configuração do Salesforce acima.

   

9. Salve seu aplicativo conectado.

   Talvez seja necessário esperar até 10 minutos para permitir que as configurações entrem em vigor e se propaguem por toda a infraestrutura da Salesforce.

3. Crie uma credencial nomeada

Em seguida, você precisará criar uma credencial nomeada.

Para criar uma credencial nomeada:

1. Em Configuração, pesquise por Nomeado e selecione Credenciais Nomeadas. Clique em Novo legado.

   

2. Insira o seguinte valor para Label, ApexMDTapi.
3. Para a URL, insira a URL da instância da sua organização, por exemplo, https://na1.salesforce.com ou, se você estiver usando Meu domínio, seu nome de domínio Meu domínio totalmente qualificado, por exemplo, https://mycompany.my.salesforce.com.
4. Em Tipo de identidade, escolha Principal nomeado.
5. Para Protocolo de Autenticação, escolha OAuth 2.0.
6. Em Provedor de Autenticação, escolha o provedor de autenticação que você criou anteriormente.
7. Em Escopo, insira refresh_token completo offline_access.
8. Habilite Iniciar fluxo de autenticação ao salvar.

   

9. Em Opções de texto explicativo, habilite Permitir mesclagem de campos no corpo HTTP e clique em Salvar.

   

10. Você será solicitado a fazer login na sua organização. Depois de fazer login, você verá uma caixa de diálogo Permitir acesso. Clique em Permitir.
11. Em seguida, você será redirecionado para a tela de credencial nomeada e o status autenticado indicará Autenticado como your-email@domain.com.

4. Crie seu site na tela de administração do Webex

Por fim, continue com o próximo tópico na guia Chamadas, Criar site para chamadas, abaixo.

Para integrações do Webex para Salesforce versão 1.19 e posterior, siga as instruções neste artigo para remover qualquer aplicativo Webex Connected existente para autorizações, credenciais nomeadas e provedores de autenticação e, em seguida, crie um novo aplicativo Webex Connected para autorização do Salesforce.

Remova todos os aplicativos Webex Connected, credenciais nomeadas e provedores de autenticação existentes

Se você já criou autorizações do aplicativo Webex Connected, credencial nomeada ou provedor de autenticação, precisará removê-las antes de continuar. Caso contrário, continue criando um novo aplicativo Webex Connected abaixo.

Remova seu aplicativo Webex Connected existente:

1. No canto superior direito da sua página inicial do Salesforce, selecione o ícone de engrenagem e escolha Configuração.
2. Na caixa de texto Busca rápida, entre no App Manager e selecione-o na lista.
3. Vá até o aplicativo Webex Connected na lista, clique no ícone de seta para baixo à direita da entrada e escolha Exibir.
4. Selecione Excluir e, em seguida, selecione Excluir novamente quando solicitado a confirmar.

Remova todas as credenciais nomeadas Webex existentes:

1. Na caixa de texto Busca rápida, insira Credenciais nomeadas e selecione-as na lista.
2. 2. Clique na seta para baixo à direita da entrada de credenciais nomeadas do Webex e escolha Excluir.
3. 3. Escolha Excluir novamente quando solicitado para confirmar.

Remova todos os provedores de autenticação Webex existentes:

1. Na caixa de texto Busca rápida, digite Auth. Provedores e selecione-os na lista.
2. Selecione o link Del no início da entrada do provedor de autenticação Webex.
3. Selecione OK quando solicitado para confirmar.

Continue na próxima seção para criar um novo aplicativo Webex Connected para autorização do Salesforce .

Crie um novo aplicativo Webex Connected para autorização do Salesforce

Para criar um novo aplicativo Webex Connected para autorização do Salesforce:

1. No canto superior direito da sua página inicial do Salesforce, selecione o ícone de engrenagem e escolha Configuração.
2. Recupere o URL do seu domínio: na Busca rápida, pesquise e selecione Domínios e salve o URL em Meu domínio.
3. Em Configuração, pesquise por Aplicativo cliente externo.

   

4. Em Aplicativo cliente externo, escolha Configurações.
5. Ative o botão de alternância para Permitir a criação de aplicativos conectados. Se o novo botão do aplicativo conectado já estiver ativado, não há necessidade de uma nova ação. Você pode criar um novo aplicativo conectado.

   

6. Para criar um novo aplicativo conectado, clique no botão Novo aplicativo conectado e insira os detalhes necessários.

   

7. Na caixa de texto Busca rápida, entre no App Manager e selecione-o na lista.
8. Insira um nome de aplicativo conectado, por exemplo, Autorização Webex Salesforce .
9. Insira um endereço de e-mail para o e-mail de contato.
10. Marque Ativar configurações de OAuth.
11. Insira duas URLs de retorno de chamada usando a URL que você recuperou anteriormente, uma por linha, e adicionando /apex/ webexsfdcauth e /apex/ cisco_webex__webexsfdcauth como sufixos. Por exemplo:

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

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

12. Escolha os seguintes escopos na lista Escopos OAuth disponíveis em Escopos OAuth selecionados:
    • Acesso total (completo)
    • Execute solicitações a qualquer momento (refresh_token, offline_access)
13. Desmarque a opção Exigir chave de prova para extensão de troca de código (PKCE) para fluxos de autorização suportados.
14. Salve o aplicativo conectado e anote a chave do consumidor e o segredo do consumidor gerados para uso posterior.

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

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

Para ativar ou desativar o histórico de chamadas:

1. Vá para Webex Admin.
2. Role para baixo até Histórico de chamadas Webex.
3. Mude o botão para a configuração desejada, ativada ou desativada.

   Quando ativado, o Histórico de chamadas está disponível para todos os usuários e perfis.

Para usuários do CUCM e do Broadworks, a seguinte funcionalidade não é suportada:

• Recebendo chamadas de entrada no discador global Salesforce (o aplicativo Webex ainda receberá chamadas de entrada)
• Visualizando a duração das chamadas na janela do registro de chamadas do Salesforce após fazer uma chamada de saída com sucesso
• Encerrar chamadas por meio do botão na janela de registro de chamadas do Salesforce após fazer uma chamada de saída com sucesso
• Preenchendo automaticamente as durações das chamadas na janela de registro de chamadas do Salesforce após encerrar uma chamada de saída

Para todas as integrações do Salesforce, observe a seguinte limitação:

• A Salesforce impõe uma limitação de contagem de eventos (25.000) que pode fazer com que as integrações falhem em caso de uso intenso. Os pacotes do Salesforce estão disponíveis para aumentar esse limite. Para obter mais informações, consulte https://developer.salesforce.com/docs/atlas.en-us.platform_events.meta/platform_events/platform_event_limits.htm.

• Os componentes do utilitário Webex Calling não estão disponíveis no aplicativo móvel Salesforce.

Usando o painel de configuração Webex Webinars Importar dados do webinar, os usuários autorizados do Salesforce podem importar convidados, inscritos e participantes do webinar Webex diretamente para objetos do Salesforce, como leads e contatos.

A interface de configuração de importação de dados do webinar está disponível na página de administração do Webex:

Depois que a importação do webinar estiver ativada, os usuários autorizados poderão importar os dados do webinar Webex usando o widget: Webex Webinars

Atribuir permissões de webinar Webex aos usuários do Salesforce

Antes que seus usuários possam acessar a funcionalidade de importação de webinars do Webex, você precisará atribuir a permissão de administrador de importação do Webex a cada um.

Para atribuir permissões a um usuário:

1. Navegue até 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 administrador de importação do 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 Salesforce Apps, insira Webex no campo de pesquisa e escolha Webex Admin:

   

2. Encontre o Webex Webinarspainel e insira o número de dias durante os quais você deseja exibir webinars anteriores e futuros na página inicial do widget Webex webinars:

   

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

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

Usando as configurações de importação do webinar Webex, você define mapeamentos entre objetos do Salesforce e campos de objetos do webinar. Por exemplo, você pode mapear o nome e o sobrenome de um objeto Salesforce Contact para os nomes de campos paralelos para convidados, inscritos e participantes do webinar: Nome e Sobrenome.

Para definir as configurações de importação do webinar Webex:

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

   

2. Escolha um objeto do Salesforce na lista suspensa Objeto:

   

   Para o objeto, você pode escolher entre os seguintes objetos padrão do Salesforce, além de quaisquer objetos personalizados configurados disponíveis:

   • Contatos
   • Conduz

   Escolha a opção Inserir novos registros para cada webinar se quiser que todos os participantes importados do webinar sejam criados como novos registros de objetos, a menos que já tenham sido importados para o mesmo webinar (com base na chave primária selecionada). Os registros existentes não serão atualizados, mesmo que a chave primária corresponda, a menos que sejam importados para o mesmo Webex Webinar.

   Para esses objetos padrão, você pode optar por vinculá-los às suas campanhas do Salesforce como:

   • Membros da campanha: leads e contatos importados estão disponíveis na seção Membros da campanha específica da Salesforce Campaign, que é um recurso padrão do Salesforce. (Disponível na versão 1.16 e posterior)
   • Membros da campanha de webinar Webex: leads e contatos importados estão disponíveis na seção de membros da campanha de webinar Webex da campanha Webex alvo, que é um recurso personalizado do Webex.
   • Membros da campanha e membros da campanha Webex Webinar: leads e contatos importados estão disponíveis em ambos os locais em uma campanha do Salesforce. (Disponível na versão 1.16 e posterior)
   Qualquer outro objeto personalizado que você escolher na lista será importado para a seção de membros da campanha Webex Webex de destino da campanha de webinar do Salesforce.

3. Na interface de seleção de chave primária, escolha um campo exclusivo como chave primária e use a seta para a direita para movê-lo para a lista Selecionado:

   

   Para a chave primária, escolha um campo disponível que será exclusivo para cada registro. 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 do webinar. Use o botão + Novo campo para adicionar campos adicionais conforme necessário.
   Todos os campos de objetos do Salesforce devem ser mapeados para os campos correspondentes do webinar, conforme mostrado acima.
   Somente perguntas padrão dos formulários de inscrição do webinar Webex podem ser mapeadas para os campos do Salesforce. Perguntas personalizadas do webinar Webex não são suportadas.
5. Você pode remover os campos que você adicionou usando o ícone da lixeira ao lado do campo à direita.
6. Clique em Salvar ao terminar e, depois de verificar sua chave primária, clique em Salvar na caixa de diálogo de confirmação:

   

   Os mapeamentos são exibidos no painel atualizado :

   

   Você pode excluir 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 de lápis.
   Você sempre pode voltar 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 resultar em duplicatas, portanto, modifique as chaves primárias com cuidado.

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

Ative a importação de dados de webinars para seus usuários do Salesforce

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

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

Para ativar a importação de dados de webinars para todos em sua organização Salesforce, alterne Ativar importação de webinars para todos os perfis/usuários para Ativado:

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

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

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

1. Certifique-se de que a opção Ativar importação de webinars para todos os perfis/usuários esteja desativada:

   

2. No menu suspenso Ativar importação de webinars somente 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 na 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 ao lado da entrada.