Toolzz: versatilidade em Funções Personalizadas

Lucas (CEO Toolzz)
18 de abril de 2026

No cenário empresarial atual, a agilidade e a personalização no atendimento ao cliente são cruciais. A Toolzz AI permite que empresas como Bradesco, Itaú, BTG Pactual, Mercado Bitcoin e iFood criem agentes de IA altamente customizados, capazes de realizar tarefas complexas e automatizadas. Uma das funcionalidades mais poderosas para alcançar esse nível de personalização são as Funções Personalizadas.

O que são Funções Personalizadas?

Funções Personalizadas, dentro da Toolzz AI, são trechos de código JavaScript que você pode integrar diretamente ao fluxo de conversação do seu agente de IA. Isso permite que o agente execute ações específicas, como consultar APIs externas, gerar links de pagamento dinâmicos, agendar compromissos, realizar cálculos complexos e muito mais. Em essência, você está expandindo as capacidades do agente de IA para além do processamento de linguagem natural, transformando-o em uma ferramenta versátil para automatizar processos de negócios.

Tecnicamente, ao definir uma Função Personalizada, você especifica um nome, uma descrição e o código JavaScript que será executado. O código recebe dados de entrada do usuário (extraídos da conversa) e retorna uma resposta que o agente de IA pode utilizar para continuar a interação. A Toolzz AI cuida da comunicação entre o agente e a função, garantindo a segurança e a integridade dos dados.

Problema que resolve

Equipes de atendimento frequentemente gastam tempo valioso respondendo a perguntas repetitivas, processando solicitações simples ou realizando tarefas manuais que poderiam ser automatizadas. Por exemplo, um cliente pode perguntar sobre o status de um pedido, solicitar um link de pagamento ou agendar uma reunião com um consultor. Essas tarefas, embora necessárias, consomem recursos que poderiam ser alocados para atividades mais estratégicas.

As Funções Personalizadas resolvem esse problema permitindo que você automatize essas tarefas. Imagine um agente de IA que, ao receber uma solicitação de status de pedido, consulta automaticamente o sistema de rastreamento e fornece a informação ao cliente em tempo real. Ou um agente que, ao identificar a necessidade de um pagamento, gera um link de pagamento personalizado e o envia via WhatsApp. A economia de tempo e o aumento da eficiência são significativos.

Como configurar no Toolzz AI

Configurar uma Função Personalizada na Toolzz AI é um processo simples e intuitivo:

1. Acesse o painel de administração: Faça login em admin.toolzz.ai.
2. Navegue até a seção de Funções Personalizadas: No menu lateral, clique em “AI Agents” e selecione “Funções Personalizadas”.
3. Crie uma nova função: Clique no botão “Criar Nova Função”.
4. Defina os parâmetros:
   • Nome: Dê um nome descritivo para a função (ex: “ConsultarStatusPedido”).
   • Descrição: Explique o que a função faz (ex: “Consulta o status de um pedido no sistema de rastreamento”).
   • Código JavaScript: Insira o código JavaScript que implementa a lógica da função. Veja um exemplo abaixo.
   • Parâmetros de entrada: Defina os parâmetros que a função receberá da conversa (ex: “Número do Pedido”).
5. Teste a função: Utilize a ferramenta de teste integrada para validar se a função está funcionando corretamente.

Exemplo de código JavaScript:

javascript // Função para consultar o status de um pedido async function consultarStatusPedido(numeroPedido) { // Substitua pela sua lógica de consulta ao sistema de rastreamento const status = await consultarSistemaRastreamento(numeroPedido); return O status do seu pedido ${numeroPedido} é: ${status}; }

// Função auxiliar para consultar o sistema de rastreamento (exemplo) async function consultarSistemaRastreamento(numeroPedido) { // Simulação de consulta a uma API return new Promise(resolve => { setTimeout(() => { resolve("Em trânsito"); }, 1000); }); }

module.exports = consultarStatusPedido;

Exemplo prático

Imagine um cliente entrando em contato via WhatsApp para saber o status de seu pedido. Veja como a interação pode ocorrer com a Função Personalizada “ConsultarStatusPedido”:

Cliente: “Olá, gostaria de saber o status do meu pedido número 12345.”

Agente de IA: “Um momento enquanto consulto o status do seu pedido...”

A IA extrai o número do pedido (12345) e o envia para a Função Personalizada “ConsultarStatusPedido”. A função consulta o sistema de rastreamento e retorna o status do pedido.

Agente de IA: “O status do seu pedido 12345 é: Em trânsito.”

Dicas de configuração avançada

• Validação de dados: Implemente a validação de dados no código JavaScript para garantir que os parâmetros de entrada sejam válidos antes de realizar a consulta ou operação. Isso ajuda a prevenir erros e a melhorar a robustez da função.
• Tratamento de erros: Implemente o tratamento de erros no código JavaScript para lidar com situações inesperadas, como falhas na conexão com APIs externas ou erros no sistema de rastreamento. Retorne mensagens de erro amigáveis ao usuário.
• Cache: Utilize o cache para armazenar os resultados de consultas frequentes e reduzir a carga no sistema de rastreamento. Isso pode melhorar o desempenho e a escalabilidade da função.
• Segurança: Siga as melhores práticas de segurança ao desenvolver o código JavaScript, como evitar a injeção de código malicioso e proteger as credenciais de acesso a APIs externas.

Limitações e workarounds

• Tempo de execução: As Funções Personalizadas têm um tempo de execução máximo. Se a função demorar muito para ser executada, a conexão pode ser interrompida. Para evitar isso, otimize o código JavaScript e utilize o cache sempre que possível.
• Complexidade do código: Funções Personalizadas muito complexas podem ser difíceis de manter e depurar. Divida a lógica em funções menores e reutilizáveis para melhorar a legibilidade e a modularidade do código.
• Dependências externas: Se a função depender de bibliotecas externas, certifique-se de que elas sejam compatíveis com o ambiente de execução da Toolzz AI.

Planos que incluem

As Funções Personalizadas estão disponíveis a partir do plano Starter (R$990/mês) da Toolzz AI. O plano Enterprise (R$3.900+/mês) oferece recursos adicionais, como maior tempo de execução e maior número de funções personalizadas.

Quer testar essa feature? Crie seu agente de IA no Toolzz AI a partir de R$399/mês no plano Mini. Já imaginou seu agente usando Funções Personalizadas para atender seus clientes 24/7 pelo WhatsApp? Conheça a Toolzz AI.

Com a Toolzz AI, você pode automatizar tarefas, otimizar processos e proporcionar uma experiência de atendimento excepcional aos seus clientes. Explore as possibilidades das Funções Personalizadas e leve sua automação para o próximo nível.