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

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:

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. É 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. 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.