---
title: "Como Configurar OpenClaw no WhatsApp Business"
url: "https://openclaw.ia.br/tutoriais/whatsapp/"
markdown_url: "https://openclaw.ia.br/tutoriais/whatsapp.MD"
description: "Guia passo a passo para conectar seu agente OpenClaw ao WhatsApp e automatizar atendimento ao cliente."
date: "2026-02-01"
author: "Ink "
---

# Como Configurar OpenClaw no WhatsApp Business

Guia passo a passo para conectar seu agente OpenClaw ao WhatsApp e automatizar atendimento ao cliente.


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. Se a meta é montar um fluxo completo de atendimento para pequena empresa, leia também o [guia de agente de IA para atendimento no WhatsApp](/tutoriais/agente-ia-atendimento-whatsapp-pme/).

## 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`:

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

### Passo 2: Iniciar o OpenClaw

Execute o OpenClaw normalmente:

```bash
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

```yaml
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:

| Recurso | Descrição |
|---------|-----------|
| Respostas automáticas | Responda clientes 24/7 |
| Mensagens agendadas | Envie lembretes e follow-ups |
| Catálogo de produtos | Mostre produtos automaticamente |
| Transferência humana | Escale para atendente quando necessário |
| Histórico de conversas | Mantenha contexto entre mensagens |

## Comandos Úteis

### Reiniciar conexão WhatsApp

```bash
openclaw whatsapp reconnect
```

### Ver status da conexão

```bash
openclaw whatsapp status
```

### Desconectar

```bash
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:

```bash
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](/blog/automacao-whatsapp-ia-guia-completo/)
- [Integrar com CRM](/integracoes/)
- [Criar fluxos de atendimento](/tutoriais/agente-ia-atendimento-whatsapp-pme/)

---

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