--- title: "Conectar o WhatsApp à API só pelo celular, sem QR Code (código de 8 dígitos)" description: "Só tem o celular? Conecte seu WhatsApp à API sem QR Code: gere o código de 8 dígitos no painel WAME e digite no app. Passo a passo e soluções." url: "https://wame.api.br/blog/conectar-whatsapp-api-pelo-celular-sem-qr-code" language: "pt-BR" og:type: "article" published_time: "2026-09-28" modified_time: "2026-09-28" author: "Raphael Serafim" keywords: "api whatsapp não oficial, api não oficial whatsapp, código de pareamento whatsapp, conectar whatsapp sem qr code, conectar com número de telefone whatsapp, conectar whatsapp api pelo celular, código de 8 dígitos whatsapp" reading_time: "7 min de leitura" --- # Conectar o WhatsApp à API só pelo celular, sem QR Code (código de 8 dígitos) > Só tem o celular? Conecte seu WhatsApp à API sem QR Code: gere o código de 8 dígitos no painel WAME e digite no app. Passo a passo e soluções. **Dá para conectar seu WhatsApp à API usando só o celular, sem QR Code e sem computador: no painel da WAME você gera um código de 8 caracteres e, no app do WhatsApp, entra em Aparelhos conectados → Conectar um aparelho → Conectar com número de telefone e digita esse código.** Em menos de um minuto o número está ligado à sua instância e pronto para enviar e receber mensagens pela API. Este guia é para quem não programa: donos de negócio, atendentes, gente que só tem o celular por perto. A visão geral dos três métodos de conexão (QR Code, código e Passkey), com os detalhes técnicos, está em [conectar WhatsApp na API sem QR Code](/blog/conectar-whatsapp-codigo-pareamento-sem-qr-code). > A camada não oficial da WAME é independente e não é afiliada, endossada ou suportada pelo WhatsApp ou pela Meta. O uso é de responsabilidade de quem envia. ## Por que o QR Code não funciona quando você só tem o celular O QR Code é pensado para duas telas: a imagem aparece no computador e você aponta a câmera do celular para ela. Quando você abre o painel no próprio celular, o QR aparece na mesma tela que precisaria lê-lo. Não tem como o aparelho fotografar a si mesmo. Na prática, isso acontece o tempo todo: - o dono da loja cria a conta pelo celular, no meio do expediente; - o computador está longe, quebrado ou é de outra pessoa; - a câmera do celular está trincada ou não foca; - a pessoa tem dificuldade de enquadrar o QR antes de ele trocar. O código de pareamento elimina tudo isso. Em vez de uma imagem, você recebe um texto curto. Copia, abre o WhatsApp e digita. Tudo no mesmo aparelho. ## Passo a passo no painel da WAME ### 1. Abra a instância e vá para a aba WhatsApp No painel, entre na instância que você quer conectar. No topo aparecem o **Server** (`https://server.wame.api.br`) e a **Key** da instância. Logo abaixo ficam as abas dos canais: WhatsApp, Instagram, Messenger, Telegram. Selecione **WhatsApp**. ### 2. Gere o código de pareamento Informe o número que vai ser conectado, no formato internacional: código do país, DDD e número, só dígitos. Exemplo: `5511999999999`. Precisa ser **o mesmo número do celular onde você vai digitar o código**. O painel mostra o código em oito caixinhas, no formato `XXXX-XXXX`, com um botão **Copiar** ao lado. Embaixo aparece o link **Faça login com QR code**, caso você prefira voltar para o método tradicional. ### 3. Copie o código Toque em **Copiar**. Não precisa copiar o hífen: ele só separa os dois blocos para facilitar a leitura. ### 4. Abra o WhatsApp e vá em Aparelhos conectados - **Android:** toque nos três pontinhos (⋮) no canto superior e escolha **Aparelhos conectados**. - **iPhone:** vá em **Configurações** e depois em **Aparelhos conectados**. Toque em **Conectar um aparelho**. O app vai pedir a sua biometria ou senha de desbloqueio e abrir a câmera para ler um QR. ### 5. Troque para "Conectar com número de telefone" Na tela da câmera, embaixo, aparece a opção **Conectar com número de telefone**. Toque nela. O app mostra campos para você digitar o código. ### 6. Digite o código Cole ou digite os oito caracteres. Em poucos segundos o WhatsApp confirma e a nova conexão aparece na lista de **Aparelhos conectados**, como uma sessão de navegador. No painel da WAME, a instância passa para **conectada**. Pronto. A partir daqui o número funciona pela API, e você continua usando o WhatsApp no celular normalmente. ## Quando algo dá errado | O que aconteceu | Por quê | Como resolver | | --- | --- | --- | | "Código inválido" ou expirado | O código vale só por alguns minutos e é de uso único | Gere um novo no painel e digite logo em seguida | | O código nunca é aceito | O número informado no painel não é o do celular onde você digitou | Confira DDI, DDD e número; gere de novo com o número certo | | Número sem código do país | Faltou o `55` (Brasil) na frente | Use o formato `5511999999999` | | O painel não mostra código | A instância já está conectada | Veja o status: não precisa conectar de novo | | Não aparece "Conectar com número de telefone" | App do WhatsApp desatualizado | Atualize o WhatsApp na loja de apps e tente de novo | | Digitou em outro celular | O código só vale para o número informado | Digite no aparelho que tem aquele número | | Instância criada para registro mobile | Esse tipo de instância não usa aparelho vinculado | Siga o registro por SMS ou voz, explicado em [WhatsApp sem celular](/blog/whatsapp-sem-celular-conexao-mobile-api) | Um detalhe sobre o "já conectado": se a instância já está pareada, o painel não gera um código novo de propósito. Pedir código numa sessão que já funciona derrubaria a conexão existente. Se você realmente quer trocar o número, desconecte a instância primeiro e só então gere o código. ## Cuidado com o golpe do código Existe um golpe muito comum no WhatsApp: alguém se passa por loja, banco ou suporte e pede "o código que chegou no seu celular". Com esse código, o golpista vincula o seu WhatsApp a um aparelho dele. O pareamento da WAME funciona **ao contrário**, e é por isso que é seguro: - **Você gera** o código, no seu painel, logado na sua conta; - **Você digita** o código no **seu próprio celular**; - o código **nunca sai** das suas mãos. Três regras simples: 1. **A WAME nunca pede esse código** por mensagem, ligação ou e-mail. 2. **Não mande o código para ninguém**, nem para alguém da sua equipe por um grupo aberto. Trate como senha. 3. **Confira os Aparelhos conectados** de vez em quando. Se aparecer uma conexão que você não reconhece, toque nela e desconecte. Se você presta serviço e conecta o WhatsApp de clientes, o caminho seguro é o cliente gerar e digitar o código do lado dele, em uma tela do seu sistema. Como montar isso está em [onboarding de WhatsApp no seu SaaS com código de pareamento](/blog/onboarding-saas-whatsapp-codigo-pareamento). ## Depois de conectar: faça um teste Com a instância conectada, vale mandar uma mensagem de teste para outro número seu. Uma chamada simples resolve (troque `SUA_KEY` pela key que aparece no topo do painel): ```bash curl -X POST "https://server.wame.api.br/SUA_KEY/message/text" \ -H "Content-Type: application/json" \ -d '{ "to": "5511988887777", "text": "Teste: WhatsApp conectado pela API." }' ``` Se a mensagem chegou, está tudo certo. Os próximos passos dependem do que você quer automatizar: - responder clientes com um [bot no WhatsApp](/blog/criar-bot-whatsapp-api-nao-oficial); - organizar e moderar grupos pela API ([automatizar grupos](/blog/automatizar-grupos-whatsapp-api)); - entender se o celular precisa ficar ligado depois disso ([API precisa do celular ligado?](/blog/api-whatsapp-precisa-celular-ligado)). E, se o número for novo, vá com calma nas primeiras semanas. Número recém-conectado que sai enviando volume alto chama atenção do anti-spam do WhatsApp. O plano de aquecimento está em [como aquecer um número novo](/blog/aquecer-numero-whatsapp-api-nao-oficial). A WAME não apoia spam: a conexão é para atendimento, notificações para quem pediu, grupos e bots. Nesse uso, a taxa de bloqueio é muito baixa para quem usa do jeito certo. ## O que acontece por trás Para quem tem curiosidade: o código de pareamento vincula a sua instância ao WhatsApp exatamente como o WhatsApp Web faz. A diferença é que, em vez de ler um QR, o app confirma o vínculo pelo código digitado. Cada instância da WAME recebe a sua própria identidade de aparelho, estável e diferente das outras, e aparece na lista de Aparelhos conectados como uma sessão de navegador. Por isso nada muda no seu WhatsApp: as conversas continuam no celular, você continua respondendo pelo app quando quiser, e a API trabalha em paralelo. Se um dia quiser desconectar, é só remover o aparelho na lista de Aparelhos conectados ou desconectar pelo painel. Para desenvolvedores, a mesma geração de código está disponível pela API em `POST /{key}/instance/pairing-code`, e os detalhes estão na [documentação](/docs). ## Conclusão Se você só tem o celular, o QR Code é um obstáculo, não um requisito. Com o código de pareamento da WAME você gera oito caracteres no painel, digita em Aparelhos conectados → Conectar com número de telefone e o número fica ligado à API em menos de um minuto, sem computador e sem câmera. Guarde as três regras: gere e digite você mesmo, não repasse o código para ninguém e gere um novo quando expirar. O resto é começar a automatizar, com calma e só para quem quer receber as suas mensagens. ## Perguntas frequentes ### Dá para conectar o WhatsApp à API usando só o celular? Sim. No painel da WAME, gere o código de pareamento na aba WhatsApp da instância. Depois, no app do WhatsApp, vá em Aparelhos conectados, toque em Conectar um aparelho, escolha Conectar com número de telefone e digite o código de 8 caracteres. Não precisa de computador nem de câmera. ### Por que não consigo escanear o QR Code pelo celular? Porque o QR Code precisa ser lido pela câmera do celular que tem o WhatsApp, e ele está sendo exibido na tela desse mesmo celular. Não dá para apontar a câmera para a própria tela. O código de pareamento resolve isso: você copia e digita, no mesmo aparelho. ### O código de pareamento expirou. O que faço? Gere outro. O código vale por pouco tempo, poucos minutos, e é de uso único. Volte ao painel, peça um novo código e digite logo em seguida no app. ### Alguém pediu o código que chegou no meu WhatsApp. Devo passar? Não. Esse é um golpe comum. No pareamento com a WAME, é você quem gera o código no seu painel e digita no seu próprio celular. Ninguém da WAME vai pedir esse código por mensagem, ligação ou e-mail. Quem tem o código consegue vincular um aparelho à sua conta. ### Conectar pelo código é diferente de conectar pelo QR Code? Não no resultado. Nos dois casos o número fica vinculado à instância como um aparelho conectado, igual ao WhatsApp Web. Muda só a forma de autorizar: imagem escaneada ou código digitado.