Para que o "Agente de IA" consiga ler seus artigos e usá-los para responder dúvidas dos seus clientes ou colaboradores, precisamos criar uma ponte segura entre as plataformas. Fazemos isso por meio de um Token de API.
O Token de API funciona como uma "chave de acesso" oficial que autoriza a IA a ler as informações da sua central de ajuda.
Abaixo está o passo a passo completo de como gerar essa chave e quais informações você precisa enviar para a nossa equipe técnica.
Pré-requisitos
Antes de começar, certifique-se de que você possui acesso de administrador no Zendesk. Apenas administradores conseguem visualizar as opções de API e gerar novos tokens na plataforma.
Passo 1 – Acessar as configurações de API
O primeiro passo é encontrar o local correto dentro das configurações da sua conta.
-
Faça login no seu Zendesk.
-
No menu lateral esquerdo, clique no ícone de engrenagem e selecione Ir para a Central de administração (Admin Center).
-
Na barra lateral da Central de administração, vá em Aplicativos e integrações.
-
Selecione a opção APIs e, em seguida, clique em APIs do Zendesk.
Passo 2 – Habilitar o acesso por token
Antes de gerar a chave, precisamos garantir que o sistema permite o uso de tokens na sua conta. Esse é um recurso de segurança importante do Zendesk.
-
Dentro da página de APIs, clique na aba Configurações.
-
Verifique a chave Acesso por token. Se ela estiver desligada, alterne o botão para Ligado.
-
Se o acesso já estiver habilitado, você verá a lista de tokens existentes logo abaixo.
Passo 3 – Criar o Token de API
Com a permissão ativada, agora você pode gerar o token exclusivo para a nossa integração.
-
Clique na aba Tokens da API.
-
Clique no botão Adicionar token da API (ou no ícone de "+").
-
No campo Descrição, digite um nome que ajude a identificar o uso no futuro, como por exemplo: Clicksmart.
-
Clique em Salvar para gerar a chave.
🚨 Atenção máxima: O token completo será exibido na sua tela apenas esta vez. Copie o código imediatamente e cole em um lugar seguro. Se você fechar a janela sem copiar, o token será perdido e você terá que gerar um novo.
Passo 4 – Reunir os dados da integração
Para que a nossa equipe técnica consiga concluir a conexão e treinar a IA, precisaremos que você nos forneça 3 informações:
Token da API: O código longo que você acabou de copiar no passo anterior.
Subdomínio do Zendesk: É o nome da sua empresa que aparece na URL de acesso, antes de .zendesk.com. (Exemplo: se o seu link é suaempresa.zendesk.com, o subdomínio é apenas suaempresa).
E-mail do administrador: O endereço de e-mail do usuário administrador usado para gerar este token. (O Zendesk exige que o e-mail seja enviado junto com o token para validar o acesso).
Passo 5 – Enviar os dados para nossa equipe
Com os dados separados, basta nos enviar um e-mail ou preencher o formulário de integração com as informações:
Subdomínio:
E-mail do Admin:
Token da API:
Pronto! Com essas informações, nossa equipe fará o teste de conexão e o Cérebro da IA começará a ler e aprender com a sua base de conhecimento do Zendesk.