## 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 conectados** → **Conectar 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)**: 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](/hc/ajuda/articles/inboxes-channels-whatsapp-web-lista-ignorados-pt-br).

## 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.

## Veja também

- [WhatsApp Cloud com Embedded Signup](/hc/ajuda/articles/inboxes-channels-whatsapp-cloud-embedded-signup-pt-br)
- [Caixa híbrida do WhatsApp: Coexistência (Cloud) + WhatsApp Web](/hc/ajuda/articles/inboxes-channels-whatsapp-hybrid-inbox-pt-br)
- [WhatsApp Hub: grupos, comunidades, canais e status](/hc/ajuda/articles/inboxes-channels-whatsapp-hub-grupos-comunidades-canais-status-pt-br)
- [Configurações de inbox](/hc/ajuda/articles/inboxes-channels-configuracoes-de-inbox-pt-br)
- [Visão geral de caixas de entrada e canais](/hc/ajuda/articles/inboxes-channels-overview-pt-br)