Integre a Salesforce ao aplicativo Webex

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

• O usuário que estiver executando a configuração deve ser um administrador da organização do Salesforce onde a integração deve 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 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 do Salesforce necessárias.
• Todos os usuários devem ter as licenças Webex necessárias para usar a funcionalidade Webex específica, como o Webex Meetings e Webex Calling, de dentro do Salesforce.

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

• Esta 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 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 o acesso do usuário a integrações para obter mais informações.

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

Para instalar a integração Webex através do Salesforce Exchange:

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

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

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 , full refresh_token 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 o 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. 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 , enter, full refresh_token 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.

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.

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

• Os componentes do utilitário Webex Calling 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 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 , 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 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 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 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.

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.