Evolution API ou ZapClaw: qual devo usar no WhatsApp?
Em resumo: a Evolution API é um software de código aberto que você roda no seu próprio servidor, conectado pelo WhatsApp Web (Baileys) ou pela API Cloud oficial da Meta com um app próprio na Meta. O ZapClaw é um gateway hospedado na API Cloud oficial da Meta: você conecta na janela de Embedded Signup da Meta sem precisar de app próprio na Meta, e o número continua funcionando no app WhatsApp Business. Escolha a Evolution API para ter controle total do código nos seus servidores, e o ZapClaw para não precisar de servidor nem configurar um app na Meta.
O ZapClaw conecta o seu número à API Cloud oficial da Meta pela Coexistência. Sem servidor para manter e sem app próprio na Meta.
Comece grátisDois produtos da Evolution Foundation
A Evolution API é um software de código aberto que você instala no seu próprio servidor. O README dela diz que ela suporta tanto a API do WhatsApp Web baseada no Baileys quanto a API Cloud oficial do WhatsApp, e você escolhe uma das duas por instância:
- O modo Baileys conecta pelo WhatsApp Web: no início rápido da Evolution, você cria a instância e escaneia um QR Code com o WhatsApp do celular. O README avisa que esse método depende da versão web do WhatsApp.
- O modo Cloud API chama a API Cloud oficial do WhatsApp, da Meta. O guia da Evolution pede que você crie um app próprio no Facebook Developers, tenha uma Business Manager (aprovada, nas palavras do guia), gere um token permanente e configure você mesmo o webhook no seu app da Meta.
O Evo Hub é um produto separado e hospedado que a Evolution Foundation vende. O site dele se apresenta como “Um proxy entre você e a API da Meta”, para a API Cloud do WhatsApp, o Instagram e o Messenger. O preço é por canal, e cada conexão conta como um: a partir de R$ 97 por mês para 3 canais, e todo plano lista tanto um app próprio na Meta quanto um compartilhado. A página dele não diz se suporta a Coexistência, então confirme com o Evo Hub antes de contar com isso. A tabela abaixo compara a Evolution API self-hosted nos seus dois modos.
Lado a lado
| Evolution API, modo Baileys | Evolution API, modo Cloud API | ZapClaw | |
|---|---|---|---|
| Como conecta | WhatsApp Web, pela biblioteca Baileys. Você escaneia um QR Code com o celular. | API Cloud do WhatsApp, da Meta, com um token permanente do seu próprio app na Meta. | API Cloud do WhatsApp, da Meta, pela Coexistência. Você conecta na janela de Embedded Signup da Meta. |
| API oficial da Meta | Não: depende do WhatsApp Web. | Sim. | Sim. |
| Número continua no app WhatsApp Business | O celular continua com o WhatsApp: a sessão é um dispositivo conectado, como o WhatsApp Web. | A documentação da Evolution não menciona a Coexistência. | Sim, pela Coexistência. |
| Quem roda | Você, no seu próprio servidor: Node.js 20 ou mais recente, PostgreSQL ou MySQL, e Redis. A documentação recomenda Docker para produção. | O ZapClaw hospeda o gateway. Você roda só o sistema que recebe o seu webhook. | |
| App na Meta e App Review | Nenhum app na Meta entra no processo. | Seu próprio app na Meta, Business Manager e token permanente. O guia não menciona App Review. | Nenhum do seu lado: você conecta pelo app do ZapClaw na Meta, e o ZapClaw é Tech Provider da Meta. |
| Números e preço | Sem taxa de licença: a página de licenciamento da Evolution Foundation diz que ela continua gratuita, self-hosted e sem limites de uso. Você paga o seu servidor, e no modo Cloud API o README avisa que pode haver custos por mensagem. | Plano grátis: 1 número e 500 mensagens por mês, sem cartão. Business: R$ 99 por mês por conta, números ilimitados, 20.000 mensagens incluídas. A Meta cobra as taxas dela direto de você, sem margem do ZapClaw. | |
| Recebimento de mensagens | Webhooks, mais integrações de eventos como RabbitMQ, Apache Kafka, Amazon SQS e Socket.io. Não verificamos a política de novas tentativas dela, então as tentativas não são comparadas aqui. | Seu webhook, assinado com HMAC-SHA256. Até 3 tentativas (na hora, depois 30 e 120 segundos mais tarde), cada uma registrada, e os eventos não entregues ficam guardados para reenvio. | |
| Envio de mensagens | API REST. | API REST, com a sua chave no header X-API-Key. |
|
| Chatwoot | Integração nativa com o Chatwoot, segundo o README. | Modo de compatibilidade: o próprio canal WhatsApp Cloud do Chatwoot fala com o ZapClaw em vez da Meta. | |
| Grupos | A documentação lista endpoints para grupos. | Não suportado: os grupos continuam funcionando no app WhatsApp Business, mas a API Cloud da Meta não os suporta na Coexistência. | |
| Código e licença | Código aberto, Apache 2.0 com condições adicionais de proteção de marca. A partir da versão 2.4.0, ainda release candidate quando verificamos, ela pede uma ativação de licença gratuita no primeiro acesso. | Um serviço hospedado que você usa pela API e pelo painel. | |
Quando a Evolution API é a melhor escolha
- Você quer tudo nos seus próprios servidores. O código é aberto, não há taxa de licença, e a página de licenciamento da Evolution Foundation diz que ela continua gratuita e sem limites de uso.
- Você já tem um app próprio aprovado na Meta. O modo Cloud API da Evolution funciona com o seu app, o seu token e o seu número, sem gateway no meio.
- Você depende de grupos do WhatsApp. A documentação da Evolution API lista endpoints para grupos. O ZapClaw conecta pela Coexistência, em que os grupos continuam funcionando no app WhatsApp Business, mas a API Cloud da Meta não os suporta.
- Você quer as integrações que já vêm nela. O README lista Typebot, Dify, OpenAI, RabbitMQ, Apache Kafka, Amazon SQS e armazenamento S3, entre outras.
Quando o ZapClaw é a melhor escolha
- Você quer a API oficial da Meta sem rodar servidor. Nada para instalar, nenhum banco de dados e nenhuma atualização do seu lado, e nenhum app, token ou webhook para configurar na Meta.
- O número precisa continuar no app WhatsApp Business. A Meta só libera a Coexistência para Solution Partners e Tech Providers, e virar Tech Provider passa por verificação empresarial e App Review. O ZapClaw é Tech Provider da Meta, então você não precisa virar um.
- Você tem muitos números ou clientes. Os planos pagos conectam números ilimitados por um único preço por conta, e o plano Agency mantém separados os números, contatos, templates, chaves de API e webhook de cada cliente.
- Você quer entregas que dá para conferir. Toda chamada de webhook é assinada, repetida em caso de falha e registrada, e um evento que o seu servidor perdeu pode ser reenviado pelo painel.
- Você usa um Chatwoot self-hosted. O canal WhatsApp Cloud nativo dele conecta ao ZapClaw com uma variável de ambiente e uma chamada de API por número.
O ZapClaw não é a ferramenta para disparo em massa, para mais de 20 mensagens por segundo, nem para grupos, chamadas de voz e vídeo ou o selo de conta comercial oficial, que a Meta não oferece na Coexistência.
Como sair da Evolution API para o ZapClaw
Os seus clientes continuam escrevendo para o mesmo número. O que muda depende do modo que você usava:
- Saindo do modo Baileys. O número precisa estar no app WhatsApp Business, na versão 2.24.17 ou mais recente (todos os requisitos). Quando ele conecta ao ZapClaw, a Meta desconecta todos os dispositivos conectados, inclusive a sessão da Evolution. Depois, a Meta deixa você conectar de novo os dispositivos compatíveis.
- Saindo do modo Cloud API. Se o número só funciona na API, ele precisa voltar primeiro para o app WhatsApp Business: veja como trocar o número de provedor.
- A sua integração. O payload do webhook do ZapClaw não é o da Evolution, então o código que lê os eventos recebidos muda, e enviar passa a ser uma chamada à API REST do ZapClaw com a sua chave de API. As duas coisas estão na documentação (em inglês).
- Chatwoot. Se você usava a integração da Evolution com o Chatwoot, o próprio canal WhatsApp Cloud do Chatwoot pode falar com o ZapClaw: veja Chatwoot na API oficial do WhatsApp.
A migração inteira, passo a passo, com os principais campos de envio e de webhook mapeados para os do ZapClaw: como migrar da Evolution API para a API oficial do WhatsApp.
Perguntas frequentes
A Evolution API é oficial?
Depende do modo. A Evolution API é um projeto de código aberto da Evolution Foundation. No modo Cloud API, ela chama a API Cloud oficial do WhatsApp, da Meta, pelo seu próprio app na Meta. No modo Baileys, ela conecta pelo WhatsApp Web, e o README do Baileys diz que a biblioteca não é afiliada, associada, autorizada nem endossada pelo WhatsApp.
Dá para continuar usando o mesmo número no app WhatsApp Business?
Com o ZapClaw, sim. Ele conecta pela Coexistência, que a documentação da Meta descreve como levar um número do app WhatsApp Business para a Cloud API enquanto a empresa continua respondendo um a um pelo app. A documentação da Evolution API não menciona a Coexistência (verificado em 14 de outubro de 2026). No modo Baileys, a sessão é um dispositivo conectado ao WhatsApp do seu celular, como o WhatsApp Web.
Preciso de um servidor?
Para a Evolution API, sim: você instala com Node.js 20 ou mais recente, PostgreSQL ou MySQL e Redis, e a documentação recomenda Docker para produção. Para o ZapClaw, não: o ZapClaw roda o gateway, e você só precisa do que recebe o seu webhook, como o seu bot, o seu app ou um Chatwoot self-hosted.
O Evo Hub é a mesma coisa que a Evolution API?
Não. O Evo Hub é um produto hospedado da Evolution Foundation nas APIs oficiais da Meta, com preço por canal. A Evolution API é o software de código aberto que você mesmo hospeda, e o próprio FAQ do Evo Hub diz que a Evolution API foca em integrações para instâncias de WhatsApp Web.
Meu número pode ser banido?
A Central de Ajuda do WhatsApp diz que conectar a sua conta a versões não oficiais do WhatsApp viola os Termos de Serviço dele e que a conta pode ser banida de forma temporária ou permanente. Ela cita apps como o GB WhatsApp, não a Evolution API nem o Baileys. Na API Cloud oficial da Meta, que o ZapClaw e o modo Cloud API da Evolution usam, as políticas de mensagens da Meta continuam valendo: a Meta pode restringir ou desativar uma conta que as descumpre, e a documentação do ZapClaw (em inglês) mostra o erro que as suas chamadas de API recebem quando isso acontece.
Fontes
Verificado em 14 de outubro de 2026. Preços, versões e recursos mudam, então confira cada fonte antes de decidir.
- README da Evolution API no GitHub (em inglês): tipos de conexão, integrações, pré-requisitos e licença.
- Documentação da Evolution API, visão geral: os dois tipos de conexão, webhooks, eventos e grupos.
- Guia de instalação da Evolution API: Docker e a conexão por QR Code.
- Evolution API, guia da WhatsApp Cloud API: app na Meta, Business Manager, token permanente e webhook.
- Licenciamento da Evolution Foundation e o arquivo LICENSE (em inglês).
- Versões da Evolution API no GitHub (em inglês): a 2.3.7 é a versão estável mais recente (5 de dezembro de 2025), e a 2.4.0 teve dois release candidates em maio de 2026.
- Documentação da Evolution Foundation, texto completo, pesquisada em busca de Coexistência.
- Evo Hub: planos, canais e FAQ.
- Meta, integração de usuários do app WhatsApp Business (em inglês): a Coexistência, os requisitos e os dispositivos conectados.
- Meta, primeiros passos como Tech Provider (em inglês): verificação empresarial e App Review.
- Central de Ajuda do WhatsApp, Sobre apps não oficiais (em inglês).
- README do Baileys no GitHub (em inglês): aviso legal.
- ZapClaw: preços, webhooks e Chatwoot na documentação (em inglês), e o que é preciso para conectar.
Compare também o ZapClaw e a Z-API, ou veja como a API oficial do WhatsApp se compara às bibliotecas não oficiais.