A maioria dos chatbots de WhatsApp funciona por palavras-chave fixas. O cliente digita "reembolso" e recebe a política de reembolso. Isso resolve dúvidas simples, mas nem sempre o cliente fala por palavras-chave. Ele escreve coisas como "fiz um pedido semana passada e ainda não chegou" ou "consigo trocar de plano no meio do mês?".

O AI Agent Builder (construtor de agentes de IA) da AiSensy foi feito exatamente para essas situações. Ele entende o que o cliente está realmente perguntando, encontra a resposta certa na base de conhecimento do seu negócio (central de ajuda) e ainda executa ações de verdade, como consultar o status de um pedido, agendar um atendimento ou buscar um orçamento — tudo isso sem escrever uma única linha de código.

Neste tutorial, você vai ver o passo a passo para criar o seu próprio Agente de IA no WhatsApp usando a AiSensy.

No fim dele, você vai ter um Agente de IA totalmente funcional, capaz de entender as perguntas dos clientes, responder com inteligência e até executar ações automaticamente.

Sobre os nomes em inglês: o painel da AiSensy está em inglês. Por isso, os nomes de botões e seções aparecem aqui exatamente como você vai vê-los na tela, com a tradução entre parênteses na primeira vez que surgem.

Deixe estas duas coisas prontas:

Faça login na sua conta AiSensy e clique em Agents (agentes) no menu à esquerda.

No Agents Studio, clique em Set up (configurar) para começar a configurar o seu Chat Agent.

Você também vai ver Manage AI Messages Plan (gerenciar plano de mensagens de IA). Use essa opção quando estiver pronto para escolher ou trocar o pacote de AI Messages usado pelo agente.

Observação: o Chat Agent é, por enquanto, o único tipo de agente disponível. Outros tipos serão adicionados no futuro.

Agora, informe à AiSensy a URL do seu site para que ela entenda o seu negócio e prepare a primeira versão do seu Agente de IA.

Preencha os seguintes campos:

Com os dois campos preenchidos, clique em Train Agent (treinar agente).

A AiSensy vai ler as páginas do seu site em segundo plano e usar essas informações para preparar o agente para os testes.

Assim que o treinamento começa, o agente já passa a responder mensagens no número de teste que você acabou de informar. Você vai ver uma tela de confirmação com a mensagem "Your agent is live" (o seu agente está no ar), junto com um aviso de que a AiSensy ainda está lendo o seu site em segundo plano.

Você não precisa esperar a leitura terminar. As respostas do agente ficam mais precisas automaticamente conforme mais páginas do seu site são lidas.

A partir daqui, você tem duas opções na parte de baixo da tela:

Se você clicou em Continue setup, vai chegar a uma tela chamada "What should your agent do?" (o que o seu agente deve fazer?). É aqui que você ativa, já de início, os recursos prontos que quer que o agente tenha.

Dois já vêm marcados: FAQ/Support (dúvidas e suporte) e Human Handoff (transferência para atendimento humano). Você pode deixar como está, adicionar mais opções em Add capabilities (adicionar recursos) ou clicar em Skip (pular) para seguir sem mudar nada. Tudo aqui é totalmente editável depois, então não perca tempo demais nesta tela.

A última tela do assistente se chama "Anything special it should know?" (tem algo especial que ele precisa saber?). É aqui que você adiciona as Ground Rules (regras gerais): instruções que o agente deve seguir sempre, não importa o assunto da conversa.

Por exemplo:

Nunca prometa entrega no mesmo dia. Não invente preços, descontos ou disponibilidade de produtos. Use apenas as informações disponíveis em Knowledge.

Esse campo é opcional. Pode pular se quiser: você encontra o mesmo campo Ground Rules dentro do painel principal, então nada se perde se deixar em branco aqui.

Clique em Go to agent (ir para o agente) para chegar ao painel completo do Chat agent. É nele que você vai passar a maior parte do tempo fazendo os ajustes.

O painel do Chat agent é uma única página com rolagem, com tudo nela: Business Profile, Voice, Skills, Knowledge, Actions e Settings (configurações), listados à esquerda como atalhos de navegação.

Vale reparar em algumas coisas no topo antes de rolar a página:

O Business Profile diz ao Agente de IA quem ele representa e dá o contexto básico necessário para falar sobre o seu negócio.

O Chat agent vai gerar uma descrição do seu negócio na seção "What your business does" (o que a sua empresa faz). Vale lembrar que o agente pode levar algum tempo para percorrer o site e gerar essa descrição.

Revise com atenção o texto gerado e ajuste o que estiver incorreto, confuso ou faltando.

Se preferir escrever manualmente, sem problema: veja as orientações abaixo como referência.

Por exemplo:

A Loja Geek Brasil é uma marca brasileira de lifestyle e cultura pop criada para quem gosta de vestir aquilo que ama. De produtos oficiais inspirados em filmes, séries, super-heróis, esportes e games a peças estilosas para o dia a dia, a marca une fandom e conforto de um jeito divertido e vestível. A coleção inclui camisetas, camisetas oversized, camisas, moletons, calças jogger, vestidos, calçados, acessórios e muito mais, para homens, mulheres e crianças.

Mantenha essa descrição factual. Não inclua ofertas, preços ou políticas que podem ficar desatualizados rápido, a menos que você pretenda atualizá-los com frequência.

Informe o nome que o Agente de IA deve usar ao se apresentar.

A saudação é enviada palavra por palavra como a primeira mensagem quando o cliente inicia uma conversa com o seu Agente de IA. Se você usar esse campo, escreva exatamente como quer que o cliente receba.

Por exemplo:

Oi! Bem-vindo à Casa Vitória. Posso te ajudar com produtos, tamanhos, pedidos e trocas. O que você quer saber?

Se não quiser uma mensagem de abertura fixa, pode deixar esse campo vazio.

É o mesmo campo Ground Rules do assistente de configuração. Edite aqui se você pulou antes ou quer acrescentar mais regras.

Inclua apenas regras que precisam valer em todas as conversas. Use as Skills, mais adiante, para instruções que valem para uma tarefa específica, como qualificação de leads ou agendamento.

A seção Voice controla o estilo de resposta do seu Agente de IA. É ela que decide como o agente fala com os clientes nas mensagens.

Escolha o tom que mais combina com o seu negócio:

Use esse campo se quiser dar instruções mais específicas sobre como o agente deve se comunicar.

Por exemplo:

Você pode mudar essas instruções conforme o seu negócio.

Por exemplo, uma empresa de serviços financeiros pode pedir que o agente evite linguagem informal, enquanto uma marca de moda pode liberar emojis e um tom mais descontraído.

Em seguida, escolha o nível de detalhe das respostas do agente:

Na dúvida, escolha Medium. Ela dá informação suficiente ao cliente sem deixar toda resposta longa demais.

As Skills definem as tarefas específicas que o seu Agente de IA consegue executar.

A forma mais simples de entender a diferença é esta:

Por exemplo, você pode criar Skills para:

As Skills são opcionais. Um Agente de IA básico já consegue responder perguntas a partir da base de conhecimento, sem nenhuma Skill personalizada.

Clique em Add Capabilities para ver as Skills prontas disponíveis na AiSensy.

As opções disponíveis hoje incluem:

Use esta Skill para perguntas gerais sobre produtos, preços, políticas, horário de funcionamento, endereços, áreas de entrega ou serviços. A resposta vem das informações adicionadas em Knowledge.

Use esta Skill quando:

A Human Handoff não deve ser usada apenas porque o agente ainda não tentou responder à pergunta.

Clique em Add ao lado do recurso que você quer e depois em Done (concluir). Use a caixa de seleção ao lado de cada Skill para ativá-la ou desativá-la.

Expanda uma Skill ativada clicando nela para revisar e configurar.

Dependendo da Skill, você pode ver as seguintes opções:

Explica o tipo de mensagem do cliente que deve ativar a Skill. As Skills prontas mantidas pela AiSensy já vêm com essa lógica.

Algumas Skills permitem definir informações que o agente deve coletar antes de concluir a tarefa.

Por exemplo, antes de transferir uma conversa para um atendente humano, você pode pedir ao Agente de IA que colete:

Informe a pergunta exata que o agente deve fazer e selecione o atributo de contato onde a resposta será salva.

Por exemplo:

Pergunta: Qual é o número do seu pedido?

Atributo: ID do pedido

Ative Required (obrigatório) se o agente precisar coletar a resposta antes de seguir adiante.

Clique em Add Variable (adicionar variável) para incluir mais perguntas.

Peça apenas as informações realmente necessárias. Perguntas demais fazem a conversa parecer um formulário longo.

Observação: NÃO use a Skill FAQ/Support para consultas de pedidos específicos, qualificação de leads ou trocas. Esses casos precisam de uma Skill ou Action própria, porque dependem de dados ao vivo ou específicos de cada cliente. Use a FAQ/Support só quando a resposta deve vir diretamente de Knowledge. Para dúvidas sobre pedidos, use a Human Handoff ou crie uma Skill personalizada (veja abaixo).

Conecte uma API existente ou defina uma nova se a Skill precisar de dados ao vivo ou precisar concluir uma ação.

Por exemplo:

Não é preciso ter API quando a resposta pode vir diretamente da sua base de conhecimento.

Você pode pedir ajuda a alguém do time técnico para definir uma nova chamada de API ou, se quiser fazer por conta própria, veja a seção Entenda e configure as Actions, mais adiante, para saber como montar uma chamada de API.

Se a tarefa que você precisa não estiver entre os recursos prontos, clique em Add Capabilities e selecione Create Custom (criar personalizada).

Você pode partir de uma sugestão como:

Também dá para descrever a tarefa com suas próprias palavras.

Por exemplo:

Qualificar clientes interessados em contratar nosso plano de marketing no WhatsApp.

Clique em Draft with AI para deixar o agente de IA da AiSensy gerar a primeira versão dos detalhes da Skill.

Depois, revise os campos abaixo:

Icon and Name (ícone e nome)

Escolha um ícone e dê à Skill um nome claro, como:

When Should the Agent Use It? (quando o agente deve usar?)

Explique quais mensagens do cliente devem ativar a Skill.

Para uma Skill de qualificação de leads:

Instructions (instruções)

Diga ao agente como concluir a tarefa, na ordem certa.

Por exemplo:

Revise a versão gerada pela IA antes de clicar em Add Skill. Confirme se ela corresponde ao processo real do seu negócio.

Knowledge é a informação de negócio que o seu Agente de IA usa para responder às perguntas dos clientes.

Essa é uma das partes mais importantes da configuração. Se o seu Knowledge estiver incompleto, confuso ou desatualizado, as respostas do agente também podem sair incompletas ou incorretas.

Você pode adicionar informação de três formas:

Use Crawl a Page para adicionar informações de um site ou artigo de ajuda.

Cole a URL da página desejada e siga as instruções na tela. Adicione páginas com informações úteis para o cliente, como:

Não adicione páginas irrelevantes, que não vão ajudar o agente a responder aos clientes.

Use Upload Files para adicionar documentos do negócio, como:

Os formatos aceitos incluem PDF, DOC, DOCX, TXT e CSV. Cada arquivo pode ter até 50 MB, e arquivos PDF podem ter até 30 páginas.

Use Paste Text para adicionar diretamente informações que não estão em uma página da web nem em um documento.

É útil para FAQs curtas, políticas internas, observações sobre produtos ou informações temporárias.

Por exemplo:

Os pedidos costumam ser despachados em 24 a 48 horas úteis. O cliente recebe o link de rastreio pelo WhatsApp assim que o pedido é enviado.

As Actions permitem que o Agente de IA vá além de responder perguntas. Elas ajudam o agente a atualizar informações de contato, consultar o Knowledge, transferir uma conversa ou chamar uma API externa.

Você vai ver três tipos de Actions.

As Business Actions aparecem quando já existem ações HTTP ou kits de ferramentas compatíveis criados na sua conta. Elas permitem que o agente use ferramentas conectadas ao seu negócio.

As Business Actions são conexões prontas — como Shopify ou Razorpay — que você configura uma única vez em Integrations → App Store. Depois de conectadas, aparecem aqui automaticamente, para que o agente possa usá-las sem nenhuma configuração técnica. Se você ainda não conectou nenhuma ferramenta, essa seção vai mostrar "No actions yet" (nenhuma ação ainda).

Estas já vêm embutidas na AiSensy e estão sempre disponíveis para o agente:

Não é preciso configurar essas Actions embutidas separadamente.

As Custom API Actions conectam o Agente de IA aos seus sistemas externos.

Por exemplo, o agente pode:

Clique em Add Custom API Action e preencha os campos a seguir.

Dê um nome claro à Action, com base no que ela faz.

Por exemplo:

Explique quando o agente deve usar a API.

Por exemplo: use esta Action depois que o cliente informar o número do pedido e pedir a situação mais recente.

Agrupe endpoints de API relacionados sob um mesmo propósito, como pedidos, agendamentos ou CRM. Isso ajuda o agente a entender qual Action relacionada usar.

A Sensitivity controla se o agente deve pedir confirmação ao cliente antes de executar a Action.

A opção Low (baixa) executa a Action sem uma mensagem de confirmação extra. Use apenas em tarefas seguras, apenas de leitura, como consultar o status de um pedido.

Para ações que alteram dados, fazem um agendamento, cancelam algo, iniciam um reembolso ou geram impacto financeiro, use uma configuração que exija confirmação do cliente, quando disponível.

Adicione de um a cinco exemplos práticos para ajudar o agente a usar os valores corretos ao chamar a API. Isso é especialmente útil quando a API aceita vários parâmetros.

Preenchidos: o nome da ação, o motivo para chamá-la e o nome da ferramenta gerado automaticamente, exibido logo abaixo de "Intent shaping".

Se o seu desenvolvedor enviar uma requisição cURL, cole na caixa e clique em Parse & Fill. A AiSensy vai usar essa requisição para preencher o método, o endpoint e os demais dados disponíveis.

Você pode configurar:

As opções de autenticação disponíveis são:

Use exatamente o método, a URL, a autenticação e os valores informados na documentação da API. Nunca exponha chaves ou tokens privados em documentos públicos ou capturas de tela.

Se você for montar a requisição manualmente, veja o que significa cada parte:

Você vai ver quatro opções na aba Auth: None, Bearer token, Basic auth e API key (header). Pense nelas como formas diferentes de mostrar a sua identificação.

Você não precisa saber qual delas é a "certa". O seu desenvolvedor vai informar o tipo de autenticação que o sistema usa. O seu trabalho é apenas escolher a opção correspondente e colar exatamente o que ele passar.

Clique em Test Call para confirmar que a requisição funciona antes de salvar.

Use dados de teste seguros, fornecidos pelo seu desenvolvedor. Evite usar informações sensíveis de clientes reais nos testes.

Clique em Next: Variables depois que a requisição de teste estiver configurada.

As variáveis são os valores que o Agente de IA deve coletar durante a conversa e preencher na hora de chamar a API.

Para uma Action de status de pedido, as variáveis podem incluir:

Para uma Action de agendamento, as variáveis podem incluir:

Se a AiSensy não detectar nenhum valor dinâmico, a requisição será enviada exatamente como configurada. Não salve um ID de cliente, telefone, e-mail ou número de pedido fixo, a não ser que a API realmente deva usar sempre esse mesmo valor.

Com as variáveis corretas confirmadas, clique em Save Action.

Abra a seção Settings e escreva uma mensagem de fallback (resposta padrão).

A mensagem de fallback é enviada quando o Agente de IA não encontra uma resposta confiável ou não consegue atender ao pedido do cliente.

Por exemplo:

Uma boa mensagem de fallback deve:

Antes de liberar o Agente de IA para todos os clientes, adicione até três números de teste.

Só esses números conseguem interagir com o agente durante o período de teste gratuito.

Informe cada número de WhatsApp, clique em Save Numbers (salvar números) e confirme que você tem acesso a esses números para testar.

A AiSensy oferece 500 mensagens de teste gratuitas, que só podem ser usadas para testar o seu agente de IA nos seus números de teste. A barra de uso mostra quantas mensagens já foram consumidas.

As mensagens de teste servem para construir e melhorar o agente antes de contratar um plano de AI Messages.

Abaixo da mensagem de fallback, você também encontra uma configuração mais completa de Human Handoff: um botão de ativação, frases de gatilho, uma mensagem de transferência e, em seguida, Handoff webhook URL, Webhook authentication e Extra headers.

A maioria dos negócios pode ignorar os campos de webhook. Eles só importam se você quiser que uma transferência avise automaticamente outro sistema, como um helpdesk ou CRM, no momento em que ela acontece. Se você só quer que o seu time veja as conversas transferidas dentro da AiSensy, preencha a mensagem de transferência e deixe o resto em branco: nada quebra.

Use o painel Train Your Agent para testar conversas direto dentro do construtor.

O modo Train responde usando as suas edições mais recentes, ainda não publicadas. Use enquanto altera Business Profile, Voice, Skills, Knowledge, Actions ou Settings.

Isso permite conferir as mudanças antes de publicá-las para os clientes.

O modo Live responde usando a versão do agente que está publicada no momento.

Use para comparar a experiência ao vivo com as suas alterações em rascunho.

Teste o agente com os seguintes tipos de mensagem:

Clique em New Chat (nova conversa) quando quiser recomeçar o teste sem o contexto da conversa anterior.

Quando o agente estiver respondendo corretamente, publique a sua configuração mais recente.

A barra superior mostra o status atual do agente:

Publicar aplica ao agente as alterações do seu rascunho mais recente. Isso não libera automaticamente um agente em teste gratuito para todos os clientes do WhatsApp.

Depois de publicar, mude para Live dentro do painel de testes e faça uma última verificação contra a versão publicada.

Durante o teste gratuito, o Agente de IA funciona apenas com os números de teste que você adicionou.

Para que ele responda às mensagens de todos os seus clientes, escolha um pacote de AI Messages.

Você pode escolher o seu pacote em Flows (fluxos) 👉 Purchase messages 👉 selecione o seu pacote 👉 confirme a compra.

Os tamanhos de pacote disponíveis incluem:

Observação: não é possível colocar o seu agente de IA no ar no plano gratuito para sempre (free forever) da AiSensy. É preciso ter um plano pago. Os agentes de IA são um recurso adicional na AiSensy e precisam ser contratados separadamente do seu plano de assinatura.

Para mais informações sobre os planos, confira o app da AiSensy ou a nossa página de preços.

Os valores aparecem dentro da sua conta AiSensy e podem variar conforme o ciclo de cobrança, o país e os impostos aplicáveis.

O plano de AI Messages inclui:

Conclua o pagamento para liberar o agente em todas as conversas de WhatsApp elegíveis.

Depois, você pode usar Manage AI Messages Plan, no Agents Studio, para revisar ou trocar o seu pacote.

Antes de liberar o agente para falar com todos os clientes, confirme que:

Com essas verificações concluídas, o seu Agente de IA para WhatsApp está pronto para atender conversas reais de clientes.

O seu Agente de IA vem com 500 mensagens de IA gratuitas para testar em até 3 números de teste. Contrate um pacote de AI Messages apenas quando estiver pronto para entrar no ar com clientes reais.

Não. Você consegue criar um Agente de IA baseado em Knowledge, definir o Voice, adicionar Skills, testar e entrar no ar sem programar. Ajuda técnica só é necessária ao conectar uma API personalizada.

Não. As Skills são opcionais. Use quando quiser que o agente execute uma tarefa bem definida, como qualificar um lead ou atender uma consulta de atacado.

Não. Adicione as suas FAQs, páginas do site ou documentos em Knowledge. A API só é necessária quando o agente precisa de informação ao vivo ou precisa concluir uma ação em outro sistema.

O Flow Builder clássico funciona por correspondência exata de palavras-chave e caminhos fixos de conversa. O AI Agent Builder acrescenta compreensão de linguagem natural, busca na base de conhecimento, chamadas de API ao vivo e roteamento dinâmico, para que o seu agente lide com conversas abertas, e não apenas com roteiros prontos.

Sim. Você pode ter alguns fluxos no construtor clássico e outros no AI Agent Builder dentro da mesma conta.

Atributos de contato são campos usados para salvar informações coletadas durante uma conversa, como o número do pedido, o orçamento, o nome da empresa ou a data preferida de agendamento.

Ele usa o comportamento de fallback configurado em Settings. Você também pode ativar a Human Handoff para que a conversa seja transferida para o seu time quando necessário.

O modo Train usa as suas alterações em rascunho, ainda não publicadas. O modo Live usa a versão publicada no momento.

Published significa que a configuração mais recente foi aplicada. Você ainda precisa de um plano ativo de AI Messages para que o agente possa responder a todos os clientes.

Sim, você pode pausar e atualizar o seu agente de IA no WhatsApp quantas vezes quiser.

Você pode adicionar até três números de teste e usar o saldo de mensagens de teste gratuitas mostrado na sua conta.

Apenas valores que mudam a cada conversa, como número do pedido, telefone, e-mail ou data de agendamento. Use a documentação da API ou peça ao seu desenvolvedor para confirmar as variáveis corretas. Não insira valores aleatórios.

Revise as conversas com clientes regularmente. Adicione ao Knowledge as informações que estiverem faltando, refine as Ground Rules, melhore as instruções das Skills e teste novamente as mudanças importantes no modo Train antes de publicar.

Qualquer resposta que envolva inteligência — uma resposta vinda da base de conhecimento, uma chamada de ferramenta ou API, ou o agente raciocinando sobre uma pergunta — conta como uma mensagem de IA da sua cota.

​