Como conectar seu agente ao WhatsApp — numero proprio ou virtual via Salvy.
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
- Contratar um numero virtual pelo QuickClaw via Salvy (R$34,90/mes)
- Usar um chip corporativo que ja estava parado
Opcoes de numero
O QuickClaw oferece duas formas de conectar WhatsApp ao seu agente:
Numero proprio
Use um chip dedicado que voce ja possui. Sem custo adicional. Conexao via QR code (igual WhatsApp Web).
Numero virtual Salvy
Numero virtual brasileiro provisionado automaticamente. R$34,90/mes. Escolha o DDD.
Opcao 1: Numero proprio
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.
Escolha 'Ja tenho um numero'
Clique em "Ja tenho um numero". Um modal sera aberto para voce digitar o numero.
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
Apos salvar, clique no agenteao verde "Conectar". Um QR Code sera exibido. 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.
Opcao 2: Numero virtual Salvy
Acesse a aba Canais e expanda WhatsApp
No dashboard, clique no agente > aba Canais > card WhatsApp.
Escolha 'Contratar numero novo'
Selecione o DDD desejado e confirme o custo de R$34,90/mes. Voce sera redirecionado ao Stripe para pagamento.
Aguarde o provisionamento
Apos o pagamento, o numero sera provisionado automaticamente em instantes. O numero aparece no formato +55XX9XXXXXXXX.
Conecte via QR Code
O agenteao "Conectar" aparecera. Siga o mesmo processo de QR Code descrito na Opcao 1 (passo 5). Voce precisara de um celular com WhatsApp Business instalado para escanear.
Configure Allowlist e teste
Adicione os numeros autorizados e teste conforme descrito na Opcao 1 (passos 6 e 7).
Custo adicional
O numero virtual custa R$34,90/mes, cobrado separadamente da assinatura do agente. Exemplo: Starter (R$147) + WhatsApp (R$34,90) = R$181,90/mes. Cancelamento a qualquer momento sem afetar o agente.
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 (@bot). Voce pode desativar esse comportamento no toggle "Precisa marcar o agente?" para que ele responda a todas as mensagens.
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) — Bot 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 |
|---|---|
| Bot nao responde | Verifique se o numero esta na allowlist |
| QR Code nao aparece | Bot 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 | Bot 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 (chip pre-pago ou virtual Salvy).
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?
Se voce tem um numero Salvy, ele e cancelado automaticamente. Se voce usa numero proprio, basta desconectar o dispositivo no WhatsApp Business.
Quanto custa o WhatsApp?
Numero proprio: Gratis (incluso em todos os planos). Voce so precisa ter um chip dedicado.
Numero virtual Salvy: R$34,90/mes, cobrado separadamente. Cancelamento a qualquer momento.
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.
