Guias

API oficial do WhatsApp (Cloud API): o que é e como funciona

O que é a Cloud API do WhatsApp, o que muda em relação ao app WhatsApp Business, o que é uma WABA, como funciona a cobrança e quando vale a pena migrar.

Atualizado em 2 de setembro de 2026

A Cloud API é a interface que a Meta hospeda para empresas enviarem e receberem mensagens no WhatsApp por software, sem nenhum aparelho ligado. Ela é a evolução da antiga On-Premises API e hoje é o caminho padrão — e o único oficialmente suportado — para colocar uma equipe inteira, um sistema ou um agente de IA atendendo no mesmo número.

Qual a diferença entre o app WhatsApp Business e a API oficial?

O aplicativo é feito para uma pessoa em um celular. A API é feita para uma empresa: várias pessoas atendendo ao mesmo tempo, histórico centralizado, integração com CRM, ERP, site e agentes.

App WhatsApp Business API oficial (Cloud API)
Quem atende 1 celular (+ até 4 aparelhos vinculados) equipe inteira, sem limite de aparelhos
Onde roda no aparelho nos servidores da Meta
Integrações nenhuma qualquer sistema, por HTTP
Envio fora da conversa manual template aprovado
Custo grátis por mensagem de template, cobrado pela Meta
Interface pronta sim depende da plataforma que você usa

A API não tem tela própria: ela entrega mensagens. A caixa de entrada, os papéis da equipe e os relatórios vêm da plataforma que você conecta em cima dela — no caso da Nivox, pelo cadastro incorporado da Meta.

O que é uma WABA?

WABA é a sigla de WhatsApp Business Account: o contêiner, dentro do Business Manager da Meta, que guarda os seus números, os templates aprovados e a classificação de qualidade. Ela é criada em nome da sua empresa. Isso importa por um motivo prático: se um dia você trocar de plataforma, a WABA, o número e o histórico de aprovação continuam sendo seus.

Como funciona a cobrança?

Desde 2025 a Meta cobra por mensagem enviada a partir de um template, com preço por categoria e por país de destino:

  • marketing — promoções, novidades, carrinho abandonado;
  • utilidade — confirmações, atualizações de pedido, lembretes de um serviço já contratado;
  • autenticação — códigos de verificação.

As mensagens de atendimento — as que você envia dentro da janela de 24 horas aberta pelo cliente — não são cobradas pela Meta. A tabela de preços é publicada pela Meta e vale para a sua conta independentemente da plataforma. Na prática, quem responde rápido dentro da janela gasta pouco; quem depende de disparo frio gasta muito.

O que é preciso para começar?

  1. Um número de telefone que não esteja ativo no WhatsApp comum. Se ele está hoje no app WhatsApp Business, dá para migrar — ou manter os dois em coexistência.
  2. Um Business Manager da Meta com a empresa cadastrada. A verificação de negócio é exigida para liberar volumes maiores e alguns recursos.
  3. Uma plataforma conectada à Cloud API, que é quem entrega a caixa de entrada, os papéis e as integrações.

Com o Embedded Signup, os três passos acontecem em uma janela só, sem sair do site e sem trocar tokens por e-mail.

Quando vale a pena migrar?

Vale quando pelo menos uma destas frases descreve o seu dia:

  • mais de uma pessoa precisa responder o mesmo número, e o celular virou gargalo;
  • o atendimento precisa saber o que existe no seu sistema — pedido, estoque, agenda;
  • você quer enviar confirmações e lembretes automaticamente, sem alguém digitando;
  • você quer um agente de IA respondendo as perguntas repetidas e passando o resto para uma pessoa.

Se nada disso vale ainda, o app resolve. A partir daí, a API oficial é o caminho — e vale insistir no oficial: as alternativas por QR code colocam o número em risco sem oferecer nada que a Cloud API não faça.

Ficou alguma dúvida?

As perguntas frequentes cobrem preço, regras da Meta, papéis da equipe e acesso de agentes. A documentação técnica é pública e pode ser lida por qualquer agente de IA.