API oficial do WhatsApp: o que é, como funciona e como começar

O que é a API oficial do WhatsApp (Cloud API)

A API oficial é a interface que a Meta oferece para empresas integrarem o WhatsApp aos seus próprios sistemas. Em vez de alguém responder pelo celular, as mensagens entram e saem por software: uma plataforma de atendimento, um CRM, um chatbot ou um agente de IA.

Hoje a forma principal de acesso é a Cloud API, hospedada pela própria Meta. Você não precisa manter servidor de WhatsApp: a Meta cuida da infraestrutura e a sua plataforma conversa com ela.

Na prática, a WhatsApp Business API não tem um "aplicativo" para abrir. Ela é o motor. O que você vê no dia a dia é a tela da plataforma que está conectada a ela — e é por isso que quase toda empresa usa a API por meio de um provedor ou de um software de atendimento.

O que a API oficial permite e o app não

• Vários atendentes no mesmo número, cada um com seu login, sem compartilhar celular.
• Automação e IA respondendo de forma permitida pela Meta, com transferência para humano.
• Mensagens ativas em escala (lembretes, avisos de pedido, campanhas) usando modelos aprovados.
• Integração com loja, ERP, agenda e CRM.

WhatsApp Business app × API oficial × conexões não oficiais

Muita gente confunde as três coisas. A tabela resume o que muda entre elas:

Conexões por QR Code funcionam e muita empresa começa por elas. O ponto é que, quanto maior o volume de mensagens, maior o risco de restrição do número — veja o guia sobre WhatsApp bloqueado por spam. Para operação com equipe e campanhas recorrentes, a API oficial é o caminho mais seguro.

O que você precisa para usar a WhatsApp Business API

1. Conta empresarial na Meta (Meta Business, antigo Gerenciador de Negócios). É nela que fica a conta do WhatsApp Business e o número.
2. Um número de telefone que receba SMS ou ligação para validação e que não esteja ativo em outro app do WhatsApp. Se o número já está no WhatsApp ou no WhatsApp Business, em regra é preciso desvinculá-lo antes de registrar na API. A Meta vem testando formas de usar o app e a API no mesmo número; confirme com seu provedor se isso está disponível para o seu caso.
3. Nome de exibição coerente com a marca. A Meta revisa o nome e pode recusar nomes genéricos ou que não batem com o negócio.
4. Verificação do negócio na Meta, com documentos da empresa. Não é obrigatória para dar os primeiros passos, mas é o que libera limites maiores de envio e mais números.
5. Forma de pagamento cadastrada para as cobranças da Meta pelas mensagens de modelo.
6. Uma plataforma conectada à API para você de fato atender, já que a API em si não tem interface.

Também é preciso seguir as políticas de uso da Meta: ter permissão (opt-in) para mandar mensagens ativas, não vender produtos proibidos e oferecer uma forma de a pessoa parar de receber.

A janela de atendimento de 24 horas

Esta é a regra que mais pega quem chega na API oficial. Sempre que o cliente manda uma mensagem, abre-se uma janela de atendimento de 24 horas. Dentro dela, a empresa responde livremente: texto, áudio, imagem, documento, botões — sem precisar de modelo aprovado.

Cada nova mensagem do cliente renova a janela. Passadas 24 horas da última mensagem dele, a conversa "fecha" para texto livre. Para voltar a falar, a empresa precisa usar um modelo de mensagem aprovado.

Modelos de mensagem aprovados e suas categorias

Modelo (template) é uma mensagem cadastrada antes e revisada pela Meta. Pode ter variáveis — nome, número do pedido, data — e botões. A Meta classifica cada modelo em uma categoria, e a categoria define regras e preço:

Marketing

Promoções, lançamentos, convites, recuperação de carrinho, reativação de cliente. Tudo que tem objetivo de venda ou relacionamento comercial.

Utilidade

Avisos ligados a algo que o cliente já fez ou pediu: confirmação de pedido, atualização de entrega, lembrete de consulta, aviso de vencimento.

Autenticação

Códigos de verificação de uso único (login, confirmação de cadastro, recuperação de acesso).

Se um modelo de "utilidade" tiver cara de promoção, a Meta pode reclassificá-lo como marketing. Abaixo, dois exemplos de texto para você adaptar (as chaves numeradas são as variáveis):

Mais ideias de texto em 50+ modelos de mensagens automáticas.

Quanto custa a API oficial do WhatsApp: como a Meta cobra

A Meta cobra pelas mensagens de modelo entregues. O valor varia conforme a categoria (marketing costuma ser a mais cara, autenticação e utilidade mais baratas) e conforme o país do número de quem recebe. A tabela oficial é publicada e atualizada pela própria Meta, por isso vale sempre consultar a versão vigente antes de planejar uma campanha.

• Responder dentro da janela de 24 horas (mensagens de atendimento) não gera cobrança por mensagem da Meta.
• Modelos de utilidade enviados dentro da janela aberta também não são cobrados, segundo as regras atuais.
• Modelos fora da janela são cobrados por mensagem, de acordo com a categoria e o país.

Além do custo da Meta, existe o custo da plataforma que você usa para atender. São coisas separadas: uma é o "pedágio" da Meta pelo envio de modelos, a outra é o software que organiza equipe, automação e IA.

Limites de envio, qualidade e selo verificado

Limites que sobem com o uso

Números novos começam com um teto de contatos que podem receber mensagens iniciadas pela empresa em 24 horas. Esse limite sobe em degraus conforme a empresa envia com regularidade, mantém boa qualidade e conclui a verificação do negócio. Responder quem chamou primeiro não conta para esse teto.

Avaliação de qualidade

A Meta acompanha bloqueios, denúncias e a reação das pessoas às mensagens. Qualidade baixa trava o aumento de limite e pode pausar modelos ou restringir o número. Para manter a qualidade alta: mande só para quem deu permissão, segmente a lista, ofereça saída clara ("responda SAIR") e controle a frequência das campanhas.

Selo verificado

O selo de verificação ao lado do nome é concedido pela Meta segundo critérios dela — notoriedade da marca, verificação e, em alguns casos, assinatura de programas de verificação. Usar a API oficial não garante o selo, e nenhum provedor pode prometê-lo. O que a API garante é o nome da empresa exibido e uma conta comercial reconhecida pela Meta.

Como conectar a API oficial do WhatsApp via plataforma

Dá para integrar a Cloud API direto, programando. Para a maioria das empresas, faz mais sentido usar uma plataforma já conectada que entregue o atendimento pronto. O roteiro costuma ser este:

1. Crie a conta na plataforma e escolha conectar o WhatsApp pela API oficial.
2. Faça login com o perfil do Facebook que administra a sua conta empresarial na Meta (ou crie uma no caminho).
3. Informe o número, valide por SMS ou ligação e defina o nome de exibição.
4. Cadastre a forma de pagamento da Meta e, se ainda não fez, inicie a verificação do negócio.
5. Crie seus primeiros modelos (um de utilidade e um de marketing) e envie para aprovação.
6. Convide a equipe, configure horário, mensagens automáticas e o chatbot ou a IA.

Veja também

• WhatsApp bloqueado por spam: por que acontece e como evitar
• Disparo em massa no WhatsApp sem perder o número
• Chatbot para WhatsApp: o que é e como montar
• Multiatendimento no WhatsApp: vários atendentes em um número

Perguntas frequentes sobre a API oficial do WhatsApp