Evolution API self-hosted ou API gerenciada: o que muda
Evolution API é open source e grátis, mas você hospeda e opera. Compare o custo total do self-hosted com uma API gerenciada como a apiwpp.
Atualizado em
A Evolution API é um dos projetos open source mais usados por quem quer uma API de WhatsApp própria. Ela é um servidor que expõe uma API REST para criar e controlar instâncias de WhatsApp, usando a biblioteca Baileys como motor do protocolo. O software é grátis. Hospedar, atualizar e manter os números conectados fica com você.
Uma API gerenciada como a apiwpp funciona sobre o mesmo protocolo do WhatsApp Web, mas a operação fica do lado de quem oferece o serviço, e você paga por número conectado. Esta página compara os dois modelos pelo que realmente muda: quem opera, quanto custa de verdade e o que você precisa construir. Não é uma avaliação da qualidade da Evolution API, que resolve bem o problema a que se propõe.
Evolution API: você hospeda e opera
No modelo self-hosted, você sobe o servidor, normalmente em contêineres, com um banco de dados para as instâncias e, conforme a configuração, cache e armazenamento de sessão. Os requisitos exatos mudam de versão para versão, então a fonte certa é a documentação oficial do projeto.
A partir daí, a sua equipe passa a ser responsável por:
- manter o servidor no ar, com backups e volumes persistentes para as sessões;
- aplicar atualizações quando o WhatsApp Web muda e o projeto publica correções;
- escolher e manter proxies, se não quiser todos os números saindo pelo IP do servidor;
- decidir o ritmo de envio e limitar conversas com contatos novos no seu próprio código;
- monitorar os números e agir quando uma sessão cai.
Em troca, você tem controle total: pode ler o código, alterar o que quiser e rodar na infraestrutura que preferir.
O custo total vai além do software
Comparar "grátis" com um preço por número engana, porque o software é só uma linha da conta. Para estimar o custo real do self-hosted, some:
| Item | Self-hosted (Evolution API) | apiwpp (gerenciada) |
|---|---|---|
| Software | Grátis, open source | Incluído no preço por número |
| Servidor, banco e cache | Você contrata e mantém | Incluído |
| Backups e sessões | Você configura e protege | Sessão salva e criptografada |
| Proxy brasileiro | Você contrata e distribui os números | Incluído por número; IP dedicado é adicional no PRO |
| Atualizações do protocolo | Você acompanha, testa e aplica | Aplicadas pela apiwpp |
| Ritmo de envio e aquecimento | Você implementa | Fila por número e 14 dias de aquecimento |
| Webhooks com novas tentativas e reenvio | Conforme o projeto e a versão; o resto você constrói | Assinados, 6 tentativas, registro e reenvio |
| Monitoramento e plantão | Você monta e cobre | Status por conexão e página de status pública |
| Cobrança | Custo de infraestrutura e de horas de engenharia | Por número, por mês, numa fatura só |
A linha que mais pesa costuma ser a de pessoas: cada hora de engenharia gasta com uma sessão caída ou uma atualização urgente é uma hora a menos no produto que o seu cliente usa.
O que a apiwpp opera por você
Tudo o que está abaixo já existe em produção e está incluído no preço por número:
- Sessão persistente. A sessão fica salva no banco de dados, criptografada. Reinícios, atualizações e reconexões não pedem um novo QR code, e o celular pode ficar desligado.
- Fila com ritmo anti-bloqueio. Por padrão, 3 mensagens por minuto, 60 por hora e 200 por dia por número, intervalo aleatório de 3 a 8 segundos e pelo menos 30 segundos entre duas mensagens para a mesma pessoa. Destinatários novos têm teto de 100 a cada 24 horas. Veja a fila anti-bloqueio.
- Aquecimento automático. Nos 14 dias depois do pareamento, os limites começam baixos e sobem por etapa, sem código do seu lado.
- Bloqueio temporário detectado. Quando o WhatsApp bloqueia temporariamente novas conversas do número, o evento
connection.statusavisa e os envios são recusados sem tentativa até o bloqueio acabar. - Webhooks confiáveis. Assinados com HMAC-SHA256, entregues pelo menos uma vez, com até 6 tentativas, registro de cada entrega e reenvio. Detalhes em webhooks.
- Proxy e IP. Cada número sai por um proxy brasileiro; você pode usar o seu próprio proxy, e o PRO oferece um IP dedicado por número.
- Chaves com escopo. Projetos e chaves de API com escopos, validade e rotação sem interrupção.
- Status público. A status.apiwpp.com mostra a saúde dos componentes, com um teste que envia mensagens reais entre dois números a cada 10 minutos.
Do lado do seu código, a integração fica numa chamada HTTP e num endpoint de webhook. A integração com Node.js mostra os dois, com o tratamento de 429 e a verificação da assinatura.
O que não muda entre os dois
Algumas coisas são iguais nos dois modelos, e é bom saber antes de decidir:
- O protocolo é o mesmo. Nem a Evolution API nem a apiwpp são a API oficial. Não há selo de conta oficial nem modelos de mensagem aprovados pela Meta.
- O risco de restrição continua existindo. O WhatsApp avalia o comportamento do número. Uma fila e um aquecimento reduzem o risco, mas nenhum dos dois caminhos pode garantir que um número nunca será restringido.
- O número é seu. Trocar de um para o outro exige desconectar o aparelho antigo e parear de novo, por QR code ou código de pareamento.
Quando self-hosted faz sentido
Hospedar a Evolution API é uma boa escolha quando:
Escolha self-hosted se
- você tem equipe de infraestrutura com tempo para operar mais um serviço crítico;
- precisa alterar o código do servidor ou rodar num ambiente próprio;
- aceita construir e manter o controle de ritmo, o aquecimento e o monitoramento.
Escolha a apiwpp se
- quer o WhatsApp integrado ao sistema sem virar dono de mais uma infraestrutura;
- prefere um custo previsível por número a somar servidor, proxy e horas de engenharia;
- quer fila anti-bloqueio, webhooks assinados e status público desde o primeiro dia.
Uma forma prática de decidir é anotar quanto tempo a equipe gastou no último mês com a operação atual: pareamentos refeitos, atualizações, incidentes. Compare esse número com a calculadora de preços, que soma números e IPs dedicados.
Para um panorama mais amplo, com Baileys e WPPConnect no mesmo quadro, leia o guia Evolution API, Baileys e WPPConnect. Se a sua equipe está pensando em construir a própria API sobre uma biblioteca, veja também o comparativo WPPConnect e Baileys.
Como migrar da Evolution API para a apiwpp
- Crie a conta e um projeto. O teste grátis de 7 dias inclui 1 número e os recursos PRO, sem cartão.
- Pareie o número de novo. Desconecte a instância antiga no celular e conecte o número na apiwpp. O aquecimento de 14 dias começa nesse momento.
- Troque o envio para
POST /connections/{id}/send, comtoem dígitos e umclientRefestável por mensagem, para repetir sem duplicar. - Troque o webhook. Os eventos chegam num envelope com
type,connectionId,tenantId,externalId,timestampedata; valide a assinatura HMAC antes de processar. - Remova o controle de ritmo que você mantinha. A fila já aplica os limites; o seu código passa a tratar o
429e o eventomessage.send_failed.
Perguntas frequentes
A apiwpp usa a Evolution API por baixo?
Não. A apiwpp é um serviço próprio, que fala o mesmo protocolo do WhatsApp Web. O que você integra é a API da apiwpp, com rotas, eventos e erros documentados numa especificação OpenAPI 3.1.
Self-hosted é sempre mais barato?
O software é grátis, mas servidor, banco, proxies, atualizações e horas de engenharia entram na conta. Para poucos números e sem equipe dedicada à operação, uma API gerenciada costuma sair mais previsível; com equipe de infraestrutura e necessidade de controle total, hospedar pode compensar.
Consigo manter a Evolution API e testar a apiwpp ao mesmo tempo?
Sim, com números diferentes. Um mesmo número conectado a dois serviços ao mesmo tempo não é o cenário recomendado; para migrar um número, desconecte o serviço antigo e pareie na apiwpp.
Uma API gerenciada elimina o risco de bloqueio?
Não. A fila, o aquecimento de 14 dias e o teto de destinatários novos reduzem o risco, mas o WhatsApp continua avaliando o comportamento do número. Veja como evitar o bloqueio do número.
Outros comparativos
Todos: Comparativos →Baileys e WPPConnect são projetos open source que falam o protocolo do WhatsApp Web. Montar uma API em produção sobre eles exige fila, webhooks confiáveis, separação por cliente, painel e cobrança. Veja o que falta construir e quando vale a pena.
Os critérios para comparar APIs de WhatsApp gerenciadas, como cobrança, fila anti-bloqueio, webhooks assinados, idempotência, proxy e documentação, com a posição da apiwpp em cada um e um roteiro de migração.
A Cloud API da Meta exige conta comercial e templates aprovados e cobra por mensagem; a apiwpp conecta o número como aparelho conectado, sem aprovação, e cobra por número. Cada uma vence em cenários diferentes.