API oficial do WhatsApp (Cloud): como funciona e como ter

A API oficial do WhatsApp — hoje chamada de WhatsApp Cloud API — é a forma que a Meta oferece para empresas atenderem clientes no WhatsApp em escala: com vários atendentes no mesmo número, automações, chatbots e integração com sistemas de atendimento. Diferente do aplicativo WhatsApp Business, a API não tem interface própria: ela é um "encanamento" que conecta o WhatsApp à plataforma que sua equipe realmente usa no dia a dia.

Neste guia, você vai entender como a API Cloud funciona, quais são os pré-requisitos, o que são a janela de 24 horas e os templates, e o caminho mais rápido para colocá-la em produção — sem precisar de um time de desenvolvimento.

O que é a WhatsApp Cloud API (e o que ela não é)

Até 2022, a API oficial exigia hospedar servidores próprios (a chamada On-Premises API). A Meta então lançou a Cloud API: a infraestrutura roda nos servidores da própria Meta, e as empresas (ou os provedores que as atendem) se conectam via chamadas HTTP.

Na prática, isso significa:

Não existe app da API. Você não instala nada no celular. As mensagens chegam e saem por meio de uma plataforma conectada à API — como o ClickDesk.
Vários atendentes, um número. Toda a equipe atende pelo mesmo número, com distribuição de conversas, filas e histórico unificado.
Selo de conta oficial. Empresas verificadas podem exibir o nome da marca e, em alguns casos, o selo de conta comercial oficial.
Automação de verdade. Chatbots, respostas automáticas, disparo de notificações e integração com CRM e tickets.

Se você ainda está em dúvida entre o aplicativo gratuito e a API, temos uma comparação detalhada em WhatsApp Business vs. API: qual usar na sua empresa.

Pré-requisitos: o que você precisa ter antes de começar

Antes de ativar a API oficial, garanta três coisas:

1. Uma conta no Meta Business (Gerenciador de Negócios)

É o painel onde a Meta administra ativos da sua empresa (páginas, contas de anúncio e o WhatsApp). Se sua empresa já anuncia no Facebook ou Instagram, provavelmente já tem uma. Criar é gratuito em business.facebook.com.

2. Um número de telefone dedicado

O número conectado à API não pode estar ativo no aplicativo WhatsApp ou WhatsApp Business ao mesmo tempo. Você tem duas opções:

Usar um número novo (fixo ou móvel — fixos funcionam bem e passam credibilidade).
Migrar o número atual do app para a API. É possível manter o número, mas o processo exige alguns cuidados — explicamos tudo em como migrar do WhatsApp Business para a API.

3. Verificação da empresa na Meta (recomendada)

Sem verificação, a conta opera com limites baixos (poucas conversas iniciadas pela empresa por dia). Com a verificação do negócio — envio de documentos como CNPJ e comprovante de endereço —, os limites sobem em camadas (1.000, 10.000, 100.000 conversas/dia) conforme a qualidade do número. Para atendimento receptivo o limite inicial costuma bastar; para campanhas ativas, a verificação é indispensável.

A janela de 24 horas: a regra mais importante da API

A Meta divide as conversas em dois cenários:

Cenário	Como funciona	O que você pode enviar
Cliente iniciou (janela de 24h)	Cada mensagem do cliente abre/renova uma janela de 24 horas	Mensagens livres: texto, áudio, imagem, botões, listas
Empresa inicia (fora da janela)	Você quer falar primeiro, ou a janela expirou	Apenas templates pré-aprovados pela Meta

Essa regra existe para proteger o usuário de spam — e é o que mantém o WhatsApp com taxas de abertura altíssimas. Na prática do mercado, ela muda a operação de dois jeitos:

Atendimento receptivo flui normalmente: o cliente chamou, você responde livremente por 24 horas a partir da última mensagem dele.
Contato ativo (confirmação de agendamento, atualização de pedido, cobrança, campanha) exige um template aprovado.

A cobrança da Meta também gira em torno desses cenários — detalhamos valores e categorias em quanto custa a API do WhatsApp.

Templates: mensagens pré-aprovadas pela Meta

Templates (modelos de mensagem) são textos estruturados que você cadastra e a Meta aprova antes do uso. Eles aceitam variáveis, botões e mídia. Um exemplo clássico:

Olá, {{1}}! Seu pedido {{2}} foi enviado e chega até {{3}}.
Acompanhe o rastreio pelo botão abaixo.

Regras essenciais:

Categorias: utilidade (transacional), marketing e autenticação — cada uma com preço e critérios diferentes.
Aprovação: costuma sair em minutos ou poucas horas, mas templates vagos, com erros de formatação ou tom de spam são rejeitados.
Qualidade: se muitos usuários bloqueiam ou denunciam, a nota do template (e do número) cai, reduzindo seus limites de envio.

Preparamos um guia com boas práticas e exemplos prontos em como criar e aprovar templates no WhatsApp.

Como ter a API oficial: integrar do zero vs. usar um provedor

Existem dois caminhos para ativar a Cloud API:

Caminho 1 — Integração direta com a Meta. Sua equipe de desenvolvimento cria o app no Meta for Developers, configura webhooks, armazena mensagens, constrói interface de atendimento, gerencia templates via API e mantém tudo atualizado a cada mudança da Meta. É viável — mas você estará construindo (e mantendo para sempre) um sistema de atendimento inteiro antes de responder o primeiro cliente.

Caminho 2 — Via uma plataforma de atendimento. Um provedor como o ClickDesk já tem a integração pronta e homologada: você conecta seu número em um fluxo guiado e ganha, no mesmo dia, caixa de entrada compartilhada, distribuição automática de conversas, chatbots com IA, gestão de templates com editor visual, relatórios e histórico unificado com os demais canais.

Para a esmagadora maioria das empresas, o caminho 2 é mais rápido, mais barato e mais seguro — a API sozinha não atende ninguém; quem atende é a operação construída em cima dela.

Passo a passo: ativando a API oficial pelo ClickDesk

O fluxo abaixo usa o Embedded Signup da Meta, o cadastro guiado dentro da própria plataforma. Leva cerca de 15 minutos.

1. Crie sua conta no ClickDesk. O trial de 14 dias não pede cartão. No painel, acesse Canais → WhatsApp → Conectar número.

Na tela: um botão "Conectar com a Meta" que abre uma janela pop-up oficial do Facebook.

2. Faça login com o perfil que administra o Meta Business. A janela da Meta pede autorização para o ClickDesk gerenciar a conta do WhatsApp Business em seu nome.

Na tela: a lista de portfólios empresariais (Meta Business) associados ao seu login — selecione o da sua empresa ou crie um na hora.

3. Crie a conta do WhatsApp Business (WABA) e o perfil comercial. Informe nome de exibição, categoria do negócio e descrição. O nome de exibição precisa ter relação real com a marca — nomes genéricos são recusados.

4. Registre e verifique o número. Digite o número dedicado e confirme o código recebido por SMS ou ligação (por isso números fixos também funcionam: a verificação pode ser por chamada de voz).

Na tela: campo para o código de 6 dígitos. Se o número ainda estiver no app WhatsApp Business, será preciso desconectá-lo antes.

5. Pronto: o número aparece conectado no ClickDesk. As conversas já caem na caixa de entrada, com filas, atribuição automática e SLA. A partir daqui:

Cadastre seus primeiros templates no editor visual (o ClickDesk envia para aprovação da Meta automaticamente);
Configure o agente de IA no flow builder para triagem e respostas fora do horário;
Envie a verificação do negócio no Meta Business para liberar limites maiores de conversas ativas.

6. (Opcional) Migre o histórico e os contatos. Se você vinha do aplicativo, exporte os contatos e importe no CRM do ClickDesk para não perder o contexto de nenhum cliente.

Erros comuns de quem está começando

Conectar o número sem tirá-lo do app. O registro falha ou a conta antiga é desativada de forma abrupta. Planeje a migração.
Ignorar a janela de 24h. Tentar mandar mensagem livre fora da janela simplesmente não entrega. Tenha templates de reengajamento prontos.
Templates com cara de spam. "Oferta imperdível!!!" com três links é rejeição na certa — e, se aprovado, derruba sua nota de qualidade.
Tratar a API como canal isolado. O ganho real aparece quando o WhatsApp entra no mesmo fluxo omnichannel de e-mail, chat e telefone, com um histórico único por cliente.

Comece pelo caminho mais curto

A API oficial do WhatsApp deixou de ser privilégio de grandes empresas: com a Cloud API e uma plataforma que cuida da parte técnica, qualquer operação de atendimento ativa o canal em um dia.

O ClickDesk conecta seu número oficial, aprova templates, distribui conversas para o time e coloca agentes de IA para responder 24/7 — tudo em português e com suporte brasileiro. Planos a partir de R$49 por agente/mês e trial de 14 dias sem cartão.

Conheça o WhatsApp oficial no ClickDesk →