Empresa brasileira · Entrega automática · Suporte em português Seg a sex, 9h as 18h · PIX em reais
ProxyBox
Verificação

Conectar o número virtual à API de WhatsApp

Como ligar o WhatsApp criado com o número virtual à API: a ordem certa, o código QR, o código de pareamento e os cuidados nos primeiros dias.

4 min de leitura Atualizado em 14 de novembro de 2026

Quem comprou o número virtual para WhatsApp e quer ligar o atendimento ao próprio sistema usa a API de WhatsApp. Este guia mostra a ordem certa. O combo do painel entrega as três peças de uma vez: o número, a instância da API e um IP brasileiro só dela.

Como as peças se encaixam

Peça O que faz
Número virtual Recebe o código para criar o WhatsApp
Celular É o aparelho principal da conta
Instância da API Entra como aparelho conectado e fala com o seu sistema
IP dedicado É o endereço de internet por onde a instância conecta, sempre o mesmo

O número não "entra" na API. Quem entra é a conta de WhatsApp criada com ele.

1. Criar o WhatsApp no celular

Siga o guia como ativar o número no WhatsApp até o fim, incluindo a confirmação em duas etapas. Use o aplicativo oficial, o WhatsApp ou o WhatsApp Business.

Não pule esta etapa. Sem um celular como aparelho principal, não há onde aprovar a conexão.

2. Usar a conta um pouco antes de conectar

Uma conta criada há poucos minutos, que conecta um aparelho e já começa a enviar mensagens por um sistema, chama a atenção do WhatsApp. O que costuma funcionar melhor:

  • preencher nome, foto e, no Business, o perfil da empresa;
  • conversar com alguns contatos que respondem;
  • esperar pelo menos um dia antes de conectar a instância.

Isso é prática de quem opera, não regra publicada pelo WhatsApp. Não existe prazo que garanta nada.

3. Abrir a instância no painel

Em API de WhatsApp, abra a sua instância. Quando ela ainda não tem conta conectada, a tela oferece dois jeitos de conectar.

Código QR

  1. No painel, peça o código QR. Ele vale poucos segundos e a tela gera outro quando vence.
  2. No celular, abra Configurações → Aparelhos conectados → Conectar um aparelho.
  3. Aponte a câmera para o QR.

Código de pareamento

Serve para quando não dá para apontar a câmera, por exemplo quando o painel está aberto no próprio celular.

  1. No painel, informe o número com 55 e o DDD e peça o código de pareamento.
  2. No celular, em Aparelhos conectados → Conectar um aparelho, escolha Conectar com número de telefone.
  3. Digite o código de 8 caracteres que o painel mostrou. Ele vale poucos minutos.

Nos dois casos, o WhatsApp do celular confirma, e a instância passa para conectada.

4. Conferir

  • No celular, a instância aparece na lista de Aparelhos conectados.
  • No painel, o estado da instância mostra o número conectado.
  • Envie uma mensagem de teste para o seu próprio número pessoal.

Cuidados nos primeiros dias

  • Comece com atendimento, não com campanha. Responder quem escreveu para você é o uso mais seguro que existe.
  • Não envie a mesma mensagem para uma lista de desconhecidos. É o que gera denúncia, com qualquer número e qualquer IP.
  • Abra o WhatsApp no celular de vez em quando. Se o aparelho principal ficar muitos dias sem uso, o WhatsApp desconecta os aparelhos ligados à conta.
  • Mantenha o número renovado. Se o WhatsApp pedir um novo código e o número tiver vencido, a conta se perde. Veja renovar, trocar e proteger o número.

Se a instância desconectar

Desconexão não é bloqueio. Acontece quando o celular principal ficou muito tempo parado, quando alguém removeu o aparelho da lista ou quando o WhatsApp pede uma nova confirmação.

  1. Abra o WhatsApp no celular e veja se a conta está normal.
  2. No painel, peça um novo QR ou código de pareamento e conecte de novo.
  3. Se o celular pedir o código de 6 dígitos do número, ele chega no cartão do número, em Número Virtual.

Se o aplicativo disser que o número não pode usar o WhatsApp, aí sim é bloqueio. O texto número banido do WhatsApp explica como pedir revisão.

O que este conjunto não faz

  • Não é a API oficial da Meta. Não há modelos de mensagem aprovados nem selo de conta verificada.
  • Não protege de bloqueio. O IP dedicado tira um fator de risco, o de várias contas saindo pelo mesmo endereço. Não muda o que o WhatsApp faz com denúncia.
  • Não é para envio em massa. A política de uso aceitável proíbe spam, e a conta é encerrada.

Perguntas frequentes

Dá para usar a API sem ter o WhatsApp no celular?
Não. A API entra na conta como um aparelho conectado, igual ao WhatsApp Web. A conta precisa existir antes em um celular, que continua sendo o aparelho principal.
Preciso do número virtual para usar a API?
Não. A API funciona com qualquer número que já tenha WhatsApp. O número virtual é para quem ainda não tem um número separado para isso.
O celular precisa ficar ligado o tempo todo?
Não. Depois de conectada, a API funciona com o celular desligado. Mas o WhatsApp desconecta os aparelhos quando o celular principal passa muitos dias sem ser usado, então abra o aplicativo de tempos em tempos.
A API é a oficial da Meta?
Não. É uma conexão pelo recurso de aparelhos conectados. Para a plataforma oficial da Meta as regras de número e de envio são outras.

Travou em alguma etapa?

Manda o print do erro no WhatsApp. Respondemos em português e, na maioria dos casos, o problema é um campo trocado entre host e porta.

Suporte em português Fale no WhatsApp