Guia
Como conseguir a API oficial do WhatsApp
Para conseguir a API oficial do WhatsApp você precisa de uma conta no Facebook, um portfólio empresarial na Meta, um número que receba SMS ou ligação e um nome de exibição. Para começar não é preciso pedir liberação nem passar por análise de app. A verificação da empresa entra quando você quer subir os limites.
Por Gustavo Calixto, fundador do Omnique. Atualizado em .
Quem pode usar a API oficial do WhatsApp?
Qualquer empresa ou desenvolvedor com conta no Facebook pode usar. A Meta não pede formulário de liberação: quem integra o número da própria empresa cria um app no painel de desenvolvedor e começa com um número de teste. A análise do app só é obrigatória para quem vai conectar números de outras empresas ao próprio produto.
A página de análise do app da Meta é direta sobre isso: apps do tipo empresa recebem acesso padrão às permissões automaticamente, e quem usa a API para si mesmo, como desenvolvedor direto, não precisa de acesso avançado nem de análise. O processo pesado (verificação da empresa, vídeos, verificação de acesso) é para Tech Providers, que conectam números de clientes. Se esse é o seu caso, leia como virar Tech Provider da Meta.
Existe um terceiro caminho, que é o mais curto: usar o Cadastro Incorporado de quem já é Tech Provider. Você não cria app, só passa pela janela da Meta dentro do painel do hub. É assim que funciona no Omnique.
O que a Meta pede para liberar a API oficial?
Cinco itens: uma conta no Facebook ou conta gerenciada da Meta, um portfólio empresarial, uma conta do WhatsApp Business dentro dele, um número comercial elegível e um nome de exibição. Como a cobrança é por mensagem, a conta precisa de um meio de pagamento: sem ele, a Meta só entrega as 1.000 respostas grátis do mês. A verificação da empresa é opcional no começo e destrava limites maiores.
| Requisito | O que é | O que a Meta diz |
|---|---|---|
| Conta no Facebook | O login de quem conecta | Pré-requisito do guia de introdução da Cloud API; vale também conta gerenciada da Meta |
| Portfólio empresarial | A empresa dentro da Meta | Dá para criar durante a criação do app ou dentro do Cadastro Incorporado |
| Conta do WhatsApp Business | Guarda números e templates | Criada no painel de desenvolvedor ou no Cadastro Incorporado |
| Número comercial | O telefone que vai para a API | Seu, com código de país e de área, capaz de receber SMS ou ligação |
| Nome de exibição | O nome que aparece no perfil | Obrigatório ao registrar o número; verificado quando o limite de mensagens sobe |
| Meio de pagamento | Cartão na conta do WhatsApp Business | A Meta cobra por mensagem entregue; no Cadastro Incorporado de um Tech Provider, o cliente cadastra o próprio cartão antes de enviar |
| Verificação da empresa | Comprovação dos dados da empresa | Não é exigida para começar; é um dos caminhos para 2 mil pessoas por dia e 20 números |
Quais números servem para a API oficial?
A Meta lista quatro condições: o número precisa ser seu, ter código de país e de área (número curto não serve), receber ligação ou SMS e ter capacidade ampliada. O celular é o tipo que ela recomenda para receber o código de verificação; fixo funciona por ligação, desde que receba chamada internacional e esteja sem URA e sem desvio de chamada.
Dois cuidados que travam muita gente:
- Número em uso no WhatsApp comum: não registra na Cloud API enquanto a conta não for apagada. Se o número foi banido, ele precisa ser liberado pelo recurso do WhatsApp antes (veja número banido no WhatsApp: o que fazer).
- Número no app WhatsApp Business: com a versão 2.24.17 ou mais nova, dá para conectar com coexistência e continuar usando o app. A Meta só oferece isso pelo Cadastro Incorporado de um Tech Provider ou Solution Partner. Detalhes em coexistência: app e API no mesmo número.
Se o número está hoje numa API não oficial, como Evolution ou Z-API, desconecte de lá antes de conectar na oficial.
Como funciona o nome de exibição?
Você informa o nome ao registrar o número, e ele aparece no perfil do WhatsApp. Quando o número chega a um limite de mensagens maior, a Meta verifica esse nome sozinha, seguindo as diretrizes de nome dela, e avisa se aprovou ou recusou. Dá para trocar o nome até 10 vezes a cada 30 dias, e cada troca volta para a verificação.
Quando a verificação da empresa é exigida?
Para começar, nunca. Sem verificação, o portfólio fala com até 250 pessoas diferentes em 24 horas fora da janela de atendimento e registra até 2 números. Verificar a empresa é um dos caminhos para subir para 2 mil pessoas; o outro é entregar 2 mil templates de alta qualidade em 30 dias. Com a empresa verificada, o teto de números passa para 20.
A verificação é obrigatória em um caso: para virar Tech Provider. Ela pede nome, endereço, telefone, e-mail e site da empresa, uma forma de confirmar o vínculo e, se a Meta não encontrar a empresa, documentos. As páginas da Meta consultadas não informam prazo para essa etapa.
Direto pela Meta ou por um hub: o que muda?
O que a Meta pede do número e da empresa é igual nos dois caminhos. Muda quem faz o resto. Direto, você cria o app, gera o token, sobe e mantém o webhook. Pelo hub, você só passa pela janela da Meta. E a coexistência com o app do celular só existe pelo Cadastro Incorporado de um parceiro.
| Item | Direto pela Meta | Por um hub (Omnique) |
|---|---|---|
| App na Meta | Você cria e configura | Não precisa: o app é do hub |
| Token de acesso | Você gera um token de usuário do sistema e guarda | Fica cifrado no hub |
| Webhook | Endpoint HTTPS seu, com verificação e conferência de assinatura | Você informa uma URL; a parte da Meta é do hub |
| Evento que falhou | A Meta reenvia por até 7 dias; deduplicar é com você | Fila, nova tentativa, log e reenvio manual |
| Coexistência com o app | Não disponível | Disponível |
| Custo além da Meta | Servidor e horas de dev | R$ 50 por número por mês, de 1 a 4 números |
Um detalhe que pesa na escolha: a Meta avisa que contas do WhatsApp Business criadas pelo app de desenvolvedor não podem ser selecionadas depois no Cadastro Incorporado. Se você testa direto na Meta e pretende migrar para um hub, use um número e uma conta separados para o teste.
Quanto custa ter a API oficial do WhatsApp?
A conta da Meta é por mensagem entregue, igual em qualquer caminho: no Brasil, desde 1º de outubro de 2026, R$ 0,035 para utilidade e autenticação e R$ 0,3217 para marketing. A resposta de atendimento tem 1.000 grátis por número por mês e custa R$ 0,035 da 1.001ª em diante. Direto pela Meta, some servidor e horas de dev. Num hub, some a mensalidade; no Omnique, R$ 50 por número, sem taxa de ativação.
| Uso no mês | Meta | Omnique (1 número) | Total |
|---|---|---|---|
| 2 mil respostas de atendimento com IA | R$ 35 (as primeiras 1.000 são grátis) | R$ 50 | R$ 85 |
| 1 mil lembretes de consulta (utilidade) | R$ 35 | R$ 50 | R$ 85 |
| 5 mil avisos de pedido (utilidade) | R$ 175 | R$ 50 | R$ 225 |
| 10 mil mensagens de marketing para quem pediu | R$ 3.217 | R$ 50 | R$ 3.267 |
Valores da Meta pela tabela em reais em vigor desde 1º de outubro de 2026, consultada em 6 de outubro de 2026. A resposta dentro da janela de 24 horas, que era grátis, passou a ser cobrada nessa data, depois das 1.000 grátis por número no mês, que não acumulam de um mês para o outro. Quem tem mais números paga menos por número no Omnique, até R$ 33; a tabela inteira está em preços.
Quanto tempo leva para conseguir a API oficial?
Pelo hub, a conexão leva minutos. Direto pela Meta, o número de teste manda a primeira mensagem no mesmo dia, mas produção pede endpoint próprio, token de usuário do sistema e número registrado. Virar Tech Provider é o caminho longo, com verificação da empresa, análise do app e verificação de acesso.
| Etapa | Prazo que a Meta documenta |
|---|---|
| Análise do app (só Tech Provider) | Cerca de 24 horas em média |
| Verificação de acesso (só Tech Provider) | Decisão em cerca de 5 dias depois do envio do formulário |
| Aumento automático de limite | Até 6 horas depois de cumprir os critérios de qualidade e uso |
| Verificação da empresa | Sem prazo nas páginas consultadas |
Pelo hub, depois da janela da Meta, a própria Meta pode deixar a conexão em análise antes de liberar. O painel do Omnique mostra esse estado, e o repasse dos eventos começa quando a Meta aprova.
Como conseguir a API oficial na prática?
Pelo hub são três passos: criar a conta, conectar o número pelo Cadastro Incorporado e informar a URL que vai receber os eventos. As telas, uma a uma, estão no passo a passo. Se você prefere montar tudo direto na Meta, o guia de configuração da Cloud API cobre app, token e webhook.
- Pelo Omnique: API oficial do WhatsApp passo a passo.
- Direto pela Meta: WhatsApp Cloud API: como configurar.
- Visão geral e todos os guias: como usar a API oficial do WhatsApp.
Quer ver funcionando com o seu número? Crie a conta e teste grátis por 3 dias, sem cartão. A mensagem você paga direto à Meta.