Passo a passo pra conectar um número de WhatsApp Web ao Codewo via QR code. É a via mais rápida pra começar a atender, com as limitações de ser uma conexão não-oficial.
Quando usar
Use WhatsApp Web quando:
- Você ainda não tem Business Manager configurado e quer atender já.
- O número é pessoal ou compartilhado entre funcionários.
- Volume é baixo a médio, sem campanhas em massa.
- Você está validando o produto antes de investir no setup oficial.
Pra qualquer operação séria com volume, ver WhatsApp Cloud setup completo.
Como funciona
Codewo abre uma "sessão" do WhatsApp Web no servidor e gera um QR code. Você escaneia com o celular do número (mesmo processo do WhatsApp Web do navegador). A partir daí, mensagens entram e saem pelo Codewo.
Passo a passo
Em Configurações → Canais → Novo canal → WhatsApp Web:
- Dê um nome ao canal — Ex: "WhatsApp Atendimento". Esse nome é interno.
- Clique em "Gerar QR Code" — O Codewo cria uma sessão temporária e mostra o QR.
- Abra o WhatsApp no celular do número que você vai conectar → Configurações → Aparelhos conectados → Conectar um aparelho.
- Escaneie o QR code na tela do Codewo com a câmera do celular.
- Aguarde a confirmação — Em alguns segundos, o status muda pra "Conectado". Pronto.
- Defina a equipe que vai receber as conversas e salve o canal.
Pegadinhas comuns
- QR code expira em ~30 segundos. Se você demorar pra escanear, ele invalida. Clique em "Gerar novo QR" e tente de novo.
- Sessão pode cair. Periodicamente (reinício do celular, perda de internet, atualização do WhatsApp), a sessão derruba. Você precisa reescanear o QR — recomendamos manter alerta de notificação ligado pra perceber rápido.
- Banimento é silencioso. Se a Meta considerar uso abusivo (muita mensagem em massa, conta reportada), banem o número. O Codewo não recebe aviso prévio — você simplesmente para de receber mensagens. Se isso acontecer, primeiro tente reconectar; se o celular do número avisar "banido", não há recurso oficial.
- Sem CTWA, sem HSM, sem broadcast oficial. Anúncios Click-to-WhatsApp não passam dados de atribuição por essa via. Templates HSM não funcionam. Broadcast em massa pelo WA Web é o tipo de uso que mais aumenta risco de ban.
- Sessão temporária fica órfã se você fechar o navegador no meio do setup. Não é fatal, mas acumula no backend. Se você abandonar o setup e tentar de novo, clique em "Cancelar e recomeçar" pra limpar.
- Funciona com WhatsApp comum E WhatsApp Business app. Não precisa converter o número.
Quando perceber que precisa migrar pra Cloud
- Volume passou de ~100 conversas/mês.
- Você quer rodar anúncios CTWA do Meta Ads.
- Você precisa mandar broadcast em massa (notificações de pedido, marketing).
- Sua operação tem requisito de compliance (banco, saúde, jurídico).
- Você está cansado de reescanear QR.
Boas práticas
- Mantenha o celular do número ligado e conectado à internet — Se o celular desligar, a sessão cai.
- Não use o mesmo número no WhatsApp Web do navegador ao mesmo tempo. Sessões competem. Se você vai usar via Codewo, saia das outras sessões.
- Evite envios em massa pelo Web. É o caminho mais rápido pra ban.
- Tenha um plano B. Se o número for crítico pra operação, configure um número Cloud paralelo pra usar quando o Web cair.