Gateway da API WhatsApp Cloud

Seu número na API oficial do WhatsApp,
sem perder o app

Conecte o seu número do WhatsApp Business pela Coexistência: as mensagens chegam no seu webhook e você envia por uma API REST.

Plano Business: R$ 99 por mês, com números ilimitados

Nenhum cartão é pedido.

API e webhooks do WhatsApp

Um gateway WhatsApp completo para seus sistemas.

inbound ←

Webhooks de Entrada

Receba mensagens do WhatsApp em tempo real na sua URL de webhook. Nós cuidamos da complexidade dos webhooks da Meta.

POST /your/webhook { "event": "message.received", "data": { "from": "5511..." } }
→ outbound

API REST

Envie mensagens de texto, template e mídia com uma simples chamada de API. Autentique com chaves de API, sem dança OAuth.

POST /api/v1/send/template { "to": "5511...", "templateName": "order_update" }

Cadastro Integrado

Conecte seu número WhatsApp Business em minutos com o fluxo oficial de Embedded Signup da Meta. Sem manipulação manual de tokens.

Lógica de Retry

Entregas de webhook com falha são automaticamente retentadas com backoff exponencial. Nunca perca uma mensagem.

Segurança por Design

Tokens e conteúdo das mensagens criptografados com AES-256, autenticação JWT, hash de chaves API, validação de assinatura de webhook e acesso restrito a cada organização.

Painel

Monitore entregas de mensagens, saúde dos webhooks e uso da API. Gerencie templates, chaves de API e configuração de webhooks em um só lugar.

Drop-in para Chatwoot self-hosted

Chatwoot self-hosted,
sem App Review da Meta.

Para manter o número no app WhatsApp Business (Coexistência) ou conectar os números dos seus clientes, a Meta exige que você seja Tech Provider ou Solution Partner, o que passa por Business Verification e App Review. O ZapClaw responde ao Chatwoot no mesmo dialeto da Meta, então o canal conecta com uma variável de ambiente e uma chamada de API por número, sem mudar nada no seu código. Seus clientes conectam pelo nosso Embedded Signup. Você mantém sua instalação do Chatwoot.

  • payload O envelope bruto da Meta Mesmo formato { object, entry[] }, assinado com X-Hub-Signature-256. O handler que já existe no Chatwoot lê sem um único patch.
  • outbound Os mesmos endpoints do Graph POST /v25.0/{phone_id}/messages com Bearer token. Espelha a superfície que o WhatsappCloudService do Chatwoot já chama.
  • onboarding Embedded Signup para seus clientes Os números entram pelo fluxo oficial de Coexistência da Meta no ZapClaw. Nada de revisão de Tech Provider no seu lado.
  • coexists Funciona junto com seu próprio webhook Você não precisa escolher. Chatwoot e um endpoint nativo são destinos independentes que podem ficar ativos ao mesmo tempo no mesmo número: o atendimento usa o Chatwoot, sua automação usa a API REST, tudo junto.
Ver o guia de instalação

Por que usar o Chatwoot com o ZapClaw

Como Funciona

Comece a usar em três passos simples.

Conecte

Cadastre-se e conecte seu número WhatsApp Business via Embedded Signup. O ZapClaw cuida da troca de tokens automaticamente.

Configure

Defina sua URL de webhook para receber mensagens. Gere uma chave de API para enviar mensagens do seu sistema.

Envie e Receba

Mensagens de entrada vão para seu webhook. Mensagens de saída passam pela nossa API REST. O ZapClaw faz a ponte.

O Monely, aplicativo de finanças pessoais da mesma empresa do ZapClaw, roda os próprios números de WhatsApp no ZapClaw desde julho de 2026. As mensagens chegam no webhook dele, e as respostas saem pela API REST com chaves de idempotência.

Veja como o Monely roda no ZapClaw

Perguntas Frequentes

Dúvidas comuns sobre o ZapClaw.

O ZapClaw, Tech Provider da Meta, é um gateway de mensagens WhatsApp que conecta seu número comercial à API oficial da Meta. Ele recebe mensagens e encaminha para sua URL de webhook, e permite enviar mensagens via uma API REST.

O ZapClaw conecta o seu número pela API oficial da Meta, e não por uma biblioteca não oficial que imita o WhatsApp Web, o tipo de conexão que contraria os termos do WhatsApp e põe números em risco. As políticas de mensagens do WhatsApp continuam valendo, como para qualquer empresa. Veja como os dois tipos de conexão se comparam.

Sim. O ZapClaw usa a API oficial WhatsApp Cloud da Meta. Na conexão, a própria janela da Meta liga o número do seu app WhatsApp Business a uma conta WhatsApp Business (WABA) no seu portfólio empresarial da Meta, e cria essa conta se você ainda não tiver. Se a Meta pedir primeiro um número de telefone, digite ou escolha o número do seu app WhatsApp Business e siga só se a Meta mostrar em seguida o perfil desse app. Se ela mostrar duas opções, escolha Conectar um app do WhatsApp Business; a outra, Criar uma conta do WhatsApp Business, é para números novos e não funciona com o ZapClaw. Pare se a Meta enviar um código por SMS ou ligação.

A Coexistência conecta um número que já roda no app WhatsApp Business (o app comercial, não o WhatsApp comum). Você continua usando o app no celular enquanto o ZapClaw cuida das mensagens da API em paralelo.

Quando alguém envia uma mensagem para seu número WhatsApp, a Meta entrega ao ZapClaw via webhook. O ZapClaw então encaminha o payload para sua URL de webhook em tempo real. Se o seu endpoint estiver fora, fazemos até 3 tentativas de entrega no total: na hora, 30 segundos depois e mais 2 minutos depois disso.

Gere uma chave de API no painel e use nossa API REST. Envie mensagens de texto, template ou mídia com um simples POST usando sua chave no header X-API-Key.

Protegemos em camadas: o conteúdo das mensagens fica criptografado com AES-256-GCM, os tokens de acesso usam outra chave, as chaves de API ficam guardadas como hash SHA-256, toda comunicação usa HTTPS, as assinaturas de webhook da Meta são verificadas, e o painel e a API leem só os dados da organização a que cada requisição pertence. Nenhum sistema é 100% seguro; a nossa página de segurança descreve as medidas.

Não precisa de CNPJ para conectar. A Coexistência funciona para profissionais autônomos, MEIs e empreendedores informais. Para conectar você precisa de: (1) uma conta pessoal no Facebook com 2FA ativo, (2) o app WhatsApp Business no número, em uso normal (a Meta pode recusar números com pouca atividade recente; na prática, cerca de 7 dias de uso têm bastado), (3) o app atualizado para a versão 2.24.17 ou mais recente, (4) o número não estar conectado em nenhum outro provedor, e (5) um computador para fazer a conexão, com o celular em mãos para confirmá-la no app WhatsApp Business. O CNPJ só importa para a verificação empresarial da Meta: o que muda sem CNPJ. Todos os requisitos.

A Meta recusa a Coexistência para números com pouca atividade recente no app WhatsApp Business. Ela não publica o limite; na prática, cerca de 7 dias de uso real têm bastado. É uma checagem antifraude da Meta, não uma limitação do ZapClaw. Continue usando o número normalmente (respondendo alguns contatos por dia) e tente novamente em alguns dias. Não apague e recadastre o número: isso recomeça a contagem. Saiba mais.

O número ainda está ligado ao provedor que você usava antes, às vezes mesmo depois de cancelar lá. No app WhatsApp Business, abra Configurações > Conta > Business Platform (pode aparecer como Plataforma Comercial), toque em Desconectar, espere 15 minutos e conecte de novo. Se a Meta ainda recusar: entre com o número no WhatsApp comum, volte para o WhatsApp Business, espere 30 minutos e tente de novo. O ZapClaw mostra esse caminho automaticamente quando detecta esse erro. Saiba mais.

Sim. Nativo e Chatwoot são dois destinos independentes, cada um com sua própria URL e liga/desliga, e os dois podem ficar ativos no mesmo número ao mesmo tempo. Um uso comum é Chatwoot para atendimento humano mais um endpoint próprio para automação; toda mensagem recebida é entregue para os dois, no formato que cada destino espera. Ativar um nunca desativa o outro. Saiba mais.

Não. Pare e feche a janela da Meta. Esse pedido só aparece no caminho para números novos, que o ZapClaw não usa, e apagar a conta tira o número do app WhatsApp Business, que é justamente o que a Coexistência precisa. Comece de novo: se a Meta pedir primeiro um número de telefone, digite ou escolha o número do seu app WhatsApp Business e siga só se a Meta mostrar em seguida o perfil desse app; se ela mostrar duas opções, escolha Conectar um app do WhatsApp Business. Pare se a Meta enviar um código por SMS ou ligação. O ZapClaw nunca exige apagar nada. Saiba mais.

Não pelo navegador do celular: a conexão é feita no computador, e o painel avisa isso se você abrir pelo celular. O celular participa mesmo assim: durante a conexão você confirma no app WhatsApp Business, escaneando o QR code que aparece no computador ou colando o código que ele mostra.

É a Meta protegendo o seu portfólio empresarial, e o botão Avançar fica girando até a verificação ser feita. No mesmo computador e navegador, abra business.facebook.com, entre no portfólio que você está conectando e faça a verificação que a Meta pedir (normalmente um código). Depois recarregue o ZapClaw e conecte de novo. A autenticação em dois fatores também precisa estar ativa na sua conta do Facebook. Saiba mais.

Os requisitos oficiais da Meta para a Coexistência não trazem restrição de país, e a palavra final é a checagem da própria Meta durante a conexão. No celular você precisa do app WhatsApp Business, em Android ou iPhone, na versão 2.24.17 ou mais recente. Os aparelhos vinculados são desconectados na conexão e podem ser vinculados de novo, menos o WhatsApp para Windows e o WearOS, que a Meta não suporta com Coexistência. Continue abrindo o app no celular principal: a Meta desconecta o número depois de cerca de 14 dias sem uso. Conectar da Alemanha ou da UE.

A Meta não oferece uma checagem de elegibilidade separada. Ela verifica o número dentro da própria janela de conexão, antes de a conexão ser concluída: se o número não for elegível, a janela para com um erro, nada é autorizado, o ZapClaw não recebe acesso nenhum e a tentativa não custa nada.

Não. Durante a conexão, o app WhatsApp Business pergunta se você quer compartilhar o histórico de conversas. Se recusar, nada é importado. Se aceitar, a Meta envia até 180 dias de histórico, que o ZapClaw guarda no máximo pelo prazo que a sua organização escolher, contado da importação: 90 dias por padrão, configurável para 30, 7 ou 0 (sem guardar conteúdo). Com 0, nenhum histórico é importado. A lista de contatos do app é sempre sincronizada.

Nunca. O ZapClaw só envia uma mensagem quando o seu sistema chama a API de envio ou quando você envia pelo painel. Usar só para receber é totalmente suportado: as mensagens chegam no seu webhook, e a sua equipe continua respondendo pelo app WhatsApp Business. Como configurar.

Pronto para conectar?

Comece a rotear mensagens WhatsApp pelos seus sistemas em minutos.

Comece grátis