Obrigado pelos seus comentários.

Antes de continuar, verifique se você atende 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 seção 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 Meu domínio 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 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 dos usuários às integrações.

  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 usando o 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 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 dos usuários às integrações.

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 chamadas recebidas, o aplicativo Webex toca, mas o Salesforce não pode interceptar a chamada, então o pop-up de registro não é exibido.

Se você estiver trabalhando com o Webex para Salesforce versão 1.18 ou anterior, você deve configurar uma autorização do Salesforce antes de poder trabalhar com o Salesforce. Webex Calling

Crie um aplicativo conectado

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

   

2. Em Aplicativos de cliente externos, escolha Configurações.
3. Ative a opção Permitir a criação de aplicativos conectados. Se o botão Novo aplicativo conectado já estiver ativado, você poderá criar um novo aplicativo conectado.

   

4. Para criar um novo aplicativo conectado, clique em Novo aplicativo conectado e insira os detalhes necessários.

   

5. Insira um nome de aplicativo conectado, como MyExampleApp.
6. Insira um endereço de e-mail de contato.
7. Marque a caixa Ativar configurações de OAuth.
8. Especifique um espaço reservado para URL de retorno de chamada (atualizaremos isso mais tarde), como. 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.

    

Crie um provedor de autenticação

Em seguida, crie um provedor de autenticação, que facilite a autenticação com sua organização do Salesforce.

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, como ApexMDTAPI.
4. Cole a chave do consumidor e o segredo do consumidor que você salvou ao configurar seu aplicativo conectado.
5. Insira completo refresh_token offline_access em Escopos padrão.
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.

   Pode levar até 10 minutos para que as configurações entrem em vigor e se propaguem por toda a infraestrutura da Salesforce.

Crie uma credencial nomeada

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

   

2. Insira ApexMDTapi em Rótulo.
3. Insira a URL da instância da sua organização em URL, como https://na1.salesforce.com; ou, se você estiver usando Meu domínio, seu nome de domínio totalmente qualificado, como https://mycompany.my.salesforce.com.
4. Em Tipo de identidade, selecione Principal nomeado.
5. Em Protocolo de Autenticação, selecione OAuth 2.0.
6. Em Provedor de Autenticação, selecione o provedor de autenticação que você criou anteriormente.
7. Insira completo refresh_token offline_access em Escopo.
8. Marque a caixa ao lado de Iniciar fluxo de autenticação ao salvar.

   

9. Em Opções de texto explicativo, marque a caixa ao lado de Permitir mesclar campos no corpo HTTP e clique em Salvar.

   

10. Faça login na sua organização. Depois de fazer login, clique em Permitir em Permitir acesso.
11. Na tela Credencial Nomeada, o Status Autenticado indica Autenticado como your-email@domain.com.

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

Continue em Criar site para chamadas na seção Chamadas.

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 de destino do Salesforce, clique em e, em seguida, selecione Configuração.
2. Na caixa de texto Busca rápida, insira App Manager e selecione-o na lista.
3. Role até o aplicativo Webex Connected na lista, clique no ícone de seta para baixo à direita da entrada e selecione Exibir.
4. Selecione Excluir e selecione Excluir novamente quando solicitado para 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. Clique na seta para baixo à direita da entrada de credenciais nomeadas do Webex e clique em Excluir.
3. Clique em Excluir novamente quando solicitado para confirmar.

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

1. Na caixa de texto Busca rápida, insira Auth. Provedores e, em seguida, selecione-os na lista.
2. Selecione o link Del no início da entrada do provedor de autenticação Webex.
3. Clique em 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 de destino do Salesforce, clique em e, em seguida, selecione 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 Aplicativos de cliente externos, selecione Configurações.
5. Ative a opção Permitir a criação de aplicativos conectados. Se o botão Novo aplicativo conectado já estiver ativado, você poderá criar um novo aplicativo conectado.

   

6. Para criar um novo aplicativo conectado, clique em 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 a caixa Ativar configurações de OAuth.
11. Insira duas URLs de retorno de chamada usando a URL que você recuperou anteriormente, uma por linha, adicionando /apex/ webexsfdcauthe /apex/ cisco_webex__webexsfdcauthcomo 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 caixa Exigir extensão de chave de prova para troca de código (PKCE) para fluxos de autorização suportados.
14. Clique em Salvar.
15. Copie e salve com segurança a Chave do Consumidor e o Segredo do Consumidor. Você precisa desses valores ao configurar a autorização do Salesforce no Control Hub.

Para a integração do Webex para Salesforce versão 1.22 e posterior, configure a autorização do Salesforce com um aplicativo cliente externo. Se você já tiver um aplicativo conectado para autorização Webex Salesforce, você pode migrá-lo para um aplicativo cliente externo e preservar sua chave de consumidor.

Antes de começar

• Você precisa de acesso de administrador do sistema Salesforce.
• Meu domínio deve estar ativado em sua organização do Salesforce.

Recupere seu URL do Meu domínio

1. No canto superior direito da sua página de destino do Salesforce, clique em e, em seguida, clique em Configurar.
2. Na caixa Busca rápida, pesquise por Domínios e selecione-os.
3. Anote sua URL do Meu domínio. Você o usará para configurar os URLs de retorno de chamada. Por exemplo, seu URL pode ser https://my-company.my.salesforce.com.

Crie um novo aplicativo cliente externo

1. Em Configuração, pesquise o App Manager na caixa Busca rápida e selecione-o.
2. Clique em Novo aplicativo cliente externo.

   Insira os seguintes detalhes:

   • Nome do aplicativo cliente externo — Autorização Webex Salesforce
   • Nome da API — Webex_Salesforce_Authorization(preenchido automaticamente)
   • E-mail de contato — Seu endereço de e-mail de administrador
   • Estado de distribuição — Local

3. Clique em Criar.

Definir as configurações do OAuth

1. Em API (Ativar configurações de OAuth), clique em Ativar OAuth.
2. Configure os URLs de retorno de chamada. [your-domain]Substitua pelo valor do Salesforce My Domain e insira cada URL em uma linha separada:
   • https://[your-domain].my.salesforce.com/apex/webexsfdcauth
   • https://[your-domain].my.salesforce.com/apex/cisco_webex__webexsfdcauth
3. Adicione esses escopos do OAuth aos escopos do OAuth selecionados:
   • Acesso total (full)
   • Execute solicitações a qualquer momento (refresh_token, offline_access)
4. Em Segurança, mantenha a opção Exigir chave de prova para troca de código (PKCE) marcada.
5. Clique em Criar.

Recupere a chave do consumidor e o segredo do consumidor

1. Em Configuração, selecione Gerenciador de aplicativos > Gerenciador de aplicativos de cliente externo.
2. Clique em Autorização Webex Salesforce.
3. Clique na guia Configurações e abra as Configurações do OAuth.
4. Clique em Consumer Key and Secret.
5. Verifique seu e-mail para obter o código de verificação da Salesforce.
6. Na página Verificar sua identidade, insira o código e clique em Verificar.
7. Copie e salve com segurança a Chave do Consumidor e o Segredo do Consumidor. Você precisa desses valores ao configurar a autorização do Salesforce no Control Hub.

Migrar um aplicativo conectado existente

Se você já tiver uma autorização do aplicativo conectado para Webex Salesforce, migre-a para um aplicativo cliente externo. Isso preserva a chave do consumidor, mantém os tokens existentes válidos e transfere as configurações do OAuth. O aplicativo conectado original permanece após a migração.

1. Em Configuração, pesquise o App Manager e escolha-o.
2. Encontre o aplicativo conectado existente, clique na seta para baixo à direita da linha e escolha Exibir.
3. Na página de detalhes do aplicativo conectado, clique em Migrar para o aplicativo cliente externo.
4. Revise o resumo da migração e clique em Migrar.
5. Quando a migração for concluída, o Salesforce abrirá a nova página de detalhes do aplicativo cliente externo.

Verifique a migração

1. Em Configuração, escolha Gerenciador de aplicativos > Gerenciador de aplicativos de cliente externo.
2. Confirme se a Autorização Webex Salesforce aparece na lista.
3. Clique no aplicativo e verifique se a guia Configurações mostra os URLs de retorno de chamada e os escopos do OAuth corretos:
   • Acesso total (full)
   • Execute solicitações a qualquer momento (refresh_token, offline_access)
4. (Opcional) Recupere a chave do consumidor e o segredo do consumidor e confirme se eles correspondem aos valores originais.

Desative o aplicativo conectado original (opcional)

Depois de verificar se o aplicativo cliente externo funciona, faça o seguinte:

1. Em Configuração, selecione Gerenciador de aplicativos.
2. Encontre o aplicativo conectado original e clique na seta para baixo à direita da linha.
3. Escolha Gerenciar.
4. Em Políticas de OAuth, defina Usuários Permitidos para bloquear novas autorizações ou deixar o aplicativo conectado ativo durante um período de transição.

Recomendamos manter o aplicativo conectado original ativo por um breve período de transição, para que as integrações continuem funcionando antes de você desativá-lo.

Quando um novo pacote estiver disponível, siga as etapas em Instalar o aplicativo Webex no Salesforce acima. 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_eventsplatform_events.meta/.htm. platform_event_limits

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