Existe uma decisão silenciosa que define se sua integração de WhatsApp vai te dar paz ou plantão: rodar a sua própria infraestrutura de conexão (self-hosted) ou usar uma API gerenciada. As duas usam a mesma tecnologia por baixo. A diferença está em quem acorda às 3h da manhã quando a sessão cai. Este artigo compara honestamente os dois caminhos — incluindo onde o self-hosted faz sentido.
O que "self-hosted" realmente envolve
Subir uma biblioteca de conexão num servidor e enviar a primeira mensagem leva 20 minutos. O problema nunca é o primeiro envio — é manter no ar. Self-hosted significa que você é responsável por:
- Persistência de sessão — guardar as credenciais da sessão de forma confiável; se o arquivo corromper ou o container reiniciar sem volume, todos os números desconectam e precisam reescanear QR.
- Reconexão automática — detectar queda (que nem sempre vem com aviso), distinguir queda transitória de logout real, e reconectar sem entrar em loop.
- Detecção de "sessão zumbi" — o caso mais traiçoeiro: a conexão diz "conectado" mas não recebe nem envia nada. Sem monitoramento ativo, fica horas assim em silêncio.
- Fila de saída e retry — garantir que uma mensagem aceita não se perca quando o gateway oscila.
- Rate limit, circuit breaker e observabilidade — proteção contra avalanche e visibilidade do que está acontecendo.
- Atualização da biblioteca — o WhatsApp muda o protocolo; a lib persegue; você precisa atualizar sem quebrar produção.
Comparativo honesto
| Dimensão | Self-hosted | Gerenciada |
|---|---|---|
| Primeiro envio | ~20 min | ~5 min |
| Reconexão/zumbi/retry | você implementa | incluído |
| Atualização da lib | seu plantão | transparente |
| Custo real | servidor + horas de eng. | assinatura fixa |
| Controle total do código | sim | não (você usa a API) |
Quando self-hosted faz sentido
Não vamos fingir que gerenciada é sempre a resposta. Self-hosted vale quando: você tem time de engenharia dedicado que quer manter isso, requisitos de compliance que exigem o dado nunca sair da sua infra, ou volume tão alto que a economia de escala compensa o plantão. Para todo o resto — startups, agências, PMEs, produtos que querem focar no core — a conta da API gerenciada fecha melhor.
O cálculo que importa
Some o custo do servidor + as horas de engenharia que você vai gastar implementando reconexão, monitoramento de zumbi, retry e mantendo a lib atualizada — e multiplique pelas madrugadas de plantão. Compare com uma assinatura fixa por instância. Na maioria dos casos, o "grátis" do self-hosted é o mais caro.
Comece em minutos, sem aprovação da Meta
Crie uma instância, conecte o WhatsApp lendo um QR Code e faça o primeiro envio via API REST. Trial de 7 dias, sem cartão.
Criar conta grátisPerguntas frequentes
A tecnologia é a mesma? Por baixo, sim. A diferença é toda a camada de confiabilidade, monitoramento e manutenção que a gerenciada entrega pronta.
Perco flexibilidade usando uma API? Você troca controle de baixo nível por uma API REST estável. Para a maioria dos casos de uso (enviar, receber, grupos, campanhas), a API cobre tudo.
E a portabilidade? Como a integração é via HTTP REST padrão, trocar de fornecedor é mudar URL e credenciais — bem mais simples que migrar uma infra self-hosted inteira.
Preciso de aprovação da Meta? Não nesta abordagem — a conexão é por QR Code.