Os tokens de API são as chaves que desbloqueiam todo o potencial do Zendesk. Seja você criando integrações personalizadas, automatizando fluxos de trabalho ou conectando ferramentas de terceiros, você precisará de um token de API para autenticar suas solicitações. Pense nisso como uma senha que permite que os aplicativos se comuniquem com sua conta do Zendesk com segurança.
A boa notícia? Criar um token de API do Zendesk leva apenas alguns minutos. A má notícia? Se você não seguir as práticas recomendadas de segurança, poderá expor dados confidenciais do cliente ou comprometer todo o seu sistema de suporte.
Neste guia, vou orientá-lo por todo o processo: desde habilitar o acesso ao token até gerar seu primeiro token, testá-lo e implementar medidas de segurança que mantêm seus dados seguros. Também mostrarei como ferramentas como o eesel AI usam esses tokens para construir agentes de IA poderosos que lidam com tickets de suporte de forma autônoma.
O que você vai precisar
Antes de começar, certifique-se de que você tem:
- Acesso de administrador à sua conta do Zendesk (apenas administradores podem gerar tokens de API)
- Acesso ao token habilitado nas configurações da sua conta (vou mostrar como verificar isso)
- Um lugar seguro para armazenar o token (gerenciador de senhas, variáveis de ambiente ou cofre seguro)
Se você não for um administrador, precisará pedir ao seu administrador do Zendesk para gerar um token para você ou conceder privilégios de administrador.
Passo 1: Habilitar o acesso ao token no Admin Center
Antes de gerar qualquer token, você precisa se certificar de que o acesso ao token está ativado no nível da conta. Este é um recurso de segurança que impede o acesso não autorizado à API.
Veja como verificar e habilitá-lo:
- Faça login na sua conta do Zendesk
- Clique no ícone de engrenagem na barra lateral esquerda e selecione Ir para o Admin Center
- Na barra lateral esquerda, clique em Apps e integrações e selecione APIs > Zendesk API
- Clique na aba Configurações
- Alterne Acesso ao Token para LIGADO (ON)
Se o acesso ao token já estiver habilitado, você verá a opção de alternância definida como LIGADO (ON) e uma lista de todos os tokens existentes abaixo. Se você não vir esta opção, sua conta pode não ter acesso à API incluído em seu plano.
Importante: Apenas usuários verificados podem usar tokens de API. Se alguém deixar sua organização, seus tokens permanecerão ativos até que você os desative manualmente. É por isso que as auditorias regulares de token são importantes.
Passo 2: Gerar um novo token de API
Agora que o acesso ao token está habilitado, você pode criar seu primeiro token de API. Cada token deve ter um nome descritivo para que você saiba para que ele serve mais tarde.
- No Admin Center, vá para Apps e integrações > APIs > API tokens
- Clique no botão Adicionar token de API (ou no ícone de mais ao lado de "Tokens de API Ativos")
- Insira uma Descrição para o token (por exemplo: "Integração eesel AI" ou "Script de Relatório Interno")
- Clique em Salvar para gerar o token
A descrição é opcional, mas altamente recomendada. Daqui a seis meses, você não se lembrará para que servia o "Token #7". Boas descrições incluem o nome da ferramenta, o propósito e a data de criação.
Você pode ter até 256 tokens ativos por conta (ou 2.048 se sua conta já exceder 256). Se você atingir o limite, precisará excluir um token existente antes de criar um novo.
Passo 3: Copiar e armazenar seu token com segurança
Aqui está a parte crítica: o token completo é exibido apenas uma vez. Depois de fechar esta janela, você nunca mais verá o token completo. Se você perdê-lo, precisará gerar um novo.
- Clique no botão Copiar para copiar o token para a sua área de transferência
- Cole-o em algum lugar seguro imediatamente (seu gerenciador de senhas, uma variável de ambiente segura ou um cofre criptografado)
- Clique em Salvar novamente para retornar à lista de tokens
Nunca armazene tokens de API em:
- Repositórios de código (GitHub, GitLab, etc.)
- Documentos ou planilhas compartilhadas
- Mensagens de e-mail ou chat
- Arquivos de texto simples no seu computador
Se você expor acidentalmente um token, exclua-o imediatamente e crie um novo. Os tokens de API podem se passar por qualquer usuário em sua conta, incluindo administradores, então trate-os como senhas.
Passo 4: Testar seu token de API
Antes de usar seu token em produção, verifique se ele funciona com uma solicitação de API simples. A maneira mais fácil é usar o curl na sua linha de comando:
curl https://your-subdomain.zendesk.com/api/v2/users.json \
-u your-email@example.com/token:your-api-token
Substitua:
your-subdomainpelo seu subdomínio do Zendesk (a parte antes de.zendesk.com)your-email@example.compelo seu e-mail de administrador do Zendeskyour-api-tokenpelo token que você acabou de copiar
Se tudo funcionar, você verá uma resposta JSON com dados do usuário. Se você receber um erro de autenticação, verifique:
- Seu endereço de e-mail está correto
- Você incluiu
/token:entre seu e-mail e o token de API - O token não foi excluído ou desativado
- O acesso ao token ainda está habilitado no Admin Center
Você também pode testar seu token usando o Postman ou qualquer cliente HTTP. Defina o tipo de autenticação para "Basic Auth" e use seu endereço de e-mail com /token anexado como o nome de usuário e seu token de API como a senha.
Token de API vs token de acesso OAuth
O Zendesk oferece dois métodos de autenticação, e escolher o certo é importante para a segurança.
Tokens de API são melhores para:
- Scripts internos e automação
- Integrações de conta única
- Testes e desenvolvimento rápidos
- Ferramentas que precisam de acesso amplo
Tokens de acesso OAuth são melhores para:
- Aplicativos de terceiros
- Acesso específico do usuário
- Permissões com escopo (limitando o que o token pode fazer)
- Aplicativos distribuídos para vários clientes
A principal diferença? Os tokens de API agem como senhas mestras. Eles podem se passar por qualquer usuário e acessar tudo o que esse usuário pode acessar. Os tokens OAuth são vinculados a usuários específicos e podem ser limitados a permissões específicas (escopos).
Se você estiver construindo algo apenas para uso interno, os tokens de API são mais simples. Se você estiver construindo um produto que outras empresas usarão, o OAuth é a escolha segura.
Melhores práticas de segurança
Os tokens de API são poderosos. Siga estas práticas para manter seus dados do Zendesk seguros:
Armazene tokens em variáveis de ambiente, não no código
export ZENDESK_API_TOKEN="seu-token-aqui"
import os
token = os.environ.get('ZENDESK_API_TOKEN')
Gire os tokens regularmente Defina um lembrete no calendário para girar os tokens a cada 90 dias. Gere um novo token, atualize seus aplicativos e exclua o token antigo.
Desative os tokens não utilizados Se você parar de usar uma integração, desative seu token imediatamente. Não espere até "poder precisar dele novamente".
Use as permissões mínimas necessárias Ao contrário dos tokens OAuth, os tokens de API não suportam permissões com escopo. Isso significa que qualquer token de API pode fazer tudo o que um administrador pode fazer. Considere criar uma conta de administrador dedicada com permissões limitadas para acesso à API.
Monitore o uso do token com logs de auditoria Nos planos Enterprise, o Zendesk registra a atividade do token de API no log de auditoria. Você pode ver quando os tokens foram criados, desativados ou usados. Revise esses logs mensalmente para atividades suspeitas.
Exclua os tokens comprometidos imediatamente Se você suspeitar que um token foi exposto, exclua-o imediatamente. Não há "desfazer" para a exclusão de token, então certifique-se de que seus aplicativos estão prontos para usar um novo token.
Solução de problemas de problemas comuns
Erro "Acesso ao token está desabilitado" Isso significa que o acesso ao token não foi habilitado no Admin Center. Siga o Passo 1 acima para ativá-lo.
Falhas de autenticação
Verifique novamente seu formato de autenticação. Deve ser email@example.com/token:api_token (com o separador /token:). Erros comuns incluem usar dois pontos em vez de uma barra ou esquecer a parte /token completamente.
Limitação de taxa O Zendesk limita as solicitações de API com base no seu plano. Se você atingir os limites de taxa, receberá uma resposta 429. O complemento High Volume API pode aumentar seus limites, se necessário.
Expiração do token Os tokens de API não expiram automaticamente, mas podem se tornar inválidos se:
- O administrador que os criou perde os privilégios de administrador
- O acesso ao token é desabilitado no nível da conta
- O token é excluído ou desativado manualmente
Usando seu token com o eesel AI
Depois de ter seu token de API, você pode conectar o Zendesk a ferramentas de automação poderosas. Na eesel AI, usamos tokens de API do Zendesk para construir agentes de IA que lidam com tickets de suporte de forma autônoma.
Veja como funciona: você fornece seu token de API e nossa IA aprende com seus tickets anteriores, artigos da central de ajuda e macros. Em minutos, ele entende o contexto do seu negócio e pode começar a lidar com o suporte de primeira linha. A IA elabora respostas, procura informações de pedidos no Shopify, processa reembolsos e encaminha problemas complexos para sua equipe humana.
Ao contrário dos chatbots básicos, o eesel AI opera como um verdadeiro colega de equipe. Você começa com a supervisão (a IA elabora respostas para revisão) e, em seguida, expande gradualmente seu escopo à medida que ela se prova. Implantações maduras atingem até 81% de resolução autônoma.
O token de API do Zendesk é o que permite que nossa IA leia tickets, atualize campos e envie respostas diretamente em sua central de ajuda. É seguro, limitado apenas à sua conta e você mantém controle total sobre o que a IA pode acessar.
Comece a automatizar seu suporte do Zendesk hoje
Criar um token de API do Zendesk é simples, mas usá-lo de forma eficaz é onde reside o verdadeiro valor. Seja você criando integrações personalizadas ou conectando ferramentas alimentadas por IA como o eesel AI, seu token de API é a ponte entre seus dados de suporte e a automação que pode transformar seu fluxo de trabalho.
Lembre-se: a segurança vem primeiro. Armazene os tokens com segurança, gire-os regularmente e monitore seu uso. Com essas práticas em vigor, você desbloqueará todo o poder da API do Zendesk, mantendo os dados de seus clientes protegidos.
Pronto para ver o que a IA pode fazer pela sua equipe de suporte? Experimente o eesel AI gratuitamente e conecte-o à sua conta do Zendesk em minutos. Nossa IA aprende seu negócio instantaneamente e começa a ajudar com os tickets desde o primeiro dia.
Perguntas Frequentes
Compartilhe esta postagem
Article by
Stevia Putri
Stevia Putri is a marketing generalist at eesel AI, where she helps turn powerful AI tools into stories that resonate. She’s driven by curiosity, clarity, and the human side of technology.
