Guia
Como usar a API oficial do WhatsApp
A API oficial do WhatsApp é a Cloud API da Meta: as mensagens chegam no seu sistema por webhook e você responde por HTTP, com o número dentro das regras do WhatsApp. Para usar, há três caminhos: configurar direto no painel de desenvolvedor da Meta, virar Tech Provider ou conectar o número por um hub como o Omnique.
Por Gustavo Calixto, fundador do Omnique. Atualizado em .
O que é a API oficial do WhatsApp?
A API oficial do WhatsApp é a Cloud API, a interface que a própria Meta hospeda para empresas enviarem e receberem mensagens por programa. Ela faz parte da Plataforma do WhatsApp Business. Seu sistema recebe cada evento por webhook e envia mensagens com chamadas HTTP, sem depender de celular ligado nem de QR code.
Na prática são duas peças. A primeira é o webhook: a Meta faz um POST no endereço que você cadastrou sempre que chega uma mensagem, um envio muda de status ou algo acontece na conta. A segunda é o envio: um POST em /<PHONE_NUMBER_ID>/messages na Graph API, autenticado com um token. Templates, perfil e número também são administrados pela mesma API.
Três nomes aparecem o tempo todo na documentação:
- Portfólio empresarial: a sua empresa dentro da Meta, o antigo Business Manager.
- Conta do WhatsApp Business (WABA): fica dentro do portfólio e guarda números e templates.
- Número comercial: o telefone registrado na Cloud API, identificado por um Phone Number ID.
A API oficial não é o app WhatsApp Business do celular, pensado para atender à mão. Também não é a API não oficial, que imita o WhatsApp Web. A Meta avisa que um número registrado na Cloud API não pode ser usado ao mesmo tempo no WhatsApp comum. A exceção é a coexistência com o app WhatsApp Business, explicada mais abaixo.
Para que serve a API oficial do WhatsApp?
Serve para automatizar conversa em escala sem arriscar o número. Os usos mais comuns são atendimento com agente de IA, avisos de pedido e de cobrança, lembretes de consulta, códigos de acesso e campanhas para quem pediu para receber. Tudo isso parte do seu sistema, do n8n ou de um CRM, e não de um celular.
Cada uso cai numa categoria de mensagem da Meta, e a categoria define o preço:
- Serviço: resposta livre dentro da janela de 24 horas. É o agente de IA respondendo, o atendente no Chatwoot, o fluxo do n8n que tira dúvida.
- Utilidade: template sobre algo que o cliente já fez, como confirmação de pedido, aviso de cobrança ou lembrete de agenda.
- Autenticação: template com código de acesso ou de verificação.
- Marketing: template de oferta, novidade, carrinho abandonado ou convite.
A API não traz tela de atendimento. Quem quer atender por inbox liga a API a uma ferramenta como o Chatwoot (veja Chatwoot com WhatsApp oficial). Quem automatiza no n8n recebe os eventos num nó Webhook (veja API oficial do WhatsApp no n8n).
Quais regras da Meta valem em qualquer caminho?
Quatro regras valem para todo mundo, direto pela Meta ou por um hub. Resposta livre só dentro da janela de 24 horas aberta pela mensagem do cliente. Fora dela, só template aprovado. Só fale com quem deu o número e aceitou receber. E existe um limite diário de pessoas novas, que começa em 250 por portfólio.
| Regra | O que a Meta diz |
|---|---|
| Janela de atendimento | Abre e se renova a cada mensagem do cliente e dura 24 horas. Dentro dela, a empresa responde com texto, mídia ou botões, sem template. |
| Template | Fora da janela, a empresa só inicia conversa com template, cobrado conforme a categoria. |
| Consentimento | Só pode contatar quem deu o número para a empresa e confirmou que quer receber mensagens dela. Pedido para parar precisa ser respeitado. |
| Limite de mensagens | 250 pessoas diferentes em 24 horas fora da janela, por portfólio, somando todos os números. Sobe para 2 mil verificando a empresa ou entregando 2 mil templates de alta qualidade em 30 dias; depois vai a 10 mil, 100 mil e ilimitado de forma automática. |
| Números por portfólio | Portfólio novo registra até 2 números. Com a empresa verificada ou o limite de 2 mil, o teto passa para 20. |
Nenhum caminho fura essas regras, e um hub também não. O que muda entre os caminhos é quanto trabalho de infraestrutura fica com você.
Quanto custa usar a API oficial do WhatsApp?
A Meta cobra por mensagem entregue, no cartão cadastrado na conta do WhatsApp Business. No Brasil, em reais, a mensagem de marketing custa R$ 0,3217 e as de utilidade e autenticação custam R$ 0,035 cada. Desde 1º de outubro de 2026, a resposta dentro da janela de 24 horas também é cobrada, depois de uma franquia: 1.000 respostas grátis por número por mês. Da 1.001ª em diante, R$ 0,035, pago direto à Meta.
| Categoria | Quando se usa | Preço por mensagem entregue |
|---|---|---|
| Serviço | Resposta livre dentro de 24 horas | Grátis até 1.000 por número no mês; depois, R$ 0,035 |
| Utilidade | Aviso de pedido, cobrança, agenda | R$ 0,035 |
| Autenticação | Código de acesso | R$ 0,035 |
| Marketing | Oferta, novidade, convite | R$ 0,3217 |
Tabela da Meta para contas faturadas em real, em vigor desde 1º de outubro de 2026 e consultada em 6 de outubro de 2026. Um agente de IA que manda 2 mil respostas no mês num número gasta R$ 35 na Meta: as primeiras 1.000 são grátis. Quando o cliente chega por um anúncio de clique para o WhatsApp e você responde em até 24 horas, abre uma janela de entrada grátis, que pode ficar aberta por até 7 dias, em que as mensagens não são cobradas. Desde 1º de julho de 2026, empresas brasileiras podem ser faturadas em reais pela Facebook Brasil, e a Meta exige a migração das contas para real até 30 de junho de 2027.
Por cima da Meta vem o custo do caminho. Direto, é o servidor e as horas de quem monta e mantém o webhook. Num hub, é a mensalidade. No Omnique são R$ 50 por número por mês de 1 a 4 números, com o preço por número caindo conforme você cresce, até R$ 33, sem taxa de ativação. A conta completa está em preços do Omnique.
Quais são os caminhos para usar a API oficial?
São três. Direto pela Meta, você cria um app no painel de desenvolvedor e cuida de token, webhook e servidor. Como Tech Provider, você passa pela verificação e pela análise da Meta para conectar números de outras empresas. Por um hub, você conecta o número numa janela da Meta e recebe a infraestrutura pronta.
| Direto pela Meta | Tech Provider | Hub (Omnique) | |
|---|---|---|---|
| Para quem | Dev que integra o número da própria empresa | Produto em que outras empresas conectam o próprio número | Quem quer o número oficial no n8n, no Chatwoot ou no sistema sem manter a camada da Meta |
| O que a Meta exige | App com o caso de uso do WhatsApp; análise do app não é exigida para uso próprio | Verificação da empresa, análise do app com vídeos, verificação de acesso e Cadastro Incorporado no seu site | Login do Facebook, portfólio e número, na janela da Meta |
| O que fica com você | Token, webhook com verificação e assinatura, fila e reenvio | Tudo do caminho direto, mais um token e uma conexão por cliente | Uma URL de destino e uma chave de API |
| Coexistência com o app | Não: a Meta exige Tech Provider ou Solution Partner | Sim | Sim |
| Custo além da Meta | Servidor e horas de dev | Servidor, horas de dev e o processo de aprovação | Mensalidade por número |
Direto pela Meta
É o caminho do dev que vai integrar um número da própria empresa. Você cria o app, gera um token de usuário do sistema, sobe um endpoint HTTPS que responde à verificação da Meta e confere a assinatura de cada POST. A Meta deixa claro que, usando a API só para o próprio negócio, não é preciso passar pela análise do app. O passo a passo está em WhatsApp Cloud API: como configurar.
Virando Tech Provider
É o caminho de quem vende um produto em que outras empresas conectam o próprio número. A Meta pede verificação da empresa, análise do app com dois vídeos e acesso avançado às permissões do WhatsApp, além da verificação de acesso. Depois você implementa o Cadastro Incorporado no seu site. Exigências, prazos e quando compensa estão em como virar Tech Provider da Meta.
Por um hub como o Omnique
O hub já é Tech Provider. Você abre a janela da Meta dentro do painel dele, faz login no Facebook, escolhe ou cria o portfólio, confirma o número e pronto. Token, endpoint da Meta, verificação e assinatura ficam com o hub. Para saber o que ter em mãos antes, leia como conseguir a API oficial do WhatsApp.
Como o Omnique entrega a API oficial sem a burocracia da Meta?
O Omnique é Provedor de Tecnologia da Meta. Você conecta o número pelo Cadastro Incorporado dentro do painel, em minutos, sem criar app nem gerar token. A partir daí cada evento chega na URL que você escolher, assinado e com identificador de entrega, e você envia mensagens com uma chave de API por instância.
- Entrega que não perde nem duplica: fila durável, nova tentativa automática,
delivery_idpara o seu fluxo não processar a mesma mensagem duas vezes, log de cada entrega e reenvio com um clique. - Assinatura nos dois lados: a assinatura da Meta é conferida na entrada, e cada entrega para você sai com o header
X-Omnique-Signature-256, um HMAC-SHA256 do corpo. - Coexistência: o número pode continuar no app WhatsApp Business, e o que você responde pelo celular também chega no seu sistema (veja coexistência: app e API no mesmo número).
- Envio pela mesma chave: texto, template, mídia, botões e listas, com chave de idempotência opcional para não mandar duas vezes.
- Templates no painel: criar, editar e acompanhar a aprovação sem abrir o gerenciador da Meta.
- Integrações: Chatwoot nos dois sentidos e 4 fluxos prontos para importar no n8n.
A mensagem você paga direto à Meta, no seu cartão, sem passar pelo Omnique. Teste grátis por 3 dias, sem cartão, e siga o passo a passo da API oficial do WhatsApp para receber a primeira mensagem no seu sistema.
API oficial ou não oficial: qual a diferença?
A API não oficial conecta pelo WhatsApp Web lendo um QR code e não paga a Meta por mensagem. Só que os Termos de Serviço do WhatsApp proíbem usar o serviço por meios automatizados não autorizados, e o número pode ser bloqueado. A oficial cobra por mensagem, com 1.000 respostas grátis por número no mês, e exige template fora da janela, mas opera dentro das regras.
A comparação completa, com cenários de custo, está em API oficial ou não oficial do WhatsApp. Se você usa a Evolution API, veja Evolution API ou API oficial. Se o número já caiu, comece por número banido no WhatsApp: o que fazer.
Por onde começar?
Depende do que você já tem e de onde quer chegar. A lista abaixo aponta o guia certo para cada situação: do requisito mínimo à primeira mensagem, da configuração direta na Meta ao status de Tech Provider, das integrações mais usadas às comparações com as alternativas.
Para entender e conectar
- Quer saber o que a Meta pede: como conseguir a API oficial do WhatsApp.
- Quer receber a primeira mensagem hoje: API oficial do WhatsApp passo a passo.
- Quer montar tudo direto na Meta: WhatsApp Cloud API: como configurar.
- Quer conectar números de clientes com o seu próprio app: como virar Tech Provider da Meta.
- Quer manter o número no celular: coexistência: app e API no mesmo número.
Para resolver um problema
- O webhook não chega: webhook do WhatsApp Cloud API.
- O número foi banido: número banido no WhatsApp: o que fazer.
Para a sua ferramenta ou o seu negócio
- Automação no n8n: API oficial do WhatsApp no n8n.
- Atendimento no Chatwoot: Chatwoot com WhatsApp oficial.
- Agência com números de clientes: API oficial do WhatsApp para agências.
Para comparar antes de decidir
- API oficial ou não oficial do WhatsApp.
- Evolution API ou API oficial do WhatsApp.
- Alternativa ao NotificaMe.
- Os melhores hubs da API oficial do WhatsApp em 2026.
Para os números, veja quanto custa o Omnique. Para a referência técnica de envio, eventos e assinatura, abra a documentação da API.