Para autenticar chamadas de API do Zendesk em ações personalizadas, você deve criar uma conexão, semelhante ao descrito em Criação de conexões para integração com serviços externos. 

Esse fluxo de trabalho inclui as etapas a seguir: 

  • Etapa 1: Criar o cliente OAuth do Zendesk
  • Etapa 2: Adicionar cliente do Zendesk como cliente de conexões
  • Etapa 3: Use a conexão em uma ação personalizada

Etapa 1: Criar o cliente OAuth do Zendesk

  1. Na Central de administração, clique em Aplicativos e integrações na barra lateral e, em seguida, selecione APIs > Clientes OAuth.
  2. Clique em Adicionar cliente OAuth no lado direito da lista de clientes OAuth.
  3. Definir o tipo de cliente como Confidencial
  4. Defina a URL de redirecionamento como https://zis.zendesk.com/api/services/zis/connections/oauth/callback.
    O subdomínio é sempre zis, não o subdomínio da sua conta.
  5. Clique em Salvar. 
    Depois de atualizar a página, um novo campo Segredo já preenchido será exibido no canto inferior direito. Esse é o valor client_secret especificado nas especificações do OAuth 2.0.
  6. Copie o valor do Segredo para a área de transferência e salve-o em um lugar seguro. 
    Como os caracteres podem ir além da largura da caixa de texto, certifique-se de selecionar tudo antes de copiar. Por razões de segurança, seu segredo é exibido por completo apenas uma vez. 
    Depois de clicar em Salvar, você terá acesso apenas aos primeiros nove caracteres.
    Para obter uma descrição completa dos campos mencionados nesta etapa, consulte Uso da autenticação OAuth com seu aplicativo.
    Detalhes da configuração do cliente OAuth

Etapa 2: Adicionar cliente do Zendesk como cliente de conexões

  1. Na Central de administração, clique em Aplicativos e integrações na barra lateral e selecione Conexões > Clientes OAuth.
  2. Clique em Adicionar cliente no lado direito da lista de clientes OAuth.
  3. Defina o tipo de concessão OAuth como Credenciais do cliente
  4. Adicione a ID do cliente e o segredo de seu cliente do Zendesk criado na Etapa 1
  5. Defina a URL do token como: https://{your_subdomain}.zendesk.com/oauth/tokens
  6. Insira uma lista de escopos padrão separados por espaço. 
    Escopos são permissões que representam o que um aplicativo de cliente pode acessar em nome do usuário. É recomendável definir apenas os escopos mínimos necessários para sua meta final (evite usar a caixa de diálogo de leitura/escrita, a menos que seja necessário). Os escopos disponíveis são documentados aqui.
  7. Clique em Salvar para criar o cliente.

    As credenciais do cliente são preferidas nesse caso, pois as Conexões ficam diretamente no Zendesk, atualizam-se automaticamente e já têm acesso ao segredo. Token de vida curta produzido pela concessão de credenciais do cliente é mais adequado para essa forma de acesso.

    O código de autorização também tem suporte, mas seu administrador precisará ativar a conexão e, se a conexão não for usada por um tempo suficiente e o refresh_token expirar, sua conexão será interrompida e precisará ser autorizada novamente.
    Se você quiser usar esse código de autorização, precisará definir a URL Autorizar como: https://{your_subdomain}.zendesk.com/oauth/authorizations/new.

Detalhes da configuração do cliente OAuth

Etapa 3: Use a conexão em uma ação personalizada

A conexão criada na etapa 3 fica disponível na lista suspensa Autenticação quando você criar uma ação personalizada.

Se você edita uma ação personalizada existente para incluir essa autorização, deve adicioná-la novamente aos fluxos de ação em que ela é usada. As alterações em ações personalizadas não são refletidas automaticamente em nenhum fluxo de ação que a inclua.

Aviso sobre a tradução: este artigo foi traduzido por um software de tradução automática para oferecer a você uma compreensão básica do conteúdo. Medidas razoáveis foram tomadas para fornecer uma tradução precisa, no entanto, a Zendesk não garante a precisão da tradução.

Em caso de dúvidas relacionadas à precisão das informações contidas no artigo traduzido, consulte a versão oficial do artigo em inglês.

Powered by Zendesk