API do Freshdesk: tickets, contatos e base de conhecimento com agentes de IA
A API do Freshdesk permite gerenciar tickets, respostas, contatos, empresas, agentes e artigos da base de conhecimento. É usada por times de suporte para integrar o help desk com produtos e sistemas internos. O acesso é pela chave de API do perfil de um agente.
Os grandes recursos da API, em português claro.
Criar, atualizar, filtrar e mesclar chamados.
Responder ao cliente e adicionar notas internas.
Cadastrar e consultar clientes.
Ler e publicar artigos de soluções.
Consultar equipes e responsáveis para roteamento.
Disparar chamadas externas a partir de regras do Freshdesk.
Como se acessa a API do Freshdesk.
- Com credencial da sua empresaChave de API encontrada no perfil do agente no Freshdesk, usada em autenticação básica; o acesso segue as permissões desse agente.
- Documentação oficialdevelopers.freshdesk.com/api
- A chave herda as permissões do agente: crie um usuário dedicado.
- Há limites de chamadas por minuto que variam por plano.
- Tickets têm dados pessoais: aplique a LGPD.
- api freshdesk
- freshdesk api
- freshdesk api tickets
- integração freshdesk
- freshdesk api key
- freshdesk webhook
O que um agente do iTeam faz com a API do Freshdesk.
O agente classifica o ticket por produto e prioridade e envia para o grupo certo.
O agente propõe a resposta com o artigo da base; o atendente aprova com um clique.
O agente identifica perguntas repetidas e escreve rascunhos de artigos.
O agente agrupa tickets da semana por causa e manda ao produto os temas que mais cresceram.
Da credencial ao agente trabalhando, com aprovação.
Usuário de integração
Crie um agente de integração no Freshdesk e use a chave de API dele.
Cofre e permissões
Guarde no cofre do iTeam e defina quais agentes podem responder e quais só classificam.
Teste com aprovação
Comece em um grupo, com aprovação nas respostas e auditoria.
Dúvidas sobre a API do Freshdesk.
A API do Freshdesk é gratuita?
A API faz parte do Freshdesk, com limites de chamadas que variam por plano. Não há cobrança separada divulgada por chamada.
Preciso programar para usar a API do Freshdesk com o iTeam?
Não necessariamente. A ferramenta HTTP do iTeam lê a documentação da API e aprende os endpoints, e o time de implantação configura credenciais, permissões e testes com você.
Qual o limite da API do Freshdesk?
O limite de chamadas por minuto depende do plano contratado. A documentação oficial e os cabeçalhos da resposta mostram o limite da sua conta.
Como o agente de IA se autentica na API do Freshdesk?
Com a chave de API do perfil de um agente do Freshdesk, usada em autenticação básica, e o acesso herda as permissões desse usuário. Crie um usuário de suporte dedicado ao agente de IA, com o papel mínimo necessário, e use a chave dele. Assim a auditoria mostra quem fez o quê e a revogação é simples.
O que o agente de IA consegue fazer com tickets no Freshdesk?
Listar e buscar tickets, ler a conversa, responder, adicionar notas privadas, alterar prioridade, grupo e status, e consultar artigos da base de conhecimento. Um uso comum é o agente classificar um ticket novo, sugerir a resposta com base nos artigos e passar o caso complexo a um atendente com resumo. Respostas ao cliente passam por aprovação no início.
Como funciona o limite de chamadas por minuto da API do Freshdesk?
O limite é por conta e depende do plano, sem cota individual por chave, e o excesso devolve o erro de muitas requisições. As respostas trazem cabeçalhos que mostram o total e o restante. O agente deve acompanhá-los, esperar ao receber o erro e preferir webhooks. Confira na página oficial de limites o número do seu plano.
Existe sandbox do Freshdesk para testar um agente?
Não confirmei um sandbox gratuito para qualquer plano; a Freshworks oferece contas de teste e, em planos mais altos, ambientes de testes que convém verificar. Na prática, use uma conta de avaliação ou um grupo de tickets de teste. Em período de teste o limite de chamadas por minuto é menor, então confira antes.
Dá para o Freshdesk avisar o agente quando chega um ticket novo?
Dá, pelas automações do Freshdesk, que podem disparar um webhook ao criar ou atualizar um ticket. O agente recebe o evento, classifica e responde ou encaminha, sem varrer a fila a cada instante. Assim se poupa o limite por minuto e o tempo de resposta cai. A regra do webhook é configurada no painel de automações.
O agente de IA substitui a equipe de suporte do Freshdesk?
Não: ele assume o repetitivo, como triagem, resposta a perguntas frequentes e resumo de histórico, e o atendente continua nos casos que pedem julgamento, empatia ou exceção de política. Defina quando o agente deve passar o ticket a um humano e como o resumo vai junto. No iTeam, essa passagem e as aprovações ficam registradas.
Tickets do Freshdesk entram na LGPD quando o agente os lê?
Entram: nome, e-mail, telefone e o conteúdo das conversas são dados pessoais, às vezes com informação sensível. O agente só deve acessar os tickets que a tarefa exige e não repassar conteúdo a terceiros. Defina retenção e quem pode perguntar sobre um cliente. Não é parecer jurídico: combine as regras com o responsável por privacidade.
Quando não vale a pena usar um agente de IA no Freshdesk?
Quando a base de conhecimento está vazia ou desatualizada, porque o agente responderia sem fonte confiável, ou quando o volume de tickets é pequeno. Antes de automatizar, escreva os artigos das dúvidas mais comuns. Para filas grandes de perguntas repetidas, o agente de primeira linha costuma fazer sentido.
