Conectar o WhatsApp à API só pelo celular, sem QR Code (código de 8 dígitos)

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.

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://us.api-wa.me) 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

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.

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):

curl -X POST "https://us.api-wa.me/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;
• organizar e moderar grupos pela API (automatizar grupos);
• entender se o celular precisa ficar ligado depois disso (API precisa do 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. 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.

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.