## Visão geral

Este é o guia de execução da **conexão pelo celular** do WhatsApp Web: o caminho inteiro, na ordem
em que ele acontece de verdade, para quem nunca fez. Se você quer entender antes o que o recurso é,
o que ele promete e o que ele não faz, leia
[Usar a conexão do celular no WhatsApp Web](/hc/ajuda/articles/inboxes-channels-whatsapp-mobile-egress-pt-br).

O trabalho tem duas metades, e elas costumam ser de pessoas diferentes:

1. **Preparar a conexão de rede** — uma vez por conta. É quem tem a conta Tailscale: um
   administrador desta conta, ou o operador da plataforma quando a rede é compartilhada por ele.
2. **Cadastrar o celular e direcionar a caixa** — sempre um administrador desta conta, com o
   telefone na mão.

Este recurso está em **piloto fechado de desenvolvimento** e vem desligado por padrão. Ele não tem
SLA e não está liberado para produção.

> Existem dois QR codes diferentes neste fluxo. O primeiro coloca o **celular** na rede. O segundo
> pareia a **sessão do WhatsApp** em Aparelhos conectados. Um não substitui o outro.

## Pré-requisitos

Confira esta lista **antes** de abrir o assistente. Cada item abaixo já derrubou um cadastro inteiro
três telas depois do erro real — conferir agora custa dois minutos.

- **Token de acesso pessoal da Tailscale — obrigatório, não opcional.** A Tailscale não publica
  nenhum escopo OAuth que cubra convites. Um cliente OAuth sozinho lê aparelhos e cria chaves de
  rota, mas **nunca** consegue convidar um celular. Sem o token, a conexão pode ser salva, o teste
  pode passar em parte, e o cadastro do celular falha depois. O token expira em **90 dias** e
  precisa ser trocado antes disso.
- **O campo "Rede (tailnet)" quer o Tailnet ID, não o nome de exibição.** O Tailnet ID é o
  identificador que a Tailscale usa para chamadas de API. O nome de exibição costuma funcionar, mas
  tem caracteres fáceis de digitar errado — quando a tela diz que a rede não existe, é quase sempre
  isto.
- **A tag precisa estar autorizada no policy file.** O assistente mostra um trecho pronto para colar
  na seção `tagOwners`. Sem essa autorização, as chaves que colocam a conta na rede são recusadas, e
  a falha aparece longe desta tela.
- **O plano precisa permitir as pessoas que entram na rede.** O plano Personal é gratuito, mas
  permitido apenas para uso não comercial. Uso comercial começa em plano pago, cobrado por pessoa
  que entra na rede — **uma pessoa por celular cadastrado**.
- **O celular precisa estar compartilhando a saída.** Instalar o aplicativo e entrar **não basta**:
  "Run as exit node" é um botão separado, desligado por padrão. Enquanto ele estiver desligado, o
  aparelho aparece na rede e a tela fica esperando indefinidamente.
- Perfil de **administrador da conta** para criar ou reconfigurar uma caixa WhatsApp Web.
- O piloto **Conexão pelo celular** habilitado para esta conta pelo operador da plataforma.
- Android ou iPhone com o [aplicativo oficial do Tailscale](https://tailscale.com/download).
- Acesso ao e-mail que será usado para entrar no Tailscale no celular.
- Wi-Fi ou dados móveis estáveis, e de preferência o aparelho na energia.

Onde pegar cada valor:

| Campo do assistente | Onde está na Tailscale |
|---|---|
| Rede (tailnet) | Settings → **General** → **Tailnet ID** |
| ID e segredo do cliente OAuth | Settings → **Trust credentials** (a página que já se chamou "OAuth clients") |
| Token de acesso pessoal | Settings → **Keys** |
| Trecho da tag | copiado do próprio assistente e colado no **policy file**, seção `tagOwners` |

Ao criar o cliente OAuth, conceda **apenas** `devices:core`, `devices:routes` e `auth_keys`, e
selecione a tag que o assistente mostra. Não conceda `users`: nada aqui usa esse escopo, e ele
inclui exclusão de usuário.

## Passo a passo

### 1. Prepare a conexão de rede (uma vez por conta)

1. Acesse **Configurações → Caixas de entrada → Adicionar caixa → WhatsApp Web** e escolha
   **Usar meu celular** como origem da conexão.
2. Se nenhuma rede estiver pronta, o assistente abre **Conecte a sua própria conta de rede**, com
   três passos e tudo pronto para copiar. Se o operador já fornece a rede, este bloco aparece como
   gerenciado e você pode pular direto para o passo 9.
3. **Crie uma conta no Tailscale**, se ainda não tiver.
4. **Adicione a tag ao seu policy file**: copie o trecho mostrado e cole na seção `tagOwners`.
5. **Crie um cliente OAuth** com os três escopos listados acima e selecione a tag.
6. **Gere o token de acesso pessoal** em Settings → Keys.
7. Preencha **Rede (tailnet)**, **ID do cliente OAuth**, **Segredo do cliente OAuth** e
   **Token de acesso pessoal**, e clique em **Salvar conexão**. As credenciais ficam guardadas
   criptografadas; deixar um campo em branco mantém o valor atual.

### 2. Teste a conexão antes de seguir

8. Clique em **Testar conexão**. O teste não se limita mais a contar aparelhos: ele exercita as três
   capacidades de que o cadastro depende, e mostra o resultado de cada uma em
   **O que este cadastro consegue fazer**.

   | Capacidade | O que o teste faz | Se falhar |
   |---|---|---|
   | Ler os aparelhos da rede | lista os aparelhos do tailnet | confira o Tailnet ID e as credenciais |
   | Convidar um celular | cria um convite descartável e **revoga em seguida** | quase sempre é o token de acesso pessoal faltando |
   | Criar a chave de rota | cria uma chave que vale 60 segundos e **revoga em seguida** | confira o escopo `auth_keys` e a tag no policy file |

   O teste não para na primeira falha: ele mostra o quadro inteiro de uma vez, com a data da última
   verificação. Uma capacidade reprovada não impede salvar a conexão — mas o cadastro do celular vai
   parar exatamente nela. Resolva antes de chamar alguém com o telefone na mão.

### 3. Cadastre o celular

9. Leia e aceite as quatro confirmações sobre rede, bateria e dados, isolamento do IP e limitação de
   chamadas. Elas são obrigatórias para continuar.
10. Informe o **e-mail que será usado no celular** e clique em **Criar link temporário**.
11. No telefone, leia o QR code ou abra o link. Ele é exibido **uma única vez**, expira em cinco
    minutos e não deve ser compartilhado.
12. Instale ou abra o Tailscale, entre com **exatamente** aquele e-mail e aceite entrar na rede.
13. No aplicativo, abra **Exit Node** e toque em **Run as exit node**. Se aparecer "Disabled" ao
    lado, esse é o estado atual — tocar é o que liga. Os cinco minutos valem para **abrir o link**:
    depois que o aparelho entra na rede, o prazo aumenta e você tem tempo de achar esse botão com
    calma.
14. Volte ao assistente e aguarde **Celular conectado**. Se mais de um aparelho aparecer, escolha
    explicitamente o que você acabou de cadastrar, comparando nome e plataforma.

> **Caminho mais curto.** Se o celular já está na sua rede, ligue **Run as exit node** *antes* de
> criar o link. O assistente reconhece o aparelho que já anuncia o compartilhamento e o cadastra
> direto, sem relógio correndo.

### 4. Direcione a caixa

15. Em **Seus celulares**, use **Usar nesta caixa** no aparelho escolhido e conclua a criação do
    canal.
16. Quando aparecer o QR do WhatsApp, abra **WhatsApp → Aparelhos conectados → Conectar um
    aparelho** e faça o pareamento normal.
17. Em uma caixa que já existe, o caminho é **Configurações → Caixas de entrada → a sua caixa →
    Conexão → Trocar rota**, e depois **Sair por este celular**.

## Configurações & opções

- **Se o aparelho ficar indisponível**: o padrão é **Segurar as mensagens até o aparelho voltar**. A
  alternativa, **Continuar enviando pela saída padrão**, mantém a caixa funcionando, mas o WhatsApp
  passa a ver a sessão saindo de outro IP enquanto o celular estiver fora — o que aumenta o risco
  para o número.
- **Uma caixa por celular**: é o limite seguro do piloto. O aparelho fica reservado enquanto a caixa
  mantiver uma rota ativa.
- **Pausar / Retomar / Remover** um aparelho: em **Seus celulares**. Uma rota ativa precisa ser
  liberada antes; remover exige cadastrar o celular de novo para voltar a usá-lo.
- **Trocar de celular**: **Trocar rota → Trocar para este celular**. A rota anterior continua valendo
  até a nova ser aplicada.
- **Verificar saída**: mostra o IP pelo qual a caixa está saindo agora. Se o gateway for antigo
  demais para responder, a tela diz isso em vez de inventar um resultado.

### Tirar a caixa do celular

Agora dá para **remover a rota pelo celular** e devolver a caixa ao proxy gerenciado ou à saída
direta do servidor — sem criar caixa nova e sem parear o número de novo, como era necessário antes.
Faça isso em **Conexão → Trocar rota**, escolhendo o proxy gerenciado. Antes de confirmar, entenda o
que muda:

- **O outro lado passa a ver outro IP.** A partir da conexão seguinte, a sessão sai pelo proxy que a
  caixa já tinha configurado ou, se não houver nenhum, direto pela internet do servidor. Para o
  WhatsApp, isso é uma mudança de origem — e mudança de origem pesa na avaliação de um número. É por
  isso que a remoção é sempre uma decisão explícita e confirmada, nunca automática e nunca um
  fallback: se o celular cair, a política de retenção continua segurando as mensagens, e a
  plataforma não troca a rota sozinha.
- **A caixa reconecta.** O que é removido é o caminho de rede, não a sessão do WhatsApp: uma caixa
  saudável e já pareada continua pareada. Se a caixa estava presa esperando um QR, o código antigo
  deixa de valer e um novo aparece — leia o novo. Uma caixa que você mesmo tinha desligado continua
  desligada.
- **Repetir é seguro.** Se você mandar remover duas vezes, a segunda apenas informa que já não havia
  rota nenhuma. Se a rede não responder no meio do caminho, tente de novo: a operação foi feita para
  ser repetida sem estragar nada.

## Casos de uso

- Colocar no ar a primeira caixa pelo celular sem descobrir os pré-requisitos um a um, na tentativa e
  erro.
- Validar uma rota residencial real usando a conexão do próprio responsável pelo número.
- Trocar o aparelho que atende uma caixa quando o celular original vai ficar fora do ar.
- Devolver uma caixa ao proxy gerenciado depois do teste, de forma consciente, sabendo que o IP visto
  pelo WhatsApp muda.

## Dicas, limites e boas práticas

- **Anote a validade do token de acesso pessoal.** São 90 dias. Quando ele vence, ler a rede continua
  funcionando e convidar um celular para de funcionar — o sintoma aparece só no próximo cadastro.
- **Teste a conexão sempre que trocar qualquer credencial.** É o único lugar que responde "isto aqui
  consegue convidar" antes de você chamar a pessoa com o telefone.
- Mantenha o Tailscale conectado, autorizado a trabalhar em segundo plano e fora da otimização
  agressiva de bateria.
- O tráfego consome o plano de dados do aparelho. Confira franquia, roaming e políticas da operadora.
- O IP público pode mudar ao alternar entre Wi-Fi e dados móveis, por CGNAT ou por decisão da
  operadora.
- **O fornecedor avisa que celular como nó de saída não é performático**: o roteamento acontece em
  espaço de usuário, sem otimização de kernel. Meça antes de prometer desempenho.
- **Chamadas de voz e vídeo não passam por esta rota** e ficam bloqueadas neste modo.
- Não use a rede de outra conta e não compartilhe o link temporário de cadastro.
- O recurso não evita bloqueios do WhatsApp nem transforma a conexão Web em uma API oficial da Meta.

## Solução de problemas

Cada item abaixo começa pela frase que aparece na tela.

- **"A conexão pelo celular não está habilitada"** — o piloto está desligado para esta conta. Fale
  com o operador da plataforma; não há nada a corrigir no cadastro.
- **"Seu perfil não pode gerenciar a conexão pelo celular"** — a tela precisa de um administrador
  desta conta.
- **"A conexão pelo celular ainda não foi configurada"** — nenhuma rede está conectada. Faça a etapa
  1 deste guia ou peça ao operador para liberar a rede compartilhada.
- **"O cadastro não tem permissão para convidar celulares"** — as credenciais leem a rede sem
  problema, mas nenhum escopo OAuth cobre convites. Salve um **token de acesso pessoal** neste
  cadastro e teste de novo. É o único erro cujo remédio é exatamente esse.
- **"A rede informada não existe"** — nenhuma rede responde pelo nome salvo. Use o **Tailnet ID** de
  Settings → General, não o nome de exibição.
- **"As credenciais da rede não foram aceitas"** — a troca de credenciais não devolveu autorização
  nenhuma, o que costuma significar ID ou segredo do cliente OAuth errado. Refaça a etapa 1; se
  persistir, o operador tem a resposta completa no log.
- **"O convite não foi criado"** — a rede aceitou o pedido e não devolveu convite. Nenhum celular foi
  cadastrado e nada ficou pendurado: tente novamente.
- **"O convite veio sem o link"** — o convite existe na rede, mas o link de uso único não veio junto
  e não dá para recuperá-lo. Cancele e crie outro link.
- **"Não foi possível ler a lista de aparelhos"** — a rede devolveu a lista num formato que a tela
  não sabe interpretar. Não há o que corrigir no cadastro; o operador tem a resposta completa no log.
- **"O celular ainda não está compartilhando a conexão"** — falta ligar **Run as exit node** no
  aplicativo, no próprio telefone. Ligue e toque em **Verificar conexão**, ou espere a verificação
  automática.
- **"A chave de rota não foi emitida"** — sem essa chave a caixa não entra na rede. Tente novamente;
  se repetir, confira se o cliente OAuth tem o escopo `auth_keys` e se a tag está autorizada no
  policy file.
- **"O celular escolhido não está mais lá"** — o aparelho saiu da rede entre ser escolhido e ser
  gravado. Nada foi registrado: atualize a lista e escolha de novo.
- **"Não houve tempo suficiente para concluir"** — a plataforma parou antes de iniciar uma etapa que
  não daria para terminar com segurança, justamente para não deixar nada pela metade. Tente
  novamente; se acontecer sempre, avise o operador.
- **"Não foi possível ler a resposta da rede"** — a rede respondeu algo ilegível. O cadastro não está
  errado; o operador tem o status e o corpo da resposta no log.
- **"Não conseguimos identificar a causa"** — a tela recebeu uma falha que não reconhece e por isso
  não sabe dizer o que mudar. Envie ao operador o horário aproximado da tentativa.
- **"O link temporário expirou"** — crie outro e abra no celular em até cinco minutos. Se o aparelho
  já estiver na rede, ligue o compartilhamento antes de criar o link.
- **"O link de uso único já foi entregue"** — por segurança ele não é exibido duas vezes. Se o celular
  não chegou a abri-lo, cancele o cadastro e crie outro link.
- **"Aguardando o celular entrar"** que não sai do lugar — o aparelho só aparece se você entrou no
  aplicativo com exatamente o e-mail informado. Entrou com outro? Cancele o link e crie um novo com o
  e-mail certo.
- **A caixa ficou retida ou offline** — mantenha o telefone online, confirme o Tailscale e o
  compartilhamento de saída, e atualize os aparelhos. Com a política de retenção, a plataforma não
  usa a saída direta enquanto o celular estiver indisponível.
- **Não consigo pausar ou remover o aparelho** — libere primeiro a caixa que ainda usa a rota ativa
  desse celular.
- **Quero voltar ao proxy gerenciado** — dá para fazer: veja "Tirar a caixa do celular", acima, e
  confirme sabendo que o IP visto pelo WhatsApp muda.

## Veja também

- [Usar a conexão do celular no WhatsApp Web](/hc/ajuda/articles/inboxes-channels-whatsapp-mobile-egress-pt-br)
- [Conectar WhatsApp Web por pareamento de QR](/hc/ajuda/articles/inboxes-channels-whatsapp-web-wazmeow-pt-br)
- [Proxies gerenciados para caixas WhatsApp Web](/hc/ajuda/articles/inboxes-channels-whatsapp-web-proxy-global-pt-br)
- [Configurações de inbox](/hc/ajuda/articles/inboxes-channels-configuracoes-de-inbox-pt-br)