Conectar WhatsApp Web por pareamento de QR

Conversa Labs

Conversa Labs

Última atualização em Jun 27, 2026

Visão geral

O canal WhatsApp Web conecta um número de WhatsApp sem usar a API oficial da Meta: você pareia o número lendo um QR code com o aplicativo do celular, exatamente como faz no WhatsApp Web do navegador. É a forma mais rápida de começar a atender pelo WhatsApp, ideal para números pessoais ou de pequenas operações que ainda não têm uma conta oficial (Cloud API).

Depois de pareado, todas as mensagens recebidas e enviadas passam a aparecer nas conversas da plataforma, com mídia, recibos de entrega/leitura e respostas em tempo real.

Pré-requisitos

  • Perfil de administrador para criar a caixa de entrada.
  • Um celular com o WhatsApp instalado e o número que será conectado.
  • O canal WhatsApp Web depende de um serviço de conexão habilitado para a sua conta (provisionado pela operação). Se você não vê esse tipo de canal, fale com o responsável.
  • O celular precisa de internet para manter a sessão ativa (como no WhatsApp Web do navegador).

Passo a passo

  1. Em Configurações → Caixas de Entrada, crie uma nova caixa e escolha WhatsApp.
  2. Selecione o provedor WhatsApp Web (pareamento por QR).
  3. Dê um nome à caixa de entrada (ex.: "WhatsApp Vendas").
  4. A plataforma exibe um QR code na tela de configuração.
  5. No celular, abra o WhatsApp → Aparelhos conectadosConectar um aparelho e aponte a câmera para o QR.
  6. Aguarde a confirmação de pareamento — o número real é detectado automaticamente e a caixa entra no estado conectado.
  7. Defina os agentes/equipes e conclua. Envie uma mensagem de teste para validar.

Configurações & opções

  • Estados de conexão: a caixa de entrada mostra o estado atual da sessão:
    • Aguardando pareamento: o QR foi gerado e está esperando a leitura.
    • Conectado: a sessão está ativa e o número atende normalmente.
    • Desconectado: a sessão caiu temporariamente (sem internet no celular, por exemplo); reconecta sozinha quando possível.
    • Desconectado da conta (logout): o aparelho foi removido no celular; é preciso parear novamente lendo um novo QR.
  • Reparear: se a sessão expirar ou for desconectada, gere um novo QR na tela da caixa de entrada e repita a leitura.
  • Mídia: imagens, vídeos, áudios, documentos, figurinhas, localização e contatos são suportados.

Casos de uso

  • Começar a atender por WhatsApp em minutos, sem processo de aprovação da Meta.
  • Conectar um número pessoal ou de equipe pequena que ainda não é uma conta oficial.
  • Operar enquanto a conta oficial (Cloud API) está em processo de verificação.

Dicas, limites e boas práticas

  • Anti-ban: respeite os limites do WhatsApp. Evitar disparos em massa, mensagens idênticas repetidas e adicionar muitos contatos novos de uma vez reduz o risco de bloqueio. A plataforma aplica um controle de envio (throttle) por número para suavizar picos.
  • Mantenha o celular conectado à internet; se ele ficar offline por muito tempo, a sessão cai.
  • Recursos interativos avançados (botões, listas) podem exigir licença específica do serviço de conexão.
  • Para volume alto e selo verde oficial, considere migrar para o WhatsApp Cloud.

Solução de problemas

  • O QR não é lido: gere um novo QR (ele expira) e tente de novo com boa iluminação.
  • Caí para "desconectado": verifique a internet do celular; a sessão deve voltar sozinha.
  • Estado "logout": o aparelho foi removido no celular — faça o pareamento novamente.
  • Mensagens não chegam: confirme que a caixa está conectada e que o número não foi bloqueado pelo WhatsApp.

Veja também