Antes de seguir as etapas de configuração, você deve primeiro vá para as Notas de versão e baixe a versão mais recente do Pacote Webex App Salesforce .

Requisitos

Salesforce Edição corporativa

Esta integração requer, no mínimo, o Salesforce Edição corporativa. Ver Edições do Salesforce para obter mais informações.

Meu domínio na organização do Salesforce

Você deve implantar o Meu domínio na sua organização se quiser usar componentes do Lightning. Veja o Meu domínio Salesforce documentação 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 pacote profissional —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 pacote profissional —Com Pacote profissional , você conta com a funcionalidade avançada de gerenciar o acesso dos usuários às integrações.

Ver Configurar o 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. Somente 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.

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 , procurar Gerenciador de aplicativos e escolha Novo aplicativo conectado .

   

2. Insira um Nome do aplicativo conectado , por exemplo, MeuExemploAplicativo .
3. Insira um E-mail de contato endereço.
4. Verificar Habilitar configurações OAuth .
5. Especifique uma URL de retorno de chamada de espaço reservado (atualizaremos isso mais tarde), por exemplo, https://localhost/placeholder .

   

6. Role para baixo e escolha os seguintes Escopos OAuth:
   • Acesso total (full)
   • Execute as solicitações a qualquer momento (refresh_token ,offline_access )

   

   A página Executar solicitações a qualquer momento O escopo permite que a Named Credentials atualize seu token de acesso quando uma sessão expirar.

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 .

   

   Pode ser necessário fazer uma nova autenticação com a Salesforce.

9. Anote o Chave do cliente e o Segredo do cliente .

   

2. Criar um provedor de autenticação

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

Para criar um provedor de autenticação:

1. Em Configuração , procurar Autenticação e selecione Aut. Provedores . Clique em Novo.

   

2. Selecionar Salesforce como o Tipo de provedor .
3. Insira um nome para o provedor de autenticação, por exemplo, ApexMDTAPI .
4. Colar no Chave do cliente e Segredo do cliente que você salvou ao configurar o aplicativo Connected.
5. Insira os seguintes escopos em Escopos padrão , cheiorefresh_tokenoffline_access .
6. Deixe tudo em branco e clique em Salvar .

   

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

   

8. Edite seu aplicativo conectado e substitua a 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.

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

3. Criar uma credencial nomeada

Em seguida, será necessário criar uma credencial nomeada.

Para criar uma credencial nomeada:

1. Em Configuração , procurar Nomeado e selecione Credenciais nomeadas . Clique Novo legado .

   

2. Insira o seguinte valor para Rótulo , 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 , sua equipe totalmente qualificada Meu domínio nome de domínio, por exemplo,https://mycompany.my.salesforce.com .
4. Para Tipo de identidade , escolha Diretor nomeado .
5. Para Protocolo de autenticação escolher OAuth 2.0 .
6. Para Provedor de autenticação , escolha o provedor de autenticação que você criou anteriormente.
7. Para Escopo , inserir, cheiorefresh_tokenoffline_access .
8. Ativar Iniciar o fluxo de autenticação ao salvar .

   

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

   

10. Você será solicitado a fazer logon na sua organização. Depois de fazer login, você verá uma Permitir acesso caixa de diálogo. Clique Permitir .
11. Você será redirecionado ao Credencial nomeada Tela e o Status autenticado indicará Autenticado como seu-e-mail@domínio.com .

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

Por fim, passe para o próximo tópico da Chamando guia, 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. Verificar Habilitar 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 (full)
   • Execute as 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á as configurações definidas.

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

Para ativar ou desativar o histórico de chamadas:

1. Vá para 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 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 a duração das chamadas na janela de log de chamadas do Salesforce depois de fazer uma chamada de saída com êxito
• Terminar chamadas através do botão na janela de log de chamadas do Salesforce depois de fazer uma chamada de saída com êxito
• Preencher automaticamente as durações das chamadas na janela de log de chamadas do Salesforce após o término de uma chamada de saída

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

• A Salesforce impõe um limite de contagem de eventos (25.000) que pode causar falhas nas integrações sob 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 de configuração Importar dados do 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.

O Importar dados do webinar interface de configuração está disponível a partir do Administrador Webex página:

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

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

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

Para atribuir permissões a um usuário:

1. Navegar para Integre o Salesforce com o aplicativo Webex .
2. Escolha o Gerenciar guia na parte inferior do artigo e, em seguida, expanda Fornecer acesso :

   

3. Siga as instruções para adicionar o Administrador de importação Webex permissão para 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 Salesforce, digite Webex no campo de pesquisa e, em seguida, escolha Administrador Webex :

   

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

   

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

Configurar mapeamentos de campo de importação de Webex

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

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

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

   

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

   

   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

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

   

   Escolha um campo disponível que seja exclusivo para cada registro. Por exemplo, você pode ter muitos contatos com o nome de Mark, mas cada contato terá um endereço de e-endereço de email exclusivo .

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

   Todos Os campos de objeto 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 adicionou usando o ícone de lixeira ao lado do campo à direita.
6. Clique Salvar quando 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 de 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á importado no sistema . Como resultado, isso pode levar a 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.

Habilite 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ários individuais e usuários que são membros de determinados perfis do Salesforce.

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

Para permitir a importação de dados do webinar para todos na sua organização do Salesforce, Habilitar importação de webinar para todos os perfis/usuários para Ativado :

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

Você pode ativar a importação de dados de webinars para usuários individuais selecionados ou para grupos específicos de usuários que correspondem 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 Habilitar importação de webinar para todos os perfis/usuários é Desativado :

   

2. Na lista suspensa Habilitar importação de webinar somente para estes perfis/usuários, selecione Perfil ou Usuário:

   

   • Para adicionar um perfil, selecione Perfil , clique em 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 digite 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 de lixeira ao lado da entrada.