Atualizado em 25/10/2026
Uma API não oficial do WhatsApp é uma biblioteca ou serviço que controla uma sessão do WhatsApp Web lida por QR Code, como Baileys, WPPConnect ou a Evolution API no modo Baileys. Ela não cobra por mensagem, mas contraria os Termos de Serviço do WhatsApp, que proíbem acesso automatizado não autorizado, e por isso o número pode ser banido a qualquer momento. A API oficial (Cloud API da Meta) tem custo por mensagem e regras de template, mas é o único caminho autorizado; vale migrar quando o WhatsApp é parte crítica da operação.
Como cada uma funciona
API não oficial. O software se conecta aos servidores do WhatsApp como se fosse o WhatsApp Web ou um aparelho vinculado. Você escaneia um QR Code com o celular, a sessão fica salva no servidor e a biblioteca expõe funções para enviar e receber mensagens. Baileys faz isso por WebSocket; WPPConnect exporta funções do WhatsApp Web para Node.js. Nenhuma delas tem relação com a Meta: o README do Baileys diz que o projeto não é afiliado, autorizado nem endossado pelo WhatsApp.
API oficial. A WhatsApp Cloud API é hospedada pela Meta. Seu sistema faz chamadas HTTPS com um token de acesso e recebe eventos por webhook. O número é registrado na plataforma, ligado a um portfólio empresarial, e a empresa aceita os termos da WhatsApp Business Platform.
A Evolution API é um caso à parte: segundo o próprio README, ela suporta tanto a conexão baseada em Baileys quanto a Cloud API oficial. O que define o risco é o canal escolhido, não o nome da ferramenta.
O que dizem os Termos de Serviço
Os Termos de Serviço do WhatsApp, na seção de uso aceitável, proíbem:
- acessar ou usar o serviço “por meios automatizados” de forma não autorizada;
- criar contas por meios não autorizados ou automatizados;
- fazer engenharia reversa, modificar ou extrair código do serviço;
- enviar comunicações não permitidas, como mensagens em massa, mensagens automáticas e discagem automática.
Os mesmos termos dizem que o WhatsApp pode desativar ou suspender a conta de quem descumpre essas regras. Uma biblioteca que emula o WhatsApp Web para automatizar envios se encaixa justamente nesses itens. O próprio README do Baileys afirma que os mantenedores não apoiam usos que violem os Termos de Serviço e desencorajam envio em massa ou automatizado.
Quer testar enquanto lê? Crie sua conta na Vectalk e envie a primeira mensagem pela API oficial. Criar conta grátis →
Por que números são banidos
Não há uma lista pública de gatilhos, e é isso que torna o risco difícil de gerenciar. Quem opera com API não oficial costuma ver:
- Banimento sem aviso, às vezes logo depois de conectar, às vezes depois de meses.
- Quebras após atualizações do WhatsApp, que exigem atualizar a biblioteca às pressas.
- Sessões que caem e pedem novo QR Code, com alguém precisando pegar o celular.
Denúncias e bloqueios de destinatários pesam em qualquer modelo. A diferença é que, na API não oficial, o próprio uso da ferramenta já é uma violação, então não existe “uso correto” que elimine o risco. Se o número for banido, recuperar exige pedir revisão ao WhatsApp, sem prazo nem garantia.
Na API oficial também há fiscalização: a Meta acompanha a qualidade das mensagens, pode pausar templates e restringir contas que violam a Política de Mensagens Comerciais. Mas o risco vem do que você envia e para quem, e não do fato de estar conectado. Os sinais aparecem antes, na qualidade do número e nos limites, e há canais de suporte e apelação.
Comparação lado a lado
| Critério | API não oficial (Baileys, WPPConnect, Evolution modo Baileys) | API oficial (Cloud API) |
|---|---|---|
| Autorização | Não; contraria os Termos de Serviço | Sim, produto da Meta para empresas |
| Conexão | QR Code e sessão salva no servidor | Token de acesso e HTTPS |
| Dependência de celular | Sim, o aparelho principal precisa estar ativo | Não |
| Risco de banimento pelo uso da ferramenta | Alto e imprevisível | Não existe; o risco vem de qualidade e política |
| Iniciar conversa | Mensagem livre | Template aprovado |
| Responder cliente | Livre | Livre dentro da janela de 24 horas |
| Custo por mensagem | Sem cobrança da Meta | Por mensagem entregue, conforme categoria e país |
| Webhooks | Formato de cada biblioteca | Formato documentado pela Meta |
| Estabilidade | Depende de engenharia reversa | API versionada, com changelog e prazos |
| Grupos e listas de transmissão | Amplo acesso | API de Grupos com regras próprias; sem listas de transmissão |
| Suporte | Comunidade | Suporte da Meta e do provedor |
Sobre custo: a API oficial não tem mensalidade da Meta, e parte das mensagens é gratuita. Os detalhes estão em existe API do WhatsApp grátis?.
Quando migrar para a API oficial
Migre agora se pelo menos um destes itens é verdade:
- o WhatsApp é canal principal de venda, cobrança ou atendimento, e um banimento para a operação;
- você vende software (CRM, ERP, plataforma) e conecta números de clientes;
- já perdeu um número ou tem sessões caindo com frequência;
- precisa de vários atendentes, IA ou integração com sistemas, com histórico confiável;
- seu cliente ou seu jurídico exige estar em conformidade com os termos do WhatsApp.
Pode esperar, ou nem precisar da API, se o uso é manual, de baixo volume e o app WhatsApp Business resolve.
Revise com cuidado antes de migrar se o fluxo depende de grupos grandes, listas de transmissão, leitura de status de contatos ou mensagens livres para quem não falou com você nas últimas 24 horas. A API oficial não replica esses usos, e o produto vai precisar mudar.
Como migrar sem parar a operação
O passo a passo completo está em como migrar de uma API não oficial para a API oficial do WhatsApp. Em resumo:
- Inventário. Liste o que é resposta ao cliente (continua igual) e o que é mensagem iniciada pela empresa (vira template).
- Conta na Meta. Portfólio empresarial, de preferência verificado. Veja como conseguir acesso à API do WhatsApp.
- Número. Se está no app WhatsApp Business, dá para usar coexistência. Se está no WhatsApp comum, é preciso liberar o número antes. Veja como liberar um número que já está no WhatsApp.
- Templates. Crie e aprove antes de virar a chave; é a etapa que depende da Meta.
- Envio e webhooks. Troque a camada de envio e reescreva o recebimento de eventos.
- Desligue a sessão antiga antes de registrar o número na Cloud API.
Um adaptador para o recebimento
A maior parte do trabalho fica no webhook, porque o formato muda. Um jeito de reduzir o impacto é converter o evento da Meta para o mesmo objeto interno que o seu sistema já usa:
// Converte o webhook da Cloud API para o formato interno usado antes da migração
export function normalizarWebhook(body) {
const eventos = [];
for (const entry of body.entry ?? []) {
for (const change of entry.changes ?? []) {
const v = change.value ?? {};
for (const m of v.messages ?? []) {
eventos.push({
tipo: 'mensagem',
numeroOrigem: m.from, // wa_id, sem @s.whatsapp.net
idMensagem: m.id, // wamid...
texto: m.text?.body ?? m.button?.text ?? null,
midiaId: m.image?.id ?? m.document?.id ?? m.audio?.id ?? null,
recebidoEm: new Date(Number(m.timestamp) * 1000),
canal: v.metadata?.phone_number_id,
});
}
for (const s of v.statuses ?? []) {
eventos.push({ tipo: 'status', idMensagem: s.id, status: s.status, erro: s.errors?.[0]?.code ?? null });
}
}
}
return eventos;
}Repare que a mídia chega como media_id, não como arquivo: é preciso uma chamada extra para baixá-la. E os erros chegam no webhook de status, não na resposta do envio. A lista dos mais comuns está em erros da API do WhatsApp.
Migrar para a API oficial com a Vectalk
A Vectalk é um proxy da WhatsApp Cloud API oficial: os payloads e os webhooks são os da Meta, mudam só a URL base (https://apis.vectalk.com.br/api) e o token. Você paga a Vectalk, e a Vectalk paga a Meta. A Vectalk oferece coexistência, então quem tem o número no app WhatsApp Business pode conectá-lo à API sem abandonar o app.
Leia o guia completo da API oficial do WhatsApp, veja o guia rápido da documentação e crie a conta em apps.vectalk.com.br/register. Para planejar a migração com o time, use a página de contato.
Perguntas frequentes
A Evolution API é oficial?
A Evolution API é um projeto de código aberto que não pertence à Meta. Ela oferece dois modos: um baseado em Baileys, que emula o WhatsApp Web e não é autorizado, e outro que usa a Cloud API oficial. Só o segundo está dentro das regras da Meta.
Usar Baileys dá banimento na certa?
Não necessariamente, mas o risco existe desde o primeiro dia e não há como zerá-lo, porque o uso em si contraria os Termos de Serviço. Muitos números funcionam por meses e caem sem aviso.
Meu número foi banido usando API não oficial. Posso usá-lo na API oficial?
Primeiro é preciso recuperar o número com um pedido de revisão ao WhatsApp. Só depois de reativado ele pode ser registrado na Cloud API.
Na API oficial o número nunca é bloqueado?
Pode ser restringido se a empresa violar as políticas ou tiver qualidade baixa, por exemplo enviando para quem não deu consentimento. A diferença é que o risco depende do seu comportamento e dá sinais antes, como queda de qualidade. Veja número bloqueado na API do WhatsApp.
Consigo manter o mesmo número ao migrar?
Na maioria dos casos, sim. Se o número está no app WhatsApp Business, a coexistência permite conectá-lo à API mantendo o app. Se está numa sessão não oficial, desconecte a sessão antes de registrar.
Fontes oficiais consultadas em 25/10/2026: Termos de Serviço do WhatsApp, Política de Mensagens Comerciais do WhatsApp, Visão geral da Cloud API, Coexistência: integração de usuários do app WhatsApp Business, README do Baileys, README do WPPConnect, README da Evolution API.
Coloque o WhatsApp oficial da sua empresa para funcionar
Crie sua conta, conecte seu número à API oficial (dá para manter o app com coexistência) e comece a atender e enviar mensagens.