Alternativa à Evolution API: quando vale sair do self-hosted

O que você realmente opera quando hospeda a Evolution API

Pelo README oficial, rodar a Evolution API em produção pede Node.js 20 ou superior, PostgreSQL ou MySQL e, de forma recomendada, Redis. Também há imagem Docker pronta. Instalar é rápido. O custo aparece no dia a dia:

• Servidor dimensionado para o número de conexões e com espaço para crescer.
• Banco de dados com backup, migração de schema a cada versão e monitoramento.
• Atualização do projeto quando o WhatsApp muda algo no protocolo do WhatsApp Web.
• Alguém de plantão para descobrir por que as conexões de um servidor caíram às duas da manhã.
• Rede: todas as conexões de um servidor saem pelo mesmo IP, a menos que você configure proxies.

Para um time pequeno, isso compete diretamente com o roadmap do produto. É esse o ponto que costuma levar à busca por uma alternativa: não um defeito do projeto, e sim o tempo que ele pede. A comparação mais ampla entre os dois modelos está em self-hosted vs gerenciada.

Motivos comuns para buscar uma alternativa

• Escala sem virar time de infraestrutura. Passar de dez para trezentas conexões exige mais servidores, balanceamento e observabilidade.
• Isolamento entre clientes. Num SaaS, um cliente com comportamento de envio arriscado não deveria afetar os outros que estão no mesmo servidor.
• Custo previsível. Servidor e horas de engenharia variam mês a mês; um valor por conexão entra direto na planilha de margem.
• Suporte com prazo. Comunidade ajuda muito, mas não responde a um incidente com hora marcada.

Evolution API e D-API comparadas

A Evolution tem mais integrações nativas com ferramentas de atendimento. Se o seu fluxo depende de várias delas, pese isso. Se o que pesa é tempo de operação e isolamento, a balança vai para o lado gerenciado.

O que muda ao migrar para a D-API

Você continua com uma API de WhatsApp REST, com webhooks e as duas modalidades de conexão. O que sai da sua lista é o servidor. Cada instância roda em ambiente próprio, com credenciais e webhook próprios, e sai por um IP que não é dividido com outros números. Se uma conexão cai, a plataforma tenta recuperá-la sozinha, e você recebe o evento connection.status para avisar o cliente.

Os webhooks também mudam de responsabilidade: se o seu endpoint falhar, a D-API faz até 7 tentativas com intervalo crescente, com timeout de 30 segundos por tentativa. Para quem já usava fila, também dá para receber os eventos por RabbitMQ, configurado por sessão.

Guia de migração da Evolution API

1. Traduza os conceitos

2. Crie as sessões e aponte os eventos

O exemplo cria a sessão de um cliente e separa mensagens recebidas e status de conexão em URLs diferentes, o que ajuda quem hoje trata tudo num único endpoint gigante:

curl -X POST https://api.d-api.cloud/api/v1/sessions \
  -H "Authorization: SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "sessionId": "loja-centro", "type": "unofficial", "connectionMode": "qr" }'

curl -X POST https://api.d-api.cloud/api/v1/sessions/loja-centro/webhook-config \
  -H "Authorization: SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "enabled": true,
    "type": "per_event",
    "events": {
      "messages.received": { "enabled": true, "webhookUrl": "https://seu-app.com/wa/mensagens" },
      "connection.status": { "enabled": true, "webhookUrl": "https://seu-app.com/wa/conexao" }
    }
  }'

curl "https://api.d-api.cloud/api/v1/sessions/loja-centro/qr?image=1" \
  -H "Authorization: SUA_API_KEY" -o qr.png

3. Troque as chamadas de envio

O envio de texto vira POST /api/v1/messages/send/text com sessionId, to e text. Mídia, listas e grupos seguem o mesmo padrão, com rotas próprias. Em Node.js, o pacote d-api-sdk encapsula essas chamadas; veja o SDK de Node.js.

4. Reconecte os números e desligue os servidores

Cada número precisa ler um QR Code novo, ou usar o código de pareamento. Migre em lotes, confirme que o status chegou como connected e que o webhook de mensagens está recebendo, e só então desligue a instância correspondente no seu servidor. Quando o último número sair, o servidor, o banco e o Redis dedicados à Evolution podem ser desativados.

Para comparar com outra opção self-hosted, veja a alternativa ao WAHA. Os planos estão em preços, e o teste de 3 dias permite validar a migração com um número antes de mover os demais.