Saltar para o conteúdo principal
Conecte o WhatsApp à sua instância Claw digitalizando um código QR — exatamente como no WhatsApp Web.

​
Pré-requisitos

O WhatsApp utiliza o seu número de telefone real. As mensagens enviadas pelo bot aparecerão como vindas da sua conta do WhatsApp. Use um número dedicado se desejar separação.
Números VoIP não são suportados. O WhatsApp exige um número de telefone real baseado em SIM. Números virtuais (Google Voice, Skype, etc.) não funcionarão para pareamento por código QR.

​
Guia de Configuração

1

Salvar a Configuração do WhatsApp

  1. Vá para o seu Claw Dashboard
  2. Clique no ícone de configurações em sua instância
  3. Abra a aba IM Integrations
  4. Expanda a seção WhatsApp
  5. Configure a Access Policy (recomenda-se allowlist)
  6. Clique em Save primeiro — você deve salvar a configuração antes de digitalizar o código QR
2

Digitalizar o Código QR

  1. Clique no botão Scan QR Code
  2. Um código QR aparecerá (válido por ~60 segundos)
  3. No seu telefone, abra o WhatsApp → Configurações → Aparelhos Conectados → Conectar um Aparelho
  4. Digitalize o código QR exibido na tela
  5. Aguarde a conexão ser estabelecida
3

Configurar Access Policy

O WhatsApp usa a política de allowlist — apenas os números de telefone que você especificar podem interagir com o bot de IA.Adicione os números de telefone permitidos no dashboard da LemonData (formato internacional, ex: +1234567890).
Ao contrário de outras plataformas, o WhatsApp não suporta o mecanismo de pareamento. Você deve adicionar explicitamente os contatos permitidos.
4

Começar a Conversar

Envie uma mensagem para o número do WhatsApp conectado a partir de um contato permitido — a IA responderá!

​
Configurações de Grupo

Grupos de WhatsApp são suportados. Configure o comportamento do grupo na aba IM Integrations:
ConfiguraçãoOpçõesDescrição
Group PolicyOpen (padrão) / Allowlist / DisabledControla quem pode acionar o bot em grupos
Require @mentionOn / OffO bot só responde quando @mencionado
Group IDsLista de JIDs de grupoRestringir a grupos específicos (vazio = todos os grupos)
Group Allowed UsersLista de números de telefoneApenas estes usuários podem acionar o bot (modo allowlist)
Use o formato E.164 para números de telefone na allowlist do grupo (ex: +1234567890).

​
Resolução de Problemas

Clique em Scan QR Code novamente para gerar um novo código. Os códigos QR expiram após ~60 segundos.
O WhatsApp pode desconectar aparelhos conectados após inatividade. Digitalize o código QR novamente para reconectar.
  • Verifique se o número do remetente está na sua allowlist (se estiver usando a política de allowlist)
  • Verifique se sua instância está em execução
  • Verifique seu saldo na LemonData