Conecte o assistente de IA Clawdbot ao WhatsApp para mensagens automatizadas, respostas inteligentes e conversas alimentadas por IA 24 horas por dia.

Visão geral da integração do Clawdbot com WhatsApp

A integração do Clawdbot com WhatsApp permite que você conecte seu assistente pessoal de IA diretamente ao WhatsApp, a plataforma de mensagens mais popular do mundo. O Clawdbot usa o WhatsApp Web via Baileys, com o Gateway sendo proprietário da sessão. Isso permite que você automatize conversas, receba respostas inteligentes e gerencie suas mensagens do WhatsApp através de automação alimentada por IA.

Por que usar o Clawdbot com WhatsApp?

O WhatsApp é usado por mais de 2 bilhões de pessoas em todo o mundo. Ao integrar o Clawdbot com o WhatsApp, você desbloqueia recursos poderosos de IA:

Recurso	Benefício do Clawdbot WhatsApp
Respostas inteligentes	O Clawdbot gera respostas inteligentes do WhatsApp automaticamente
Disponibilidade 24/7	Seu assistente Clawdbot WhatsApp nunca dorme
Automação de mensagens	Automatize conversas repetitivas do WhatsApp com Clawdbot
Privacidade em primeiro lugar	O Clawdbot é executado localmente, mantendo seus dados do WhatsApp privados
Múltiplas contas	Conecte várias contas do WhatsApp ao Clawdbot
Roteamento determinístico	As respostas sempre retornam ao WhatsApp, sem necessidade de roteamento de modelo

Configuração rápida (Iniciante)

Use um número de telefone separado, se possível (recomendado)
Configure o WhatsApp em ~/.clawdbot/clawdbot.json
Execute clawdbot channels login para escanear o código QR (Dispositivos vinculados)
Inicie o gateway

Configuração mínima:

{
  "channels": {
    "whatsapp": {
      "dmPolicy": "allowlist",
      "allowFrom": ["+15551234567"]
    }
  }
}

Obtendo um número de telefone

O WhatsApp requer um número de celular real para verificação. Números VoIP e virtuais geralmente são bloqueados. Existem duas maneiras suportadas de executar o Clawdbot no WhatsApp:

Número dedicado (Recomendado)

Use um número de telefone separado para o Clawdbot WhatsApp. Isso proporciona a melhor experiência do usuário com roteamento limpo e sem peculiaridades de auto-chat.

Configuração ideal: telefone Android sobressalente/antigo + eSIM. Deixe-o conectado ao Wi-Fi e à energia, e vincule-o via QR.

Dica do WhatsApp Business: Você pode usar o WhatsApp Business no mesmo dispositivo com um número diferente para manter seu WhatsApp pessoal separado.

Exemplo de configuração (número dedicado, lista de permissões de usuário único):

{
  "channels": {
    "whatsapp": {
      "dmPolicy": "allowlist",
      "allowFrom": ["+15551234567"]
    }
  }
}

Número pessoal (Alternativa)

Alternativa rápida: execute o Clawdbot em seu próprio número. Envie mensagens para si mesmo (WhatsApp "Enviar mensagem para você mesmo") para testar.

Exemplo de configuração (número pessoal, auto-chat):

{
  "whatsapp": {
    "selfChatMode": true,
    "dmPolicy": "allowlist",
    "allowFrom": ["+15551234567"]
  }
}

Dicas para obter números

eSIM local da operadora móvel do seu país (mais confiável)
SIM pré-pago — barato, só precisa receber um SMS de verificação
Evitar: TextNow, Google Voice, a maioria dos serviços de "SMS grátis" — o WhatsApp bloqueia esses agressivamente

Dica: O número só precisa receber um SMS de verificação. Depois disso, as sessões do WhatsApp Web persistem via creds.json.

Configurando o Clawdbot WhatsApp

Pré-requisitos

Antes de conectar o Clawdbot ao WhatsApp, certifique-se de ter:

Clawdbot instalado em seu dispositivo
Uma conta do WhatsApp com um número de telefone ativo
Node.js 22 ou superior

Passo 1: Configurar o canal do WhatsApp

Adicione a configuração do WhatsApp ao seu ~/.clawdbot/clawdbot.json:

{
  "channels": {
    "whatsapp": {
      "dmPolicy": "allowlist",
      "allowFrom": ["+15551234567"]
    }
  }
}

Execute o comando de login do Clawdbot WhatsApp:

clawdbot channels login

Abra o WhatsApp no seu telefone, vá para Configurações > Aparelhos conectados > Conectar um aparelho, e escaneie o código QR exibido pelo Clawdbot.

Para login com múltiplas contas:

clawdbot channels login --account <id>

Passo 3: Iniciar o Gateway

clawdbot gateway --port 18789

Passo 4: Verificar a conexão

Confirme que sua integração do Clawdbot WhatsApp está funcionando:

clawdbot channels status whatsapp

Recursos do Clawdbot WhatsApp

Tratamento inteligente de mensagens

O Clawdbot WhatsApp processa mensagens recebidas e gera respostas contextuais. A IA entende o histórico de conversação e fornece respostas relevantes. O modelo vê contexto suficiente para entender respostas citadas.

Opções de política de DM

Política	Descrição
`allowlist`	Responder apenas a números na lista `allowFrom`
`pairing`	Remetentes desconhecidos recebem um código de emparelhamento; aprovar com CLI
`open`	Responder a todas as mensagens (não recomendado)

Suporte para mensagens de grupo

O Clawdbot WhatsApp suporta conversas em grupo. Chats diretos usam a sessão principal do agente; grupos permanecem isolados.

Suporte de mídia

O Clawdbot WhatsApp pode processar e responder a:

Mensagens de texto
Imagens (com IA de visão)
Mensagens de voz (áudio PTT com transcrição)
Documentos
Mensagens de localização

{
  "channels": {
    "whatsapp": {
      "dmPolicy": "allowlist",
      "allowFrom": ["+15551234567", "+10987654321"],
      "configWrites": true,
      "selfChatMode": false
    }
  }
}

Gravações de configuração

Por padrão, o WhatsApp tem permissão para gravar atualizações de configuração acionadas por /config set|unset. Desabilitar com:

{
  "channels": {
    "whatsapp": {
      "configWrites": false
    }
  }
}

Armazenamento de credenciais do Clawdbot WhatsApp

O Clawdbot armazena as credenciais do WhatsApp com segurança:

~/.clawdbot/credentials/whatsapp/<accountId>/creds.json

Cópia de backup em creds.json.bak (restaurada em caso de corrupção)
Compatibilidade legada: instalações mais antigas armazenavam arquivos Baileys diretamente em ~/.clawdbot/credentials/

Os dados da sua sessão do WhatsApp permanecem em sua máquina local, garantindo privacidade.

Solução de problemas do Clawdbot WhatsApp

Conexão perdida

Se o Clawdbot WhatsApp desconectar:

Verifique a conexão com a Internet
Reautentique: clawdbot channels login
Revise os logs: cat /tmp/clawdbot/whatsapp.log

Mensagens não estão sendo enviadas

Se o Clawdbot WhatsApp falhar ao enviar mensagens:

Verifique o status da conta: clawdbot channels status whatsapp
Verifique a configuração da lista de permissões
Certifique-se de que o gateway do Clawdbot está em execução
Um ouvinte ativo é necessário para envios de saída

Código QR expirado

Se o código QR do Clawdbot WhatsApp expirar:

clawdbot channels logout
clawdbot channels login

Logout

O logout exclui o estado de autenticação do WhatsApp (mas mantém o oauth.json compartilhado):

clawdbot channels logout
# ou para uma conta específica
clawdbot channels logout --account <id>

Melhores práticas do Clawdbot WhatsApp

Use um número dedicado: Um número de telefone separado proporciona a melhor experiência
Defina limites claros: Configure listas de permissões para controlar o acesso do Clawdbot WhatsApp
Monitore o uso: Revise os logs do Clawdbot WhatsApp regularmente
Atualize regularmente: Mantenha o Clawdbot atualizado para a compatibilidade mais recente com o WhatsApp
Faça backup das credenciais: Faça backup das suas credenciais do Clawdbot WhatsApp periodicamente

Por que não Twilio?

Números do WhatsApp Business não são adequados para um assistente pessoal:

A Meta impõe uma janela de resposta de 24 horas
O uso de alto volume desencadeia bloqueios agressivos
Contas comerciais não são destinadas a mensagens de assistente pessoal

Próximos passos

Integração do Clawdbot com Telegram - Conecte o Clawdbot ao Telegram
Integração do Clawdbot com Discord - Configure o Clawdbot no Discord
Guia de configuração do Clawdbot - Guia de instalação completo

Integração do Clawdbot com WhatsApp