API oficial do WhatsApp

WhatsApp Business API: o que é a API oficial e como usar no seu número.

A WhatsApp Business API, hoje chamada de Cloud API, é a única forma autorizada pela Meta de ligar o WhatsApp da empresa a um bot, a um painel com vários atendentes ou a um sistema. Dá para conectar o número que a empresa já usa sem tirá-lo do app do celular.

Pede cartão. Nada é cobrado nos 7 dias; cancele pelo painel antes do 8º dia e não paga.

Autorizada pela Meta

É o caminho previsto nos termos do WhatsApp. Ferramenta que conecta por QR code é proibida e põe o número em risco de banimento.

Roda na Meta

A Cloud API fica nos servidores da Meta. Você não instala nada nem depende de um celular ligado para o bot responder.

Mesmo número, mesmo app

Com a Coexistência, o número continua no app WhatsApp Business do celular enquanto o bot responde pela API.

App WhatsApp Business, WhatsApp Business API: o que é cada coisa

Os dois produtos se chamam “WhatsApp Business” e fazem coisas diferentes. Confundir os dois é a origem da maior parte das decisões erradas nesse assunto.

O app WhatsApp Business

É o aplicativo que se baixa na loja, gratuito, feito para quem atende sozinho ou quase. Tem catálogo simples, etiquetas, mensagem de saudação e de ausência e respostas rápidas. Depende do celular ligado, não integra com sistema nenhum e não responde perguntas, só guarda texto pronto para você enviar.

A WhatsApp Business Platform (Cloud API)

É a via oficial da Meta para empresas conectarem o WhatsApp a software. Não tem interface própria: você acessa por uma plataforma. Roda em servidor, não depende de celular, permite vários atendentes no mesmo número com histórico centralizado, integra com CRM e catálogo e é o único caminho autorizado para automação.

E as ferramentas não oficiais

Existe um terceiro grupo, que se conecta pelo WhatsApp Web e automatiza por fora. É proibido pela Meta. Funciona até o número cair, e o desfecho costuma ser sem aviso e sem recuperação. O desconto não compensa perder o número da empresa.

Quem precisa da API, e quem não precisa

A resposta honesta é que muita empresa não precisa. A API passa a fazer sentido quando pelo menos uma destas coisas é verdade:

Se nada disso se aplica, o app gratuito resolve. Não há vergonha nenhuma nisso, há empresa pagando plataforma para usar o que o app já fazia.

Como funciona a cobrança da Meta

A Cloud API não tem mensalidade da Meta. A Meta cobra por mensagem entregue, direto na conta do dono do número, e a regra vale para qualquer plataforma.

A janela de 24 horas

Quando o cliente manda uma mensagem, abre-se uma janela de 24 horas em que a empresa responde livremente, sem template. Desde 1º de outubro de 2026, a Meta cobra essas respostas por mensagem entregue: as 1.000 primeiras do mês, por número, são grátis e, acima disso, cada uma custa US$ 0,0068 no Brasil. Passadas as 24 horas, só é possível reabrir com um template previamente aprovado, que também é cobrado. A regra é da Meta e vale para qualquer plataforma na API oficial.

As categorias de template

Utilidade (confirmação, lembrete, status de pedido) e autenticação (código de verificação) custam US$ 0,0068 por mensagem no Brasil. Marketing é a categoria mais cara.

Na prática, uma operação de atendimento em que o cliente puxa a conversa gasta pouco com a Meta, porque as 1.000 primeiras respostas do mês são grátis. Gasta mais quem dispara campanha. Some sempre o custo da plataforma, e confira se ela cobra margem em cima do preço da Meta. A conta completa está em preço da API do WhatsApp, e os planos do MercaBot em preços.

Como conseguir acesso à API, passo a passo

  1. Tenha o número no app WhatsApp Business. Pode ser o que a empresa já usa. Com o modo Coexistência ele continua funcionando no app do celular. Se estiver no WhatsApp comum, migre para o WhatsApp Business antes: é grátis e as conversas vão junto.
  2. Conecte pela Meta. O login e a autorização acontecem na própria Meta, com a conta comercial da empresa.
  3. Verifique o negócio. A Meta pede documento da empresa para liberar limites maiores de envio. Dá para começar antes da verificação, com limite reduzido.
  4. Suba os templates. Toda mensagem que reabre conversa precisa ser aprovada antes. Reprovação é comum quando o texto parece promoção disfarçada de aviso.
  5. Configure a automação. Catálogo, horário, políticas e o que a resposta automática pode prometer.

Com uma plataforma que faz a ativação guiada, a conexão sai pelo cadastro oficial da Meta, sem programar. Feito direto na Meta, sem intermediário, exige desenvolvimento próprio.

Cloud API: a versão da API que roda na Meta

Quando alguém fala hoje em WhatsApp Business API, está falando da Cloud API. É a mesma WhatsApp Business Platform, hospedada nos servidores da Meta. A versão antiga, que a empresa instalava no próprio servidor (On-Premises), foi descontinuada.

Para quem não programa, a diferença prática é que não há nada para instalar nem manter. O software conversa com a Cloud API pela internet, e a Meta cuida da infraestrutura. É por ela que a MercaBot, as outras plataformas oficiais e os sistemas feitos sob medida se conectam.

BSP, Tech Provider e plataforma: quem conecta você à API

A empresa não entra na API sozinha, a não ser que tenha desenvolvedor. Ela entra por um parceiro oficial da Meta, e existem dois tipos:

A MercaBot é Tech Provider. A conta do WhatsApp fica no seu Meta Business Manager, a cobrança das mensagens vem da Meta, e a MercaBot cobra só o plano. Se um dia quiser trocar de fornecedor, o número continua seu.

O que derruba um número na API

Perguntas frequentes

Preciso trocar de número?

Não. O número que a empresa já usa é conectado à API, e com a Coexistência ele continua no app do celular.

Isso é só para empresa grande?

Não. O que define o valor não é o tamanho da empresa, e sim o quanto o WhatsApp já pesa na rotina comercial.

A API sozinha responde o cliente?

Não. A API é o canal. Quem responde é o software ligado a ela: um bot, um painel de atendimento ou um sistema.

E o WhatsApp que eu já uso no celular?

Se o número está no app WhatsApp Business (o verde com o “B”), ele continua no celular: na janela em que você conecta, escolha o modo Coexistência da Meta. Você atende pelo celular quando quiser, e o bot pausa sozinho naquela conversa assim que percebe a sua resposta. Está em todos os planos. Como funciona a Coexistência.

Se o número está no WhatsApp comum, instale o WhatsApp Business e migre a conta antes de conectar: é grátis e as conversas vão junto. A Meta pede um histórico de uso no app antes de liberar esse modo. Se não quiser esperar, dá para conectar um número só para o atendimento (chip novo ou o fixo da empresa).

Se eu quiser sair depois, perco meu número?

Não. A conta do WhatsApp fica no seu Meta Business Manager, e a MercaBot entra como fornecedora autorizada, nunca como dona do número. No painel existe "Desconectar meu número", com duas opções: desvincular da MercaBot (o número segue na API oficial, pronto pra outro fornecedor) ou liberar pra você voltar a usá-lo no app do WhatsApp Business. Nenhuma das duas apaga o número nem o histórico.