WhatsApp Cloud API: o que é e como começar sem servidor
O que é a WhatsApp Cloud API, por que ela substituiu a versão instalada em servidor próprio e o caminho para enviar a primeira mensagem sem infraestrutura.
Resumo por IA
Resumo gerado por IA, revisado pela redação.
A Cloud API é a versão da API oficial do WhatsApp hospedada pela própria Meta. Você não instala nada, não mantém servidor e não cuida de atualização: faz chamadas para o endereço da Meta e pronto. Desde outubro de 2025, quando a versão instalável foi desligada, ela é o único caminho oficial — e a boa notícia é que começar a usar ficou muito mais barato, porque a infraestrutura saiu da sua conta.
Adicione ao Google NotíciasNeste artigo
O que mudou em relação à versão antiga
Até 2025 havia duas opções. A On-Premises rodava num servidor da sua empresa: exigia máquina, banco de dados, time para atualizar e lidar com queda. A Cloud API nasceu como alternativa e acabou substituindo a outra por completo.
| Aspecto | Versão instalada (desligada) | Cloud API |
|---|---|---|
| Onde roda | Servidor da sua empresa | Infraestrutura da Meta |
| Custo de infraestrutura | Seu | Zero |
| Atualização de versão | Manual, com janela de manutenção | Automática |
| Tempo até a primeira mensagem | Dias | Minutos |
| Disponível hoje | Não | Sim |
Quem ainda encontra tutorial falando em instalar contêiner e subir banco está lendo material de antes do desligamento. Não há o que instalar.
Como a Cloud API funciona
São duas direções, e entender a diferença evita a maior parte dos problemas de quem está começando.
Para enviar, o seu sistema faz uma chamada para o endereço da Meta, dizendo o número de destino e o conteúdo. A resposta traz um identificador único daquela mensagem — guarde-o, porque é por ele que você vai saber depois se foi entregue e lida.
Para receber, o caminho é inverso: a Meta chama um endereço seu, público, toda vez que acontece alguma coisa. Mensagem nova do cliente, confirmação de entrega, leitura, falha de envio — tudo chega por ali.
É neste ponto que trava quem está começando. Enviar funciona de primeira, porque é só uma chamada. Receber exige um endereço público, acessível pela internet, que responda rápido. Sistema rodando só na máquina do desenvolvedor não recebe nada — e o sintoma é cruel: o teste de envio passa, e as respostas dos clientes somem.
O que você precisa antes de começar
- Portfólio empresarial no Gerenciador de Negócios da Meta, com a empresa verificada.
- Um aplicativo criado no painel de desenvolvedores, com o produto do WhatsApp adicionado.
- Um número que não esteja ativo em outra conta de API.
- Um endereço público para receber os eventos — pode ser um servidor simples, uma função sem servidor ou um túnel durante o desenvolvimento.
Para testar antes de tudo isso, a Meta oferece um número de teste e um punhado de destinatários cadastrados. Serve para validar a integração, não para atender cliente.
Passo a passo até a primeira mensagem
- Crie o aplicativo no painel de desenvolvedores e adicione o produto do WhatsApp. Ele já vem com um número de teste.
- Cadastre um destinatário de teste — o seu próprio celular serve. Sem esse cadastro, o número de teste não envia para ninguém.
- Envie a mensagem de exemplo que o painel oferece. Se chegar no seu celular, a parte de envio está funcionando.
- Configure o recebimento. Informe o seu endereço público e o texto de verificação que você escolher. A Meta chama esse endereço uma vez para confirmar que ele é seu.
- Assine os eventos da conta. Esta etapa é separada da anterior e é a mais esquecida: sem ela, o endereço está configurado mas não recebe nada.
- Responda pelo celular e confirme que a mensagem apareceu no seu sistema. É o teste que fecha o circuito.
- Troque o número de teste pelo número real, registrando-o com um PIN de seis dígitos.
Quem prefere não escrever código consegue montar o mesmo circuito com ferramentas de automação visual, que já trazem os blocos de envio e de recebimento prontos — o caminho está detalhado em como conectar a WhatsApp Cloud API ao n8n, que cobre a montagem passo a passo.
Cuidados que economizam retrabalho
- Confirme que a chamada veio mesmo da Meta. Cada evento recebido traz uma assinatura que precisa ser conferida contra o segredo do seu aplicativo. Endereço público sem essa conferência aceita qualquer coisa que alguém mandar.
- Responda rápido e processe depois. A Meta espera uma confirmação imediata. Se o seu sistema demora para responder porque está salvando em banco ou chamando outro serviço, a entrega é considerada falha e repetida.
- Trate mensagem repetida. Pela regra acima, o mesmo evento pode chegar mais de uma vez. Guarde o identificador e ignore o que já foi processado, senão o cliente recebe resposta duplicada.
- Fixe a versão nas chamadas. A Meta mantém cada versão por pelo menos dois anos; quando uma expira, as chamadas passam a ser atendidas por outra, o que pode mudar formatos sem aviso útil.
- Guarde o PIN do número. Ele é pedido de novo em qualquer migração futura, e recuperá-lo é burocrático.
Mensagem de teste chegando no celular, resposta do celular aparecendo no seu sistema e a assinatura dos eventos sendo conferida: a integração está de pé e pode receber o número real.
Quanto custa
A Cloud API em si não tem mensalidade nem custo de infraestrutura — essa é a mudança em relação à versão antiga. O que se paga é a mensagem, pela tabela da Meta por categoria. No Brasil, mensagem promocional custa R$ 0,3217 e as de utilidade, autenticação e serviço custam R$ 0,035, com mil mensagens de serviço gratuitas por número a cada mês.
Perguntas frequentes
O que é a WhatsApp Cloud API?
É a versão da API oficial do WhatsApp hospedada pela Meta. O seu sistema envia mensagens chamando o endereço dela e recebe os eventos num endereço seu, sem que você mantenha servidor nenhum.
Como ativar a Cloud API?
Criando um aplicativo no painel de desenvolvedores da Meta com o produto do WhatsApp, cadastrando um destinatário de teste, configurando o endereço de recebimento, assinando os eventos da conta e registrando o número definitivo com um PIN de seis dígitos.
A Cloud API é gratuita?
O acesso e a infraestrutura são. Não há mensalidade nem custo de servidor. As mensagens enviadas são cobradas pela categoria, e cada número tem mil mensagens de serviço gratuitas por mês.
Qual a diferença entre Cloud API e a API oficial do WhatsApp?
Hoje são a mesma coisa. A API oficial tinha duas formas de rodar, e a instalável foi desligada em outubro de 2025 — restou a Cloud API.
Preciso de servidor para usar?
Não para enviar. Para receber, você precisa de um endereço público que a Meta possa chamar, mas ele pode ser uma função sem servidor ou um serviço hospedado simples, sem máquina dedicada.
Dá para usar sem programar?
Dá, por duas vias: contratando uma plataforma pronta, que entrega painel e relatórios, ou montando o circuito em uma ferramenta de automação visual, que traz os blocos de envio e recebimento prontos.
Este tutorial faz parte do guia API oficial do WhatsApp: o que é, quanto custa e como ter. Veja também: Quanto custa a API oficial do WhatsApp: o preço por mensagem · Coexistência no WhatsApp: app e API oficial no mesmo número · API oficial da Meta ou solução não oficial: qual usar no WhatsApp da empresa · Como contratar e ativar a API oficial do WhatsApp passo a passo · Disparo em massa no WhatsApp: o que a API oficial permite e o que derruba a conta · Meta Tech Provider: o que é e como se tornar um
