Nesta página, descrevemos como configurar a autenticação e as permissões antes de criar o repositório de dados do Zendesk.
Ativar o acesso ao token
Para permitir que o Zendesk se autentique e interaja com sua instância do Zendesk, ative o acesso ao token. Siga estas etapas para ativar o acesso ao token:
- Acesse sua instância do Zendesk e faça login com uma conta de administrador.
- No menu de navegação, expanda Apps e integrações e selecione Configuração da API em APIs.
- Marque a caixa de seleção Permitir acesso ao token da API.
- Clique em Salvar.
Configurar autenticação e permissões
Para uma integração segura usando o OAuth 2.0, registre seu aplicativo no Zendesk para receber o ID e a chave secreta do cliente necessários.
Criar um cliente OAuth e receber credenciais de autenticação
Para criar um cliente OAuth no Zendesk e receber as credenciais de autenticação, siga estas etapas:
Acesse sua instância do Zendesk e faça login com uma conta de administrador.
Clique no ícone Produtos do Zendesk e selecione Central de administração.
Central de administração do Zendesk No menu de navegação, expanda Apps e integrações e selecione Clientes OAuth em APIs.
Clique em Adicionar cliente OAuth.
Insira os seguintes detalhes do cliente:
- Nome:insira um nome descritivo para o aplicativo.
- Opcional: Descrição:insira uma breve descrição.
- Opcional: Empresa. Insira o nome da sua empresa.
- Opcional: Logotipo:forneça um logotipo, que aparece na tela de permissão.
- Identificador exclusivo (ID do cliente): dê um nome exclusivo ao cliente. Você pode editar a sugestão inicial, mas ela precisa ser exclusiva.
- Tipo de cliente:selecione Público para aplicativos executados em um navegador ou em um dispositivo móvel ou Confidencial para aplicativos executados em servidores seguros.
- Redirecionar URLs (obrigatório): digite
https://vertexaisearch.cloud.google.com/oauth-redirect. Esse é o URL para que o Zendesk redireciona após a autorização, recebendo o código de autorização.
Clique em Salvar para receber o chave secreta do cliente.
- ID do cliente:o valor do campo Identificador exclusivo.
- Chave secreta do cliente:um novo campo Chave secreta aparece. Copie e salve esse secret imediatamente em um local seguro. Por motivos de segurança, a senha completa é mostrada apenas uma vez. Se você perder a chave, será necessário regenerá-la.
Credenciais do cliente geradas Clique em Salvar novamente para finalizar as mudanças.
Configurar permissões
Para configurar as permissões necessárias, siga estas etapas:
- Acesse sua instância do Zendesk e faça login com uma conta de administrador.
- Clique no ícone Produtos do Zendesk e selecione Central de administração.
- No menu de navegação, expanda Apps e integrações e selecione Clientes OAuth em Conexões.
- Clique em Adicionar cliente.
Insira os seguintes detalhes do cliente:
- Nome: insira um nome descritivo. Isso não pode ser alterado.
- Tipo de concessão do OAuth: selecione Código de autorização.
- ID do cliente: digite o ID do cliente obtido na seção Criar um cliente OAuth no Zendesk.
- Chave secreta do cliente: insira o valor da chave secreta do cliente obtido na seção Criar um cliente OAuth no Zendesk.
- URL de autorização: o endpoint de autorização geralmente está no formato
https://<var>your-subdomain</var>.zendesk.com/oauth/authorize. Substitua<var>your-subdomain</var>pelo seu subdomínio real do Zendesk. - URL do token: o endpoint do token geralmente está no formato
https://<var>your-subdomain</var>.zendesk.com/oauth/token. Substitua<var>your-subdomain</var>pelo seu subdomínio real do Zendesk.
Adicionar escopos - Escopos: insira os seguintes escopos separados por espaços, com base no modo de conexão:
Modo de conexão Escopo Finalidade É necessário consentimento do administrador Pesquisa federada read,users:readPermite pesquisar dados do Zendesk. Não Clique em Salvar.