Pular para o conteúdo
Agentes de IA

WhatsApp com agente de IA: como montar um atendimento que responde 24 horas

Passo a passo para conectar seu número de WhatsApp a um agente de IA do CollaborAI — dos modos de segurança às proteções de atendimento e ao custo real por conversa.

Equipe CollaborAI 9 min de leitura
Ilustração de um agente de IA do CollaborAI atendendo conversas no WhatsApp

A maior parte das vendas perdidas em pequenas e médias empresas não morre por preço. Morre por silêncio: a mensagem chega às 22h de uma terça, ninguém responde, e às 9h da manhã seguinte o cliente já resolveu o problema com outra pessoa.

O WhatsApp é onde essa conversa acontece — e é justamente o canal mais difícil de manter coberto. Um agente de IA resolve esse buraco de cobertura sem contratar plantão: ele lê a mensagem, entende o contexto, consulta as informações do seu negócio e responde na hora, a qualquer hora.

Este guia mostra como fazer isso na prática no CollaborAI: como conectar o número, quais são os modos de segurança, o que configurar antes de abrir para clientes reais e quanto custa por conversa.

Agente de IA não é chatbot de fluxo

Vale separar as duas coisas, porque a diferença muda o resultado.

Um chatbot de fluxo segue uma árvore fixa: “digite 1 para vendas, 2 para suporte”. Ele só sabe o que você desenhou, e qualquer pergunta fora do roteiro cai em “não entendi, tente novamente”.

Um agente de IA trabalha por objetivo, não por script. Você descreve em linguagem simples o que ele faz, quais regras deve seguir e a que informações tem acesso. A partir daí ele interpreta a mensagem do cliente, decide se precisa consultar um documento, buscar um horário na agenda ou chamar uma API sua — e responde. Se o cliente perguntar de um jeito que você nunca imaginou, ele ainda assim entende.

Uma distinção interna do CollaborAI também ajuda: Especialistas funcionam dentro do Chat, com você presente, conduzindo. Agentes trabalham sozinhos, em canais como o WhatsApp, inclusive quando você está dormindo.

O que você precisa antes de começar

  • Um plano Pro ou Enterprise. O plano Free não inclui Agentes.
  • Um número de WhatsApp que possa ficar conectado — de preferência o número comercial, não o seu pessoal.
  • Uma ideia clara do escopo: o que o agente deve resolver sozinho e o que deve encaminhar para um humano.
  • Opcionalmente, documentos (tabela de preços, políticas, FAQ, catálogo) para virarem Base de Conhecimento. É o que separa uma resposta genérica de uma resposta sobre o seu negócio.

Passo a passo: conectando o WhatsApp ao agente

1. Crie a instância e leia o QR Code

No menu Agent Studio, vá em Conectores > WhatsApp e crie uma instância. No celular, abra o WhatsApp em Aparelhos Conectados > Conectar um Aparelho e escaneie o QR Code exibido na tela.

O código expira em 60 segundos — se demorar, é só gerar outro. A conexão funciona como o WhatsApp Web: o número continua sendo seu, e você segue enxergando todas as conversas no aparelho.

2. Escolha quem pode falar com o agente

Toda instância nasce no modo Privado. É proposital: só o seu próprio número consegue conversar com o agente. Nenhum cliente é exposto a um agente mal calibrado no primeiro dia.

Quando estiver satisfeito com as respostas, você avança para o modo Restrito, que libera uma lista de contatos autorizados — ideal para um piloto com clientes de confiança. O modo Público, que abre o atendimento para qualquer pessoa, chega em breve.

3. Crie o agente (ou adote um pronto)

O criador tem quatro passos:

  1. Identidade — nome, avatar, propósito, personalidade e o modelo de IA. Para atendimento em WhatsApp, um modelo rápido costuma ser a melhor escolha: o tempo de resposta pesa mais que a profundidade analítica.
  2. Conhecimento — vincule as Bases de Conhecimento com os documentos do seu negócio.
  3. Habilidades — ative as ferramentas que ele pode usar (Gmail, Google Agenda, Outlook, WhatsApp) e habilidades personalizadas que você mesmo criou.
  4. Gatilhos — agendamentos e webhooks, caso ele também precise executar rotinas.

Depois de publicar, o agente fica em provisionamento por cerca de 30 segundos antes de entrar No ar. Cada publicação gera uma versão imutável (v1, v2, v3…), então dá para voltar atrás com rollback se uma mudança piorar as respostas.

Se preferir pular a configuração do zero, o Marketplace tem 15 agentes prontos criados pela equipe CollaborAI. Vários já nascem falando WhatsApp: SDR de WhatsApp, Atendimento 24h, Recepção de Clínica, Atendente de Delivery, Vendedor de Loja, Recepção de Salão, Consultor Imobiliário, Petshop, Secretária Contábil e Recepção de Academia. O assistente de adoção conecta o que for necessário, vincula sua instância de WhatsApp e ativa o agente já configurado — e você personaliza tudo depois.

4. Vincule o canal ao agente

No agente, abra o card Canais e vincule a instância de WhatsApp que você conectou. A partir daí, cada mensagem recebida naquele número vira uma conversa com o agente.

O WhatsApp não é o único canal: o mesmo agente pode atender por webchat público (um link /c/seu-slug mais um widget para embutir no seu site) e pelo Chat do painel, onde você conversa com ele para testar.

5. Teste antes de abrir para os clientes

Use o Chat do painel para a bateria de testes. Ele mostra métricas em tempo real — duração, tokens, custo estimado — e um bloco Bastidores com as ferramentas que o agente acionou em cada resposta. É ali que você descobre que ele consultou a Base de Conhecimento errada, ou que respondeu de cabeça quando deveria ter buscado um dado.

Faça as perguntas difíceis: o desconto que você não dá, o prazo que não cumpre, a reclamação agressiva. O comportamento nesses casos é o que você precisa ajustar nas instruções.

As proteções que evitam dor de cabeça

Um agente solto no WhatsApp sem limites é um risco operacional. O CollaborAI traz três proteções configuráveis que resolvem os problemas mais comuns:

Aviso de assistente virtual. O agente se identifica como IA no início da conversa. Além de ser a prática correta de transparência com o cliente, evita a situação constrangedora de alguém descobrir depois que estava falando com um robô.

Limite de mensagens por contato/dia. Impede que um único contato — ou um loop entre dois sistemas automatizados — consuma sua cota mensal inteira em uma tarde.

Pausa automática quando um humano assume. Se você ou alguém da equipe entra na conversa pelo celular, o agente para de responder ali. Nada pior que cliente recebendo duas respostas diferentes, uma sua e uma da IA, na mesma thread.

Vale acrescentar uma quarta proteção, essa de processo: deixe explícito nas instruções do agente quando ele deve parar e chamar um humano. Cancelamento, reclamação formal, pedido fora do padrão. Um agente que sabe a hora de passar a bola vale mais que um que tenta resolver tudo.

Áudio, e o que mais o agente entende

Mensagem de voz é praticamente um dialeto do WhatsApp brasileiro — e ignorá-la quebra o atendimento. O agente transcreve áudios de até 5 minutos automaticamente e responde como responderia a um texto. O cliente nem percebe a diferença.

Dando superpoderes ao agente

Um agente que só conversa é limitado. O que muda o jogo é ele conseguir agir:

  • Conectores — Gmail e Google Agenda (criar, listar e atualizar eventos), Outlook, Calendário do Microsoft 365 (inclusive com reunião do Teams) e Contatos. Conectados uma vez por OAuth, ficam disponíveis para todos os seus agentes. Os tokens são criptografados e nunca são expostos ao modelo de IA.
  • Bases de Conhecimento — seus PDFs, DOCX, planilhas e manuais indexados. É o que faz o agente responder sobre a sua tabela de preços, e não sobre uma genérica.
  • Habilidades personalizadas — qualquer API HTTPS sua, conectada por um construtor visual, sem programar. Consultar CEP, buscar um pedido no seu ERP, verificar estoque, checar a segunda via de um boleto.

Na prática é a diferença entre “vou verificar e te retorno” e “sua entrega saiu hoje às 14h20 e chega até amanhã”.

Quanto custa por conversa

A cobrança é por execução (ou run). Cada conversa, agendamento ou chamada de webhook consome 1 run da cota mensal da conta:

PlanoExecuções incluídas por mês
Freenão inclui Agentes
Pro200
Enterprise2.000

A cota é compartilhada entre todos os seus agentes. Passou disso, as execuções seguintes são cobradas em créditos — o mesmo saldo usado para gerar imagens e vídeos — proporcionalmente ao modelo e ao tamanho da execução. Como referência, uma execução simples com um modelo rápido fica em torno de 8 créditos; com um modelo mais avançado, em torno de 23.

Duas travas evitam surpresas: cada agente tem um orçamento mensal de créditos configurável, e a lista de agentes mostra um indicador de quantos runs você já usou no mês. Sem saldo, a execução é bloqueada até você comprar créditos ou virar o mês — o gasto nunca corre solto.

Além do atendimento: rotinas agendadas

O mesmo agente que responde no WhatsApp pode trabalhar sozinho por gatilhos:

  • Agendamento — um prompt fixo que roda diariamente, semanalmente ou mensalmente, com hora e minuto definidos e fuso horário (padrão America/Sao_Paulo). Serve para o resumo das conversas do dia, a lista de leads sem resposta ou o relatório de segunda-feira.
  • Webhook — uma URL que seus sistemas chamam via POST, com assinatura HMAC opcional. Útil para disparar uma ação no agente quando um pedido entra no seu e-commerce.

O plano Pro permite 3 agendamentos e 3 webhooks; o Enterprise, 10 de cada. Quando a cota mensal acaba, os agendamentos pausam sozinhos e voltam no dia 1º.

Cinco erros comuns na largada

  1. Abrir para todos os clientes no primeiro dia. O modo Privado existe por um motivo. Teste com seu número, depois com uma lista restrita, e só então abra.
  2. Escopo largo demais. “Atende tudo” vira “não resolve nada”. Comece por um objetivo único — qualificar leads, ou agendar horários — e expanda depois.
  3. Não alimentar a Base de Conhecimento. Sem os seus documentos, o agente responde bem em forma e mal em conteúdo. É a causa número um de respostas decepcionantes.
  4. Esquecer o caminho de saída. Todo agente precisa saber quando chamar um humano. Escreva isso nas instruções, com exemplos.
  5. Publicar e nunca mais olhar. Leia as conversas da primeira semana. Cada resposta ruim é uma linha a corrigir nas instruções — e a versão anterior fica salva, então dá para voltar atrás.

Perguntas frequentes

Preciso do WhatsApp Business API oficial? Não. A conexão é feita por QR Code, do mesmo jeito que o WhatsApp Web. Seu número continua funcionando normalmente no celular.

Preciso saber programar? Não. Todo o processo é visual — inclusive a criação de habilidades que chamam APIs próprias.

Continuo vendo as conversas? Sim. Tudo aparece no seu WhatsApp, e você pode assumir qualquer conversa a qualquer momento — o agente pausa automaticamente quando isso acontece.

Posso usar o mesmo agente em mais de um canal? Sim. O mesmo agente atende no WhatsApp, no webchat público do seu site e no Chat do painel, com a mesma personalidade e o mesmo conhecimento.

E se eu quiser desligar? Basta desvincular a instância do agente ou desconectar o aparelho no WhatsApp. O atendimento volta a ser 100% humano na hora.


O caminho mais rápido para o primeiro resultado é começar pequeno: adote um agente do Marketplace, deixe no modo Privado por dois dias conversando só com você, ajuste as instruções com base no que te incomodar, e então libere para uma lista curta de clientes. Em uma semana você tem um atendimento que não dorme.

#whatsapp #agentes #atendimento #automação
Compartilhar

Continue lendo

Seu WhatsApp respondendo sozinho, ainda esta semana

Crie um agente, escaneie o QR Code e comece pelo modo Privado. Sem programar, sem fidelidade.

Criar meu agente