# CRPRO Hub

> Plataforma para conectar números de WhatsApp de clientes à API oficial da Meta (WhatsApp Business Platform / Cloud API) por coexistência: o número continua funcionando no aplicativo, no aparelho do cliente, e responde pela Cloud API ao mesmo tempo — sem trocar de número e sem QR code. Multitenant, com chaves de API escopadas por organização, webhooks assinados com HMAC SHA-256 e log de auditoria por número.

Operado pela CRPRO (https://crpro.com.br). O CRPRO Hub é a camada de integração, para quem programa; o CRPRO CRM é o produto de atendimento e vendas da mesma empresa, para quem quer usar o WhatsApp oficial sem programar.

Fatos que costumam ser perguntados:
- A conta WhatsApp Business é do cliente final, não do Hub. A Meta cobra as mensagens diretamente dele.
- A conexão usa o Embedded Signup da Meta. Não há leitura de QR code nem sessão de navegador para manter viva.
- Envio responde 202 (aceito e enfileirado), nunca 200 de entregue. O estado final chega por webhook.
- O header Idempotency-Key é obrigatório no envio: a mesma chave com o mesmo corpo devolve a resposta original.
- Pedir um recurso de outra organização responde 404, não 403.
- Desde 1º de outubro de 2026 a Meta cobra, por mensagem entregue, as respostas sem template dentro da janela de atendimento e os templates de utilidade enviados dentro dela; até 30 de setembro de 2026 as duas eram gratuitas. Para as mensagens de serviço, cada número de telefone comercial tem 1.000 gratuitas por mês, sem acúmulo, e depois delas a tarifa é a mesma de utilidade e autenticação do país. Template de utilidade dentro da janela é cobrado desde a primeira mensagem. Sem meio de pagamento cadastrado na conta WhatsApp Business, a Meta entrega mensagens de serviço só até o fim dessa franquia.
- Planos mensais: Starter R$ 97 (3 números, 10 webhooks) e Pro R$ 147 (5 números, 15 webhooks), cobrados em reais.

## Por onde começar

- [Aprender](https://crprohub.com/aprender): índice de todo o conteúdo, por tema: API oficial, custos, oficial x não oficial, integração e para quem integra

## Produto e preço (português)

- [Quanto custa a API oficial do WhatsApp](https://crprohub.com/precos): as duas cobranças separadas: a da Meta, por mensagem, e a assinatura do Hub
- [O que muda na cobrança do WhatsApp em outubro de 2026](https://crprohub.com/mudanca-cobranca-whatsapp-outubro-2026): desde 1º de outubro de 2026 a Meta cobra mensagem de serviço (acima de 1.000 gratuitas por mês por número) e template de utilidade dentro da janela de atendimento; os valores do Brasil e o que acontece com a conta sem meio de pagamento cadastrado
- [O que é a API oficial do WhatsApp](https://crprohub.com/o-que-e-api-oficial-do-whatsapp): definição, como ter acesso, o que é preciso para começar, as regras da Meta e o custo em uma frase
- [WhatsApp Cloud API: o que é e como usar](https://crprohub.com/whatsapp-cloud-api): endpoint, ativos e tokens, webhooks, limites de envio (por número e por portfólio), versões da Graph API e o que mudou em 2025 e 2026
- [Coexistência no WhatsApp](https://crprohub.com/coexistencia-whatsapp): o app e a API no mesmo número: como funciona, e os limites da plataforma
- [Tech Provider ou BSP](https://crprohub.com/tech-provider-vs-bsp): as três categorias de provedor da Meta e de onde vem o markup por mensagem
- [API de WhatsApp para software house e SaaS](https://crprohub.com/para/software-house): multitenancy, chave escopada por organização e link de conexão para o cliente final
- [API de WhatsApp para agência](https://crprohub.com/para/agencia): migrar de API não oficial sem trocar o número do cliente, e sem entrar na cobrança da Meta
- [API de WhatsApp para CRM](https://crprohub.com/para/crm): eventos assinados, formato de compatibilidade EvoHub e custo de troca de provedor
- [Como escolher uma API de WhatsApp](https://crprohub.com/comparar/apis-whatsapp): as cinco perguntas estruturais que separam os provedores, sem tabela de preço que envelhece
- [Calculadora de custo da API do WhatsApp](https://crprohub.com/ferramentas/calculadora-api-whatsapp): estima o que a Meta cobra e o que o Hub cobra, separados, com a mudança de outubro de 2026
- [API oficial x não oficial](https://crprohub.com/api-oficial-vs-nao-oficial): comparação lado a lado, risco para o número e custo real de manutenção
- [Como conectar um número à API oficial](https://crprohub.com/como-conectar-numero-api-oficial): o que a Meta exige, os passos do Embedded Signup e o que muda depois
- [Automação de WhatsApp pela API oficial](https://crprohub.com/automacao-de-whatsapp): o que dá para automatizar, o que a Meta não expõe e onde os fluxos quebram
- [Alternativa à Z-API](https://crprohub.com/alternativas/z-api): sessão do WhatsApp Web x Cloud API oficial, e como migrar sem trocar de número

## Documentação (português)

- [Visão geral da API](https://crprohub.com/docs): o que dá para fazer e como a API se comporta
- [Início rápido](https://crprohub.com/docs/quickstart): da chave de API até a primeira mensagem enviada
- [Autenticação](https://crprohub.com/docs/autenticacao): sessão do painel, chave de API escopada e token de canal
- [Webhooks](https://crprohub.com/docs/webhooks): assinatura HMAC, verificação em Node, retentativas e modos de payload
- [Erros](https://crprohub.com/docs/erros): envelope de erro e tabela de códigos por status HTTP
- [Códigos de erro da Meta (Cloud API)](https://crprohub.com/docs/erros/meta): o que significa cada código (131049, 131026, 131047, 131056, 132000 e outros), por que acontece, o que fazer e como chega pelo Hub
- [Erro 131049](https://crprohub.com/docs/erros/131049): limite de marketing por contato: por que o WhatsApp segura o template e quanto esperar
- [Erro 131026](https://crprohub.com/docs/erros/131026): mensagem não entregue: número sem WhatsApp, termos não aceitos ou aplicativo antigo
- [Erro 131047](https://crprohub.com/docs/erros/131047): janela de 24 horas fechada: quando só template sai
- [Limites](https://crprohub.com/docs/limites): limites de taxa e de tamanho, e política de entrega de webhook

## Documentation (English)

- [WhatsApp Coexistence API](https://crprohub.com/en): product overview in English
- [WhatsApp Business API pricing](https://crprohub.com/en/pricing): the two separate costs: Meta per message, and the Hub subscription
- [WhatsApp Coexistence](https://crprohub.com/en/whatsapp-coexistence): the app and the Cloud API on the same number, and the platform limits
- [API documentation](https://crprohub.com/en/docs): what the API does and how it behaves
- [Quickstart](https://crprohub.com/en/docs/quickstart): from API key to first message sent
- [Authentication](https://crprohub.com/en/docs/authentication): dashboard session, scoped API key and channel token
- [Webhooks](https://crprohub.com/en/docs/webhooks): HMAC signature, Node verification, retries and payload modes

## Guias por tarefa

- [Como enviar uma mensagem de WhatsApp pela API](https://crprohub.com/docs/guias/enviar-mensagem): 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 um template de WhatsApp pela API](https://crprohub.com/docs/guias/enviar-template): 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 enviar botões no WhatsApp pela API](https://crprohub.com/docs/guias/enviar-botao): 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](https://crprohub.com/docs/guias/enviar-midia): Upload do arquivo, uso do media ID no envio, tipos aceitos e por que enviar por ID é diferente de enviar por URL.
- [Como configurar um webhook do WhatsApp](https://crprohub.com/docs/guias/configurar-webhook): Registre um endpoint, valide a assinatura HMAC SHA-256, teste a entrega e reenvie um evento perdido — sem expor o segredo.
- [Como receber mensagens do WhatsApp na sua aplicação](https://crprohub.com/docs/guias/receber-mensagens): 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](https://crprohub.com/docs/guias/webhook-nao-chega): 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](https://crprohub.com/docs/guias/nodejs): 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](https://crprohub.com/docs/guias/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](https://crprohub.com/docs/guias/php): Enviar mensagem e receber webhook em PHP, com verificação de assinatura usando hash_equals.
- [Como integrar a API do WhatsApp no n8n](https://crprohub.com/docs/guias/n8n): Enviar mensagem pelo nó HTTP Request e receber eventos pelo nó Webhook, sem escrever código.
- [Como criar um agente de IA no WhatsApp pela API oficial](https://crprohub.com/docs/guias/agente-de-ia): 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](https://crprohub.com/docs/guias/typebot): 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](https://crprohub.com/docs/guias/chatwoot): 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.

## Referência por recurso

- [Canais](https://crprohub.com/docs/referencia/canais): endpoints, parâmetros e exemplos
- [Mensagens](https://crprohub.com/docs/referencia/mensagens): endpoints, parâmetros e exemplos
- [Mídia](https://crprohub.com/docs/referencia/midia): endpoints, parâmetros e exemplos
- [Templates](https://crprohub.com/docs/referencia/templates): endpoints, parâmetros e exemplos
- [Webhooks](https://crprohub.com/docs/referencia/webhooks): endpoints, parâmetros e exemplos
- [Chaves de API](https://crprohub.com/docs/referencia/chaves-de-api): endpoints, parâmetros e exemplos
- [Assinatura](https://crprohub.com/docs/referencia/assinatura): endpoints, parâmetros e exemplos
- [Uso](https://crprohub.com/docs/referencia/uso): endpoints, parâmetros e exemplos
- [Logs](https://crprohub.com/docs/referencia/logs): endpoints, parâmetros e exemplos
- [Conexão pública](https://crprohub.com/docs/referencia/conexao-publica): endpoints, parâmetros e exemplos

## Opcional

- [Especificação OpenAPI 3.1](https://crprohub.com/openapi.json): o contrato completo da API em formato legível por máquina
- [Coleção do Postman](https://crprohub.com/downloads/crpro-hub.postman_collection.json): os endpoints que aceitam chave de API, gerados do mesmo catálogo da referência
- [Fluxo do n8n: resposta automática](https://crprohub.com/downloads/n8n-resposta-automatica.json): webhook com verificação de assinatura, deduplicação e envio, pronto para importar
- [Página inicial (português)](https://crprohub.com/): produto, planos e perguntas frequentes