Um guia prático para a Freshdesk API v2

Se você gerencia uma equipe de suporte no Freshdesk, provavelmente está sempre em busca de maneiras de tornar as coisas mais fluidas. Você já deve ter ouvido falar da Freshdesk API v2, uma ferramenta que oferece fluxos de trabalho personalizados, aplicativos conectados e muita automação. Mas o que isso realmente significa para você, a pessoa que gerencia a equipe?

Este guia é para os tomadores de decisão, não para os desenvolvedores. Vamos pular o código denso e focar no que você pode realmente realizar com a API, o que precisa para começar e alguns detalhes importantes a serem lembrados. Também veremos um caminho rápido para obter resultados poderosos usando ferramentas complementares que funcionam diretamente dentro do ecossistema Freshdesk.

O que é a Freshdesk API v2?

Pense em uma API (Interface de Programação de Aplicações) como um tradutor universal que permite que diferentes programas de software conversem entre si. A Freshdesk API v2 é um conjunto específico de regras que permite que outros aplicativos interajam de forma segura com seus dados do Freshdesk. É uma versão moderna e confiável construída sobre um padrão chamado REST, o que significa que a maioria dos desenvolvedores já sabe como trabalhar com ela.

Basicamente, ela permite que você ou sua equipe escrevam scripts que executam ações automaticamente dentro do Freshdesk. Essas ações são feitas pela web usando alguns comandos básicos:

• GET: Para buscar informações (como consultar os detalhes de um ticket).

• POST: Para criar algo novo (como gerar um novo ticket a partir de um formulário no site).

• PUT: Para atualizar algo que já existe (como alterar a prioridade de um ticket).

• DELETE: Para remover algo (como excluir um ticket de spam).

Isso abre as portas para a construção de ferramentas personalizadas que podem otimizar seu processo de suporte, sincronizar dados de clientes com seu CRM ou até mesmo gerar relatórios detalhados adaptados às necessidades específicas do seu negócio.

Primeiros passos com a Freshdesk API v2

Antes de poder fazer qualquer coisa com a API, você precisa verificar suas permissões. Isso é chamado de autenticação, e é assim que o Freshdesk garante que apenas pessoas ou aplicativos autorizados possam acessar os dados do seu help desk.

Localizando sua chave da Freshdesk API v2

Sua chave de API é um código exclusivo que funciona como uma senha especial para suas automações. Veja onde encontrá-la:

1. Faça login na sua conta Freshdesk.

2. Clique na sua foto de perfil no canto superior direito e selecione Profile Settings (Configurações de Perfil).

3. Você verá sua chave de API no lado direito da página.

Trate esta chave como faria com qualquer senha. Ela fornece acesso seguro à sua conta Freshdesk através da API.

Entendendo a autenticação e as permissões da Freshdesk API v2

Para usar a chave, basta incluí-la no cabeçalho (header) de qualquer solicitação de API. As permissões da chave estão vinculadas diretamente ao usuário ao qual ela pertence.

Portanto, se você usar a chave de API de um agente e a função dele não permitir a exclusão de tickets, qualquer script de API que use essa chave também será impedido de excluir tickets. É um recurso de segurança prático que garante que suas automações sigam as regras estabelecidas do seu help desk.

Principais recursos da Freshdesk API v2

A API oferece controle sobre quase todos os elementos do seu help desk. Embora a documentação da API completa seja muito abrangente, a maioria das coisas que as pessoas fazem com ela se divide em três grandes categorias.

Gerenciamento de tickets e conversas

Este é, de longe, um dos usos mais comuns da API. Você pode criar fluxos de trabalho personalizados que complementam as regras integradas do Freshdesk.

• Criar tickets automaticamente: Você pode configurar para que um ticket do Freshdesk seja criado instantaneamente a partir de uma fonte externa, como um formulário de "Fale Conosco" em seu site ou um alerta de sua ferramenta de monitoramento de servidor.

• Atualizar tickets a partir de outros apps: Altere o status, a prioridade ou a atribuição de agente de um ticket com base em gatilhos de outros sistemas. Por exemplo, você pode atualizar automaticamente a prioridade de um ticket se o seu CRM mostrar que aquele cliente acaba de se tornar um VIP.

• Listar e filtrar tickets para visualizações personalizadas: Extraia listas de tickets que atendam a critérios muito específicos para alimentar painéis personalizados ou relatórios especializados.

• Adicionar notas e respostas programaticamente: Adicione automaticamente notas privadas com contexto extra para seus agentes ou até mesmo envie respostas públicas com base em determinados gatilhos.

Automatizando o gerenciamento de contatos e empresas

Você pode usar a API para manter as informações dos seus clientes perfeitamente sincronizadas entre o Freshdesk e outras ferramentas, como seu CRM ou sistema de faturamento.

• Criar ou atualizar contatos: Quando um novo usuário se cadastra no seu produto, um script pode criar automaticamente o perfil de contato dele no Freshdesk, garantindo que seus registros estejam sempre atualizados.

• Gerenciar empresas: Vincule contatos às suas respectivas empresas e mantenha os detalhes do nível da empresa, como planos de assinatura, atualizados.

• Sincronizar seus dados: Certifique-se de que, quando as informações de um cliente mudarem em um lugar, elas sejam atualizadas em todos os lugares. Isso dá aos seus agentes o contexto completo e correto todas as vezes.

Integrando sua base de conhecimento

A API não serve apenas para tickets; ela também pode gerenciar seus artigos de ajuda no Freshdesk. Isso é realmente útil se você deseja otimizar suas operações de conteúdo.

• Criar ou atualizar artigos: Imagine um fluxo de trabalho onde a atualização de um documento interno no Confluence ou Google Docs aciona automaticamente uma atualização no artigo correspondente da central de ajuda pública.

• Listar artigos e pastas: Você pode extrair o conteúdo da sua base de conhecimento para exibi-lo em outro lugar, como dentro do seu próprio aplicativo, para uma experiência mais unificada.

Desafios e limitações comuns da Freshdesk API v2

Embora a API seja poderosa, usá-la diretamente envolve algumas considerações técnicas que são importantes para o planejamento de seus recursos.

Navegando pelos limites de taxa da Freshdesk API v2

O Freshdesk utiliza limites de taxa (rate limits) para garantir a estabilidade e o desempenho da plataforma para todos os usuários. O limite depende do seu plano de assinatura. Por exemplo, o plano Growth permite 200 chamadas por minuto, enquanto o Enterprise permite 700.

Plano	Limite de Taxa da API (por minuto)
Growth	200
Pro	400
Enterprise	700

Fonte: Documentação da Freshdesk API

Se você atingir o limite, o Freshdesk gerencia temporariamente o volume de solicitações para manter a integridade do sistema. Para uma equipe de suporte atarefada, isso significa simplesmente que seus desenvolvedores precisarão levar esses níveis em conta ao construir seus scripts personalizados.

A necessidade de recursos de desenvolvedor

Usar a API diretamente é uma tarefa técnica. Geralmente requer um desenvolvedor para:

• Escrever o código: Alguém que construa e teste os scripts que interagem com a API.

• Hospedar o código: Esses scripts rodam em um servidor para permanecerem conectados.

• Mantê-lo: À medida que seu negócio evolui, seu código personalizado pode precisar de atualizações para se manter alinhado com seus fluxos de trabalho mais recentes.

Esta é uma parte padrão da construção de qualquer integração personalizada e é uma ótima maneira de obter exatamente a funcionalidade que você precisa.

Complexidade na recuperação do contexto completo

A API do Freshdesk é incrivelmente detalhada e, às vezes, obter os dados exatos que você deseja requer o conhecimento de parâmetros específicos. Por exemplo, se você estiver procurando por estatísticas de tickets específicos, como "Tempo de primeira resposta", basta lembrar de incluir o parâmetro include=stats em sua solicitação. Os fóruns da comunidade e a documentação do Freshdesk são ótimos recursos para encontrar essas dicas úteis.

Uma maneira mais rápida de automatizar o Freshdesk com IA

Se você deseja obter os benefícios da automação rapidamente, existem ferramentas especializadas que funcionam ao lado do Freshdesk para aprimorar seu fluxo de trabalho. Plataformas modernas de IA para automação de suporte ao cliente podem ajudá-lo a alcançar esses resultados sem começar do zero.

Por exemplo, a eesel AI é uma opção que funciona dentro do ecossistema Freshdesk através de uma integração perfeita com o Freshdesk.

Coloque tudo em funcionamento em minutos

Em vez de um projeto de codificação personalizado, você pode conectar ferramentas como a eesel AI à sua conta Freshdesk muito rapidamente. Esses tipos de integrações costumam ser de autoatendimento, permitindo que você comece a automatizar partes do seu fluxo de trabalho em questão de minutos.

Crie fluxos de trabalho sem escrever código

Com opções como o AI Agent da eesel, você pode configurar automações usando um construtor visual. Você pode definir como a IA ajuda com marcações (tagging) ou mudanças de status, tudo enquanto ela trabalha dentro dos parâmetros que você definiu para sua instância do Freshdesk.

Unifique todas as suas fontes de conhecimento instantaneamente

Enquanto uma integração de API foca nos dados dentro do Freshdesk, ferramentas complementares também podem se conectar a outras fontes como Confluence, Google Docs ou Slack. Isso dá ao seu ecossistema de suporte uma base de conhecimento mais ampla de onde extrair informações, ajudando a fornecer respostas abrangentes aos seus clientes.

Considerações finais sobre a Freshdesk API v2

A Freshdesk API v2 é uma ferramenta poderosa e confiável para qualquer equipe que queira personalizar seu help desk. Ela oferece um controle profundo sobre seus tickets, contatos e base de conhecimento, tornando-se o padrão ouro para a construção de fluxos de trabalho sob medida e de nível empresarial.

Construir integrações personalizadas diretamente com a API é uma escolha sólida quando você tem recursos de desenvolvedor disponíveis para mantê-las. Para equipes que buscam uma abordagem mais imediata ou sem código, o marketplace e o ecossistema do Freshdesk oferecem muitas ferramentas complementares.

Plataformas como a eesel AI servem como um ótimo complemento que funciona diretamente sobre o Freshdesk. Elas permitem que você conecte seu conhecimento e construa fluxos de trabalho inteligentes rapidamente, ajudando você a desviar tickets de forma eficaz e dando aos seus agentes mais tempo para focar nas necessidades complexas dos clientes.

Pronto para ver como você pode aprimorar seu fluxo de trabalho no Freshdesk em 2026?

Inicie seu teste gratuito com a eesel AI ou agende uma demonstração para vê-la em ação.