Como Criar um Agente de IA no WhatsApp em 10 Minutos

Como Criar um Agente de IA no WhatsApp em 10 Minutos (Passo a Passo)

Criar um agente de IA no WhatsApp costumava ser um projecto de três meses: aprovar API da Meta, codificar integração, hospedar servidor, testar. Com o OpenClaw, a mesma entrega funciona em 10 minutos do cadastro à primeira conversa real. Este post é o passo a passo honesto — com os 4 atritos que vai encontrar e como ultrapassar cada um.

TL;DR: Cadastro → descrever o agente em texto → conectar WhatsApp Business → configurar 1 integração → primeira conversa. ~10 min. Nenhuma linha de código.

---

O que precisa antes de começar

Três coisas (e nada mais):

1. Conta WhatsApp Business (a app gratuita da Meta — não confunda com a pessoal).
2. Número de telefone dedicado. Pode ser fixo, virtual ou de telemóvel — mas não pode estar em uso no WhatsApp pessoal.
3. 10 minutos sem interrupção. O fluxo bloqueia se sair a meio da autenticação.

Não precisa de cartão de crédito no plano gratuito. Não precisa de NUIT (embora recomendemos). Não precisa de saber o que é webhook.

---

Passo 1 — Criar a conta (1 min)

Entre em openclaw.com.br, clique em Criar conta grátis e preencha:

• E-mail
• Palavra-passe
• Nome do seu negócio

O sistema cria o seu workspace em segundos. Entra no dashboard com um tour de 3 passos.

Atrito comum: O e-mail de confirmação por vezes cai no spam do Gmail. Se em 1 min não chegou, confirme a pasta "Promoções" ou "Spam".

---

Passo 2 — Descrever o agente em linguagem natural (3 min)

Aqui o OpenClaw diverge da maioria das plataformas. Em vez de montar fluxograma com blocos a arrastar, descreve o agente em texto e a plataforma monta a lógica.

Abra Agentes → + Novo agente. Vai ver três campos:

Nome

O nome que o cliente vê. Ex: Sofia, Atendente OpenClaw, Assistente da Clínica Solar.

Objectivo

Uma frase curta do que o agente deve fazer. Exemplos que funcionam:

• ✅ Qualificar novos leads e agendar avaliação gratuita com um consultor.
• ✅ Tirar dúvidas sobre os nossos cursos, aplicar cupão de desconto e enviar link de pagamento.
• ❌ Vender. (muito genérico)
• ❌ Ser amigável, eficiente, profissional e vender. (objectivo vira lista de adjectivos — mau)

Personalidade e restrições

Aqui dá o "manual de marca" em texto corrido. Exemplo que usamos como baseline:

Tom: casual moçambicano, próximo mas profissional. Pode usar emojis com parcimónia (1 por mensagem).

Sempre: apresente-se no primeiro turno. Use o primeiro nome do cliente quando souber. Confirme agendamento duas vezes.

Nunca: prometa descontos que não estão no catálogo. Fale sobre concorrência. Invente horário ou preço. Responda pergunta de saúde/jurídica/financeira — encaminhe para o humano.

Quando travar: peça com educação que a pessoa aguarde e chame um humano via /chamar_humano.

Guarde. Em 2 segundos tem um agente funcional — ainda sem integrações.

---

Passo 3 — Conectar o WhatsApp Business (3 min)

Esta é a parte que mais gera atrito e onde a maioria das plataformas perde o utilizador. O OpenClaw encurta o fluxo oficial da Meta para uma sequência linear.

3.1 Iniciar conexão

No painel, clique em Integrações → WhatsApp → Conectar. Escolha:

• Número novo: se vai usar um número que ainda não está em nenhum WhatsApp.
• Migrar do WhatsApp Business (app): se já tem o app WhatsApp Business instalado e quer transferir o número para a API. Atenção: o app deixa de funcionar depois da migração.

3.2 Autenticar com a Meta

O OpenClaw redireciona para o login da Meta (não Google, não Facebook pessoal — conta Business Manager). Se nunca abriu o Business Manager, a Meta cria para si na hora.

Atrito comum #1: A sua conta pessoal do Facebook precisa ser admin do Business Manager. Se ninguém lhe deu acesso, não consegue passar dessa tela.

3.3 Selecionar / criar WhatsApp Business Account

Dentro da autenticação da Meta, escolhe qual WABA (WhatsApp Business Account) vai usar. Se ainda não existe, a Meta cria na hora pela interface embutida.

3.4 Verificar o número

A Meta envia código SMS ou chamada para o número que vai conectar. Digite o código na interface do OpenClaw.

Atrito comum #2: Se já usou esse número num WhatsApp (pessoal ou business app), o código não chega. Solução: desinstalar o WhatsApp desse número no telemóvel ANTES de iniciar a conexão.

3.5 Configurar webhook

O OpenClaw configura o webhook automaticamente. Não precisa de fazer nada. Quando a tela mostra Número conectado ✅, está pronto.

---

Passo 4 — Plugar UMA integração (2 min)

Pode saltar este passo e já começar a conversar — mas 95% dos agentes que ficam no ar usam pelo menos 1 integração. Recomendamos começar pela que gera valor mais rápido no seu caso:

O seu negócio	Integração primeira
Clínica, consultório, estúdio	Google Calendar
Infoproduto, curso	Stripe ou Mercado Pago
Serviço B2B (consultoria, agência)	HubSpot ou RD Station
Loja física / delivery	Planilhas Google

Exemplo — Google Calendar:

1. Integrações → Google Calendar → Conectar.
2. Autoriza com a conta Google que tem o calendário da operação.
3. Escolhe qual calendário o agente pode consultar / criar evento.
4. Define janela (ex: seg-sex 9h-18h, sab 9h-13h).
5. Salva.

Pronto. O agente agora consulta horário livre em tempo real e cria evento sem intervenção humana.

---

Passo 5 — Primeira conversa real (1 min)

Pega no seu outro telemóvel (ou pede a alguém), manda uma mensagem para o número que conectou. Teste cenários que sabe que vão acontecer:

• "olá"
• "quanto custa?"
• "atende ao sábado?"
• "quero marcar"
• "preciso falar com uma pessoa"

Observe as respostas. Volta no painel do OpenClaw → Conversas para ver a transcrição.

Ajuste o que não ficou bem: se o agente errou o tom ou inventou algo, volta no campo de personalidade e adiciona a regra que faltou. O agente relê a descrição a cada nova mensagem — mudanças valem na próxima conversa.

---

Os 4 erros mais comuns nos primeiros 10 minutos

1. Objectivo genérico demais. Agente com objectivo vago dá resposta vaga. Reescreva com o resultado concreto que espera.
2. Esquecer as restrições negativas. "Nunca invente preço" vale mais do que "seja profissional". Regras negativas orientam melhor.
3. Saltar a integração e testar só com texto. Agente sem calendário no exemplo da clínica fica decorativo — o cliente sai da conversa sem ter marcado nada.
4. Achar que está pronto no primeiro teste. Os primeiros 20-30 turnos reais revelam padrões que não previu. Reserve 1 semana para iterar antes de dispensar o atendente humano.

---

E depois dos 10 minutos?

O agente no ar é só o ponto de partida. O trabalho real de maximizar resultados está em:

• Analisar conversas reais e refinar a personalidade.
• Adicionar skills customizadas para operações específicas do seu negócio (consulta de stock, verificação de pagamento, etc.).
• Configurar handoff inteligente para quando o agente precisa de chamar uma pessoa.
• Acompanhar métricas de resolução vs escalação.

Cobrimos cada um desses em posts separados — mas primeiro vale entender o que acontece por dentro do agente a cada turno de conversa para calibrar a expectativa.