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
-
Escolha da conexão na criação: selecione Sem proxy (conexão direta), Proxy de conexão gerenciado ou Usar meu celular. A rota direta está disponível mesmo sem provedores; a rota de proxy exige capacidade e o celular exige um aparelho configurado. Se um proxy foi escolhido e ficou indisponível, a criação informa a falha e não troca para conexão direta.
-
Recursos antes e depois de criar: o assistente e a aba Recursos exibem os mesmos controles de grupos, canais, recebimento e publicação de Status, presença, histórico e mídia, contatos e rejeição de chamadas. Receber Status e publicar Status são opções independentes. Os valores iniciais vêm dos padrões da plataforma; as escolhas visíveis são aplicadas à nova caixa. Restaurar padrões da plataforma desfaz as edições do assistente. Alterações na aba Recursos exigem Salvar alterações e permanecem após recarregar a página.
-
Respostas e reações ao seu Status: quando um contato responde ou reage a um Status publicado por você — pelo compositor, por uma transmissão do Hub ou pelo próprio celular — a mensagem aparece na conversa do contato com o cartão Você · Status, mostrando a legenda e a miniatura do Status original, mesmo que o WhatsApp não envie a miniatura junto com a resposta. Os Status publicados ficam registrados por caixa de entrada com a mídia enviada, e continuam consultáveis depois das 24 horas em que o WhatsApp os exibe. Nenhum contato ou conversa é criado para o próprio Status.
-
Desconectar: pausa a conexão e mantém o aparelho vinculado. A confirmação permite cancelar sem alterar a sessão; depois você pode reconectar. Se a solicitação falhar, a tela informa o erro e permite tentar novamente.
-
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: gere um novo QR quando a tela de Conexão confirmar que um novo pareamento é necessário. Uma observação de estado ausente, vencida ou inválida não prova que a sessão expirou ou caiu. O pedido de reconexão pode falhar e só uma nova confirmação conectada mostra que a sessão voltou.
-
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.
Estado da sessão na conversa
Ao abrir ou atualizar uma conversa desta caixa Web — inclusive quando ela é o membro Web de um par híbrido — a plataforma lê a última observação disponível. O aviso aparece nessa abertura ou atualização; não há promessa de alerta imediato por uma sonda nem de acompanhamento contínuo de uma aba já aberta.
Somente uma observação fresca que confirma a sessão fora mostra “WhatsApp Web sem sessão desde {data e hora}”, no fuso da conta. Se o episódio começou em outro dia, a data acompanha a hora. Enquanto a indisponibilidade estiver confirmada, mensagens que exigem Web não serão enviadas. Isso não informa a entrega anterior, não reenvia mensagem e não confirma fallback ou retry em outro transporte.
Uma observação ausente, vencida, inválida ou indisponível é estado desconhecido, não uma desconexão. Quem atende vê o contexto e procura um administrador; não recrie a caixa, não apague histórico nem faça logout para resolver esse estado. Quando o perfil tiver permissão, o administrador abre a Conexão existente da caixa. Pedir reconexão pode falhar; só uma nova confirmação conectada remove o aviso.
Um e-mail administrativo, quando enviado sobre uma indisponibilidade conhecida, não prova recuperação, entrega de mensagem nem atualização da conversa já aberta.
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.
Produtos, pedidos e pagamentos na conversa
As mensagens comerciais do WhatsApp aparecem com o tipo de cartão, itens, quantidades e valores disponíveis. Atualizações de pedido e pagamento têm estados separados. “Pagamento informado” reproduz o que o remetente declarou na mensagem; não executa uma transferência nem concilia uma cobrança.
Use Ver detalhes para consultar a referência, os ajustes e as instruções incluídas naquela mensagem. Uma atualização sem valor não recebe um total presumido de outra mensagem. As respostas citadas identificam o pedido ou a cobrança, e as miniaturas ficam compactas para não ampliar imagens de baixa resolução.