Antes de prosseguir, certifique-se de que atende aos seguintes pré-requisitos:

• O usuário que realiza a configuração deve ser um administrador da organização Salesforce onde a integração será instalada.

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

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

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

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

  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.

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

  • Sem o Pacote Pro—Quando você tem o Control Hub básico, você pode optar por permitir ou negar o 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 a 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 do Webex via Salesforce Exchange:

1. Navegue até Webex App for Salesforce no AppExchange.
2. Selecione Obter 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 do Webex na guia Instalar e administrar.

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.

• Sem o Pacote Pro—Quando você tem o Control Hub básico, você pode optar por permitir ou negar o 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 a integrações para obter mais informações.

Ligando

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

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

1. Crie um aplicativo conectado

Para criar um novo aplicativo conectado:

1. Em Configuração, procure por Gerenciador de Aplicativos e então escolha Novo Aplicativo Conectado.

   

2. Insira um Nome do aplicativo conectado, por exemplo, MyExampleApp.
3. Insira um endereço de e-mail de contato.
4. Verifique Ativar configurações OAuth.
5. Especifique um URL de retorno de chamada provisório (atualizaremos isso mais tarde), por exemplo, https://localhost/placeholder.

   

6. Role a página para baixo e selecione os seguintes escopos OAuth:
   • Acesso total (completo)
   • Executar solicitações a qualquer momento (refresh_token, offline_access)

   

   O escopoPerform requests at any time permite que Named Credentials atualize seu token de acesso quando uma sessão expira.

7. Deslize até o final da página e clique em Salvar e depois clique em Continuar.
8. Na próxima página, role até API (Ativar configurações OAuth) e clique em Gerenciar detalhes do consumidor.

   

   Você pode precisar se autenticar novamente no Salesforce.

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

   

2. Criar um provedor de autenticação

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

Para criar um provedor de autenticação:

1. Em Configuração, procure por Autenticação e selecione Autenticação. Fornecedores. 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, completo 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 de espaço reservado pelo URL de retorno de chamada que você copiou da Configuração do Salesforce acima.

   

9. Salve seu aplicativo conectado.

   Pode ser necessário aguardar até 10 minutos para que as configurações entrem em vigor e se propaguem por toda a infraestrutura do Salesforce.

3. Criar uma credencial nomeada

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

Para criar uma credencial nomeada:

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

   

2. Insira o seguinte valor para Label, ApexMDTAPI.
3. Para o URL, insira o 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 Principal nomeado.
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 Escopo, digite, completo refresh_token offline_access.
8. Ativar Iniciar fluxo de autenticação ao salvar.

   

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

   

10. Você será solicitado a fazer login na sua organização. Após fazer login, você verá uma caixa de diálogo Permitir acesso. Clique em Permitir.
11. Você será então redirecionado para a tela Credencial Nomeada e o Status de Autenticação indicará Autenticado como your-email@domain.com.

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

Finalmente, continue para o próximo tópico na guia Chamando, Criar site para chamar, abaixo.

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

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

Se você já tiver criado autorizações, credenciais nomeadas ou provedores de autenticação para um aplicativo conectado ao Webex, será necessário removê-los antes de prosseguir. Caso contrário, continue para Criar 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 digite Gerenciador de aplicativos e selecione-o na lista.
3. Role a lista até encontrar seu aplicativo Webex Connected, 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 do Webex existentes:

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

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

1. Na caixa de texto Busca rápida digite Autenticação. Fornecedores 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 para a próxima seção para criar um novo aplicativo Webex Connected para autorização do Salesforce.

Criar 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: Em Busca rápida, procure e selecione Domíniose salve o URL de Meu domínio.

1. Na caixa de texto Busca rápida digite Gerenciador de aplicativos e selecione-o na lista.
2. Insira um Nome do aplicativo conectado, por exemplo, Autorização Webex Salesforce.
3. Insira um endereço de e-mail para E-mail de contato.
4. Verifique Ativar configurações OAuth.
5. Insira dois URLs de retorno de chamada usando o URL que você recuperou anteriormente, um 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 Escopos OAuth disponíveis em Escopos OAuth selecionados:
   • Acesso total (completo)
   • Executar solicitações a qualquer momento (refresh_token, offline_access)
7. Desmarque Exigir chave de prova para extensão de troca de código (PKCE) para fluxos de autorização suportados.
8. 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 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.

Para ativar ou desativar o histórico de chamadas:

1. Vá para a administração Webex.
2. Deslize para baixo até Histórico de chamadas do Webex.
3. Mova a chave para a configuração desejada, ativada ou desativada.

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

Para usuários do CUCM e do Broadworks, as seguintes funcionalidades não são suportadas:

• Recebendo chamadas de entrada no discador global do Salesforce (o aplicativo Webex ainda receberá chamadas de entrada).
• Visualizando a duração das chamadas na janela de registro de chamadas do Salesforce após realizar uma chamada de saída com sucesso.
• Encerrar chamadas através do botão na janela de registro de chamadas do Salesforce após realizar uma chamada de saída com sucesso.
• Preenchimento automático da duração das chamadas na janela de registro de chamadas do Salesforce após o término de uma chamada de saída.

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

• A Salesforce impõe uma limitação na contagem de eventos (25.000), o que pode fazer com que as integrações falhem em situações de uso intenso. Existem pacotes da Salesforce 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 de utilitário de chamadas do Webex não estão disponíveis no aplicativo móvel do Salesforce.

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 e 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:

   

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

   • Contatos
   • Pistas

   Selecione a opção Inserir novos registros para cada Webinar se desejar que todos os participantes importados do Webinar sejam criados como novos registros de objeto, 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 Webinar do Webex.

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

   • Membros da campanha: Os leads e contatos importados estão disponíveis na seção Membros da campanha de destino da campanha do Salesforce, que é um recurso padrão do Salesforce. (Disponível na versão 1.16 e posteriores)
   • Membros da campanha de webinars Webex: Os leads e contatos importados estão disponíveis na seção Membros da campanha do Webinar Webex de uma campanha do Salesforce de destino, que é um recurso personalizado do Webex.
   • Tanto membros da campanha quanto membros da campanha do Webinar Webex: 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 posteriores)
   Qualquer outro objeto personalizado que você escolher da lista será importado para a seção Membros da campanha do Webinar Webex da campanha do Salesforce de destino.

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:

   

   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 webinar. Use o botão + Novo Campo para adicionar campos adicionais, conforme necessário.
   Todos os campos do objeto Salesforce devem ser mapeados para os campos correspondentes do webinar, conforme mostrado acima.
   Somente as perguntas padrão dos formulários de inscrição para webinars do Webex podem ser mapeadas para campos do Salesforce. Não há suporte para perguntas personalizadas em webinars do Webex.
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ê 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 duplicados, então modifique as teclas principais exclusivamente.