Aprender: a API oficial do WhatsApp para quem integra
Guias para quem conecta números de clientes à API oficial do WhatsApp: o que ela é, quanto custa, como ela se compara às APIs não oficiais e como integrar com código, webhooks e n8n.
O conteúdo está organizado em cinco temas, do conceito à integração. Quem quer usar o WhatsApp oficial sem programar encontra o produto pronto no CRPRO CRM, da mesma empresa.
API oficial do WhatsApp
O que é a Cloud API, como um número se conecta a ela e como o aplicativo e a API convivem no mesmo número.
- O que é a API oficial do WhatsApp
Definição, como ter acesso, o que é preciso para começar e as regras da Meta.
- WhatsApp Cloud API: o que é e como usar
Endpoint, tokens, webhooks, limites de envio e o que mudou em 2025 e 2026.
- Coexistência: app e API no mesmo número
Como funciona, o que o cliente precisa fazer e os limites da plataforma.
- Como conectar um número à API oficial
O que a Meta exige, os passos do Embedded Signup e o que muda depois.
- Tech Provider ou BSP
As categorias de provedor da Meta e de onde vem o markup por mensagem.
Custos da API
O que a Meta cobra por mensagem, o que mudou em outubro de 2026 e quanto custa a sua operação.
- Quanto custa a API oficial do WhatsApp
As duas cobranças separadas: a da Meta, por mensagem, e a assinatura do Hub.
- Calculadora de custo da API
Estima o que a Meta cobra e o que o Hub cobra, separados.
- O que mudou na cobrança em outubro de 2026
Mensagem de serviço e template de utilidade dentro da janela, com os valores do Brasil.
Oficial ou não oficial
Riscos, custo real e como sair de uma API não oficial sem trocar o número do cliente.
- API oficial x não oficial
Comparação lado a lado, risco para o número e custo de manutenção.
- Como escolher uma API de WhatsApp
As perguntas estruturais que separam os provedores.
- Alternativa à Z-API
Sessão do WhatsApp Web x Cloud API oficial, e como migrar sem trocar de número.
Integrar e automatizar pela API
Do primeiro envio aos webhooks assinados, com código em Node.js, Python, PHP e um fluxo pronto no n8n.
- Início rápido
Da chave de API até a primeira mensagem enviada.
- Como integrar a API do WhatsApp no n8n
Enviar mensagem pelo nó HTTP Request e receber eventos pelo nó Webhook, sem escrever código.
- Como enviar um template de WhatsApp pela API
Quando o template é obrigatório, como montar o corpo com as variáveis, e por que um template aprovado ainda pode voltar recusado no envio.
- Como configurar um webhook do WhatsApp
Registre um endpoint, valide a assinatura HMAC SHA-256, teste a entrega e reenvie um evento perdido — sem expor o segredo.
- Automação de WhatsApp pela API
O que dá para automatizar, o que a Meta não expõe e onde os fluxos quebram.
- Webhooks
Assinatura HMAC, verificação, retentativas e modos de payload.
- Como enviar uma mensagem de WhatsApp pela API
Envie uma mensagem de texto pela API oficial do WhatsApp: a requisição, o header Idempotency-Key, o que significa a resposta 202 e como saber se ela foi entregue.
- Como enviar botões no WhatsApp pela API
Mensagens interativas com botões de resposta rápida e lista: como montar o payload, os limites que a Meta impõe e como a resposta do cliente chega de volta.
- Como enviar imagem, áudio e documento pela API do WhatsApp
Upload do arquivo, uso do media ID no envio, tipos aceitos e por que enviar por ID é diferente de enviar por URL.
- Como receber mensagens do WhatsApp na sua aplicação
O evento de mensagem recebida, o que vem no payload, como responder dentro da janela de atendimento e como não perder evento em caso de falha.
- Webhook do WhatsApp não chega: causas e diagnóstico
Por que um webhook do CRPRO Hub não chega ao seu sistema — URL recusada, endpoint pausado, evento não assinado, assinatura, tempo de resposta, canal desconectado — e a ordem para diagnosticar.
- Como integrar a API do WhatsApp em Node.js
Da chave de API à primeira mensagem em Node.js, com verificação de assinatura de webhook usando timingSafeEqual.
- Como integrar a API do WhatsApp em Python
Enviar mensagem e receber webhook em Python, com verificação de assinatura HMAC usando hmac.compare_digest.
- Como integrar a API do WhatsApp em PHP
Enviar mensagem e receber webhook em PHP, com verificação de assinatura usando hash_equals.
- Como criar um agente de IA no WhatsApp pela API oficial
Um agente de IA que responde no WhatsApp oficial: webhook do CRPRO Hub, modelo de linguagem, resposta pela API, histórico, passagem para humano e os limites da Meta que afetam o bot.
- Como ligar o Typebot ao WhatsApp oficial
Rodar um fluxo do Typebot no número oficial do WhatsApp pela API de chat do Typebot e pelo CRPRO Hub, sem app próprio na Meta: sessão por contato, botões e listas.
- Como ligar o Chatwoot ao WhatsApp oficial
Atender no Chatwoot as conversas do WhatsApp oficial com uma caixa de entrada do tipo API e o CRPRO Hub: mensagens nos dois sentidos, status de entrega e como evitar laço.
- Visão geral da documentação
O que dá para fazer e como a API se comporta.
- Autenticação
Sessão do painel, chave de API escopada e token de canal.
- Erros da API
Envelope de erro e tabela de códigos por status HTTP.
- Códigos de erro da Meta
131049, 131026, 131047 e os outros: o que significam e o que fazer.
- Limites
Limites de taxa e de tamanho, e política de entrega de webhook.
Para quem integra
Software houses, agências e CRMs que conectam o WhatsApp dos próprios clientes à API oficial.
- Para software house e SaaS
Multitenancy, chave por organização e link de conexão para o cliente final.
- Para agência
Migrar de API não oficial sem trocar o número do cliente.
- Para CRM
Eventos assinados, formato de compatibilidade e custo de troca de provedor.