Como Configurar OpenClaw no WhatsApp Business

O WhatsApp é o aplicativo mais usado no Brasil para comunicação com clientes. Conectar o OpenClaw ao WhatsApp permite automatizar respostas, agendar mensagens e oferecer atendimento 24/7.

Pré-requisitos

Antes de começar, você precisa:

• OpenClaw instalado e funcionando
• Node.js 18+ instalado
• Um número de WhatsApp dedicado para o bot
• Acesso ao terminal/linha de comando

Método 1: WhatsApp Web (Mais Simples)

O OpenClaw pode se conectar ao WhatsApp através do WhatsApp Web. É o método mais fácil para começar.

Passo 1: Configurar o Canal WhatsApp

Edite seu arquivo de configuração openclaw.yaml:

channels:
  whatsapp:
    enabled: true
    # Número no formato internacional
    phoneNumber: "+5511999999999"

Passo 2: Iniciar o OpenClaw

Execute o OpenClaw normalmente:

openclaw gateway start

Passo 3: Escanear o QR Code

Na primeira execução, um QR code aparecerá no terminal. Escaneie com seu WhatsApp:

1. Abra o WhatsApp no celular
2. Toque nos três pontos (⋮) → Aparelhos conectados
3. Toque em Conectar um aparelho
4. Escaneie o QR code do terminal

Passo 4: Verificar Conexão

Após escanear, você verá:

✓ WhatsApp conectado: +5511999999999

Envie uma mensagem de teste para o número e veja a resposta automática!

Método 2: WhatsApp Business API (Profissional)

Para empresas maiores, a API oficial oferece mais recursos e estabilidade.

Requisitos

• Conta Meta Business verificada
• Número de telefone dedicado
• Aprovação da Meta para usar a API

Configuração

channels:
  whatsapp:
    enabled: true
    provider: "business-api"
    accessToken: "seu_token_aqui"
    phoneNumberId: "seu_phone_number_id"
    businessAccountId: "seu_business_id"

Recursos Disponíveis

Com WhatsApp + OpenClaw você pode:

Comandos Úteis

Reiniciar conexão WhatsApp

openclaw whatsapp reconnect

Ver status da conexão

openclaw whatsapp status

Desconectar

openclaw whatsapp logout

Boas Práticas

1. Use um número dedicado

Não use seu número pessoal. Crie um número exclusivo para o bot.

2. Configure horário de funcionamento

Defina quando o bot deve responder e quando escalar para humanos.

3. Mantenha respostas curtas

WhatsApp funciona melhor com mensagens concisas. Evite parágrafos longos.

4. Personalize a saudação

Configure uma mensagem de boas-vindas que explique o que o bot pode fazer.

Solução de Problemas

QR Code expira rápido

O QR code expira em 60 segundos. Se perder, reinicie o gateway:

openclaw gateway restart

Desconecta frequentemente

Mantenha o celular conectado à internet. O WhatsApp Web depende do celular online.

Mensagens não chegam

Verifique se o número está correto no formato internacional (+55…).

Próximos Passos

• Configurar respostas automáticas
• Integrar com CRM
• Criar fluxos de atendimento

Dica: O Brasil usa WhatsApp 3x mais que a média global. Ter um agente IA no WhatsApp é vantagem competitiva real.