Antes de seguir as etapas de configuração, você deve primeiro ir para as notas de versão e baixar a versão mais recente do Webex App Salesforce Package .

Requisitos

Salesforce Enterprise Edition

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

Meu domínio na organização Salesforce

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

Acesso do usuário no Control Hub

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

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

• Com o Pro Pack —Com o Pro Pack , você tem funcionalidade avançada para gerenciar o acesso a integrações para os usuários.

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

Chamadas

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

• As chamadas no Webex (Unified CM) são parcialmente suportadas. Apenas chamadas de saída abrem um pop-up de registro no Salesforce. Para entrada, o aplicativo Webex toca, mas o Salesforce não pode interceptar a chamada, portanto, 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 o Webex Calling no Salesforce, precisará configurar uma autorização do Salesforce. Siga as seções deste artigo para começar a funcionar.

Esses procedimentos se aplicam aos clientes usando a versão 1.18 e anterior da integração do Webex Salesforce. Consulte as instruções atualizadas para as versões 1.19 e posterior: Configurar uma autorização do Salesforce (1.19 e posterior) na guia Instalar e administrar

1. Criar um aplicativo conectado

Para criar um novo aplicativo conectado:

1. Em Configuração , procure Gerenciador de aplicativos e escolha Novo aplicativo conectado .

   

2. Insira um Nome do aplicativo conectado , por exemplo, MyExampleApp .
3. Insira um endereço Contact Email .
4. Marque Ativar configurações OAuth .
5. Especifique uma URL de retorno de chamada do placeholder (atualizaremos isso mais tarde), por exemplo, https://localhost/placeholder .

   

6. Role para baixo e escolha os seguintes escopos OAuth:
   • Acesso total (completo)
   • Executar 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 expira.

7. Role para a parte inferior da página e clique em Salvar e clique em Continuar .
8. Na página seguinte, role até API (Ativar configurações OAuth) e clique em Gerenciar detalhes do cliente .

   

   Talvez seja necessário autenticar novamente com o Salesforce.

9. Anote a Chave de Consumidor e o Segredo de Consumidor .

   

2. Criar 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 do Salesforce.

Para criar um provedor de autenticação:

1. Em Setup , procure Auth e selecione Auth. 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 na Chave do consumidor e Segredo do consumidor que você salvou ao configurar seu aplicativo Conectado.
5. Insira os seguintes escopos em Scopes padrão , refresh_token completo offline_access .
6. Deixe tudo em branco e clique em Salvar .

   

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

   

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

   

9. Salve o aplicativo conectado.

   Você pode precisar esperar até 10 minutos para permitir que as configurações entrem em vigor e se espalhem pela infraestrutura da Salesforce.

3. Criar uma credencial nomeada

Você precisará criar uma credencial nomeada.

Para criar uma credencial nomeada:

1. Em Setup , procure Named e selecione Named Credentials . 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 totalmente qualificado Meu Domínio , por exemplo, https://mycompany.my.salesforce.com .
4. Para Tipo de identidade , escolha Nomeado Principal .
5. Para Protocolo de autenticação escolha OAuth 2.0 .
6. Para Provedor de autenticação , escolha o provedor de autenticação que você criou anteriormente.
7. Para Scope , insira, refresh_token completo offline_access .
8. Ative Iniciar fluxo de autenticação no Save .

   

9. Em Opções de chamada de saída, ative Permitir campos de mesclagem no corpo HTTP e clique em Salvar .

   

10. Você será solicitado a efetuar logon na sua organização. Depois de efetuar logon, você verá uma caixa de diálogo Permitir acesso . Clique em Permitir .
11. Você será redirecionado para a tela Named Credential e o Status autenticado indicará Autenticado como your-email@domain.com .

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

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

Siga as convenções de nomenclatura acima durante a configuração do site.

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

Esses procedimentos se aplicam aos clientes usando a versão 1.19 e posterior da integração do Webex Salesforce. Para obter instruções sobre as versões 1.18 e anteriores, consulte Configurar uma autorização do Salesforce (1.18 e posterior) na guia Instalar e administrar

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

Se você já tiver criado autorizações do aplicativo conectado Webex, credenciais nomeadas ou provedor de autenticação, precisará removê-las antes de continuar. Caso contrário, continue Crie um novo aplicativo Webex conectado abaixo.

Remova o aplicativo Webex conectado existente:

1. No canto superior direito da página de destino do Salesforce, selecione o ícone de engrenagem e escolha Setup .
2. Na caixa de texto Quick Find , digite App Manager e selecione-a na lista.
3. Role até o aplicativo Webex conectado na lista, clique no ícone de seta para baixo à direita da entrada e escolha View .
4. Selecione Excluir e selecione Excluir novamente quando solicitado a confirmar.

Remova todas as credenciais Webex Nomeadas existentes:

1. Na caixa de texto Quick Find digite Credenciais nomeadas e selecione-a na lista.
2. 2. Clique na seta para baixo à direita da entrada de credenciais nomeadas no Webex e escolha Excluir .
3. 3. Escolha Excluir novamente quando solicitado a confirmar.

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

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

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

Criar um novo aplicativo conectado Webex para autorização do Salesforce

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

1. No canto superior direito da página de destino do Salesforce, selecione o ícone de engrenagem e escolha Setup .
2. Recupere a URL do seu domínio: em Localização rápida , procure e selecione Domínios , e salve a URL do Meu domínio .

1. Na caixa de texto Quick Find , digite App Manager e selecione-a na lista.
2. Insira um Nome do aplicativo conectado , por exemplo, Autorização do Webex Salesforce .
3. Insira um endereço de e-mail para Contato E-mail .
4. Marque Ativar configurações OAuth .
5. Insira duas URLs de retorno de chamada usando a URL recuperada 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

6. Escolha os seguintes escopos da lista Available OAuth Scopes em Selecionado OAuth Scopes :
   • Acesso total (completo)
   • Executar solicitações a qualquer momento (refresh_token, offline_access)
7. Desmarque Exigir ramal de prova de chave para troca de código (PKCE) para fluxos de autorização suportados .
8. Salve o aplicativo conectado e anote a chave gerada Consumer e Consumer Secret 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á suas configurações configuradas.

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 a administração Webex.
2. Role para baixo até Histórico de chamadas Webex .
3. Alterne a alternância para a configuração desejada, ativada ou desativada.

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

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

• Recebendo chamadas de entrada no discador global do Salesforce (o aplicativo Webex ainda receberá chamadas de entrada)
• Visualizando as durações da chamada na janela do registro de chamadas do Salesforce após efetuar com êxito uma chamada de saída
• Encerrar chamadas através do botão na janela de registro de chamadas do Salesforce após efetuar com êxito uma chamada de saída
• Preencher automaticamente as durações da chamada 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:

• O Salesforce aplica uma limitação de contagem de eventos (25.000) que pode fazer com que as integrações falhem com 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 .

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

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

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

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

Para que seus usuários possam acessar a funcionalidade de importação do webinar Webex, você precisará atribuir a permissão Webex Import Admin 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 Webex Import Admin à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 exibido:

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

   

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

   

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 de webinars Webex, você define os mapeamentos entre os objetos do Salesforce e os campos de objetos do Webinar. Por exemplo, você pode mapear o nome e o sobrenome de um objeto de contato do Salesforce para os nomes de campo paralelo dos convidados do webinar, inscritos e convidados: firstName e lastName .

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

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

   

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

   

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

   • Contatos
   • Líderes

   Escolha o Inserir novos registros para cada Webinar alternar se desejar 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 se a chave primária corresponder, 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 do Salesforce de destino, que é um recurso padrão do Salesforce. ( Disponível na versão 1.16 e posterior )
   • Membros da campanha do Webex Webinar : Líderes e contatos importados estão disponíveis em uma seção específica da campanha do Salesforce Membros da campanha do Webinar Webex , que é um recurso Webex personalizado.
   • Membros da campanha e membros da campanha do Webex Webinar : Leads e contatos importados estão disponíveis em ambos locais dentro de 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 destino da campanha do Salesforce Membros da campanha do Webinar Webex .

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

   

   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, mas cada contato terá um endereço de e-mail exclusivo.

4. Na interface Mapeamento do campo de dados , escolha um campo do objeto Salesforce selecionado e mapeie-o em um campo correspondente ao 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 de webinar correspondentes, conforme mostrado acima.

   Apenas as perguntas padrão dos formulários de registro do webinar Webex podem ser mapeadas para os campos do Salesforce. As perguntas personalizadas do webinar Webex não são suportadas.

5. Você pode remover os campos que adicionou usando o ícone da lixeira ao lado do campo à direita.
6. Clique em Salvar quando terminar e depois de verificar sua chave primária, clique em Salvar no 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 de lápis.

   Você sempre pode 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 duplicatas, então modifique as chaves primárias com cautela.

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

Habilitar a importação de dados do webinar para seus usuários do Salesforce

Com os mapeamentos de campo do webinar estabelecidos, você poderá 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ários individuais e usuários que são membros de determinados perfis do Salesforce.

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

Para habilitar a importação de dados do webinar para todos em sua organização do Salesforce, alterne Habilitar importação de webinars para todos os perfis/usuários para Habilitado :

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

Você pode habilitar 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 habilitar a importação de dados do webinar para usuários ou perfis selecionados:

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

   

2. No menu suspenso Ativar importação de webinar apenas para esses Perfis/Usuários, selecione Perfil ou Usuário:

   

   • Para adicionar um perfil, selecione Profile e 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.