Integração com Salesforce CRM

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 14 min. de leitura

    • A integração da aplicação Gestão de ativos de software com os serviços Salesforce de gestão de relacionamento com clientes (CRM) permite que você rastreie suas assinaturas de software e recupere licenças não utilizadas.

    Nota:

    Se você estiver usando Espaço para ativos de software, use o Playbook SaaS para integrar sua instância ServiceNow com o Salesforce CRM. Para obter mais informações sobre como criar um perfil de integração Salesforce CRM por meio do Playbook, consulte Criar uma integração Salesforce CRM.

    Os serviços Salesforce CRM compatíveis incluem
    • Salesforce Sales Cloud
    • Salesforce Service Cloud
    • Salesforce Plataforma
    • Salesforce Comunidade de clientes
    • Salesforce Comunidade de parceiros
    • Salesforce Comunidade da empresa
    • Salesforce Conversa
    As organizações Salesforce Classic e Salesforce Lightning são compatíveis.
    Nota:
    Você pode rastrear direitos de outros serviços pelos quais você paga, mas não são baseados em assinatura de usuário, usando métricas de licença personalizadas. Consulte Adiciona uma métrica de licenciamento personalizado para obter mais detalhes sobre como criar uma métrica de licença personalizada.

    A conta Salesforce que você usa para conectar a integração requer uma licença de usuário Salesforce e as seguintes permissões de acesso de usuário.

    Importante:
    Minimize os riscos de segurança e proteja as informações concedendo acesso somente ao usuário ou às permissões de API necessárias.
    Tabela 1. Permissões mínimas do usuário
    Processo Função do usuário necessária na aplicação Salesforce CRM Escopos de autenticação
    Baixar assinaturas Usuário com as seguintes permissões:
    • Exibir instalação e configuração
    • Personalizar aplicação
    • Gerenciar aplicações conectadas
    • API habilitada
    • gerenciar seus dados (API)
    • Execute solicitações em seu nome a qualquer momento (refresh_token, acesso off-line)
    Extrair atividade do usuário Usuário com as seguintes permissões:
    • Exibir instalação e configuração
    • Personalizar aplicação
    • Gerenciar aplicações conectadas
    • API habilitada
    • gerenciar seus dados (API)
    • Execute solicitações em seu nome a qualquer momento (refresh_token, acesso off-line)
    Recuperar assinatura Usuário com permissões de administrador
    • gerenciar seus dados (API)
    • Execute solicitações em seu nome a qualquer momento (refresh_token, acesso off-line)

    Para obter informações adicionais sobre os serviços Salesforce de CRM, consulte a Documentação do desenvolvedor do Salesforce.

    Registrar uma aplicação Salesforce

    Registre uma aplicação por meio do portal do administrador Salesforce.

    Antes de Iniciar

    Salesforce Função necessária: administrador

    Procedimento

    1. Faça login no Salesforce e alterne para o ambiente clássico.
    2. Selecione Configuração.
    3. No menu de navegação à esquerda, selecione Compilação > Criar > Apps.
    4. Na seção Aplicações conectadas, selecione Novo.
    5. No formulário, preencha os campos.
      Tabela 2. Novo formulário do App de conexão
      Campo Descrição
      Nome do app conectado Nome da sua aplicação.
      Nome da API Nome da API. Este campo é preenchido automaticamente.
      E-mail do Contato O endereço de e-mail que você deseja associar à aplicação.
      Habilitar configuração do OAuth Opção para habilitar as configurações do OAuth.
      URL do Retorno de Chamada URL do provedor OAuth para o qual os usuários são redirecionados após a autenticação.

      Insira https://instance.service-now.com/oauth_redirect.do, em que <instance> é o nome da sua instância ServiceNow.
      Escopos do OAuth selecionados Escopos do OAuth que determinam a quantidade de acesso que é concedido a um token de acesso. Os seguintes valores são necessários:
      • Acessar e gerenciar seus dados (API)
      • Execute solicitações em seu nome a qualquer momento (refresh_token, offline_access)
    6. Certifique-se de que o valor da política Token de atualização esteja definido como Token de atualização válido até ser revogado.
    7. Selecione Salvar.
    8. Na página do seu novo app, copie os valores nos campos Chave do consumidor e Segredo do consumidor.
      Salve-os em um local seguro para uso posterior. Sua chave do consumidor (ID do cliente) e o segredo do consumidor (segredo do cliente) são confidenciais. Não os compartilhe.

    Criação do perfil de Integração Salesforce CRM

    Crie um perfil de integração para rastrear assinaturas de software e otimizar o licenciamento dos serviços Salesforce CRM.

    Nota:
    Você deve criar a integração Salesforce CRM somente no escopo Global.

    Crie seu primeiro Salesforce CRM perfil de integração

    Crie um perfil de integração para a primeira organização Salesforce para a qual você deseja rastrear assinaturas de software e otimizar o licenciamento.

    Antes de Iniciar

    Para criar um perfil de integração Salesforce CRM, solicite o plug-in Gestão de ativos de software - Gestão de licenças de SaaS (com.sn_sam_saas_int) na ServiceNow Store.

    ServiceNow Função necessária: sam_integrator ou administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Se você estiver usando Espaço para ativos de software, a opção para criar o perfil de integração [ Salesforce CRM em IU principal estará inativa.

    Procedimento

    1. Navegue até o perfil de integração.
      InterfaceAção
      IU principal
      1. Navegar até Todos > Ativo de Software > Licença de SaaS > Perfis de Integração Direta.
      2. Selecione Novo.
      3. Selecione Perfil de integração do Salesforce CRM.
      Espaço para ativos de software
      1. Navegar até Operações de licença > Assinaturas de Usuário > Perfis de integração direta.
      2. Selecione Novo.
      3. Selecione Salesforce CRM na lista suspensa.
      4. Selecione Continuar.

        O Playbook é iniciado para integração Salesforce CRM, e as próximas etapas não são válidas. Para obter mais informações, consulte Criar uma integração Salesforce CRM.
    2. No formulário, preencha os campos.
      Tabela 3. Formulário Perfil de integração
      Campo Descrição
      Nome de visualização Nome do perfil de integração.
      Insira um nome que identifique exclusivamente a organização Salesforce para a qual você está criando este perfil de integração. Por exemplo, SFDC Org1.
      Dica:
      Mantenha este nome curto para ajudá-lo a ser exibido melhor durante a emissão de relatórios.
      Conexão e Credencial Alias de credencial e conexão para Salesforce.

      Para o seu primeiro perfil de integração Salesforce CRM, use a conexão padrão e o alias de credencial que é preenchido automaticamente.
      Status Status do perfil de integração.
      • Se você não publicou o perfil de integração, este campo será definido automaticamente como Rascunho.
      • Se você já publicou o perfil de integração, este campo será definido automaticamente como Publicado.
      Tipo de perfil Tipo de perfil de integração. Este valor é definido automaticamente como Salesforce CRM.
    3. Na guia Subfluxo de assinatura de download, verifique se o campo Subfluxo está definido como Assinaturas de download do Salesforce CRM.
      Você pode exibir eventos realizados por usuários individuais até um ano antes da data atual. Para obter mais informações, consulte Revisar uma regra de recuperação de software.
      Nota:
      Gestão de ativos de software extrai os eventos a partir do momento em que você começa a baixar assinaturas de usuário, independentemente da data de criação do perfil.
    4. Na guia Recuperar subfluxo de assinatura, verifique se o campo Subfluxo está definido como Salesforce CRM Recuperar assinatura.
    5. Na guia Subfluxo de consumo de download, verifique se o campo Subfluxo está definido como Consumo de download do Salesforce CRM.
    6. Selecione Salvar.
      Nota:
      O subfluxo Calcular atividade não é necessário para integrações Salesforce CRM porque essas integrações usam informações sobre os últimos logins de usuário dos registros de usuário.
      Você pode exibir as contagens de consumo da aplicação Salesforce CRM baseada em consumo específico.
    7. Abra o registro de aliases de conexão e credencial selecionando o ícone de visualização (ícone de visualização) ao lado do campo Conexão e credencial.
    8. Selecione Abrir registro na visualização do registro.
    9. No formulário Aliases de conexão e credencial, selecione o link relacionado Criar nova conexão e credencial.
    10. Na caixa de diálogo Criar conexão e credencial, preencha os campos.
      Tabela 4. Caixa de diálogo Criar conexão e credencial
      Campo Descrição
      Nome da conexão O nome da conexão.

      Insira um nome que identifique exclusivamente a organização Salesforce para a qual você está criando esta conexão e credencial. Por exemplo, SFDC Org1.
      URL de conexão (URL da instância) URL que é exibido após o login em Salesforce ou o URL de domínio personalizado de Salesforce.
      ID do cliente OAuth ID do cliente (chave do consumidor) atribuída à sua aplicação Salesforce.
      Segredo do cliente OAuth Segredo do cliente (segredo do consumidor) atribuído à sua aplicação Salesforce.
      URL de redirecionamento do OAuth URL do provedor OAuth para o qual os usuários são redirecionados após a autenticação.

      Este campo é preenchido automaticamente com base no URL de retorno de chamada que você especificou em Registrar uma aplicação Salesforce.
    11. Selecione Criar e obter um Token do OAuth.
      Nota:
      Para a função necessária para executar esta etapa, consulte a tabela Permissões mínimas do usuário.
    12. Na caixa de diálogo OAuth2, faça login na mesma conta de administrador Salesforce que você usou para criar sua aplicação Salesforce.
      Dica:
      Se a caixa de diálogo não abrir automaticamente, verifique se os pop-ups são permitidos no navegador.
      Sua instância ServiceNow cria um token OAuth para Salesforce e retorna automaticamente para o formulário de perfil de integração.
    13. Selecione Publicar.

    Resultado

    Depois de publicar o perfil de integração, sua instância ServiceNow começa a recuperar dados de seus serviços Salesforce CRM. Para organizações com menos de 100 usuários, esse processo normalmente leva apenas alguns minutos para ser concluído. Para organizações com 100 a 5.000 usuários, esse processo pode levar cerca de 15 minutos para ser concluído. Para organizações com mais de 5.000 usuários, esse processo pode levar mais de uma hora para ser concluído.

    O que Fazer Depois

    Depois que a integração se conecta, sua instância ServiceNow cria automaticamente modelos de software, regras de recuperação e assinaturas de usuário que são atualizadas diariamente.

    Revise todas as regras de recuperação geradas automaticamente para recuperar assinaturas de usuário. Para obter mais informações, consulte Revisar uma regra de recuperação de software.

    Crie direitos de software para os modelos de software gerados automaticamente para rastrear o software usado em relação ao software de propriedade.
    A reconciliação também é executada em suas assinaturas como um trabalho agendado ou sob demanda. Você pode exibir os resultados da reconciliação no Workbench de licenças (Gestão de ativos de software aplicação clássica) ou na exibição de uso de licença (Software Asset Workspace). Use esses resultados para determinar sua posição de conformidade de licença e corrigir qualquer não conformidade.

    Criar Salesforce perfis de integração de CRM adicionais

    Crie um perfil de integração para cada organização Salesforce adicional para a qual você deseja rastrear assinaturas de software e otimizar o licenciamento.

    Antes de Iniciar

    Para criar um Salesforce perfil de integração de CRM, solicite o plug-in Gestão de ativos de software - Gestão de licenças de SaaS (com.sn_sam_saas_int) na ServiceNow Store.

    ServiceNow Função necessária: sam_integrator ou administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Se você estiver usando Espaço para ativos de software, a opção para criar o perfil de integração [ Salesforce CRM em IU principal estará inativa.

    Procedimento

    1. Navegue até o perfil de integração.
      InterfaceAção
      IU principal
      1. Navegar até Todos > Ativo de Software > Licença de SaaS > Perfis de Integração Direta.
      2. Selecione Novo.
      3. Selecione Perfil de integração do Salesforce CRM.
      Espaço para ativos de software
      1. Navegar até Operações de licença > Assinaturas de Usuário > Perfis de integração direta.
      2. Selecione Novo.
      3. Selecione Salesforce CRM na lista suspensa.
      4. Selecione Continuar.

        O Playbook é iniciado para integração Salesforce CRM, e as próximas etapas não são válidas. Para obter mais informações, consulte Criar uma integração Salesforce CRM.
    2. No formulário, preencha os campos.
      Tabela 5. Formulário Perfil de integração
      Campo Descrição
      Nome de visualização Nome do perfil de integração.
      Insira um nome que identifique exclusivamente a organização Salesforce para a qual você está criando este perfil de integração. Por exemplo, SFDC Org2.
      Dica:
      Mantenha este nome curto para ajudá-lo a ser exibido melhor durante a emissão de relatórios.
      Status Status do perfil de integração.
      • Se você não publicou o perfil de integração, este campo será definido automaticamente como Rascunho.
      • Se você já publicou o perfil de integração, este campo será definido automaticamente como Publicado.
      Tipo de perfil Tipo de perfil de integração. Este valor é definido automaticamente como Salesforce CRM.
    3. Na guia Subfluxo de assinatura de download, verifique se o campo Subfluxo está definido como Assinaturas de download do Salesforce CRM.
      Você pode exibir eventos realizados por usuários individuais até um ano antes da data atual. Para obter mais informações, consulte Revisar uma regra de recuperação de software.
      Nota:
      Gestão de ativos de software extrai os eventos a partir do momento em que você começa a baixar assinaturas de usuário, independentemente da data de criação do perfil.
    4. Na guia Recuperar subfluxo de assinatura, verifique se o campo Subfluxo está definido como Salesforce CRM Recuperar assinatura.
    5. Na guia Subfluxo de consumo de download, verifique se o campo Subfluxo está definido como Consumo de download do Salesforce CRM.
    6. Selecione Salvar.
      Nota:
      O subfluxo Calcular atividade não é necessário para integrações Salesforce CRM porque essas integrações usam informações sobre os últimos logins de usuário dos registros de usuário.
      Você pode exibir as contagens de consumo da aplicação Salesforce CRM baseada em consumo específico.
    7. Selecione o ícone de visualização (ícone de visualização) ao lado do campo Conexão e credencial para abrir o registro de aliases de conexão e credencial.
    8. Selecione Abrir registro na visualização do registro.
    9. No formulário Aliases de conexão e credencial, crie um alias secundário que possa identificar exclusivamente a conexão e as credenciais para este perfil de integração.
      O primeiro perfil de integração Salesforce CRM que você cria usa o alias de conexão e credencial padrão (primário) para Salesforce. Cada perfil de integração Salesforce CRM adicional que você cria requer um alias secundário exclusivo que ajuda a diferenciar a conexão e as credenciais entre cada perfil de integração.
      1. Selecione o link em Aliases secundários > Parentalidade = *** para adicionar aliases secundários.
      2. Selecione Novo.
        O formulário Aliases de conexão e credencial do alias secundário é aberto.
      3. Insira um nome para o alias secundário no campo Nome.
      4. Mantenha selecionado (ou clique com o botão direito do mouse) o cabeçalho do formulário e selecione Salvar.
      5. Depois que o formulário for recarregado, selecione o link relacionado Criar nova conexão e credencial.
      6. Na caixa de diálogo Criar conexão e credencial, preencha os campos.
        Tabela 6. Caixa de diálogo Criar conexão e credencial
        Campo Descrição
        Nome da conexão O nome da conexão.

        Insira um nome que identifique exclusivamente a organização Salesforce para a qual você está criando esta conexão e credencial. Por exemplo, SFDC Org2.
        URL de conexão (URL da instância) URL da instância Salesforce à qual você está se conectando por meio desta integração.
        ID do cliente OAuth ID do cliente (chave do consumidor) atribuída à sua aplicação Salesforce.
        Segredo do cliente OAuth Segredo do cliente (segredo do consumidor) atribuído à sua aplicação Salesforce.
        URL de redirecionamento do OAuth URL do provedor OAuth para o qual os usuários são redirecionados após a autenticação.

        Este campo é preenchido automaticamente com base no URL de retorno de chamada que você especificou em Registrar uma aplicação Salesforce.
      7. Selecione Criar e obter um Token do OAuth.
        Nota:
        Para a função necessária para executar esta etapa, consulte a tabela Permissões mínimas do usuário.
      8. Na caixa de diálogo OAuth2, faça login na mesma conta de administrador Salesforce que você usou para registrar sua aplicação Salesforce.
        Dica:
        Se a caixa de diálogo não abrir automaticamente, verifique se os pop-ups são permitidos no navegador.
        Sua instância ServiceNow cria um token OAuth para Salesforce e retorna automaticamente para o formulário Aliases de conexão e credencial.
    10. Retorne ao seu perfil de integração navegando até Licença de SaaS > Administração > Perfis de Integração Direta e selecionando o perfil na lista Perfis de integração.
    11. No campo Conexão e credencial do formulário Perfil de integração, selecione o ícone de pesquisa para localizar e selecionar o alias secundário que você criou na etapa 8.
      A seleção do alias secundário associa o alias ao perfil de integração. Sua instância ServiceNow usa esse alias para identificar a conexão e as credenciais para esse perfil de integração.
    12. Selecione Publicar.

    Resultado

    Depois de publicar o perfil de integração, sua instância ServiceNow começa a recuperar dados de seus serviços Salesforce CRM. Para organizações com menos de 100 usuários, esse processo normalmente leva apenas alguns minutos para ser concluído. Para organizações com 100 a 5.000 usuários, esse processo pode levar cerca de 15 minutos para ser concluído. Para organizações com mais de 5.000 usuários, esse processo pode levar mais de uma hora para ser concluído.

    O que Fazer Depois

    Depois que a integração se conecta, sua instância ServiceNow cria automaticamente modelos de software, regras de recuperação e assinaturas de usuário que são atualizadas diariamente.

    Revise todas as regras de recuperação geradas automaticamente para recuperar assinaturas de usuário. Para obter mais informações, consulte Revisar uma regra de recuperação de software.

    Crie direitos de software para os modelos de software gerados automaticamente para rastrear o software usado em relação ao software de propriedade.
    A reconciliação também é executada em suas assinaturas como um trabalho agendado ou sob demanda. Você pode exibir os resultados da reconciliação no Workbench de licenças (Gestão de ativos de software aplicação clássica) ou na exibição de uso de licença (Software Asset Workspace). Use esses resultados para determinar sua posição de conformidade de licença e corrigir qualquer não conformidade.