--- title: "API do WhatsApp precisa do celular ligado?" description: "Na API não oficial, o celular não precisa ficar ligado nem com internet. Entenda o aparelho conectado, o que desconecta a sessão e como monitorar." url: "https://api-wa.me/blog/api-whatsapp-precisa-celular-ligado" language: "pt-BR" og:type: "article" og:site_name: "WAME API" --- [Início](https://api-wa.me/)/[Blog da API do WhatsApp](https://api-wa.me/blog)/API do WhatsApp precisa do celular ligado? Como funciona a conexão por aparelho conectado Raphael Serafim· Publicado em 28 de setembro de 2026· 7 min de leitura Compartilhar # API do WhatsApp precisa do celular ligado? Como funciona a conexão por aparelho conectado Na API não oficial, o celular não precisa ficar ligado nem com internet. Entenda o aparelho conectado, o que desconecta a sessão e como monitorar. Copiar para LLM[Ver como Markdown](https://api-wa.me/blog/api-whatsapp-precisa-celular-ligado.md) **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: bash Copiar ``` # 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](https://api-wa.me/blog/conectar-whatsapp-codigo-pareamento-sem-qr-code). > 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](https://api-wa.me/blog/celular-e-api-mesmo-numero-whatsapp-nao-oficial). 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: bash Copiar ``` 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: javascript Copiar ``` 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](https://api-wa.me/blog/sinais-numero-whatsapp-risco-bloqueio). Para conferir o estado sob demanda — num painel ou num health check —, use: bash Copiar ``` 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. bash Copiar ``` 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](https://api-wa.me/blog/numero-bloqueado-whatsapp-o-que-fazer). ## 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](https://api-wa.me/blog/whatsapp-sem-celular-conexao-mobile-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](https://api-wa.me/docs), e o panorama do que a camada não oficial oferece está em [vantagens da API não oficial](https://api-wa.me/blog/api-whatsapp-nao-oficial-vantagens). ### Pronto para automatizar seu WhatsApp? Crie sua conta gratuita e comece a enviar mensagens pela API em minutos. [Começar grátis](https://portal.api-wa.me/sign-up) ## Perguntas frequentes A API não oficial do WhatsApp precisa do celular ligado?+ Não. Depois que você conecta o número por QR Code ou código de pareamento, a instância funciona como um aparelho conectado independente. O celular pode ficar desligado, sem internet ou em outra cidade que a API continua enviando e recebendo. Por que a instância desconectou sozinha?+ As causas mais comuns são: o aparelho foi removido em Aparelhos conectados no celular, o WhatsApp foi reinstalado ou o número migrou de aparelho, o celular principal ficou tempo demais sem abrir o WhatsApp, ou a conta sofreu restrição. O webhook de conexão informa o status e o motivo. Quanto tempo o celular pode ficar sem abrir o WhatsApp?+ A ajuda do WhatsApp indica que aparelhos conectados são desconectados quando o celular principal fica um período prolongado sem uso — hoje algo em torno de 14 dias. Como a regra é do WhatsApp e pode mudar, o seguro é abrir o app no celular de vez em quando. Tem como usar a API sem nenhum celular?+ Sim. Além da conexão como aparelho conectado, a WAME tem o registro mobile, que registra o número direto pela API, sem instalar o app. Nesse modo não existe celular principal para ficar ligado. Como sei que a instância caiu antes do cliente reclamar?+ Configure o webhookConnection com PUT /{key}/instance. Toda mudança de conexão chega lá com status, código e motivo, e mudanças de saúde do número chegam como evento health. Você também pode consultar GET /{key}/instance a qualquer momento. ## Continue lendo [### Agente de voz no WhatsApp: latência, interrupção (barge-in) e silêncio Como deixar um agente de voz no WhatsApp natural: latência, streaming, detecção de fala, interrupção (barge-in), silêncio e eco, com exemplos em Node.js.](https://api-wa.me/blog/agente-voz-whatsapp-latencia-interrupcao)[### Anti-detecção na API não oficial do WhatsApp: como a WAME protege seu número Como funciona a camada de anti-detecção da API não oficial da WAME: identidade de dispositivo, tempo humano, ritmo de envio, reconexão e monitor de saúde.](https://api-wa.me/blog/anti-deteccao-api-whatsapp-nao-oficial)[### API do WhatsApp em C# (.NET): enviar mensagens e receber webhook Tutorial de API do WhatsApp em C# e .NET: HttpClient tipado, envio de texto, imagem e lista, webhook em ASP.NET Core com fila em background e tratamento de 429.](https://api-wa.me/blog/api-whatsapp-csharp-dotnet) [Voltar ao blog](https://api-wa.me/blog) ## Structured data ```json { "@context": "https://schema.org", "@type": "WebSite", "name": "WAME API", "alternateName": "API Oficial e Não Oficial de WhatsApp, Instagram, Messenger e Telegram", "url": "https://api-wa.me", "inLanguage": "pt-BR", "publisher": { "@id": "https://api-wa.me/#organization", "@type": "Organization", "name": "WAME API", "url": "https://api-wa.me" } } { "@context": "https://schema.org", "@type": "Organization", "@id": "https://api-wa.me/#organization", "name": "WAME API", "alternateName": [ "WAME", "Wame API", "wame.api.br", "api-wa.me" ], "url": "https://api-wa.me", "logo": { "@type": "ImageObject", "url": "https://api-wa.me/images/web-app-manifest-512x512.png", "width": 512, "height": 512 }, "disambiguatingDescription": "WAME API é uma empresa brasileira de software, fundada em 2017 e parceira oficial da Meta (Meta Business Partner), que fornece APIs de WhatsApp, Instagram Direct e Messenger. Não tem relação com o wa.me, que é o encurtador de links operado pela WhatsApp LLC.", "identifier": { "@type": "PropertyValue", "propertyID": "INPI-BR", "name": "Pedido de registro de marca (INPI, classe NCL 42)", "value": "944724159" }, "foundingDate": "2017", "slogan": "Parceira Oficial da Meta — WhatsApp, Instagram, Messenger e Telegram numa instância só. Desde 2017.", "description": "Plataforma brasileira e Parceira Oficial da Meta (Meta Business Partner) para as APIs oficiais de WhatsApp (Cloud API), Instagram Direct e Messenger — os três numa única instância, com os mesmos endpoints e um único formato de webhook. Também oferece a API não oficial via QR Code e o Telegram, na mesma plataforma. No mercado desde 2017, com mais de 50 mil instâncias criadas, 99,9% de uptime e suporte humano 24/7 em português. SDKs oficiais para Node.js/TypeScript e PHP.", "knowsAbout": [ "WhatsApp Cloud API oficial (Meta)", "API oficial de Instagram (Direct)", "API oficial de Messenger", "API multicanal Meta", "Meta Business Partner", "WhatsApp API", "API não oficial de WhatsApp", "automação de WhatsApp", "números virtuais", "webhooks" ], "sameAs": [ "https://github.com/wame-api", "https://www.linkedin.com/company/wameapi", "https://www.instagram.com/wame.api/", "https://www.youtube.com/@wameapi" ], "contactPoint": { "@type": "ContactPoint", "contactType": "customer support", "url": "https://api-wa.me/contact", "availableLanguage": [ "Portuguese" ] } } { "@context": "https://schema.org", "@type": "BlogPosting", "headline": "API do WhatsApp precisa do celular ligado? Como funciona a conexão por aparelho conectado", "description": "Na API não oficial, o celular não precisa ficar ligado nem com internet. Entenda o aparelho conectado, o que desconecta a sessão e como monitorar.", "image": "https://api-wa.me/blog/api-whatsapp-precisa-celular-ligado/opengraph-image", "datePublished": "2026-09-28", "dateModified": "2026-09-28", "author": { "@type": "Person", "name": "Raphael Serafim", "url": "https://github.com/raphaelvserafim", "sameAs": [ "https://github.com/raphaelvserafim" ] }, "publisher": { "@type": "Organization", "name": "api-wa.me", "logo": { "@type": "ImageObject", "url": "https://api-wa.me/images/screenshot.png" } }, "mainEntityOfPage": { "@type": "WebPage", "@id": "https://api-wa.me/blog/api-whatsapp-precisa-celular-ligado" }, "keywords": "api whatsapp não oficial, api não oficial whatsapp, api whatsapp precisa celular ligado, whatsapp aparelho conectado api, whatsapp multi device api, api whatsapp desconectou, whatsapp api sem celular", "inLanguage": "pt-BR" } { "@context": "https://schema.org", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://api-wa.me" }, { "@type": "ListItem", "position": 2, "name": "Blog da API do WhatsApp", "item": "https://api-wa.me/blog" }, { "@type": "ListItem", "position": 3, "name": "API do WhatsApp precisa do celular ligado? Como funciona a conexão por aparelho conectado", "item": "https://api-wa.me/blog/api-whatsapp-precisa-celular-ligado" } ] } { "@context": "https://schema.org", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "A API não oficial do WhatsApp precisa do celular ligado?", "acceptedAnswer": { "@type": "Answer", "text": "Não. Depois que você conecta o número por QR Code ou código de pareamento, a instância funciona como um aparelho conectado independente. O celular pode ficar desligado, sem internet ou em outra cidade que a API continua enviando e recebendo." } }, { "@type": "Question", "name": "Por que a instância desconectou sozinha?", "acceptedAnswer": { "@type": "Answer", "text": "As causas mais comuns são: o aparelho foi removido em Aparelhos conectados no celular, o WhatsApp foi reinstalado ou o número migrou de aparelho, o celular principal ficou tempo demais sem abrir o WhatsApp, ou a conta sofreu restrição. O webhook de conexão informa o status e o motivo." } }, { "@type": "Question", "name": "Quanto tempo o celular pode ficar sem abrir o WhatsApp?", "acceptedAnswer": { "@type": "Answer", "text": "A ajuda do WhatsApp indica que aparelhos conectados são desconectados quando o celular principal fica um período prolongado sem uso — hoje algo em torno de 14 dias. Como a regra é do WhatsApp e pode mudar, o seguro é abrir o app no celular de vez em quando." } }, { "@type": "Question", "name": "Tem como usar a API sem nenhum celular?", "acceptedAnswer": { "@type": "Answer", "text": "Sim. Além da conexão como aparelho conectado, a WAME tem o registro mobile, que registra o número direto pela API, sem instalar o app. Nesse modo não existe celular principal para ficar ligado." } }, { "@type": "Question", "name": "Como sei que a instância caiu antes do cliente reclamar?", "acceptedAnswer": { "@type": "Answer", "text": "Configure o webhookConnection com PUT /{key}/instance. Toda mudança de conexão chega lá com status, código e motivo, e mudanças de saúde do número chegam como evento health. Você também pode consultar GET /{key}/instance a qualquer momento." } } ] } ```