Atualizado em 25/10/2026
A API oficial do WhatsApp é a WhatsApp Business Platform da Meta, oferecida hoje como Cloud API: uma API HTTP hospedada pela própria Meta que permite enviar e receber mensagens a partir do seu sistema. Para usá-la, você precisa de um portfólio empresarial na Meta, um número registrado na plataforma, templates aprovados para iniciar conversas e uma forma de pagamento, já que a cobrança é feita por mensagem entregue. É o único caminho que a Meta autoriza para automatizar o WhatsApp de uma empresa.
Este guia explica o que separa a API oficial das bibliotecas não oficiais, quais são os requisitos, como escolher entre integrar direto com a Meta ou usar um intermediário, quanto custa em linhas gerais e em que cenários a troca compensa.
O que é a API oficial do WhatsApp
A WhatsApp Business Platform é o conjunto de APIs que a Meta disponibiliza para empresas. Na prática, quando alguém fala em “API oficial do WhatsApp” hoje, está falando da Cloud API: endpoints da Graph API (graph.facebook.com) que recebem JSON e devolvem JSON, e webhooks que avisam seu servidor quando chega uma mensagem ou muda o status de uma mensagem enviada.
Alguns termos aparecem o tempo todo na documentação da Meta. Vale conhecer antes de começar:
| Termo | O que é | Onde aparece |
|---|---|---|
| Portfólio empresarial | A conta da empresa na Meta (antes chamada de Business Manager). Pode ser verificada. | business_id |
| Conta de mensagens (WABA) | A antiga conta do WhatsApp Business (WABA). Desde 23/09/2026, a Meta separou a WABA em duas: a conta do WhatsApp, que detém os números, e a conta de mensagens, que guarda templates, cobrança e webhooks. Os IDs de WABA existentes viraram IDs de conta de mensagens. | waba_id |
| Número de telefone comercial | O número registrado na Cloud API, usado para enviar e receber. | phone_number_id |
| Template (modelo de mensagem) | Mensagem pré-aprovada, obrigatória para iniciar contato fora da janela de atendimento. | type: "template" |
| Janela de atendimento | Período de 24 horas aberto a cada mensagem do cliente, em que você pode responder com mensagens livres. | regras de envio e preço |
| Webhook | URL do seu sistema que recebe eventos (mensagens recebidas, status de entrega). | object: "whatsapp_business_account" |
API oficial × API não oficial
Bibliotecas como Baileys e WPPConnect, e ferramentas construídas sobre elas (como o modo Baileys da Evolution API), funcionam emulando o WhatsApp Web: você lê um QR Code com o celular e o software passa a controlar aquela sessão. Não existe contrato com a Meta, não existe template, não existe cobrança por mensagem. Também não existe garantia de que a próxima atualização do WhatsApp não vá quebrar a integração.
Os Termos de Serviço do WhatsApp proíbem acessar ou usar o serviço “por meios automatizados” não autorizados e criar contas “por meios não autorizados ou automatizados”. O texto também cita envio em massa e mensagens automáticas entre os usos não permitidos. É por isso que números usados com APIs não oficiais podem ser banidos sem aviso.
| Critério | API oficial (Cloud API) | API não oficial (Baileys, WPPConnect etc.) |
|---|---|---|
| Autorização da Meta | Sim, é o produto da Meta para empresas | Não; contraria os Termos de Serviço |
| Conexão | Token de acesso e chamadas HTTP | Sessão do WhatsApp Web via QR Code |
| Risco de banimento por uso da ferramenta | Não; o risco vem de qualidade e política | Alto e imprevisível |
| Iniciar conversa | Só com template aprovado | Mensagem livre (e é aí que mora o risco) |
| Custo de mensagens | Por mensagem entregue, tabela da Meta | Sem cobrança da Meta |
| Estabilidade | Versionada, com changelog e prazos de descontinuação | Depende de engenharia reversa |
| Webhooks | Formato documentado pela Meta | Formato próprio de cada biblioteca |
A Evolution API, vale notar, também oferece integração com a API oficial, além do modo baseado em Baileys. O que define o risco é o canal usado, não o nome da ferramenta. Se você está nessa situação, o artigo Como migrar de uma API não oficial para a API oficial do WhatsApp traz o passo a passo.
Requisitos para usar a API oficial
Portfólio empresarial na Meta
Todo uso da plataforma parte de um portfólio empresarial. É nele que ficam a conta de mensagens, os números, os usuários do sistema e a forma de pagamento.
Verificação da empresa
A verificação não é obrigatória para dar os primeiros passos, mas muda o que você consegue fazer. Segundo a documentação de limites de mensagens da Meta, portfólios novos começam com limite de 250 destinatários únicos por 24 horas fora da janela de atendimento. Verificar a empresa é um dos caminhos para subir para 2.000. O limite de números registrados também depende disso: portfólios novos podem registrar dois números, e o teto sobe para 20 quando a empresa é verificada ou chega ao limite de 2.000 mensagens.
No fluxo da Vectalk, o guia rápido pede uma conta Meta Business verificada para conectar o número. Por isso, trate a verificação como parte do projeto, não como etapa opcional.
Número de telefone
Pela documentação de números da Cloud API, o número precisa:
- pertencer à sua empresa;
- ter código de país e de área (códigos curtos não são aceitos);
- conseguir receber SMS ou ligação de voz para o código de verificação.
Um ponto que pega muita gente: números que já estão em uso no WhatsApp não podem ser registrados na Cloud API sem antes serem excluídos do aplicativo. A exceção é o número do app WhatsApp Business, que pode ser conectado à API mantendo o app em uso, no recurso conhecido como coexistência. Explicamos requisitos e limitações em Coexistência no WhatsApp.
Você também vai precisar de um nome de exibição, que a Meta analisa antes de liberar.
Forma de pagamento
Desde 1º de outubro de 2026, a Meta voltou a cobrar mensagens de serviço depois de uma franquia mensal gratuita por número. A página de preços avisa que contas sem forma de pagamento deixam de ter mensagens de serviço entregues após o uso dessa franquia. Na prática, toda operação em produção precisa de um meio de pagamento ativo na conta de mensagens.
Na Vectalk, essa etapa fica com a gente: o cliente paga a Vectalk, e a Vectalk paga a Meta pelas mensagens. Você não precisa cadastrar cartão nem linha de crédito na Meta.
Consentimento (opt-in) dos contatos
A Política de Mensagens Comerciais do WhatsApp só permite contatar quem forneceu o número e deu permissão para receber mensagens. Pedidos para parar de receber precisam ser respeitados, inclusive quando feitos fora do WhatsApp. Isso vale para qualquer integração oficial e é um dos fatores que mais pesam na qualidade do número.
Limites que você precisa conhecer
| Limite | Valor padrão | Observação |
|---|---|---|
| Limite de mensagens (fora da janela) | 250 destinatários únicos / 24 h em portfólios novos | Sobe para 2.000, 10.000, 100.000 e ilimitado, conforme verificação, volume e qualidade. Vale para o portfólio inteiro. |
| Números registrados por portfólio | 2 inicialmente | Passa a 20 com verificação ou ao atingir o limite de 2.000 |
| Taxa de envio (throughput) | Até 80 mensagens por segundo por número | Pode ser ampliada; números em coexistência ficam em 20 mps |
| Janela de atendimento | 24 horas a partir da última mensagem do cliente | Fora dela, só templates |
Fontes: limites de mensagens, visão geral da Cloud API e números de telefone.
Um detalhe importante: o limite de mensagens é do portfólio, não do número. Se você tem três números no mesmo portfólio, um deles pode consumir toda a capacidade do dia.
Como a conversa funciona: janela de 24 horas e templates
A regra central da API oficial é simples. Quando o cliente manda uma mensagem, abre-se uma janela de atendimento de 24 horas. Dentro dela, você responde com qualquer tipo de mensagem: texto, imagem, botões, listas. Cada nova mensagem do cliente reinicia o contador.
Fora da janela, só é possível enviar templates. Eles são criados com categoria (marketing, utilidade ou autenticação), passam por aprovação da Meta e aceitam variáveis. Um template de confirmação de pedido, por exemplo:
{
"messaging_product": "whatsapp",
"to": "5584999999999",
"type": "template",
"template": {
"name": "order_confirmation",
"language": { "code": "pt_BR" },
"components": [
{
"type": "body",
"parameters": [
{ "type": "text", "text": "Maria" },
{ "type": "text", "text": "#12345" }
]
}
]
}
}Esse é o mesmo payload aceito pela Meta e pela Vectalk. A categoria do template também define o preço da mensagem, assunto que detalhamos em Quanto custa a API do WhatsApp no Brasil em 2026.
BSP, Provedor de Tecnologia ou Cloud API direta
Há três jeitos de chegar à Cloud API. A diferença está em quem cuida do app na Meta, dos tokens, dos webhooks e da cobrança.
Integração direta. Você cria um app no painel da Meta, gera um token de usuário do sistema, configura o webhook com verificação e assinatura, assina os campos da conta de mensagens e cuida da rotação de credenciais. Não há intermediário, mas toda a operação fica com o seu time.
Parceiros da Meta. A documentação para parceiros divide os intermediários em três tipos:
- Parceiros de Soluções (o que o mercado chama de BSP): são Parceiros de Negócios da Meta, podem estender linha de crédito aos clientes e cobrar deles diretamente pelo uso da plataforma.
- Provedores de Tecnologia: oferecem serviços sobre a plataforma, mas sem linha de crédito. O cliente cadastra a própria forma de pagamento e a Meta cobra o uso da API diretamente dele.
- Parceiros de Tecnologia: Provedores de Tecnologia que também foram aprovados como Parceiros de Negócios da Meta.
Proxy gerenciado. É o modelo da Vectalk (nos docs, o produto aparece como Vectax Hub). Sua aplicação fala com a Vectalk, que repassa as chamadas para a Cloud API. Os payloads são os mesmos da Meta; mudam apenas a URL base e o token:
| Cloud API direta | Vectalk | |
|---|---|---|
| URL base | https://graph.facebook.com/vXX.X | https://apis.vectalk.com.br/api |
| Token | Token de acesso da Meta (usuário do sistema) | Token gerado na Vectalk |
| Payloads | Formato da Meta | Igual ao da Meta |
| Várias contas | Um token e um phone_number_id por contexto | Um token de organização para todas as instâncias, enviando o phone_number_id |
| Webhooks | Um endpoint por app, configurado no painel da Meta | Várias URLs por instância, registradas via API |
Na Vectalk, o envio de uma mensagem de texto fica assim:
curl -X POST https://apis.vectalk.com.br/api/messages \
-H "Authorization: Bearer SEU_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"messaging_product": "whatsapp",
"to": "5584999999999",
"type": "text",
"text": { "body": "Seu pedido saiu para entrega." }
}'Se você já tem código escrito para a Cloud API, a migração para o proxy é trocar duas variáveis de ambiente. Os detalhes de token de organização e de instância estão na página de autenticação.
Custos em linhas gerais
Desde 1º de julho de 2025, a Meta cobra por mensagem entregue, com preço definido pela categoria da mensagem e pelo país do destinatário. As categorias são marketing, utilidade, autenticação e serviço, e desde julho de 2026 existe também a categoria Meta Business Agent, para respostas geradas pela plataforma de IA da própria Meta. Algumas mensagens não são cobradas, como as enviadas dentro da janela de ponto de entrada gratuito aberta por anúncios de clique para o WhatsApp e as primeiras 1.000 mensagens de serviço do mês, por número.
Para o Brasil, a tabela oficial é publicada em reais e as contas em BRL são faturadas pelo Facebook Brasil. Valores, faixas de volume e mudanças de outubro de 2026 estão em Quanto custa a API do WhatsApp no Brasil em 2026.
Quando a API oficial faz sentido
Ela compensa quando o WhatsApp é parte do produto ou da operação, e não um canal secundário:
- Sistemas que precisam notificar clientes: confirmação de pedido, lembrete de consulta, segunda via de boleto, código de verificação.
- Atendimento com várias pessoas ou com IA: um número, vários atendentes ou um agente respondendo, com histórico no seu sistema.
- SaaS que oferece WhatsApp aos próprios clientes: CRMs, ERPs, plataformas de agendamento e de e-commerce que precisam conectar números de terceiros com segurança.
- Operações que não podem parar: qualquer fluxo em que um banimento de número custa caro.
E faz menos sentido em alguns casos:
- quando o uso é só conversa manual, com poucas mensagens por dia, e o app WhatsApp Business resolve;
- quando o plano depende de mandar mensagens para listas sem consentimento, o que a política não permite em nenhuma API oficial;
- quando o fluxo depende de recursos que a Cloud API não cobre ou cobre com limites. A API de Grupos, por exemplo, exige conta comercial oficial e aceita no máximo 8 participantes por grupo, segundo a documentação de grupos.
Primeiros passos com a Vectalk
- Crie sua conta em apps.vectalk.com.br/register. Uma organização é criada automaticamente.
- Em Instâncias, clique em Conectar conta e conclua o Cadastro Incorporado (Embedded Signup) da Meta. A Vectalk importa
phone_number_id,waba_ide o token de acesso. - Em Configurações → API Tokens, gere um token de organização ou de instância. Ele aparece uma única vez.
- Envie a primeira mensagem com
POST /api/messagese registre um webhook comPOST /api/webhooks.
O passo a passo completo está no guia rápido da documentação. Para dúvidas de conta e cobrança, consulte a Central de Ajuda.
Perguntas frequentes
A API oficial do WhatsApp é gratuita?
Não. A Meta cobra por mensagem entregue, conforme categoria e país do destinatário. Há situações sem cobrança, como a franquia de 1.000 mensagens de serviço por mês por número e as mensagens dentro da janela de ponto de entrada gratuito. O intermediário que você escolher pode cobrar à parte pelo serviço dele.
Preciso de CNPJ para usar a API oficial?
A Meta exige um portfólio empresarial, e a verificação da empresa pede documentação da organização. Os documentos aceitos no Brasil variam; consulte a central de ajuda da Meta para o processo de verificação.
Posso usar o mesmo número que já uso no celular?
Se o número está no app WhatsApp Business, é possível conectá-lo à API sem sair do app, pela coexistência. Se está no WhatsApp comum (Messenger), é preciso excluir a conta do app antes de registrar o número na Cloud API.
Qual é a diferença entre a API oficial e o app WhatsApp Business?
O app é feito para uso manual em celular e computador. A API é para sistemas: envio programático, webhooks, vários atendentes, integrações e automação. A API tem regras de template e janela de 24 horas que o app não tem.
Quanto tempo leva para colocar no ar?
O tempo técnico de integração costuma ser curto quando o time já conhece APIs REST. O que costuma demorar é a parte do lado da Meta: verificação da empresa, aprovação do nome de exibição e dos templates. Planeje essas etapas com antecedência.
Fontes oficiais consultadas em 25/10/2026: Preços da plataforma do WhatsApp Business (atualizada em 30/09/2026), Limites de mensagens (atualizada em 21/05/2026), Números de telefone comerciais, Parceiros da plataforma, Termos de Serviço do WhatsApp, Política de Mensagens Comerciais, Atualizações nas contas do WhatsApp Business.