Conecte seu número WhatsApp Business à API oficial da Meta. Receba mensagens via webhook, envie via REST API. Sem complexidade.
Um gateway WhatsApp completo para seus sistemas.
Receba mensagens do WhatsApp em tempo real na sua URL de webhook. Nós cuidamos da complexidade dos webhooks da Meta.
Envie mensagens de texto, template e mídia com uma simples chamada de API. Autentique com chaves de API, sem dança OAuth.
Conecte seu número WhatsApp Business em minutos com o fluxo oficial de Embedded Signup da Meta. Sem manipulação manual de tokens.
Entregas de webhook com falha são automaticamente retentadas com backoff exponencial. Nunca perca uma mensagem.
Tokens criptografados com AES-256, autenticação JWT, hash de chaves API, validação de assinatura de webhook e isolamento total entre clientes.
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.
Ligar o canal nativo WhatsApp Cloud do Chatwoot direto na Meta significa meses de App Review, Business Verification e onboarding de Tech Provider. O ZapClaw responde ao Chatwoot no mesmo dialeto da Meta, então o canal conecta com duas variáveis de ambiente e um restart, sem mudar nada no seu código. Seus clientes conectam pelo nosso Embedded Signup. Você mantém sua instalação do Chatwoot.
{ object, entry[] }, assinado com X-Hub-Signature-256. O handler que já existe no Chatwoot lê sem um único patch.
POST /v25.0/{phone_id}/messages com Bearer token. Espelha a superfície que o WhatsappCloudService do Chatwoot já chama.
Comece a usar em três passos simples.
Cadastre-se e conecte seu número WhatsApp Business via Embedded Signup. O ZapClaw cuida da troca de tokens automaticamente.
Defina sua URL de webhook para receber mensagens. Gere uma chave de API para enviar mensagens do seu sistema.
Mensagens de entrada vão para seu webhook. Mensagens de saída passam pela nossa API REST. O ZapClaw faz a ponte.
Dúvidas comuns sobre o ZapClaw.
O ZapClaw é um gateway leve 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 simples.
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. Quando ela perguntar como conectar, escolha Conectar um app do WhatsApp Business. A outra opção, Criar uma conta do WhatsApp Business, é para números novos e não funciona com o ZapClaw.
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.
Sim. Tokens de acesso são criptografados com AES-256-GCM, chaves de API são hasheadas com SHA-256, toda comunicação usa HTTPS e os dados de cada cliente são completamente isolados (multi-tenant). Também validamos assinaturas de webhook da Meta.
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. CNPJ + verificação empresarial só entram em cena depois, se você quiser aumentar limites de envio ou conquistar o selo verificado. 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.
Isso acontece quando o número esteve conectado em outra plataforma antes (Wati, Take Blip, Chatwoot, etc.) e o vínculo persiste mesmo depois de você desconectar lá. O workaround que funciona de forma confiável: (1) logue esse número no WhatsApp comum do celular, (2) logue de volta no WhatsApp Business, (3) aguarde 30 minutos, (4) tente a conexão aqui de novo. O ZapClaw mostra esse workaround automaticamente quando detecta esse erro.
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.
Não. Pare e feche a janela da Meta. Esse pedido só aparece no caminho para números novos (Criar uma conta do WhatsApp Business), 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 e escolha Conectar um app do WhatsApp Business. 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, tocando na mensagem da Meta e colando o código que aparece no computador.
É 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.
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 por 90 dias a partir da importação, como toda mensagem. 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.