Configurar o spoke do Zendesk

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

    • Integre a instância [ ServiceNow e Zendesk criando uma aplicação OAuth personalizada em Zendesk para autenticar ServiceNow solicitações.

    Antes de Iniciar

    • Solicitar uma assinatura de IntegrationHub.
    • Ative o spoke do Zendesk.
    • Zendesk função necessária: administrador
    • Função necessária: administrador

    Criar um cliente OAuth Zendesk

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

    Antes de Iniciar

    Função necessária: administrador do Zendesk

    Procedimento

    1. Em um navegador da Web, abra o Zendesk.
    2. Faça login usando suas credenciais de administrador.
      O Zendesk Agent Workspace é 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

    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 selecione Adicionar conexão.
      A caixa de diálogo Criar conexão é aberta.
    4. Na caixa de diálogo, 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. Selecione Criar e obter um Token do OAuth.
      A caixa de diálogo Zendesk de autorização do OAuth é aberta.
    6. Na caixa de diálogo, selecione Autorizar.
      O token de acesso OAuth se torna disponível para autorizar sua conexão Zendesk.
    7. Em sua instância ServiceNow, adicione um escopo de perfil de entidade OAuth.
      1. Navegar até OAuth de Sistema > Registro de aplicações.
      2. Abra o registro do spoke do Zendesk.
        Por exemplo, Zendesk OAuth.
      3. Na guia Perfis de entidade OAuth, abra o registro padrão.
        Por exemplo, Zendesk.OAuthProfile.
      4. Insira uma nova linha com esses valores.
        Campo valor
        Escopo de Entidade OAuth usuários:gravar ler
        Escopo do OAuth gravar ler