API do WhatsApp precisa do celular ligado? Como funciona a conexão por aparelho conectado

Não: na API não oficial do WhatsApp, o celular não precisa ficar ligado nem com internet. Depois de conectado por QR Code ou código de pareamento, o número roda na instância como um aparelho conectado independente, igual ao WhatsApp Web ou ao app de desktop. O celular só precisa ser aberto de vez em quando, porque o próprio WhatsApp desconecta aparelhos conectados quando o principal fica muito tempo sem uso.

É uma das dúvidas mais comuns de quem vai integrar WhatsApp, e faz sentido: há alguns anos, o WhatsApp Web realmente dependia do celular online. Isso mudou com o modelo de múltiplos aparelhos, e entender como ele funciona evita muita desconexão misteriosa.

Antes: o WhatsApp Web era um espelho

No modelo antigo, o WhatsApp Web não tinha vida própria. Ele espelhava o celular: cada mensagem enviada pelo navegador passava pelo telefone, que precisava estar ligado e conectado. Bateria acabou, celular sem sinal, e o WhatsApp Web parava.

Qualquer automação construída nesse modelo herdava o problema. Era comum ver celulares ligados na tomada, presos numa gaveta do escritório, só para manter o sistema de pé.

Hoje: cada aparelho conectado é independente

Com o modelo de múltiplos aparelhos, cada aparelho conectado passou a ter suas próprias chaves de criptografia e a falar direto com os servidores do WhatsApp. O celular continua sendo o aparelho principal — é por ele que você autoriza a conexão —, mas depois disso ele não precisa estar online para os outros funcionarem.

A instância da API não oficial é exatamente isso: um aparelho conectado. Quando você conecta:

# Gera o QR Code (escaneie em Aparelhos conectados)
curl -X POST "https://us.api-wa.me/SUA_KEY/instance"

# Ou, sem QR, pede um código de pareamento
curl -X POST "https://us.api-wa.me/SUA_KEY/instance/pairing-code" \
  -H "Content-Type: application/json" \
  -d '{ "phoneNumber": "5511999999999" }'

…o celular autoriza a entrada de um novo aparelho, e a partir daí a instância envia e recebe sozinha, hospedada na infraestrutura da WAME. O passo a passo das formas de conectar está em conectar sem QR Code: código de pareamento e Passkey.

A camada não oficial da WAME não é afiliada, endossada ou suportada pelo WhatsApp ou pela Meta. O uso é de responsabilidade de quem envia.

O que o celular continua fazendo

Mesmo sem precisar estar ligado, o celular principal ainda tem papel:

• Ele autoriza e remove aparelhos. Em Aparelhos conectados, qualquer pessoa com o celular na mão pode desconectar a instância com um toque.
• Ele mantém a conta ativa. O WhatsApp desconecta os aparelhos conectados se o principal ficar tempo demais sem abrir o app. A ajuda do WhatsApp fala em um período prolongado, hoje em torno de 14 dias — como a regra é deles, trate como referência e não como garantia.
• Ele continua sendo um canal de atendimento. Você pode responder pelo celular enquanto a API automatiza; as mensagens aparecem nos dois lados. Como organizar isso está em usar o celular e a API no mesmo número.

Na prática: o celular pode ficar desligado no fim de semana, sem problema. Esquecido numa gaveta por um mês, não.

Por que uma instância desconecta

Quando a conexão cai, quase sempre é uma destas causas:

1. Alguém removeu o aparelho no celular. Um funcionário "limpando" os aparelhos conectados, ou o dono do número achando estranho aquele dispositivo na lista.
2. O WhatsApp foi reinstalado ou o número mudou de aparelho. A troca de celular principal invalida os aparelhos conectados antigos.
3. O celular principal ficou tempo demais sem abrir o WhatsApp.
4. A conta sofreu restrição. Nesse caso a desconexão é consequência, não causa — e insistir em reconectar e voltar a enviar piora a situação.
5. Instabilidade temporária. Quedas curtas acontecem e a instância reconecta sozinha, com espera crescente e variação aleatória entre tentativas, para não virar uma rajada de reconexões.

As quatro primeiras exigem ação sua; a quinta, não.

Como monitorar a conexão

Não espere o cliente avisar que o bot parou. Configure o webhook de conexão:

curl -X PUT "https://us.api-wa.me/SUA_KEY/instance" \
  -H "Content-Type: application/json" \
  -d '{
    "allowWebhook": true,
    "allowNumber": "all",
    "webhookConnection": "https://seu-servidor.com/webhook/conexao",
    "webhookFormat": "meta"
  }'

Toda mudança de estado chega com field: "connection" e, em value.connection, o status, o code e o reason. Um tratamento mínimo:

app.post('/webhook/conexao', (req, res) => {
  res.sendStatus(200);

  const change = req.body?.entry?.[0]?.changes?.[0];
  if (change?.field === 'connection') {
    const { status, code, reason } = change.value.connection;
    if (status !== 'open') {
      avisarEquipe(`WhatsApp desconectado: ${status} (${code ?? '-'}) ${reason ?? ''}`);
    }
  }

  if (change?.field === 'health') {
    const saude = change.value.health;
    if (saude.should_pause) pausarFilaDeEnvio(saude.reason);
  }
});

O segundo bloco é importante. Além da conexão, a WAME acompanha a saúde do número e, quando ela muda — degradada, restrita, deslogada —, manda um evento health para o mesmo webhook, com um indicador de que é hora de pausar. Quem pausa é você: pare a fila nesse momento, em vez de insistir. Os sinais que antecedem uma restrição estão em 7 sinais de que o número está em risco.

Para conferir o estado sob demanda — num painel ou num health check —, use:

curl "https://us.api-wa.me/SUA_KEY/instance"

O que fazer quando cai

Depende da causa:

• Instabilidade ou instância travada: reinicie. O restart funciona mesmo que a instância não esteja carregada e, se a sessão continua válida, dispensa ler o QR Code de novo.

curl -X POST "https://us.api-wa.me/SUA_KEY/instance/restart"

• Aparelho removido, WhatsApp reinstalado ou celular inativo: a sessão não volta sozinha. Gere um novo QR Code ou código de pareamento e conecte de novo.
• Restrição da conta: pare os envios. Reconectar e retomar a fila como se nada tivesse acontecido é o caminho mais curto de uma restrição temporária para um bloqueio. O que fazer está em número bloqueado: o que fazer agora.

Uma rotina simples que evita a maioria das quedas

• Defina quem guarda o celular principal do número e combine que ninguém remove aparelhos conectados sem avisar.
• Abra o WhatsApp no celular pelo menos uma vez por semana.
• Não troque de aparelho nem reinstale o app sem planejar a reconexão.
• Mantenha o webhook de conexão apontando para algo que avisa uma pessoa de verdade — e-mail, Slack, o próprio WhatsApp de outro número.

E se eu não quiser celular nenhum?

Existe a alternativa de não ter celular principal: o registro mobile, em que o número é registrado direto pela API, sem instalar o WhatsApp num telefone. Nesse modo não há aparelho principal para ficar inativo nem para alguém remover a instância por engano. O passo a passo está em WhatsApp sem celular: registrar o número pela API.

Faz sentido para números dedicados à automação. Para o número que a equipe também usa no dia a dia, o modelo de aparelho conectado costuma ser o mais prático.

Conclusão

A API não oficial do WhatsApp não precisa do celular ligado: a instância é um aparelho conectado independente, hospedada e gerenciada pela WAME, com 99,9% de uptime. O celular só precisa continuar existindo como aparelho principal — aberto de vez em quando e sem ninguém removendo a instância. Com o webhook de conexão e o evento de saúde monitorados, você fica sabendo de qualquer queda antes do cliente. Os endpoints de instância estão na documentação, e o panorama do que a camada não oficial oferece está em vantagens da API não oficial.