Como conectar seu agente ao WhatsApp usando um numero dedicado seu.
Aviso importante
NUNCA use seu numero pessoal
O numero usado para o agente deve ser um WhatsApp Business em um numero dedicado exclusivamente para o agente.
Quando o agente conecta, ele assume o controle das mensagens daquele WhatsApp. Todas as conversas passam a ser respondidas pela IA. Voce perde o acesso pessoal enquanto o agente estiver conectado.
Opcoes recomendadas:
- Comprar um chip pre-pago barato (R$10-15) dedicado ao agente
- Usar um chip corporativo que ja estava parado
Conectar seu numero
O QuickClaw nao vende numero: voce conecta um chip dedicado que ja possui, sem custo adicional, via QR code (igual ao WhatsApp Web).
Prepare o numero dedicado
Pegue um chip novo/dedicado (NAO use seu pessoal). Instale o WhatsApp Business (app verde, nao o azul normal). Cadastre o numero e configure o perfil comercial.
Acesse a aba Canais
No dashboard, clique no agente > aba Canais. Na coluna da direita, expanda o card WhatsApp.
Digite o numero completo
Digite com DDI: +5571996441459
Formato: +55 (Brasil) + DDD (71) + numero (996441459)
Cuidado com DDD duplicado
Certo: +5571996441459 — Errado: +557171996441459
Conecte via QR Code
Clique em "Conectar WhatsApp". O numero e salvo e o QR Code aparece em seguida. No celular com o chip dedicado:
- Abra o WhatsApp Business
- Va em Configuracoes > Dispositivos conectados
- Toque em Conectar dispositivo
- Aponte a camera para o QR Code
Configure a Allowlist
Sem isso, ninguem consegue falar com o agente.
No card WhatsApp, va ate "Quem pode falar com o agente?". Selecione "Apenas quem eu permitir" e adicione os numeros de quem pode conversar (formato: +5571996441459).
Adicione seu numero pessoal para poder testar.
Teste
No seu celular pessoal, mande uma mensagem para o numero do agente. Aguarde 30-60 segundos — o agente vai responder.
Controle de acesso (Allowlist)
A allowlist define quem pode conversar com o agente no WhatsApp. Sem configurar, ninguem consegue falar.
Politicas disponiveis
- Apenas quem eu permitir (recomendado) — Somente numeros cadastrados na lista podem conversar. Protege seus creditos.
- Qualquer pessoa — Qualquer numero pode falar com o agente. Cuidado: consome creditos de qualquer interacao.
- Pareamento (avancado) — Usuarios precisam se parear antes de conversar. O agente fornece um comando de pareamento.
Formato dos numeros
Sempre use o formato internacional com DDI: +5511999887766. Sem espacos, tracos ou parenteses.
O numero do agente NAO precisa estar na lista
Voce so precisa adicionar os numeros de quem vai falar com o agente, nao o numero do proprio agente.
Grupos WhatsApp
O agente pode participar de grupos WhatsApp. Para configurar:
- Adicione o numero do agente ao grupo normalmente
- Na aba Canais > WhatsApp > Controle de Acesso, mude para o modo Grupo
- Adicione o ID do grupo (formato
120363012345678901@g.us)
Como descobrir o ID do grupo
- Temporariamente, mude a politica de grupo para "Qualquer pessoa"
- Envie uma mensagem no grupo — o agente captura o ID nos logs
- Copie o ID e adicione na allowlist de grupos
- Volte a politica para "Apenas quem eu permitir"
Mencao requerida
Por padrao, o agente so responde em grupos quando mencionado (@agente). Voce pode desativar esse comportamento no toggle "Precisa marcar o agente?" para que ele responda a todas as mensagens.
Esse e o padrao do canal. Cada grupo pode ter regra propria: em Regras por grupo, escolha Usar padrao, Exigir ou Nao exigir. Com a politica de grupos "Apenas autorizados", cada grupo autorizado aparece na lista; com "Qualquer grupo", adicione o ID do grupo (XXXXX@g.us) que deve ser diferente e os demais seguem o padrao.
Conexao via QR Code
A conexao funciona igual ao WhatsApp Web — o agente se conecta como um "dispositivo vinculado" ao seu WhatsApp Business.
Mantenha o celular conectado
O celular com o chip dedicado precisa estar com internet ativa. Se o celular ficar muito tempo offline, a sessao pode desconectar. Nesse caso, basta refazer o QR Code pelo dashboard.
Status da sessao
- Conectado (verde) — Agente funcionando normalmente
- Nao conectado (amarelo) — QR code ainda nao escaneado
- Desconectado (vermelho) — Sessao perdida, refaca o QR code
Configuracoes avancadas
Usuarios avancados podem acessar configuracoes extras no card WhatsApp > Configuracoes Avancadas:
Mensagens
- Debounce (ms) — Tempo de espera antes de processar mensagens rapidas (padrao: 1500ms)
- Bloquear streaming — Envia resposta completa de uma vez
- Confirmacao de leitura — Envia check azul ao receber mensagem
- Prefixo recebido/resposta — Texto adicionado antes de mensagens
- Limite por mensagem — Caracteres maximos antes de dividir
Reacoes
- Reagir ao receber DM — Emoji de confirmacao ao receber mensagem direta
- Reacao em grupos — Emoji ao receber mensagem em grupo
- Emoji de reacao — Qual emoji usar (padrao: olhos)
Acoes permitidas
- Enviar mensagens — Permitir o agente enviar mensagens
- Reagir com emoji — Permitir reacoes
- Criar enquetes — Permitir polls
Sistema
- Escrita de config pelo canal — Comandos no chat alteram config
- Modo chat pessoal — Modo especial para self-chat
Reinicio do gateway
Salvar configuracoes reinicia o gateway do agente. Ele pode levar 30-60 segundos para voltar a responder.
Problemas comuns
| Problema | Solucao |
|---|---|
| Agente nao responde | Verifique se o numero esta na allowlist |
| QR Code nao aparece | Agente precisa estar ligado (running) |
| "Desconectado" | Refaca o QR Code. O celular precisa ter internet |
| Numero errado | Nao duplique o DDD: +5571... nao +557171... |
| Ninguem consegue falar | Allowlist vazia — adicione os numeros |
| Usando WhatsApp normal | Precisa ser WhatsApp Business (app verde) |
| Usou numero pessoal | Agente responde TODAS as conversas. Use numero dedicado |
Perguntas frequentes
Posso usar meu numero pessoal?
Nunca. O agente assume o controle total do WhatsApp. Todas as suas conversas pessoais passarao a ser respondidas pela IA. Use sempre um numero dedicado (um chip pre-pago serve).
Precisa ser WhatsApp Business?
Sim. O WhatsApp normal nao suporta "dispositivos conectados" da mesma forma. Use o WhatsApp Business (app verde) para garantir estabilidade da conexao.
O que acontece se eu cancelar o agente?
O agente para de responder. Para liberar o numero, desconecte o dispositivo no WhatsApp Business.
Quanto custa o WhatsApp?
Nada a mais: o canal WhatsApp esta incluso em todos os planos. Voce so precisa ter um chip dedicado.
O agente funciona em grupos?
Sim. Adicione o agente ao grupo, configure o ID do grupo na allowlist e defina se o agente precisa ser mencionado para responder. Veja a secao Grupos WhatsApp.