Você já construiu na Cloud API. Não precisa construir de novo.
Enviar uma mensagem de WhatsApp pelo seu próprio código é trabalho de uma manhã. Tudo o que vem depois — estados de aprovação de modelo, novas tentativas de webhook, tratamento de mídia, conciliação de entregas, descontinuações de versão e uma caixa de entrada para as respostas — é o projeto de verdade. A pergunta útil não é se você consegue construir, e sim se quer continuar mantendo.
- Uma integração existente com a Cloud API se muda sem tocar em como você monta as requisições
- Host e token
- As falhas chegam no envelope de erro que seu código já trata
- Os mesmos erros
- A versão fixada nas suas URLs continua funcionando depois que a Meta a aposenta
- Sem correr atrás de descontinuações
Para quem é
Desenvolvedores e agências que já integraram a Cloud API da Meta diretamente, ou estão prestes a isso, e estão pesando a manutenção contra uma plataforma.
A dúvida que resolve
"Trocar de plataforma significa reintegrar." Aqui não: os endpoints compatíveis espelham as rotas, os corpos e o envelope de erro da Cloud API, então trocar host e token é a migração.
A parte que é uma manhã e a parte que é um ano
A primeira mensagem é fácil. A lista abaixo é o que se acumula depois, e nada disso é trabalho interessante.
- Submissão de modelos, estados de aprovação, motivos de recusa e regras de ligação de variáveis
- Entrega de webhook, novas tentativas e um jeito de ver o que realmente chegou
- Upload e download de mídia, e as URLs que expiram
- Conciliar recibos de entrega e leitura de volta aos seus próprios registros
- Limitação de ritmo que dose os envios em vez de esbarrar nos limites da conta
- Uma caixa de entrada, porque os clientes respondem e alguém precisa ler
- Descontinuações de versão, no calendário da Meta e não no seu
Lado a lado
| Construir você mesmo | Numa plataforma | |
|---|---|---|
| Primeira mensagem enviada | Uma manhã | Um assistente e um playground |
| Ciclo de vida dos modelos | Você implementa | Uma tela com status e notificações |
| Depurar webhooks | Seus logs | Um botão de teste e um registro de entregas |
| Respostas | Você constrói uma caixa de entrada | Uma caixa compartilhada com atribuição e notas |
| Relatórios de entrega | Você concilia | Status por destinatário, exportável |
| Descontinuações da Meta | Você acompanha e migra | Absorvidas por você |
| Usuários não técnicos | Não conseguem ajudar | Rodam campanhas sem um desenvolvedor |
Comprar não significa abrir mão da API
Isto não é escolher entre código e painel. Você mantém o acesso programático — requisições assinadas, permissões por chave, um webhook com registro de entregas, trechos gerados e um playground — e ganha as partes que teria de escrever você mesmo. O time que quer um painel tem um; a pessoa desenvolvedora continua com uma API.
E migrar não é reescrever
O motivo comum de os times ficarem numa integração direta não costuma ser que ela seja melhor, e sim que mudar parece caro. Os endpoints compatíveis removem esse argumento: as mesmas rotas, os mesmos corpos de requisição, as mesmas respostas e o mesmo envelope de erro. Mude a URL base, mude o token, e use sua suíte de testes atual como a verificação da migração.
Conferido com o produto em 2026-08-14. As regras e cobranças do WhatsApp são definidas pela Meta e podem mudar.
Bom saber
Até onde este recurso vai, em palavras claras — para que nada aqui surpreenda você depois da contratação.
- A superfície compatível é uma lista de permissões proposital das rotas documentadas, não um proxy aberto, e suporta apenas GET, POST e DELETE.
- As requisições usam uma chave de API mais uma assinatura e um carimbo de tempo em vez de um token bearer pelado — e isso é proposital.
- Mídia em formato livre continua precisando de uma sessão aberta de 24 horas com o destinatário; fora dela, use um modelo.
- As cobranças de conversa da Meta valem de todo jeito, seja qual for a rota. Uma plataforma não as elimina.
- Reações só valem para mensagens dos últimos 30 dias e precisam do identificador de mensagem do próprio WhatsApp.
Perguntas frequentes
Quanto do meu código existente muda?
A URL base e o token. Rotas, corpos de requisição, respostas e formatos de erro batem, então sua suíte de testes é a verificação da migração.
Perco o acesso à API se usar a plataforma?
Não. Você tem chaves com permissões e uso por chave, um webhook com botão de teste e registro de entregas, um playground e trechos gerados — além do painel de que seus colegas não técnicos precisam.
Sai mais barato construir eu mesmo?
Para a primeira mensagem, sim. O custo está no que vem depois — estados de modelo, novas tentativas de webhook, mídia, conciliação, descontinuações e uma caixa de entrada — que é contínuo, não pontual.
O que acontece quando a Meta descontinua uma versão da API?
Numa integração direta, você migra. Nos endpoints compatíveis, a versão na sua URL é aceita e ignorada, então uma versão antiga continua funcionando.
Posso rodar os dois enquanto migro?
Pode. Como os formatos de requisição são idênticos, apontar um serviço para o novo host enquanto os outros ficam onde estão é uma mudança de configuração, não um branch.
Mude sem reintegrar
Troque o host, troque o token e fique com o código que você já escreveu.
Ver planosOs recursos por trás disso
Cada um em detalhe, inclusive seus limites.
- Compatível com a Cloud APIAs mesmas rotas, os mesmos corpos de requisição, o mesmo envelope de erro. Sua integração atual continua funcionando.
- Gerenciamento de APIChaves de API que você controla e pode revogar, um webhook com botão de teste e registro de entregas, um playground e trechos de código gerados.
- Message TemplatesCreate approved templates, track their status, and personalise them from your contact data — without learning Meta's Business Manager.
- Caixa compartilhadaTodas as conversas do número conectado, com responsável, status, etiquetas e notas internas. Um helpdesk, não um espelho do chat.
Outras comparações
As outras decisões que surgem junto.
- App vs APIO que cada um realmente entrega, quando o app grátis é de fato suficiente, e o que muda no dia em que você o supera.
- Oficial vs não oficialA diferença mecânica entre uma conexão oficial e uma ferramenta de dispositivo conectado — e o que isso significa para o número com que seu negócio funciona.
- Caixa compartilhada vs celular compartilhadoO que realmente quebra quando um time divide um único aparelho, e o que muda com uma caixa compartilhada.