Suporte ao cliente
Conectar o Zendesk a um agente de IA autônomo
O Zendesk centraliza os tickets de clientes. Um agente Atako pode classificá-los, priorizá-los e preparar respostas, com acesso limitado às ações que você escolher.
Fluxos de trabalho possíveis
Triagem e priorização dos tickets recebidos
O agente lista os novos tickets com list_tickets ou search_tickets, lê seu conteúdo com get_ticket e get_ticket_comments, e então atualiza status, prioridade e tags com update_ticket. Um ticket urgente de faturamento não fica mais parado três horas em uma fila genérica antes de chegar ao agente humano certo, e os tickets menores são agrupados em vez de tratados um a um sem ordem pela equipe de suporte.
Suporte de primeiro nível via macros e Help Center
Para as dúvidas recorrentes, o agente consulta as macros existentes com list_macros e os artigos do Help Center com get_article, compõe uma resposta coerente com o tom da empresa, e então a adiciona ao ticket via update_ticket. Os casos ambíguos continuam abertos para um agente humano, em vez de serem fechados indevidamente por excesso de confiança em uma resposta automática mal calibrada para o caso específico.
Estruturação das organizações de clientes
Quando um novo cliente chega, o agente cria a organização correspondente com create_organization, mapeando seu domínio de e-mail, atualiza suas notas e tags com update_organization, e associa os usuários envolvidos com update_user. Uma base organizada facilita depois a filtragem automática dos tickets por conta de cliente, em vez de classificar cada solicitação uma a uma sem o contexto da conta associada.
Ações do conector
list_tickets
Leitura. Listar os tickets da conta, ordenáveis e filtráveis.
search_tickets
Leitura. Buscar tickets com a sintaxe de consulta do Zendesk.
get_ticket
Leitura. Recuperar um ticket: status, prioridade, responsável.
get_ticket_comments
Leitura. Listar os comentários de um ticket, em ordem cronológica.
list_macros
Leitura. Listar as macros de resposta disponíveis.
get_article
Leitura. Recuperar um artigo do Help Center.
list_ticket_fields
Leitura. Listar os campos de ticket definidos na conta.
create_ticket
Escrita. Criar um ticket com um assunto e um primeiro comentário.
update_ticket
Escrita. Alterar status, prioridade, tags, e adicionar um comentário.
create_organization
Escrita. Criar uma organização, com mapeamento de domínios de e-mail.
update_organization
Escrita. Modificar nome, domínios, notas ou tags de uma organização.
create_user
Escrita. Criar um usuário, agente ou cliente final.
Pré-requisitos
- Papel de admin na empresa Atako para conectar a integração.
- Subdomínio Zendesk da empresa (yourcompany.zendesk.com).
- Papel de Agent no mínimo do lado do Zendesk, Guide admin para o Help Center.
- Acesso via API token ativado no Admin Center antes de gerar o token.
Como conectar
- 1
Abrir Configurações → Integrações
Um admin escolhe o Zendesk e informa o subdomínio da empresa.
- 2
Ativar e gerar o token do lado do Zendesk
Admin Center → Apps and integrations → APIs → ativar Token access, e então criar um token.
- 3
Colar e-mail e token no Atako
O campo espera o endereço do agente Zendesk e o token, separados por dois-pontos.
- 4
Conceder o acesso a um agente
Escolhem-se as ações precisas por agente, em escopo de leitura ou de leitura e escrita.
Por que conectar um agente autônomo ao Zendesk
O Zendesk centraliza as solicitações de clientes, com seu histórico, prioridade, comentários e organização de vínculo. Um agente autônomo com acesso a ele decide sozinho, conforme a instrução recebida, buscar um ticket, priorizá-lo ou preparar uma resposta, via tool calling.
A conexão é feita por chave de API, um endereço de e-mail e um token combinados, com um subdomínio Zendesk específico da sua conta, sem nunca transmitir a senha da própria conta Zendesk.
Esse funcionamento se encaixa bem em um agente de triagem de suporte ou de automação de suporte: ele roda continuamente, recebe os novos tickets continuamente e prepara o trabalho sem esperar que um humano abra a conta Zendesk pela manhã. O Zendesk está entre os conectores incluídos no plano Standard, sem custo adicional específico para essa integração.
Limites e boas práticas
O Zendesk vem retirando progressivamente a autenticação por API token em favor do OAuth: os tokens inativos há 30 dias são desativados desde o fim de julho de 2026, a criação de novos tokens será bloqueada no fim de outubro de 2026, e todos os tokens deixarão de funcionar em 30 de abril de 2027 (anúncio do Zendesk). Uma conexão configurada hoje por token precisará ser revista antes desse prazo.
O papel da conta usada para gerar o token define o que o token pode fazer do lado do Zendesk, além do próprio grant do Atako: um papel Agent basta para os tickets, mas a gestão do Help Center exige um papel Guide admin na conta.
A documentação não menciona um limite de taxa específico para o conector, ao contrário das cotas documentadas nos canais de e-mail ou webhook. Cada chamada, bem-sucedida ou recusada, continua consultável no log de auditoria da página do agente.
Casos de uso relacionados
Integrações relacionadas
Perguntas frequentes
O agente pode fechar ou responder a um ticket sem validação?
Se ele tiver o grant update_ticket em escopo de escrita, sim, pode alterar o status e adicionar um comentário diretamente. Muitas empresas limitam esse grant aos tickets simples e deixam os casos sensíveis para um agente humano.
Como revogar o acesso do Atako ao Zendesk?
Em Configurações → Integrações, clique em Revoke na conexão Zendesk. O token criptografado é removido imediatamente, e todos os agentes que o usavam perdem o acesso na hora.
O Zendesk vai abandonar a autenticação por API token?
Sim, o Zendesk está retirando progressivamente os tokens de API em favor do OAuth, com desativação completa prevista para o fim de abril de 2027. Uma conexão configurada hoje por token precisará ser revista antes desse prazo.
O que ler a seguir
Fontes
- Managing API token access to the Zendesk API · acessado em 4 de setembro de 2026
- Announcing the removal of API tokens as an authentication method for API requests · acessado em 4 de setembro de 2026
- Migrating from API tokens to OAuth access tokens · acessado em 4 de setembro de 2026
CTO da Atako
Este conteúdo foi redigido pelos agentes de IA da Atako, depois revisado, corrigido e validado por Romain Laodicina, CTO da Atako.