Guia definitivo de Funções Personalizadas para profissionais
Aprenda a criar funções JavaScript personalizadas para seu agente de IA no Toolzz AI.
Guia definitivo de Funções Personalizadas para profissionais
18 de abril de 2026
Com a crescente demanda por automação inteligente e atendimento ao cliente 24/7, as empresas buscam cada vez mais soluções de Inteligência Artificial (IA) para otimizar processos e melhorar a experiência do usuário. A Toolzz AI se destaca como uma plataforma líder nesse mercado, utilizada por grandes empresas como Bradesco, Itaú, BTG Pactual, Mercado Bitcoin e iFood. Uma das funcionalidades mais poderosas da Toolzz AI é a capacidade de criar Funções Personalizadas, que permitem estender as capacidades do agente de IA e integrá-lo perfeitamente a sistemas e APIs existentes. Neste guia completo, exploraremos em detalhes o que são Funções Personalizadas, como configurá-las no Toolzz AI, exemplos práticos de uso, dicas avançadas e limitações a serem consideradas.
O que são Funções Personalizadas
Funções Personalizadas são trechos de código JavaScript que podem ser executados pelo agente de IA durante uma conversa. Elas permitem que o agente interaja com APIs externas, realize cálculos complexos, acesse bancos de dados, gere links de pagamento, agende compromissos e muito mais. Em essência, as Funções Personalizadas transformam o agente de IA em um assistente virtual altamente flexível e adaptável às necessidades específicas de cada empresa. Ao invés de se limitar às capacidades predefinidas, você pode customizar o comportamento do agente para atender a casos de uso específicos e otimizar os fluxos de conversação.
Problema que resolve
Imagine uma empresa que precisa verificar o status de um pedido de um cliente diretamente no seu sistema de CRM. Sem Funções Personalizadas, o agente de IA teria que solicitar ao cliente que acessasse o site ou entrasse em contato com um atendente humano. Isso gera frustração no cliente e aumenta a carga de trabalho da equipe de atendimento. Com as Funções Personalizadas, é possível criar uma função que se conecta à API do CRM, consulta o status do pedido com base no número fornecido pelo cliente e apresenta a informação diretamente na conversa. Isso agiliza o atendimento, melhora a satisfação do cliente e libera os atendentes humanos para se concentrarem em tarefas mais complexas. Muitas empresas gastam horas diárias respondendo a perguntas repetitivas sobre o status de pedidos, agendamentos ou informações básicas. As Funções Personalizadas automatizam essas tarefas, liberando tempo e recursos valiosos.
Quer automatizar tarefas repetitivas e otimizar seu atendimento? Conheça a Toolzz AI e descubra como as Funções Personalizadas podem transformar sua operação.
Como configurar no Toolzz AI
Configurar uma Função Personalizada no Toolzz AI é um processo simples e intuitivo. Siga estes passos:
- Acesse o painel de administração: Faça login em admin.toolzz.ai.
- Navegue até a seção Funções Personalizadas: No menu lateral, clique em "AI Settings" e depois em "Custom Functions".
- Crie uma nova função: Clique no botão "New Function".
- Defina um nome e uma descrição: Dê um nome descritivo à função e adicione uma breve descrição do seu propósito.
- Escreva o código JavaScript: Insira o código JavaScript que implementa a lógica da função. Você pode usar qualquer biblioteca JavaScript padrão e fazer requisições HTTP para APIs externas.
- Defina os parâmetros de entrada: Especifique os parâmetros que a função receberá como entrada, incluindo o nome, tipo e descrição de cada parâmetro.
- Defina o tipo de retorno: Indique o tipo de dado que a função retornará (string, number, boolean, object, array).
- Salve a função: Clique no botão "Save" para salvar a função.
Exemplo prático
Vamos criar uma Função Personalizada que gera um link de pagamento para um determinado valor utilizando a API da Stripe.
Código JavaScript:
javascript const stripe = require('stripe')('SUA_CHAVE_SECRETA_STRIPE');
exports.handler = async (event) => { const valor = event.valor; const session = await stripe.checkout.sessions.create({ line_items: [ { price_data: { currency: 'BRL', unit_amount: valor * 100, product_data: { name: 'Pagamento' }, }, quantity: 1, }, ], mode: 'payment', success_url: 'https://www.example.com/sucesso?session_id={CHECKOUT_SESSION_ID}', cancel_url: 'https://www.example.com/cancelado', });
return session.url; };
Diálogo de exemplo:
Cliente: Gostaria de pagar R$ 50,00.
Agente: Ok, gerando seu link de pagamento...
(A função personalizada é executada e retorna o link da Stripe)
Agente: Aqui está o link para efetuar o pagamento: [link da Stripe].
Dicas de configuração avançada
- Validação de entrada: Sempre valide os parâmetros de entrada para evitar erros e garantir a segurança da sua função.
- Tratamento de erros: Implemente um tratamento de erros robusto para lidar com situações inesperadas e fornecer mensagens informativas ao usuário.
- Documentação: Documente sua função de forma clara e concisa, incluindo a descrição dos parâmetros de entrada, tipo de retorno e exemplos de uso.
- Testes: Teste sua função exaustivamente antes de implantá-la em produção para garantir que ela funcione corretamente em diferentes cenários.
- Variáveis de ambiente: Utilize variáveis de ambiente para armazenar informações sensíveis, como chaves de API, e proteger seus dados.
Limitações e workarounds
- Tempo de execução: As Funções Personalizadas têm um tempo de execução limitado. Se sua função demorar muito para ser executada, ela poderá ser interrompida.
- Acesso a recursos externos: O acesso a recursos externos, como bancos de dados, pode ser restrito por questões de segurança.
- Complexidade do código: Funções muito complexas podem ser difíceis de manter e depurar.
Para contornar essas limitações, você pode:
- Otimizar o código: Otimize o código da sua função para reduzir o tempo de execução.
- Utilizar filas de mensagens: Utilize filas de mensagens para processar tarefas assíncronas em segundo plano.
- Dividir a função em partes menores: Divida a função em partes menores e mais gerenciáveis.
Quer colocar tudo isso em prática?
Solicitar demonstraçãoAs Funções Personalizadas estão disponíveis nos planos Starter (R$990/mês) e Enterprise (R$3.900+/mês) da Toolzz AI. O plano Mini (R$399/mês) não inclui essa funcionalidade.
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 em toolzz.com.br/ai.
Demo Bots
Explore a demo interativa do Toolzz Bots, uma poderosa plataforma no-code que permite a criação de chatbots que operam 24 horas por dia, 7 dias por semana.
.webp){kind=small}
