# WhatsApp Business API: o que é, como funciona e quando vale a pena

> O que é a API oficial do WhatsApp Business, como funcionam a janela de 24 horas, os modelos de mensagem e a cobrança, e quando vale migrar do aplicativo.

Publicado em 2026-10-25 por Equipe Franco. Fonte: https://papofranco.online/blog/whatsapp-business-api-guia-completo

**Resposta rápida:** a WhatsApp Business API (hoje chamada de *WhatsApp Business Platform*, na versão Cloud API) é a forma oficial da Meta para empresas usarem o WhatsApp em escala: vários atendentes no mesmo número, integração com CRM e chatbots, disparos com modelos aprovados e mensagens automáticas. Ela não tem aplicativo próprio. Você usa a API por meio de uma plataforma de atendimento. Vale a pena quando mais de uma pessoa atende pelo mesmo número, quando você precisa de automação ou quando o volume de conversas já não cabe no celular.

## O que é a WhatsApp Business API

O WhatsApp tem três produtos para empresas:

| Produto | Para quem | Limites principais |
| --- | --- | --- |
| **WhatsApp Business (app)** | Pequenos negócios com uma ou poucas pessoas atendendo | Funciona no celular e em alguns aparelhos vinculados. Automação limitada a mensagens de saudação, ausência e respostas rápidas |
| **WhatsApp Business Platform (API)** | Empresas com equipe de atendimento, vendas ou suporte | Não tem interface própria: precisa de uma plataforma (como o Franco) ou de desenvolvimento próprio |
| **WhatsApp pessoal** | Uso pessoal | Não deve ser usado para atendimento comercial |

A API é o mesmo WhatsApp que o cliente já usa. A diferença está do lado da empresa: em vez de um celular, as mensagens chegam em um sistema que distribui conversas entre atendentes, registra histórico, aciona automações e mede resultados.

Desde 2023, a Meta oferece a **Cloud API**, hospedada pela própria Meta. Na prática, ela substituiu a antiga versão "on-premises", que exigia servidores próprios. Hoje praticamente toda integração nova usa a Cloud API.

## Como a API funciona na prática

Três conceitos explicam quase tudo o que você vai encontrar no dia a dia.

### 1. A janela de atendimento de 24 horas

Quando o cliente manda uma mensagem, abre-se uma **janela de atendimento de 24 horas**. Durante esse período a empresa pode responder livremente, com texto, imagens, áudios, documentos e botões. Cada nova mensagem do cliente reinicia a contagem.

Quando a janela fecha, a empresa só pode iniciar a conversa de novo com um **modelo de mensagem** (*template*) aprovado pela Meta. É assim que funciona o [follow-up de clientes que pararam de responder](/blog/follow-up-de-vendas-no-whatsapp). É isso que impede o uso do WhatsApp para spam e é a regra que mais pega equipes de surpresa.

> Dica prática: se o cliente sumiu há mais de 24 horas, um "Oi, tudo bem?" digitado à mão não sai. Tenha modelos aprovados prontos para retomar conversas.

### 2. Modelos de mensagem (templates)

Modelos são mensagens pré-aprovadas, com variáveis (como `{{1}}` para o nome do cliente) e, opcionalmente, botões e mídia. Cada modelo pertence a uma categoria:

- **Marketing:** ofertas, novidades, convites, recuperação de carrinho e qualquer mensagem promocional.
- **Utilidade:** atualizações sobre algo que o cliente já pediu ou contratou, como confirmação de pedido, status de entrega, lembrete de pagamento ou de agendamento.
- **Autenticação:** códigos de verificação de acesso (senha de uso único).

A Meta revisa cada modelo e pode **reclassificar** a categoria. Um "lembrete" com tom de promoção vira marketing. A aprovação costuma ser rápida, mas modelos vagos, com erros de português ou que parecem enganosos são recusados.

### 3. Número, perfil e verificação

A API usa um número de telefone exclusivo. Ele não pode estar ativo ao mesmo tempo no aplicativo WhatsApp comum. Esse número fica ligado a uma conta do WhatsApp Business dentro do **portfólio empresarial** da Meta (o antigo Business Manager). Verificar a empresa no portfólio libera limites maiores de envio e dá mais credibilidade ao perfil.

## Quanto custa a API oficial

A cobrança é feita pela Meta e, desde julho de 2025, segue o modelo **por mensagem de modelo entregue**. Em linhas gerais:

- **Respostas dentro da janela de 24 horas** (mensagens de atendimento, texto livre) não são cobradas.
- **Modelos de utilidade** enviados dentro de uma janela de atendimento aberta também não são cobrados.
- **Modelos de marketing** são cobrados por mensagem entregue, com preço que varia por país.
- **Modelos de utilidade e autenticação** fora da janela são cobrados, com preços menores que os de marketing.
- Conversas que começam por **anúncios de clique para o WhatsApp** ou pelo botão da página do Facebook abrem uma janela gratuita estendida.

Os valores mudam por país e são atualizados pela Meta periodicamente. Antes de planejar uma campanha, confira a tabela oficial de preços da Meta para o Brasil. Além do custo da Meta, existe o custo da plataforma que você usa para operar a API.

## Quando vale a pena sair do aplicativo e ir para a API

Use este checklist. Se marcar dois ou mais itens, a API provavelmente já se paga:

- Mais de uma pessoa responde pelo mesmo número.
- Clientes reclamam de demora ou de "ninguém respondeu".
- Você perde o histórico quando um atendente sai da empresa ou troca de aparelho.
- Precisa avisar muitos clientes ao mesmo tempo (pedido, cobrança, campanha).
- Quer que uma IA ou um chatbot responda perguntas repetidas fora do horário comercial.
- Precisa medir tempo de resposta, volume por canal e conversão de vendas.
- Usa ou quer usar um CRM ligado às conversas.

Se nenhum item faz sentido hoje, o aplicativo WhatsApp Business continua sendo uma boa opção.

## Como começar com a API oficial

1. **Escolha o número.** Pode ser um número novo ou o atual. Se for o atual, ele precisa sair do aplicativo antes da migração, e as conversas antigas do celular não vão junto.
2. **Organize o portfólio empresarial da Meta.** Tenha acesso de administrador e, se possível, inicie a verificação da empresa com CNPJ e documentos.
3. **Conecte o número pela plataforma de atendimento.** No Franco, a conexão é feita pelo fluxo oficial da Meta, sem instalar nada.
4. **Configure o perfil:** nome de exibição, foto, descrição, endereço e site. O nome de exibição passa por aprovação da Meta.
5. **Crie os primeiros modelos:** uma mensagem para retomar conversas, uma confirmação de pedido ou agendamento e, se fizer sentido, uma oferta.
6. **Defina regras de atendimento:** quem recebe cada conversa, horários, mensagens automáticas e quando a IA passa para uma pessoa.

## Erros comuns de quem está começando

- **Comprar listas de contatos.** Veja [como fazer disparo em massa sem bloqueio](/blog/disparo-em-massa-whatsapp-sem-bloqueio). Além de violar as políticas do WhatsApp e a LGPD, derruba a qualidade do número rapidamente.
- **Mandar promoção como se fosse utilidade.** A Meta reclassifica, e o envio pode ser bloqueado.
- **Ignorar a qualidade do número.** O WhatsApp Manager mostra a classificação de qualidade (alta, média ou baixa). Muitos bloqueios e denúncias reduzem seus limites de envio.
- **Não ter dono para cada conversa.** Com vários atendentes no mesmo número, conversas sem responsável ficam sem resposta. Distribua por equipe ou por regra.
- **Automatizar sem saída humana.** Bots que não deixam o cliente falar com uma pessoa geram frustração e denúncias.

## Como o Franco usa a API oficial

O Franco conecta o número da empresa pela Cloud API e coloca as conversas do WhatsApp na mesma caixa de entrada de Instagram, Facebook, e-mail, Telegram e chat do site. A partir daí:

- cada conversa tem responsável, etiquetas, notas privadas e histórico completo;
- o **Capitão**, a IA de atendimento, responde com base nos documentos da empresa e transfere para uma pessoa quando precisa;
- os **disparos** usam apenas modelos aprovados, com ritmo controlado e respeito a quem pediu para não receber;
- quando a janela de 24 horas fecha, a equipe pode retomar a conversa com um modelo aprovado direto do card da conversa.

## Perguntas frequentes

### A WhatsApp Business API é gratuita?

O acesso à Cloud API é gratuito, mas o envio de modelos de mensagem é cobrado pela Meta por mensagem entregue, conforme a categoria e o país. Responder clientes dentro da janela de 24 horas não é cobrado. Além disso, você paga a plataforma que usa para operar a API.

### Posso usar o mesmo número no aplicativo e na API?

Não ao mesmo tempo, na configuração padrão. O número conectado à API deixa de funcionar no aplicativo comum. Por isso é importante decidir antes da migração se vale usar um número novo.

### O que acontece se eu mandar mensagem fora da janela de 24 horas?

Mensagens de texto livre não são entregues fora da janela. Para falar com o cliente de novo, é preciso usar um modelo aprovado pela Meta.

### Preciso de um desenvolvedor para usar a API?

Não, se você usar uma plataforma de atendimento que já integra a API oficial. O desenvolvimento só é necessário se você quiser construir a sua própria interface do zero.

### A API oficial evita que meu número seja banido?

Ela reduz bastante o risco, porque você opera dentro das regras da Meta. Mas o número ainda pode ter limites reduzidos ou ser restringido se receber muitos bloqueios e denúncias, por exemplo, ao mandar mensagens para quem não pediu.