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
- Em Configurações → Caixas de Entrada, crie uma nova caixa e escolha WhatsApp.
- Selecione o provedor WhatsApp Web (pareamento por QR).
- Dê um nome à caixa de entrada (ex.: "WhatsApp Vendas").
- A plataforma exibe um QR code na tela de configuração.
- No celular, abra o WhatsApp → Aparelhos conectados → Conectar um aparelho e aponte a câmera para o QR.
- Aguarde a confirmação de pareamento — o número real é detectado automaticamente e a caixa entra no estado conectado.
- 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): a sessão foi encerrada. A caixa informa a causa — desconectado por outro aparelho (o caso normal quando a Coexistência é ativada nesse número), o aparelho principal foi desconectado (troca de celular ou bloqueio do número) ou desconectado por motivo desconhecido. Nos três casos a correção é a mesma: pareie novamente lendo um novo QR na tela de conexão da caixa — e nada se perde.
- Reparear: se a sessão expirar ou for desconectada, gere um novo QR na tela da caixa de entrada e repita a leitura.
- Rotas de saída opcionais: proxy gerenciado e conexão pelo próprio aparelho só aparecem na aba Conexão quando o recurso correspondente está habilitado para a conta. Se nenhum estiver habilitado, a caixa usa a saída do servidor e a tela não mostra controles de rota inativos.
- Atividade em tempo real: o painel mostra quando o contato está digitando ou gravando um áudio. Em grupos, aparece o nome do participante que está realizando a ação.
- Mídia: imagens, vídeos, áudios, documentos e outros arquivos podem ter até 100 MB no WhatsApp Web. Esse limite é próprio da conexão por aparelho e não altera os limites do WhatsApp Cloud. Notas privadas continuam seguindo o limite geral de anexos da instalação.
- Sincronização de histórico: depois de parear ou reconectar, lotes grandes são importados em segundo plano, de forma incremental. Você pode continuar atendendo enquanto o histórico aparece.
- Contatos de grupos (aba Recursos): duas opções independentes controlam isso — Sincronizar contatos (importa a lista de membros; desativado por padrão) e Criar contatos para quem envia mensagem em grupos/comunidades (ativado por padrão). Para não ter nenhum participante na sua lista de contatos, desmarque as duas. Detalhes — e a lista de ignorados por caixa — em Lista de ignorados e sincronização de contatos.
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
- “Nenhum serviço de WhatsApp Web está disponível”: nenhuma instância de conexão ativa e online está disponível para criar a caixa. Não é um problema do número nem da escolha de proxy; peça ao operador da plataforma para verificar os gateways e tente novamente depois.
- “As credenciais do serviço de WhatsApp Web são inválidas”: a credencial operacional do gateway foi recusada. O operador da plataforma precisa corrigi-la; o administrador da conta não deve trocar o número ou recriar a caixa para contornar o erro.
- 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.
- Ficou em "logout" logo depois de ativar a Coexistência (Cloud) nesse número: é o comportamento esperado — a ativação da Coexistência desconecta todos os aparelhos conectados do WhatsApp Business. Gere um novo QR na tela de conexão da caixa e pareie novamente. Nada se perde: a mesma caixa é reaproveitada — número, conversas, contatos e histórico permanecem.
- A caixa pareou, mas nada chega: o número pode ter ficado preso em um número provisório (placeholder) porque outra caixa já usa esse número — na mesma conta (mesmo provedor) ou em outra conta. A tela de pareamento mostra o motivo. Libere ou remova a caixa que retém o número e pareie de novo.
- Mensagens não chegam: confirme que a caixa está conectada e que o número não foi bloqueado pelo WhatsApp.
- O histórico ainda está incompleto após reconectar: aguarde o processamento em segundo plano; contas movimentadas podem chegar em vários lotes. Não repareie durante a importação.