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 projeto de três meses: aprovar API da Meta, programar integração, alojar servidor, testar. Com o OpenClaw, a mesma entrega funciona em 10 minutos do registo à primeira conversa real. Este artigo é o passo a passo honesto — com os 4 atritos que vai encontrar e como ultrapassar cada um.

TL;DR: Registo → 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 aplicação gratuita da Meta — não confunda com a pessoal).
2. Número de telefone dedicado. Pode ser fixo, virtual ou 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 NIPC (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. Vai parar ao painel de controlo com um tour de 3 passos.

Atrito comum: E-mail de confirmação às vezes vai para o spam do Gmail. Se em 1 min não chegar, 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 arrastando, 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.

Objetivo

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

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

Personalidade e restrições

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

Tom: casual brasileiro, 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 a pergunta de saúde/jurídica/financeira — encaminhe para o humano.

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

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

---

Passo 3 — Ligar 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 ligação

No painel de controlo, clique em Integrações → WhatsApp → Ligar. 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 a app WhatsApp Business instalada e quer transferir o número para a API. Atenção: a 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 de ser administrador do Business Manager. Se ninguém lhe deu acesso, não consegue passar desta ecrã.

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 incorporada.

3.4 Verificar o número

A Meta envia código SMS ou chamada para o número que vai ligar. 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 ligação.

3.5 Configurar webhook

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

---

Passo 4 — Ligar 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, sáb 9h-13h).
5. Guarda.

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 teu outro telemóvel (ou pede a alguém), envia uma mensagem para o número que conectaste. Testa cenários que sabes que vão acontecer:

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

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

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

---

Os 4 erros mais comuns nos primeiros 10 minutos

1. Objetivo genérico demais. Agente com objetivo vago dá resposta vaga. Reescreve com o resultado concreto que esperas.
2. Esquecer as restrições negativas. "Nunca inventes preço" vale mais do que "sê profissional". Regras negativas orientam melhor.
3. Saltar a integração e testar só com texto. Agente sem calendário no exemplo da clínica torna-se 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 previste. Reserva 1 semana para iterar antes de desligar o atendente humano.

---

E depois dos 10 minutos?

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

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

Cobrimos cada um desses em publicações separadas — mas primeiro vale a pena entender o que acontece por dentro do agente a cada turno de conversa para calibrar expectativas.