A API não é a oficial da Meta: o WhatsApp pode bloquear qualquer número, e a ProxyBox não reembolsa por bloqueio. Para conhecer o produto, o IP brasileiro dedicado e os planos, veja a página da API de WhatsApp.
Como leio a coluna "Situação"?
Cada recurso tem uma situação honesta, para você decidir quanto confiar:
- Provado quer dizer que a rota foi usada em um número real, em aparelho, em 10/11/2026 e, pela API pública, em 12/11/2026 (veja o histórico de versões para a lista de 12/11): texto, imagem, documento, voz, áudio como arquivo, figurinha, localização, contato, enquete, reação, editar, apagar para todos, ler conversas, baixar mídia recebida, contatos, foto, perfil e listar grupos.
- Beta quer dizer que o recurso já funciona, está em fase de testes e pode mudar. Isso vale para todas as novidades da versão 1.2.
- Em breve quer dizer que ainda não está disponível.
- Consulta é página de referência, sem recurso por trás.
Sou desenvolvedor
- Primeiros passos: a primeira mensagem.
- Sandbox: teste sem número e sem pagar.
- Aviso automático: receba mensagens e confira a assinatura.
- Erros e limites e referência: o que cada rota devolve.
- Segurança e IPs permitidos: proteja a chave antes de ir para produção.
Sou agência e gerencio vários números
- Primeiros passos para uma instância de teste.
- Equipe, papéis e métricas para dar acesso sem compartilhar a chave e acompanhar cada número.
- Chatwoot para o atendimento em equipe.
- Criar instâncias por API, para agências, ainda está em breve e não tem página.
Tenho uma loja virtual
- Modelos prontos: pedido pago no WooCommerce, cobrança, compra aprovada e formulário.
- Integrações: Woo, Asaas, Hotmart, Kiwify e Mercado Pago, com o status de cada uma.
- Agendar uma mensagem para lembretes.
- Não perturbe e chamadas: quem pede para parar não recebe mais nada.
Quero responder clientes automaticamente
- Bots de WhatsApp: escolha entre Typebot, Dify, Flowise, IA ou o seu fluxo.
- Aprovação humana: uma pessoa lê antes de a resposta sair.
- Receber por consulta e agrupar mensagens: o bot responde à frase completa.
- Botões: de resposta e de ação funcionam; lista (menu) e carrossel não.
Já uso a Evolution ou a Z-API
Migrar da Evolution, migrar da Z-API e migrar da Wafly trazem o mapa rota a rota. Para comparar preço, IP e recursos antes de decidir, leia alternativa à Z-API e Evolution hospedada ou contratada.
Qual é o mapa completo, em ordem de leitura?
Começar
Enviar e receber
| Página |
O que resolve |
Situação |
| Enviar imagem, vídeo e áudio no WhatsApp via API |
Imagem, vídeo, áudio, voz, documento e figurinha. |
Imagem, documento, voz e figurinha provados; vídeo em beta |
| Reagir, editar, apagar e status: API de WhatsApp |
Enquete, reação, editar, apagar, ler, 'digitando' e status (stories). |
Provado, exceto estrela, presença e status (em beta) |
| Botões e listas no WhatsApp via API |
Botões de resposta, link, copiar e ligar com POST /messages/interactive; lista e carrossel não funcionam. |
Envio provado em 12/11/2026; lista e carrossel não funcionam |
| Verificar número com WhatsApp pela API |
Conferir se o número tem WhatsApp e consultar perfil. |
Parte provada |
| Criar e administrar grupos de WhatsApp pela API |
Criar e administrar grupos, convites e pedidos de entrada. |
Listar provado; o resto em beta |
| Bloquear, silenciar e administrar grupos pela API |
Bloquear contatos, silenciar e apagar conversas, fixar mensagem, privacidade, grupos, comunidades, canais e evento. |
Beta |
| Ler conversas e baixar mídia no WhatsApp via API |
Ler o histórico, baixar o que o cliente mandou e etiquetar conversas. |
Leitura provada; etiquetas provadas em 12/11/2026 |
| Agendar mensagem de WhatsApp pela API |
Uma mensagem por vez, até 30 dias à frente. |
Agendar uma mensagem provado em 12/11/2026 |
Avisos e controle
Integrações
| Página |
O que resolve |
Situação |
| Integrações da API de WhatsApp: n8n, Make, Zapier |
Cartão por ferramenta e o status honesto de cada uma. |
Hub; tudo em beta |
| 13 modelos para a API de WhatsApp (Woo, Asaas) |
13 modelos HTTP: Woo, Asaas, Hotmart, Sheets, CRM e IA. |
Modelos não testados em terceiros |
| WhatsApp no n8n: enviar e receber com a API |
Enviar e receber no n8n com os nós que já existem. |
Nós padrão do n8n |
| Nós n8n para a API de WhatsApp: instalar |
Pacote de nós da ProxyBox e 8 modelos de fluxo. |
Beta; não rodou num n8n real |
| Chatwoot com WhatsApp: ligar pela API |
Atendimento em equipe espelhado no Chatwoot. |
Beta; não provado com Chatwoot real |
| Guardar mídia do WhatsApp no S3, R2 ou MinIO |
Guardar a mídia recebida no seu bucket. |
Beta |
| MCP do WhatsApp para Claude e Cursor |
Operar a API por um assistente de IA, com confirmação. |
Beta |
| SDKs, OpenAPI e Postman da API de WhatsApp |
SDKs, OpenAPI 3.1, Postman e a página de status. |
SDKs não existem ainda; OpenAPI e Postman disponíveis |
Bots e IA
Conta e migração
O que a documentação não cobre?
- Mensagem em massa. Não existe lista de transmissão nem envio para todos; a política de uso aceitável proíbe.
- WebSocket e filas (RabbitMQ, SQS, Kafka). O aviso assinado e a consulta com espera cobrem o uso.
- SDKs oficiais. Ainda não existem; veja o que há hoje em SDKs, OpenAPI e Postman.
- Garantia contra bloqueio. Nenhum guia promete isso. As causas reais estão em WhatsApp banido: causas na API e no Business.
Como a documentação é mantida?
Cada página tem a data de atualização e o contrato por trás: o catálogo da versão 1.4, com 110 operações. Os exemplos de código foram escritos contra a API, que tem testes automáticos, mas não foram executados contra a API aberta ao público, porque ela ainda não abriu. Os formatos de terceiros (Typebot, Dify, Flowise, Chatwoot, Asaas, Z-API e outros) foram lidos nas páginas oficiais deles na data indicada em cada guia, e os pontos não confirmados aparecem escritos. Se você achar uma diferença entre a documentação e o comportamento da API, avise o suporte: durante o teste, a documentação segue a API.
Autoria: equipe técnica da ProxyBox. Atualizado em 12/11/2026, contra o catálogo da versão 1.2.