Blog · Agentes de IA
Agente de IA no WhatsApp: como montar um atendente que responde sozinho
Um agente de IA no WhatsApp lê a mensagem do cliente, segue as suas instruções e responde na hora, a qualquer horário. Na TalvraHub, você escolhe o modelo (Claude, GPT ou modelos abertos pela Groq), usa a sua própria chave do provedor e liga o agente ao número por QR, à API oficial ou aos dois. Quando o cliente pede uma pessoa, ele passa a conversa para a sua equipe.
Modelos disponíveis
Você escolhe o provedor e o modelo, e paga o consumo direto a ele. A chave fica cifrada na TalvraHub.
| Provedor | Modelos |
|---|---|
| Anthropic | Claude Sonnet 5 (o equilíbrio recomendado), Claude Haiku 4.5 (mais barato e rápido) e Claude Opus 5 (máxima qualidade) |
| OpenAI | GPT-5 mini, GPT-5.2 e GPT-5 nano |
| Groq | GPT-OSS 20B e GPT-OSS 120B, com a faixa gratuita do próprio provedor |
Passo a passo
- Abra Automação → Agentes IA, clique em Novo agente e escolha o agente de mensagens.
- Escolha o provedor e o modelo, e cole a API key da sua conta no provedor. O link Obter chave leva até a página certa.
- Escreva as instruções do agente, com até 8.192 caracteres. Se preferir, use Construir personalidade: você preenche papel, empresa, objetivo, tom da conversa, como conduzir, o que ele não pode fazer e quando chamar uma pessoa.
- Escolha onde ele atende: a caixa não oficial (número por QR), a caixa oficial (API da Meta) ou as duas. Cada caixa tem um agente ativo por vez.
- Defina o máximo de respostas por hora, por contato, de 1 a 60. O padrão é 10.
- Clique em Testar e converse com o agente na sala de ensaio. A chamada ao modelo é real, mas nada é gravado e o teste não conta no limite.
- Ligue o agente.
Na API oficial, o agente também pode iniciar até 10 fluxos que você escolher, quando a conversa pede um atendimento automático específico.
O que ele já sabe sem você escrever
- Contexto da conversa: as últimas 20 mensagens, a data e a hora, o nome da sua empresa, o nome do contato e até 20 atributos dele no CRM.
- Regras fixas, em todo agente: responder no idioma da última mensagem do cliente, nunca inventar preço, prazo ou condição que não esteja nas instruções ou no contexto, e passar para uma pessoa quando o cliente pedir ou depois de duas tentativas sem conseguir ajudar.
Quando responde e quando fica quieto
O agente é a última camada do atendimento automático. Antes dele vêm, nesta ordem, um fluxo que está esperando a resposta do contato e os gatilhos ou palavras-chave. Ele só fala quando nada antes casou.
- Pediu uma pessoa: o agente para de responder naquela conversa por 24 horas e a marca como não lida, para a equipe ver.
- A equipe respondeu: se a última mensagem enviada na conversa não foi do agente, ele fica quieto.
- Pausa manual: na barra de atendimento, Pausar automação para este contato por 30 minutos, 2 horas ou 24 horas.
- Limite por hora: passou do máximo de respostas por contato, ele espera.
- Falha do provedor: se o modelo não responde, o agente fica quieto em vez de mandar uma resposta cortada.
- Grupos e listas de transmissão: ficam de fora.
No número por QR, dá até para recusar uma ligação recebida e deixar o agente continuar a conversa por mensagem.
O agente dentro de um fluxo
Além do agente da caixa, o construtor de fluxos tem o nó Agente de IA, para usar a IA num trecho da jornada: por exemplo, tirar dúvidas antes de mandar a oferta. Você define as palavras de saída, que devolvem a conversa ao fluxo, e o máximo de turnos (o padrão é 10). Esse nó funciona no número por QR.
Como escrever boas instruções
O agente usa o que está nas instruções e no contexto. Ele não lê PDF nem site, então o que importa para vender tem de estar escrito ali:
- Preços, prazos, formas de pagamento e o link de compra de cada produto.
- O horário de atendimento da equipe, para ele saber o que prometer.
- O que ele não pode fazer, como dar desconto ou confirmar entrega.
- Quando chamar uma pessoa: reclamação, negociação, pedido fora do comum.
Teste as perguntas mais comuns dos seus clientes na sala de ensaio antes de ligar o agente no número.
Perguntas frequentes
Preciso pagar a IA à parte?
O consumo do modelo é cobrado na sua conta do provedor (Anthropic, OpenAI ou Groq), com a sua chave. A Groq tem uma faixa gratuita própria.
O agente de IA responde em grupos de WhatsApp?
Não. Ele atende conversas individuais; grupos e listas de transmissão ficam de fora.
Como a equipe assume uma conversa do agente?
Quando o cliente pede uma pessoa, ou depois de duas tentativas sem conseguir ajudar, o agente para de responder naquela conversa por 24 horas e a marca como não lida. Se alguém da equipe responder depois dele, ele também fica quieto.
O agente pode inventar preço ou prazo?
Todo agente recebe uma regra fixa para nunca inventar preço, prazo ou condição que não esteja nas instruções ou no contexto. Por isso, escreva esses dados nas instruções.
O agente de IA funciona no Instagram?
Não. O agente atende no WhatsApp, pelo número por QR e pela API oficial. No Instagram, a TalvraHub roda as automações de comentário, Direct, story e boas-vindas.
Veja também como recuperar vendas pelo WhatsApp e os outros artigos do blog.
