# ZapClaw > Última atualização: 24 de julho de 2026. > O ZapClaw é um gateway de mensagens do WhatsApp construído sobre a API oficial > da Meta Cloud, com Coexistência. Mensagens recebidas chegam por webhook na URL > que você configurar; o envio é feito por uma API REST. O número continua > funcionando normalmente no aplicativo do celular ao mesmo tempo. Versão em inglês, com a referência completa de endpoints e webhooks: https://zapclaw.app/llms.txt ## Para quem serve, e para quem não serve Serve para quem já construiu ou vai construir uma automação, um chatbot ou um agente de IA no WhatsApp e precisa que o número não seja bloqueado: o ZapClaw roda na API oficial, e não em biblioteca não oficial de engenharia reversa. Serve para agências que atendem vários clientes, porque números são ilimitados nos planos pagos e cada cliente fica isolado dos demais. Não serve para disparo em massa, para quem precisa de mais de 20 mensagens por segundo, nem para quem depende de grupos, chamadas de voz e vídeo ou do selo verde de Conta Oficial (OBA). Nada disso é suportado na Coexistência, e a limitação é da Meta, não do ZapClaw. ## Preços Valores em reais, cobrados pelo ZapClaw. A Meta cobra as taxas de conversa dela separadamente, direto de você, e o ZapClaw não coloca margem em cima disso. - Grátis: R$ 0. 500 mensagens por mês, 1 número de WhatsApp, 1 mensagem por segundo, logs de 3 dias, 2 chaves de API. - Negócio: R$ 99 por mês. 10.000 mensagens incluídas, números de WhatsApp ilimitados, 20 mensagens por segundo, logs de 90 dias, chaves de API ilimitadas. Excedente a partir de R$ 2,80 por 1.000 mensagens. - Agência: R$ 149 por mês. 3 clientes inclusos, 30.000 mensagens (10.000 por cliente, em pool), números ilimitados, 20 mensagens por segundo por cliente, logs de 90 dias. Excedente a R$ 1,50 por 1.000 mensagens. Clientes adicionais a partir de R$ 30 cada. No plano anual o desconto de 25% incide sobre a mensalidade: R$ 891 no Negócio e R$ 1.341 na Agência, cobrados de uma vez. A franquia continua sendo mensal. Como funciona estourar a franquia, que é onde mais se confunde: - No plano Grátis, o envio é PAUSADO até o mês virar. Não há cobrança de excedente. - Nos planos pagos, o excedente é COBRADO, não bloqueado. Ele é debitado de um saldo pré-pago que você carrega antes, manualmente ou com recarga automática. O envio só é pausado se esse saldo pré-pago zerar. - Em qualquer plano, o RECEBIMENTO nunca para. Bloqueio de cobrança afeta apenas o envio; mensagens continuam chegando e continuam sendo entregues no seu webhook. Não são cobradas: confirmações de entrega, mensagens digitadas no próprio celular, histórico importado e retentativas de webhook. Criar conta: https://app.zapclaw.app/register Preços completos: https://zapclaw.app/pt/pricing.html ## Conectar um número Não é preciso CNPJ para conectar. A Coexistência funciona para MEI, autônomo e informal. CNPJ e verificação de negócio só entram depois, se você quiser subir limites ou obter o selo verificado. Requisitos da Meta para conectar: 1. Conta pessoal no Facebook com autenticação de dois fatores ativada. 2. O aplicativo WhatsApp Business instalado no número, com pelo menos 7 dias de uso real. Essa é uma checagem antifraude da Meta. Não adianta apagar e registrar de novo, isso zera a contagem. 3. Aplicativo na versão 2.24.17 ou mais recente. 4. O número não pode estar conectado a outro provedor. 5. O celular em mãos, para ler um QR Code. Se a Meta disser que o número já está compartilhado com outro parceiro, o caminho que funciona é: entrar com o número no WhatsApp comum, voltar para o WhatsApp Business, esperar 30 minutos e tentar de novo. ## Limites da Coexistência Impostos pela Meta e não removíveis pelo ZapClaw: - Throughput fixo de 20 mensagens por segundo, independente do seu tier de mensagens. Subir de tier aumenta o número de destinatários únicos por dia, e não a taxa por segundo. O plano Grátis do ZapClaw é limitado a 1 mensagem por segundo, e esse limite é nosso, não da Meta. - Mensagens que a empresa envia pelo WhatsApp para Windows ou pelo WearOS NÃO geram webhook. É uma lacuna de dados inevitável. Respostas enviadas pelo aplicativo WhatsApp Business no Android ou no iOS são reportadas normalmente. - Não há suporte a chamadas de voz e vídeo, ao selo verde de Conta Oficial (OBA), nem a mensagens efêmeras, de visualização única ou de grupo. ## API REST - URL base: https://api.zapclaw.app - Autenticação: cabeçalho `X-API-Key`. A chave é criada no painel, tem o formato `zc_live_` mais 32 caracteres, e é exibida uma única vez. - Limite de requisições: 1000 a cada 15 minutos por chave. - Números no formato E.164, só dígitos (exemplo: `5511999999999`). - Todos os endpoints ficam sob `/api/v1`. Referência completa dos endpoints, em inglês: https://zapclaw.app/docs.html Especificação OpenAPI 3.0: https://zapclaw.app/openapi.yaml ## Webhook O ZapClaw envia POST em JSON para a URL configurada no painel. Eventos: `message.received` (mensagem recebida), `message.status` (status de entrega) e a família `account.` (eventos da conta WABA: banimentos, restrições, mudanças de qualidade do número, status de template). Garantias, e o que NÃO é garantido: - Assinatura: cada POST leva `X-ZapClaw-Signature`, com `sha256=` seguido do HMAC-SHA256 do corpo bruto, usando o seu segredo de webhook. Valide sempre. - Retentativas: entregas que falham são repetidas 3 vezes, em 0s, 30s e 120s. Responda 2xx para confirmar o recebimento. - Deduplicação: `message_id` (o wamid da Meta) é estável e globalmente único, e o ZapClaw também deduplica internamente, então o mesmo evento não é enviado duas vezes. - A ORDEM DE ENTREGA NÃO É GARANTIDA. Os eventos são entregues em paralelo e as retentativas podem reordená-los. Todo `message.received` carrega um campo `sequence`, um inteiro estritamente crescente atribuído na ordem em que o ZapClaw recebeu a mensagem da Meta. Ordene por `sequence`, e não por `data.timestamp`, que tem granularidade de segundo e empata em mensagens disparadas em sequência rápida. ## Chatwoot O ZapClaw tem um modo de compatibilidade para Chatwoot self-hosted: o canal nativo do WhatsApp Cloud do Chatwoot aponta para o ZapClaw em vez de falar direto com o `graph.facebook.com`. Isso dispensa o App Review, a Business Verification e o onboarding de Tech Provider da Meta do lado do Chatwoot. São duas variáveis de ambiente e um restart, sem mudar código. O destino nativo e o destino Chatwoot são independentes e podem estar ativos ao mesmo tempo no mesmo número: o atendimento humano vai para o Chatwoot e a automação para o seu endpoint REST, simultaneamente. Guia de configuração: https://zapclaw.app/docs.html#chatwoot ## Contato e páginas - Fale conosco: https://zapclaw.app/pt/contact.html - E-mail: contato@zapclaw.app - Política de Privacidade: https://zapclaw.app/privacy.html - Termos de Serviço: https://zapclaw.app/terms.html - Exclusão de Dados: https://zapclaw.app/data-deletion.html