Conectar o WhatsApp Web pela conexão do celular: passo a passo

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.

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.
• 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:

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
• Conectar WhatsApp Web por pareamento de QR
• Proxies gerenciados para caixas WhatsApp Web
• Configurações de inbox