Freddy AI Agent custom functions: configuração, planos, cobrança
Kira
Katelin Teen
Última edição 12 de novembro de 2026

As custom functions do Freddy AI Agent são trechos de JavaScript que remodelam dados entre etapas de um workflow, não uma forma de chamar sistemas externos. A Freshworks as marca para o Freshdesk Omni em Growth, Pro e Enterprise, sem linha de preço separada na página de preços; você ainda paga por sessão a $49 por 100, depois de 500 incluídas uma vez por conta. Para consultas em tempo real, você precisa antes de uma ação de API. Se preferir descrever a tarefa em vez de desenhar o workflow, o eesel se conecta ao Freshdesk e alcança suas próprias APIs sem que seja preciso escrever uma função. A CLI do eesel permite que um agente de código configure tudo e teste respostas antes.
O que são as custom functions do Freddy AI Agent?
As custom functions do Freddy AI Agent são trechos de JavaScript reutilizáveis que recebem entradas, executam sua lógica e retornam um objeto JSON que blocos posteriores do workflow podem ler. A Freshworks as descreve como uma forma de transformar e processar dados, como extrair uma data de entrega de uma resposta completa de pedido ou decidir se um pedido ainda está dentro da janela de devolução.

A biblioteca de functions fica em AI Agent Studio > Library > Functions. Ela tem duas abas: functions pré-criadas para datas, texto, listas, aritmética e Base64, e My functions para as que você escreve. A captura de tela acima, retirada do próprio guia de functions da Freshworks, é a página onde você vai viver.
Aqui está a parte fácil de passar batido. Uma function nunca conversa com seu sistema de pedidos. Li todos os artigos que a Freshworks publicou sobre isso, e cada um descreve as functions como transformação de dados dentro do workflow. A chamada para o mundo externo é um bloco diferente, a ação de API, e os dois são encadeados. A atualização de produto da Freshworks de setembro lista as custom functions entre as adições ao Freddy AI Agent Studio, junto com gatilhos de workflow predefinidos.
| Peça | O que faz | Chama um sistema externo? |
|---|---|---|
| Pre-built function | Etapa pronta para data, texto, lista, matemática ou Base64 | Não |
| Custom function | Seu próprio JavaScript, retorna JSON | Não |
| Ação de API | Requisição REST com cabeçalhos, corpo e autenticação | Sim |
| App de AI Actions | Operações tipadas construídas com o SDK da Freshworks | Sim, se você programar o callback |
Como as functions se encaixam com as ações de API em um workflow?
Uma function fica entre dois blocos que de fato conversam com seus sistemas: ela pega o que uma ação de API retornou e dá à próxima etapa algo sobre o que ramificar. O exemplo da própria Freshworks é um workflow de pedido em que uma ação de API retorna o pedido e as datas de entrega, uma function verifica a elegibilidade e uma condição lê isEligibleForReturn.

O construtor de workflow mostra a mesma divisão. Ao clicar no ícone de mais, o menu de blocos lista Collect info, API Action, Execute Function, Condition paths, Custom response e Agent handoff como coisas separadas.

As ações de API são a metade que custa tempo de configuração. Você dá a cada uma uma URL, um método HTTP (GET, POST, PUT, PATCH ou DELETE), cabeçalhos e uma escolha de autenticação entre API Key, Bearer Token, Basic Auth ou OAuth 2.0. Variáveis de saída são mapeadas com JSON path, e a saída de uma ação pode alimentar a próxima. O artigo sobre ações de API da Freshworks também observa que Ask for confirmation pode ser ativado para etapas de alto impacto como reembolsos.
"Test requests use real values and may affect your external system depending on the endpoint."
Como você cria uma custom function?
Você cria uma custom function em cinco passos: dar um nome, definir entradas tipadas, escrever o código, testá-la com valores de exemplo e definir as saídas que o workflow pode usar. O guia para criar custom functions da Freshworks explica isso passo a passo, e você precisa de acesso de administrador ao AI Agent Studio além de um workflow existente.
- Vá para AI Agent Studio > Library > Functions e clique em Create.
- Em General, adicione um nome e uma descrição.
- Adicione entradas. Cada uma tem um nome, um tipo texto, número, booleano ou lista, e uma marcação opcional de Required.
- Escreva a lógica no editor de código. Ela deve retornar um objeto JSON válido. No exemplo da Freshworks, o corpo da resposta do workflow é lido em
data['Response_body']. - Clique em Test function, informe valores de exemplo, execute e depois verifique a resposta e os logs de console. Finalize com Define outputs e Create.

O exemplo na documentação filtra pedidos cujo total_price está acima de um limite de 160 e retorna os IDs dos pedidos e os nomes dos itens. Isso é típico do que essas functions servem para fazer: reduzir uma resposta grande de API aos dois campos de que uma frase voltada ao cliente precisa.
A Freshworks diz na introdução que você pode escrever ou gerar a lógica da function. Os passos numerados só descrevem como escrevê-la, então não consegui confirmar como é a opção de gerar. O próprio conselho deles vale a pena seguir de qualquer forma: testar com entradas válidas, inválidas e vazias.
Como você usa uma function dentro de um workflow?
Você adiciona um bloco Execute Function, escolhe uma function em My functions ou Pre-built functions, mapeia valores do workflow para seus parâmetros e, opcionalmente, mapeia suas saídas para propriedades de contato ou ticket. O painel mostra uma pré-visualização dos detalhes da function antes de você confirmar.

Dois detalhes do guia de gerenciar e usar functions economizam tempo de depuração. Primeiro, capture entradas com um bloco Collect info antes de mapeá-las, ou mapeie-as direto a partir de propriedades de contato ou ticket, especialmente para e-mail ou telefone. Segundo, você pode clonar uma function pré-criada e editá-la, o caminho mais rápido para uma variante sua.
Aqui estão três tarefas em que eu recorreria a uma function em vez de uma instrução no prompt:
- Janela de devolução: calcular os dias desde a entrega e retornar um booleano, para que o ramo da condição seja determinístico.
- Verificações de promoção ou cupom: comparar a validade com a data de hoje antes de o agente dizer que um código é válido.
- Reduzir um payload: retornar apenas o número de rastreio e o status de uma resposta longa de envio.
A lista de functions pré-criadas da Freshworks já cobre as duas primeiras (Get Days Between, Compare Dates), então uma custom function só se justifica quando sua regra é específica do seu negócio.
Quais planos incluem custom functions?
Os artigos de functions da Freshworks trazem um banner de plano para Freshdesk Omni com marcas em Growth, Pro e Enterprise, e a linha "Not available in previous plans." Eles também dizem que, se você se cadastrou antes de dezembro de 2025, sua experiência no Freshdesk Omni pode ser diferente. Os planos atuais na página de preços são $19, $55 e $89 por agente ao mês com cobrança anual.
Veja os guias do plano Growth do Freshdesk e do plano Pro para o que mais cada nível oferece, e a comparação de planos do Freshdesk para ver lado a lado.
Uma cerca vizinha: o caminho de desenvolvedor para operações personalizadas, os apps de AI Actions, por enquanto só pode ser publicado como app personalizado, e aparece como indisponível no Freshdesk Legacy, Freshcaller, Freshsales Classic e Freshservice MSP.
Quanto custam as custom functions do Freddy?
A Freshworks não lista um preço separado para as custom functions, então o medidor que você realmente vai acompanhar é a sessão do AI Agent. A página de preços dá as primeiras 500 sessões gratuitas em Growth, Pro e Enterprise, uma vez por conta, depois $49 por 100 sessões. Uma sessão de e-mail é uma janela de 72 horas a partir do primeiro e-mail do cliente, independentemente de quantas respostas saiam dentro dela.

A mesma página lista outros dois medidores de uso: tarefas de app conector a $80 por 5.000, e ações MCP a $15 por 1.000. O que eu não consegui encontrar é qualquer declaração sobre se uma execução de function, ou uma ação de API dentro do workflow, aumenta algum dos dois. Trate isso como uma pergunta para seu representante da Freshworks antes de desenhar um workflow de alto volume. Para a conta de sessões na prática, minha aritmética: uma equipe que já usou suas 500 gratuitas e depois lida com 2.500 sessões em um trimestre compra 25 pacotes, o que dá $1.225. O guia de consumo de sessões mostra quais conversas contam, e o post preços do Freddy AI por agente cobre o lado dos assentos.
Quais são os limites e as pegadinhas?
Os limites práticos vêm de como as functions são compartilhadas e de como os canais se comportam, não de uma cota publicada. Não encontrei tempo de execução, memória ou limite de número de chamadas declarados para as functions, então teste com tamanhos de payload realistas.
- A lógica compartilhada muda em todo lugar. A Freshworks avisa que editar uma ação de API compartilhada afeta todo workflow que a usa, então teste primeiro em um ambiente fora de produção.
- Não é possível excluir functions em uso. Você não pode excluir uma function usada em um workflow ativo.
- O chat é síncrono. No chat, os blocos de ação de API são executados durante a conversa, e a entrada de texto fica indisponível até terminarem; um tempo limite ou falha leva ao caminho Fallback.
- O e-mail pula a confirmação. Blocos de confirmação são pulados para agentes de e-mail, então a Freshworks diz para você colocar salvaguardas para operações de alto impacto na camada de API. O guia do agente de IA de e-mail do Freshdesk cobre esse canal.
- Regras pertencem ao código, não à prosa. Uma function te dá uma verificação determinística, que é sua verdadeira força sobre uma instrução ao modelo.
Onde a documentação da Freshworks discorda de si mesma, aqui está o que encontrei:
- Login do MCP. O artigo sobre workflows diz que a camada MCP "uses OAuth-based authentication". O artigo de segurança do MCP diz que o OAuth não é suportado atualmente para integrações MCP do Freshdesk, e o artigo de configuração do MCP diz que é só API key. Essas páginas descrevem o próprio servidor MCP da Freshworks, que pode não ser a mesma coisa que um servidor MCP que você conecta dentro de uma ação de API, então eu trataria as duas como não confirmadas.
- Período de cota do MCP. A tabela do artigo de configuração dá ações incluídas "per account, annually" (
1.200em Growth,6.000em Pro,12.000em Enterprise), enquanto o artigo de segurança fala de cotas mensais. - Pré-requisitos. O artigo de ações de API diz que sua conta precisa estar no Freshdesk Omni "or have AI Agent Studio enabled", enquanto a página de preços lista o Freddy AI Agent nos três planos do Freshdesk.
- Número de functions. A documentação lista
13functions pré-criadas em cinco grupos, mas a captura da página Functions mostra14na aba pré-criadas.
Como as functions do Freddy se comparam com as chamadas de API personalizadas do eesel?
As functions do Freddy dão a você lógica determinística que você desenha e programa; o eesel te dá um teammate que decide quando chamar suas APIs a partir das instruções. Eles resolvem metades diferentes de "meu agente precisa de dados em tempo real".

No eesel, o Your APIs permite que o teammate alcance qualquer API REST. Você libera o domínio, adiciona o cabeçalho que a API espera (Bearer, Basic ou uma API key), e as credenciais ficam nas suas configurações e nunca são mostradas à IA. Ele pode fazer requisições GET, POST, PATCH e DELETE. O Freshdesk em si é uma integração nativa: com uma conexão completa (subdomínio mais API key) o teammate lê sua central de ajuda, respostas prontas e tickets antigos, e pode responder, deixar notas internas, marcar, atribuir e fechar. Cada ação pode ser definida como ativada, perguntar antes ou desativada, segundo o guia de ações e aprovações.
Onde o Freddy é melhor: a verificação da janela de devolução é código, então se comporta da mesma forma sempre, e o workflow visual torna o caminho auditável. No eesel essa regra fica em suas instruções, que um modelo segue bem, mas que não são uma garantia compilada. Onde o eesel é melhor: não há function para escrever ou versionar, um workspace cobre tickets e chat em tempo real, e um desenvolvedor ou agente de código pode executar toda a configuração a partir de um terminal com a CLI do eesel. A página do eesel para Freshdesk em docs.eesel.ai lista a tabela de ações.
Construo integrações com o Freshdesk para o eesel há anos, e as surpresas raramente estão nas chamadas de API. Uma que nos custou horas: o Freshdesk não dispara suas regras de automação para tickets criados por um agente, então um gatilho que você supunha que acordaria o teammate simplesmente nunca chega. Lógica que você controla em código não resolve isso; conhecer a plataforma resolve.
Dois clientes mostram o padrão. A SamCart roda um agente eesel nos tickets do Freshdesk e outro no chat do site, ambos respondendo a partir de cerca de 280 artigos da central de ajuda, e o agente recua assim que uma pessoa é atribuída. A Timengo usa o eesel no Freshdesk para suporte técnico em dinamarquês, redigindo respostas a partir de cerca de 5.300 tickets e artigos antigos, com um engenheiro enviando cada uma. Nenhuma das duas precisou de uma custom function; o trabalho estava no conhecimento e nas regras de transferência.
Para o panorama mais amplo, veja Freddy AI versus eesel AI, as alternativas ao Freddy AI e as alternativas de IA ao Freshdesk.
Para onde ir a seguir com o Freddy e o Freshdesk?
Se você ficar com o Freddy, construa a ação de API primeiro, adicione uma function só onde uma regra precisar ser código, e acompanhe sua contagem de sessões. Três guias vizinhos ajudam aqui: fontes de conhecimento do Freddy, a visão geral do AI Agent do Freshdesk e as ações conversacionais do Freddy.
Se você está ligando o Freshdesk a um sistema de pedidos, os posts sobre webhooks do Freshdesk e Freshdesk com Shopify mostram a encanamento.
Os limites de taxa da API do Freshdesk explicam o que te freia.
O guia de integração de API de agente de IA cobre o padrão de forma geral.
Para mais contexto, leia como adicionar IA ao Freshdesk, depois automação no Freshdesk e o guia do chatbot do Freshdesk.
Está avaliando o helpdesk em si? Freshdesk versus Zendesk e a análise do Freshdesk são os pontos de partida, e o Freddy Copilot cobre o assistente do lado do agente.
Experimente o eesel para Freshdesk
Se seu objetivo é um agente de Freshdesk que responda a partir da sua central de ajuda e do seu próprio sistema de pedidos, o eesel funciona como um novo teammate que entra na sua fila em minutos. Conecte o Freshdesk com um subdomínio e uma API key, comece com rascunhos como notas internas, e amplie seu acesso conforme ele ganha confiança. Com a CLI do eesel, um agente de código com IA pode enviar conhecimento aprovado como artigos de solução exportados, ajustar as instruções do teammate e fazer perguntas de teste para checar as respostas antes de qualquer coisa ir ao ar, embora uma pessoa com acesso de administrador ainda aprove a própria conexão com o Freshdesk. Veja a integração com Freshdesk ou os preços do eesel.

Perguntas frequentes
O que são as custom functions do Freddy AI Agent?
São trechos de JavaScript que você escreve no AI Agent Studio: eles recebem entradas, retornam um objeto JSON e alimentam a próxima etapa do workflow. Eles remodelam dados, por exemplo transformando duas datas em um indicador de elegibilidade. Eles não chamam sistemas externos, isso é trabalho das ações de API. O guia de agentes Freddy AI cobre o produto mais amplo.
Quais planos do Freshdesk incluem as custom functions do Freddy?
Os artigos de ajuda da Freshworks marcam as functions como Freshdesk Omni em Growth, Pro e Enterprise, e indicam que não estão disponíveis em planos anteriores. Se você se cadastrou antes de dezembro de 2025, sua configuração pode ser diferente. Compare preços de planos no guia de preços do Freshdesk.
Quanto custam as custom functions do Freddy AI Agent?
A página de preços da Freshworks não lista um preço separado para as functions. A unidade cobrada do agente é a sessão: as primeiras 500 estão incluídas uma vez por conta, depois $49 por 100 sessões. Veja como as sessões são contadas e o detalhamento de preços do Freddy AI.
Uma custom function do Freddy pode chamar uma API externa?
Os artigos da Freshworks descrevem as functions apenas como transformação de dados, e encaminham chamadas a sistemas externos pelas ações de API. Se você precisa de uma consulta de pedido em tempo real, crie uma ação de API e passe sua saída para a function. Um exemplo de API de ticket do Freshdesk mostra o formato da requisição.
Preciso saber JavaScript para construir uma custom function do Freddy?
A Freshworks diz que é preciso um entendimento básico de JavaScript se você escrever uma custom function manualmente. Functions pré-criadas para datas, texto, listas, matemática e Base64 cobrem os casos comuns sem código. Para um caminho sem código, veja a biblioteca de skills pré-criadas do Freddy.
Qual é a diferença entre uma custom function do Freddy e uma API personalizada do eesel?
Uma function do Freddy é código que você escreve dentro de um workflow desenhado por você. No eesel, você libera um domínio de API, adiciona o cabeçalho de autenticação e descreve nas instruções quando o teammate deve consultar algo. Leia a comparação Freddy AI versus eesel ou veja a integração do eesel com o Freshdesk.
Posso excluir uma custom function que já está em uso?
Não. A Freshworks diz que você não pode excluir uma function usada em um workflow ativo, então remova a dependência primeiro. Clonar uma function é a forma segura de editar a lógica sem tocar em uma function ativa, o que importa ao seguir as melhores práticas do agente de IA do Freshdesk para lançamentos.