Como integrar com Zendesk

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 6 min. de leitura

    • Você pode integrar sua instância ServiceNow com a aplicação Zendesk para rastrear suas assinaturas de software e recuperar licenças não utilizadas.

    Criar um cliente OAuth Zendesk

    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.
      O Zendesk Espaço do agente é aberto.
    3. No menu de navegação esquerdo do Zendesk Espaço do agente, selecione o ícone do administrador (ícone do administrador).
      O menu Administrador é aberto.
    4. No menu Administrador, navegue até Canais > API.
      A página da API Zendesk é aberta.
    5. Selecione a guia Clientes OAuth e clique em Adicionar cliente OAuth.
    6. O formulário Criar um novo cliente OAuth é aberto.
    7. No formulário, preencha os campos.
      Tabela 1. 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 exibido durante a autenticação de suas solicitações de API Zendesk. Clique no quadrado verde para localizar e selecionar o logotipo que você deseja exibir.
      Identificador exclusivo 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.
      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.
    8. Clique em Salvar.
      A caixa de diálogo Armazene o segredo que aparecerá será aberta.
    9. Na caixa de diálogo, clique em OK.
      A caixa de diálogo é fechada e o formulário é recarregado.
    10. Copie o valor no campo Segredo.
      Salve-o 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. Na 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 clique em Configurar.
    4. Na caixa de diálogo Criar conexão, preencha os campos.
      Tabela 2. 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 OAuth Identificador exclusivo do seu cliente OAuth Zendesk. Insira o mesmo identificador exclusivo que você especificou em Criar um cliente OAuth Zendesk.
      Segredo do cliente OAuth Segredo atribuído ao seu cliente OAuth Zendesk. Insira o mesmo segredo que você copiou em Criar um cliente OAuth Zendesk.
      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 cliente OAuth Zendesk.
    5. Clique em Criar e obter token do OAuth.
      A caixa de diálogo Zendesk de autorização do OAuth é aberta.
    6. Na caixa de diálogo, clique em 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 (com.sn_sam_saas_int) na ServiceNow Store.

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

    Por Que e Quando Desempenhar Esta Tarefa

    Se você estiver usando o Software Asset Workspace, a opção para criar o perfil de integração Zendesk na IU principal ficará 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 Zendesk.
      Espaço de ativo do software
      1. Navegar até Operações de licença > Assinaturas de Usuário > Perfis de integração direta.
      2. Selecione Novo.
      3. Selecione Zendesk na lista suspensa.
      4. Selecione Continuar.
    2. No formulário, preencha os campos.
      Tabela 3. Formulário de perfil de integração
      Campo Descrição
      Nome de exibição Nome do perfil de integração. Por exemplo, Integração do Zendesk.
      Conexão e Credencial Alias de conexão e credencial para o spoke Zendesk. Este campo é definido automaticamente como sn_zendesk_spoke.Zendesk.
      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. Na guia Baixar subfluxo de assinatura, verifique se o campo Subfluxo está definido como Assinaturas de download do Zendesk.
      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ê inicia o download de 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 Recuperar assinatura do Zendesk.
    5. Clique em Salvar.
      Sua instância ServiceNow cria um perfil de integração de rascunho. O perfil de integração usa os subfluxos Zendesk Baixar assinaturas e Zendesk Recuperar assinatura para recuperar dados do usuário da aplicação Zendesk.
    6. Depois que o formulário for recarregado, clique em Publicar.

    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 sua propriedade.
    A reconciliação também é executada em suas assinaturas como um trabalho programado ou sob demanda. Você pode exibir os resultados da reconciliação no Workbench de licença (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 para corrigir qualquer não conformidade.