Integração

Evolution API self-hosted x gerenciada: quando vale parar de hospedar

Vale parar de hospedar a Evolution API quando o WhatsApp deixa de ser um experimento e vira parte do negócio — o momento em que sessão caindo, número tomando ban e atualização que quebra passam a custar dinheiro e sono. Uma API gerenciada compatível com a Evolution v2 tira a infra de você sem exigir reescrever código: você troca a base URL e mantém o resto.

Este post compara as duas abordagens de forma honesta e mostra o ponto de virada.

Self-host: barato no papel

Rodar a Evolution por conta própria é ótimo pra começar. A API é boa e a comunidade é grande. O custo aparece na operação:

  • VPS pra provisionar e manter atualizada.
  • Sessão de WhatsApp que cai e precisa de reconexão.
  • Número que toma ban sem aviso.
  • Atualização da engine que quebra o que estava funcionando.
  • Ninguém de plantão às 2 da manhã além de você.

Enquanto o volume é baixo, dá pra absorver. Quando o WhatsApp entra no caminho crítico do produto, esse servidor vira o seu ponto único de falha.

Gerenciada: o contrato igual, sem o servidor

Uma plataforma gerenciada compatível com a Evolution v2 fala os mesmos endpoints /v2/*, com os mesmos payloads e o mesmo envelope de resposta. A diferença é quem opera a infra.

- BASE_URL=http://meu-servidor-evolution:8080
+ BASE_URL=https://api.shiftz.com.br/v2

Na Shiftz, os pods de engine rodam com autoscaling e healthcheck, os webhooks são assinados com HMAC-SHA256 e têm retry de até 24h, e o multi-tenant é nativo (chaves escopadas por instância).

Quando ainda faz sentido hospedar

Sejamos justos: o self-host continua válido se você tem volume pequeno, gosta de operar a infra e o WhatsApp não é crítico pro seu negócio. Não é sobre a API ser ruim — é sobre quem paga o custo de mantê-la de pé.

O ponto de virada

Considere migrar quando:

  • O WhatsApp está no caminho crítico (suporte, vendas, notificações que não podem falhar).
  • Você opera vários números e quer isolamento por cliente.
  • Quedas de sessão já te custaram tempo ou receita.
  • Você quer webhooks confiáveis com retry, não best-effort caseiro.

O que costuma quebrar na migração

  • Achar que vai ter retrabalho. Não tem: o contrato é o mesmo. Você troca a BASE_URL e a apikey.
  • Esquecer de reconectar o número. A engine nova precisa escanear o QR uma vez. Suba a instância e vire o tráfego quando o estado ficar open.

Próximo passo

Quer ver a compatibilidade na prática? Crie uma conta grátis, suba uma instância e aponte sua integração Evolution pra ela. Sem cartão, sem reescrever código.

Escrito por Marcos Pedrosa

Construindo a Shiftz, a WhatsApp API que sua IA já sabe usar.