Configuracao do WhatsApp
Guia passo a passo para conectar seu agente Claw Buff ao WhatsApp
A integracao com o WhatsApp esta em Beta. Ela usa o protocolo WhatsApp Web (Baileys) que nao e uma API oficial. Veja as Notas Importantes abaixo.
Conecte seu agente de IA Claw Buff ao WhatsApp para que os usuarios possam conversar com ele como um contato comum. A configuracao leva cerca de 5 minutos.
Pre-requisitos
- Uma conta no WhatsApp (um numero de telefone dedicado e fortemente recomendado)
- Um smartphone para escanear o codigo QR
- Um agente Claw Buff implantado (Primeiros Passos)
Passo 1: Conecte ao Claw Buff
- Abra o Console do Claw Buff → pagina de Canais
- Encontre o card do WhatsApp e clique em Connect
- Clique em Generate QR Code
Um codigo QR aparecera na tela.
Passo 2: Escaneie o Codigo QR
Abra o WhatsApp no seu celular
Abra o menu ⋮ (canto superior direito) ou Configuracoes, depois toque em Aparelhos Conectados → Conectar um Aparelho. Em algumas versoes, toque no icone de QR ao lado do nome do seu perfil.
Escaneie o codigo QR
Aponte a camera do seu celular para o codigo QR mostrado no Console. A conexao sera estabelecida automaticamente.
Verifique a conexao
O Console mostrara o status como Connected. Voce vera o numero de telefone vinculado.
Passo 3: Comece a Conversar
Envie uma mensagem para o numero do WhatsApp vinculado a partir de qualquer outra conta do WhatsApp. Seu agente de IA respondera!
Recomendamos usar um numero de telefone dedicado para seu bot no WhatsApp. Isso mantem seu WhatsApp pessoal separado e evita qualquer risco para sua conta pessoal.
Recursos
| Recurso | Suportado |
|---|---|
| Mensagens Diretas | Sim |
| Chats em Grupo | Sim |
| Formatacao Rica | Sim |
| Anexos de Arquivos | Sim |
| Mensagens de Voz | Planejado |
Notas Importantes
Status Beta
A integracao com o WhatsApp usa a biblioteca Baileys (protocolo WhatsApp Web). Esta nao e uma API oficial do WhatsApp, o que significa:
- Risco para a conta — O WhatsApp pode restringir contas que usam APIs nao oficiais. Use um numero dedicado, nao o seu pessoal
- Expiracao da sessao — A sessao vinculada expira apos cerca de 30 dias de inatividade. Voce precisara escanear o codigo QR novamente
- Sem SLA — Mudancas no protocolo pelo WhatsApp podem interromper temporariamente a conexao
Recomendacao de Numero Dedicado
Recomendamos fortemente obter um numero de telefone separado para seu bot no WhatsApp. Opcoes:
- Um chip pre-pago
- Numero do Google Voice
- Um numero VoIP que possa receber SMS para verificacao
Alternativa Cloud API
Para casos de uso em producao que exigem uma API oficial, o suporte ao WhatsApp Cloud API esta planejado para uma versao futura. Isso usara a API oficial de Negocios da Meta com SLAs adequados e sem risco para a conta.
Perguntas Frequentes
1. Codigo QR expirou?
Os codigos QR expiram apos cerca de 60 segundos. Clique em Generate QR Code novamente no Console para obter um novo.
2. Conexao cai frequentemente?
- Certifique-se de que o celular permanece conectado a internet
- Verifique se o WhatsApp esta atualizado para a versao mais recente
- A sessao pode precisar ser reconectada se o celular ficou offline por muito tempo
3. Mensagens nao estao sendo entregues?
- Verifique se o numero do destinatario esta no formato E.164 (ex.: +5511912345678)
- Mensagens em grupo requerem que o numero do bot seja membro do grupo
- Verifique a pagina de Canais no Console para detalhes de erro