Integração com Zendesk

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 7 min. de leitura

    • A integração da aplicação Gestão de ativos de software com a aplicação Zendesk permite que você rastreie suas assinaturas de software e recupere licenças não utilizadas.

    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 Zendesk Escopos de autenticação
    Download de assinaturas Agente light Nenhum(a)
    Extrair atividade do usuário Agente light Nenhum(a)
    Recuperar assinatura administrador Nenhum(a)

    Criar um Zendesk cliente OAuth

    Crie um cliente OAuth para autenticar Zendesk solicitações de API.

    Antes de Iniciar

    Zendesk Função necessária: administrador

    Procedimento

    1. Em um navegador da Web, abra o Zendesk.
    2. Faça login usando suas credenciais de administrador.
    3. No menu de navegação à esquerda do Zendesk Espaço do agente, selecione o ícone do administrador ( ícone do administrador).
    4. Acesse a Central de administração na página do administrador e, no menu do administrador, navegue até Aplicações e integrações > API.
      A página da API Zendesk é aberta.
    5. Selecione a guia Clientes OAuth e Adicionar cliente OAuth.
    6. No formulário, preencha os campos.
      Tabela 2. Criar um novo formulário de cliente OAuth
      Campo Descrição
      Nome de cliente Nome do cliente OAuth.
      Descrição Breve descrição do cliente OAuth.
      Empresa Nome da empresa cujos dados o cliente OAuth concede acesso por meio da API Zendesk. O nome da empresa é exibido durante a autenticação de suas solicitações de API Zendesk.

      Este campo é preenchido automaticamente com base na empresa à qual sua conta Zendesk está associada. No entanto, você pode modificar o nome da empresa conforme necessário.
      Logotipo Logotipo que é exibido durante a autenticação de suas Zendesk solicitações de API.

      Selecione o quadrado verde para localizar e selecionar o logotipo que você deseja exibir.
      Identificador único Identificador exclusivo do cliente OAuth. Este campo é preenchido automaticamente com base no nome do cliente OAuth que você especificou no campo Nome do cliente. No entanto, você pode modificar o identificador exclusivo conforme necessário.
      Nota:
      O identificador exclusivo é usado somente no código Zendesk.
      Tipo de cliente Este campo deve ser definido como Confidencial. Os clientes de autenticação confidencial são executados em servidores seguros, onde suas credenciais podem ser mantidas em segurança.
      URLs de redirecionamento 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.
    7. Selecione Save (Salvar).
    8. Na caixa de diálogo, selecione OK.
      A caixa de diálogo é fechada e o formulário é recarregado.
    9. Copie o valor do campo Segredo.
      Salve o valor do segredo em um local seguro para uso posterior.

    Criar uma conexão do Zendesk

    Crie uma conexão entre suas aplicações Zendesk e sua instância ServiceNow para que sua instância possa recuperar dados do usuário de suas aplicações.

    Antes de Iniciar

    ServiceNow Função necessária: administrador

    Procedimento

    1. Em sua instância ServiceNow, navegue até Automação de Processo > Flow Designer.
      O Flow Designer é iniciado em uma nova guia.
    2. Selecione a guia Conexões.
    3. Localize sua conexão Zendesk e selecione Configurar.
    4. Na caixa de diálogo, preencha os campos.
      Tabela 3. Caixa de diálogo Criar conexão
      Campo Descrição
      Informação de conexão
      Nome da Conexão Nome da conexão Zendesk. Este campo é preenchido automaticamente.
      URL de conexão URL da conexão.

      Insira https://<subdomain> .zendesk.com , em que <subdomain> é o subdomínio da sua organização.
      Informações de credencial
      ID do cliente do OAuth Identificador exclusivo do seu Zendesk cliente OAuth.

      Insira o mesmo identificador exclusivo que você especificou em Criar um Zendesk cliente OAuth.
      Segredo do cliente do OAuth Segredo atribuído ao seu cliente OAuth Zendesk.

      Insira o mesmo segredo que você copiou em Criar um Zendesk cliente OAuth.
      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 redirecionamento que você especificou em Criar um Zendesk cliente OAuth.
    5. 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.
    6. Na caixa de diálogo Zendesk de autorização do OAuth, selecione Autorizar.
      O token de acesso OAuth se torna disponível para autorizar sua conexão Zendesk.

    Criação do perfil de Integração Zendesk

    Crie um perfil de integração Zendesk para rastrear assinaturas de software e otimizar o licenciamento de suas aplicações Zendesk.

    Antes de Iniciar

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

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

    Importante:
    Você deve marcar a caixa de seleção Zendesk Spoke para esta integração ao instalar recursos opcionais na página Application Manager. Para obter mais informações sobre como escolher as aplicações SaaS necessárias, consulte Solicitação Gestão de licenças de SaaS.

    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 Zendesk em IU principal estará inativa.

    Procedimento

    1. Navegue até o perfil de integração.
      InterfaceAção
      IU principal
      1. Navegar até Tudo > Ativo de Software > Licença de SaaS > Perfis de Integração Direta.
      2. Selecione Novo.
      3. Selecione Perfil de integração do Zendesk.
      Espaço de ativo do software
      1. Navegar até Operações de licença > Assinaturas de Usuário > Perfis de integração diretos.
      2. Selecione Novo.
      3. Selecione Zendesk na lista suspensa.
      4. Selecione Continuar.
    2. No formulário, preencha os campos.
      Tabela 4. Formulário Perfil de integração
      Campo Descrição
      Nome para exibição Nome do perfil de integração. Por exemplo, Zendesk Integration.
      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 campo é definido automaticamente como Assinatura do Zendesk.
    3. Revise as funções de usuário necessárias ou as permissões de API especificadas no campo Configuração do fornecedor para cada processo para minimizar os riscos de segurança e otimizar SaaS licenças.
      Nota:
      Para obter mais informações, consulte Tabela de permissões mínimas do usuário.
      1. Na seção Subfluxo de assinatura de download, verifique se o campo Subfluxo está definido como Assinaturas de download do Zendesk.
        Nota:
        A caixa de seleção Baixar assinaturas está marcada por padrão e você não pode desmarcá-la.
      2. Na seção Recuperar subfluxo de assinatura, verifique se o campo Subfluxo está definido como Recuperar assinatura do Zendesk.
        Nota:
        A caixa de seleção Recuperar assinaturas está marcada por padrão. Se você não quiser recuperar assinaturas, poderá desmarcar esta caixa de seleção. Se você desmarcar, os candidatos a remoção serão criados, mas o subfluxo de assinatura de recuperação não será acionado ou o processo de recuperação não será iniciado.
    4. Selecione Save (Salvar).
      Sua instância ServiceNow cria um perfil de integração de rascunho.

      O campo Conexão e credencial é exibido e definido automaticamente como sn_zendesk_spoke.Zendesk.

    5. No formulário de perfil de integração, selecione Validar conexão para verificar os detalhes de conexão e credencial desta integração.

      A validação da conexão verifica as APIs de download de assinaturas, mas não as APIs de recuperação de assinaturas.

    6. Depois que a conexão for verificada, selecione Publicar.
    7. Na caixa de diálogo Confirmação de publicação, selecione OK.

    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 software que são atualizadas diariamente.

    Se você quiser configurar vários perfis de integração com conexões exclusivas, crie aliases secundários para gerenciar diferentes configurações e definições para cada perfil de integração. Para obter mais informações, consulte Crie um alias secundário para configurar vários perfis de integração.

    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.