“Como criar um agente de IA” é uma das buscas que mais crescem no Brasil, e a maior parte dos tutoriais responde começando pelo lugar errado: qual modelo usar, qual ferramenta conectar, qual prompt escrever.
Nada disso é o primeiro passo. O primeiro passo é uma pergunta de negócio: o que essa IA precisa enxergar para ser útil?
Quem responde isso primeiro monta um agente. Quem pula direto para a ferramenta monta um respondedor bem escrito que erra estoque, marca horário que não existe e devolve o cliente para a fila sabendo menos do que ele já tinha contado.
Abaixo, a sequência real, com os requisitos que estão na documentação e o ponto em que cada etapa costuma quebrar.
Passo 1: escolher o caminho pelo alcance, não pela ferramenta
Existem três caminhos, e eles não competem pelo mesmo problema. Detalhamos as diferenças em Business AI, Meta Business Agent e agente próprio; aqui vale o resumo de decisão.
Assistente do aplicativo. Configurado dentro do WhatsApp Business, sem código, a partir do perfil e do catálogo. Responde bem o que é estável. Não consulta sistema nenhum e vive num aparelho — sem fila, sem transferência, sem histórico da empresa.
Meta Business Agent. A plataforma de agentes da própria Meta, para quem está na API Oficial. Aceita conhecimento mais amplo e chama as suas APIs por conectores.
Agente da plataforma de atendimento. Roda na API Oficial pelo seu parceiro, integrado ao seu CRM e à sua operação, com fila humana atrás.
A pergunta que decide: quando o cliente perguntar “tem disponível?”, de onde sai a resposta? Se sair de um texto que alguém digitou, escolha o caminho um e não se iluda. Se precisar sair do sistema, o caminho é dois ou três.
Passo 2: resolver os requisitos antes de qualquer configuração
Aqui é onde os projetos descobrem, tarde, que não podiam começar.
Para o Meta Business Agent, a documentação lista:
- uma WhatsApp Business Account com um número comercial registrado;
- um app da Meta com a permissão
whatsapp_business_messaging; - um negócio que opere em país e vertical aprovados.
Esse terceiro item merece atenção porque ele não é negociável e não é óbvio. A documentação diz que o agente está disponível apenas em países e verticais aprovados, e a lista de verticais nomeia cinco: “Automotive, Consumer Packaged Goods (CPG), Professional Services, Retail and Ecommerce, and Travel”.
Em vez de tentar se encaixar na lista por interpretação, use o que a Meta publicou para isso:
“To check whether a specific phone number is eligible programmatically, use the Eligibility endpoint.”
Consulte o endpoint de elegibilidade com o seu número, antes de desenhar o projeto. É uma chamada de API que evita descobrir no fim que o caminho escolhido não estava disponível para você.
E, antes de tudo isso, existe a burocracia que vale para qualquer operação na API Oficial: verificação de negócio, registro do número e aprovação dos templates. Os prazos reais estão em quanto tempo leva para a API Oficial entrar no ar.
Passo 3: dar conhecimento — e separar o que muda do que não muda
As fontes de conhecimento documentadas são objetivas: “add business information, FAQs, websites, and files so the agent answers from your content”. Informações do negócio, perguntas frequentes, sites e arquivos.
O erro clássico deste passo não é técnico, é de classificação. As pessoas cadastram tudo junto — e metade do “tudo” tem prazo de validade.
Pode virar texto (estável): como funciona a garantia, política de troca, como chegar, o que levar na primeira consulta, quais formas de pagamento existem, como funciona o processo de compra.
Não pode virar texto (muda): preço, estoque, disponibilidade de horário, status de pedido, saldo, prazo de entrega, se aquele imóvel ainda está livre.
Um agente que responde preço a partir de texto cadastrado vai, um dia, informar um preço antigo para um cliente — e esse cliente vai cobrar o preço que a sua empresa disse. Dado que muda pertence ao passo 4, não ao 3.
Passo 4: dar ações, que é onde o agente vira agente
Responder é fácil. Fazer é o que separa os projetos.
A documentação do Meta Business Agent descreve exatamente isso:
“connect your own APIs and set up webhook subscriptions so the agent can take actions and listen to events, such as booking an appointment or confirming a payment”
Conectar as suas APIs e assinar webhooks para que o agente execute ações e escute eventos — agendar um horário, confirmar um pagamento. Em uma plataforma de atendimento, a mesma coisa acontece via integração com o seu CRM ou ERP, assunto de integrar WhatsApp com CRM e ERP.
Duas regras que evitam a maior parte dos problemas:
1. O agente só pode oferecer o que ele consegue executar. Se não existe integração com a agenda, ele não oferece horário — ele coleta a preferência e passa para um humano marcar. Prometer e não cumprir é pior do que não prometer.
2. Toda ação precisa de confirmação de volta. Agendou, o cliente recebe a confirmação. Falhou a integração, alguém precisa saber — e não pode ser o cliente descobrindo na porta da clínica.
Passo 5: desenhar a saída para o humano antes de precisar dela
Este passo é o mais pulado e o mais caro, porque ele só aparece quando a conversa já vale dinheiro.
O que precisa estar definido antes de subir:
- os gatilhos de saída — pedido explícito de atendente, reclamação, menção a cancelamento, duas tentativas sem entender, qualquer assunto sensível;
- para onde vai — fila, setor, pessoa específica; conversa que sai da IA e cai no vazio é pior do que conversa que nunca teve IA;
- o que vai junto — o histórico inteiro, e não um resumo. Cliente obrigado a repetir o que já explicou é a queixa número um sobre atendimento automatizado;
- o que acontece fora do horário — se não tem humano, a IA precisa dizer isso com prazo real, não sumir.
Tratamos os gatilhos e a mecânica da passagem em quando o bot deve passar a conversa para um humano.
Passo 6: medir o que revela problema, não o que revela sucesso
Quase todo painel de IA mostra “conversas atendidas pela IA” e “taxa de automação”. São números que sobem sozinhos e não ensinam nada.
Os que ensinam:
Mensagens por conversa. A partir de 1º de outubro de 2026, quando as mensagens de serviço deixam de ser gratuitas, essa métrica vira custo direto. Conversa que resolve em quatro mensagens custa um terço de uma que resolve em doze.
Conversas sem resposta. O número que ninguém quer olhar e que explica a maior parte da receita perdida.
O que a IA não soube responder. Essa lista é o melhor roteiro de melhoria que existe, e é gratuita: são as perguntas reais dos seus clientes, ordenadas por frequência.
Quanto tempo até um humano assumir, quando a IA sai.
Os limites do canal que o projeto tem que respeitar
Por mais capaz que o agente seja, ele opera dentro de regras que não são dele:
- dentro da janela de 24 horas, ele conversa livremente;
- fora dela, só template aprovado — e template não é conversa, é modelo submetido antes;
- para iniciar conversa, é preciso consentimento do cliente;
- conversa iniciada por anúncio click-to-WhatsApp tem janela de 72 horas, e vale desenhar o fluxo para aproveitá-la.
Ou seja: a autonomia do agente termina na borda da janela. Esse é o limite que quase nenhum material sobre agentes de IA menciona, e ele está detalhado em agente de IA no WhatsApp: os limites do canal.
Um cronograma honesto
Para uma operação que ainda não está na API Oficial:
- Semana 1 — verificação de negócio e registro do número em andamento; em paralelo, mapear o que a IA precisa enxergar.
- Semana 1 a 2 — templates escritos e submetidos. Primeiro contato, retomada, confirmação.
- Semana 2 — conhecimento estável carregado; separação clara entre texto e integração.
- Semana 2 a 4 — integrações. É aqui que o prazo mora, e é aqui que ele estoura quando alguém tratou isso como detalhe.
- Antes de abrir — testar a passagem para humano, testar o agente errando de propósito, testar fora do horário.
- Depois de abrir — ler a lista do que a IA não soube responder, toda semana, por um mês.
O passo 4 é o que decide o prazo. Quem promete agente pronto em dois dias está falando do passo 3.
Onde a gente entra
O AtendeChat é parceiro oficial da Meta e faz esse caminho junto com você: conduzimos a verificação de negócio, o registro do número e a aprovação dos templates, e entregamos a operação em volta do agente — vários atendentes no mesmo número, fila de distribuição, histórico centralizado, funil em kanban, relatórios e integração com os seus sistemas, que é o passo 4 resolvido.
Se o seu número hoje está no aplicativo comum e o receio é perder conversa e contato na migração, nós suportamos coexistência — o número segue funcionando dos dois lados durante a transição.
Fale com a gente com uma lista na mão: as cinco perguntas que os seus clientes mais fazem e de qual sistema sai a resposta de cada uma. Com isso a gente já consegue te dizer o que a IA resolve e o que ela vai precisar consultar.