Migrar da API não oficial do WhatsApp para a oficial | Vectalk
Baileys, Evolution e similares

Saia da API não oficial e vá para a API oficial do WhatsApp sem trocar de número

Se a sua automação conecta o WhatsApp lendo um QR code, o número depende de uma conexão que a Meta não autoriza. Com a coexistência da Vectalk, o mesmo número passa a funcionar na API oficial e continua no app WhatsApp Business.

Você cria a conta, conecta o número e migra a integração no seu ritmo.

Por que a conexão não oficial é um risco

O problema não é a ferramenta em si, é o tipo de conexão.

🔗

Conexão como aparelho conectado

Bibliotecas como o Baileys, e soluções construídas sobre esse tipo de conexão, ligam o número como se fosse um WhatsApp Web. Essa forma de acesso não faz parte da plataforma oficial da Meta para empresas.

⛔

Número sujeito a bloqueio

Os termos do WhatsApp proíbem usar o serviço por meios automatizados não autorizados. Se o número for restringido, sua operação de atendimento e vendas para junto com ele.

🔧

Integração que pode quebrar

Como depende do funcionamento interno do WhatsApp Web, uma mudança do lado do WhatsApp pode derrubar a conexão sem aviso, e a correção não está nas suas mãos.

Comparação completa: API oficial x API não oficial do WhatsApp.

O que muda na prática

Conexão não oficialAPI oficial pela Vectalk
Como conectaQR code, como aparelho conectadoWhatsApp Cloud API da Meta
Autorizada pela MetaNãoSim
Iniciar conversaTexto livreTemplate aprovado pela Meta
Responder o clienteTexto livreTexto, mídia e botões na janela de 24 horas
EventosFormato de cada ferramentaWebhooks no formato da documentação da Meta
Custo de mensagemSem tarifa da MetaTarifa da Meta por categoria, descontada do saldo

A principal mudança de rotina é o template: toda mensagem que a sua empresa inicia precisa de um modelo aprovado. Veja como a Meta classifica templates e como funciona a janela de 24 horas.

Coexistência: o mesmo número no app e na API

Você não precisa abrir mão do celular de atendimento para ter a API oficial.

📱

O número continua no app

Com a coexistência, o número segue no app WhatsApp Business e também passa a funcionar na API oficial. Sua equipe continua respondendo pelo celular enquanto a automação roda pela API.

🔄

Está no WhatsApp comum?

A coexistência vale para números do app WhatsApp Business. Se o seu número está no WhatsApp comum, passe a conta para o app WhatsApp Business antes, mantendo o mesmo número.

Migração em 6 passos

  1. Liste o que a automação atual fazSepare o que é resposta ao cliente (continua livre dentro da janela de 24 horas) do que é mensagem iniciada pela empresa (vai virar template).
  2. Crie sua conta na VectalkO cadastro é feito em apps.vectalk.com.br. Tenha em mãos o acesso ao portfólio empresarial da sua empresa na Meta.
  3. Desconecte a sessão não oficialNo app, em Aparelhos conectados, encerre a sessão usada pela ferramenta não oficial, para não manter uma automação fora das regras no mesmo número.
  4. Conecte o número com coexistênciaNo painel, crie uma instância de WhatsApp e conecte o número que está no app WhatsApp Business.
  5. Cadastre os templatesNa aba Templates, use a Biblioteca de Modelos como ponto de partida e envie seus modelos para aprovação da Meta.
  6. Troque as chamadas da integraçãoAponte o webhook da instância para o seu sistema e substitua as chamadas de envio pelas da documentação da Vectalk. Se usa n8n ou Typebot, ajuste o fluxo; se preferir, um parceiro de integração faz isso.

Mais detalhes no guia como migrar para a API oficial do WhatsApp.

Depois da migração: o que acompanhar

Na API oficial, a forma de enviar influencia o quanto você pode enviar.

Opt-in da sua lista →

Envie só para quem autorizou receber mensagens da sua empresa pelo WhatsApp.

Qualidade do número →

Bloqueios e denúncias derrubam a qualidade e travam o aumento de limites.

Limite de marketing por usuário →

Por que algumas mensagens de marketing não são entregues.

Custo por mensagem

Você paga a mensalidade do plano e carrega saldo; cada mensagem entregue é descontada dele. No Brasil, desde 1º/10/2026: marketing R$ 0,3217; utilidade, autenticação e serviço R$ 0,0350, com 1.000 mensagens de serviço por número por mês sem cobrança.

Tire seu número do risco

Crie a conta, conecte o número com coexistência e migre a integração para a API oficial.

Perguntas frequentes

Vou perder meu número ao sair da API não oficial?

Não precisa. Se o número estiver no app WhatsApp Business, a coexistência conecta esse mesmo número à API oficial e ele continua funcionando no app. Se ele estiver no WhatsApp comum, o primeiro passo é passar a conta para o app WhatsApp Business, mantendo o número.

As conversas que estão no celular continuam lá?

Com a coexistência, o número segue no app WhatsApp Business, e as conversas do app continuam no aparelho. O que é sincronizado entre o app e a API tem regras próprias da Meta, explicadas no artigo coexistência: o que sincroniza e o que não.

Preciso reescrever a minha integração?

Sim, a parte que envia e recebe mensagens. Os endpoints mudam e os webhooks passam a seguir o formato da documentação da Meta. Mensagens que a sua empresa inicia passam a usar templates aprovados. A referência está em docs.vectalk.com.br; se preferir, um parceiro de integração faz a adaptação.

Quanto custa a API oficial em comparação?

Na API oficial, a Meta cobra por mensagem conforme a categoria. Pela Vectalk, você paga a mensalidade do plano e carrega saldo; cada mensagem entregue é descontada do saldo, sem cartão na Meta. Para o Brasil, desde 1º/10/2026, marketing custa R$ 0,3217 e utilidade, autenticação e serviço custam R$ 0,0350, com franquia de 1.000 mensagens de serviço por número por mês. Veja o preço da API do WhatsApp no Brasil.