WhatsApp API

Evolution API no ar, sem montar VPS.

A API de WhatsApp com várias instâncias, webhooks e painel, já ligada a um Postgres com backup e HTTPS. Um clique no console, a partir de R$ 14,90 por mês.

30 dias de garantia · Pix ou cartão · sem fidelidade

O que vem pronto

A API, o banco e o HTTPS já conversando.

Você abre o /manager, cria a instância e lê o QR code com o celular.

Painel /manager

Crie instâncias, leia o QR code e configure webhooks pelo painel da própria Evolution API, no seu endereço com HTTPS.

Postgres com backup

Os dados das instâncias ficam num Postgres gerenciado, com backup diário de 7 dias fora do servidor.

Chave gerada para você

A chave da API (AUTHENTICATION_API_KEY) é gerada ao criar, aparece uma vez e fica na aba de variáveis do app.

Webhooks para o seu sistema

Mensagens recebidas, status e conexão chegam por webhook no seu backend, no n8n, no Activepieces ou no chatbot.

Endereço com HTTPS

A API ganha um endereço em nome.lumahost.app com certificado automático. Domínio próprio também funciona.

Logs legíveis

O template já ajusta o nível dos logs e tira as cores do terminal, para a aba de logs mostrar só o que importa.

Um clique

O que o template configura por você.

No console, em Templates, escolha a Evolution API. A plataforma cria o Postgres, aponta a API para ele pela rede interna, gera a chave e faz o primeiro deploy. Sem Redis: um container só, com cache local, para não ocupar outro pedaço da cota.

Depois, abra /manager, informe o endereço e a chave, crie uma instância e leia o QR code em Aparelhos conectados. Pelo MCP, dá para pedir ao Claude Code ou ao Cursor: "sobe uma Evolution API pra mim".

Variáveis criadas pelo template
SERVER_URL=https://whatsapp.lumahost.app
AUTHENTICATION_API_KEY=••••••••  (gerada)
DATABASE_PROVIDER=postgresql
DATABASE_CONNECTION_URI=<Postgres da conta>
CACHE_REDIS_ENABLED=false
CACHE_LOCAL_ENABLED=true
DEL_INSTANCE=false
LANGUAGE=pt-BR
TZ=America/Sao_Paulo

VPS ou hospedagem gerenciada

O mesmo software, sem o servidor para cuidar.

A Evolution API é a mesma nos dois casos. Muda quem cuida do resto.

Numa VPS, você instala Docker, sobe o Postgres, configura proxy reverso e certificado, abre portas, atualiza o sistema e monta o próprio backup. Funciona, e para quem gosta de servidor pode ser o caminho. O custo escondido é o tempo de manutenção e o risco de um banco sem cópia.

Na LumaHost Cloud, essa parte vem pronta: HTTPS automático, Postgres com backup diário fora do servidor, logs e gráfico de memória no painel, e reinício se o processo cair. Você continua com acesso às variáveis e ao Dockerfile, e pode trocar a versão quando quiser. Preço fixo em reais, sem cobrança por mensagem.

Sem letra miúda

O que você precisa saber antes.

Preferimos dizer agora a você descobrir com o número bloqueado.
  • O template ocupa 1 GB da cota (API e Postgres) e pede o plano Hobby ou maior.
  • Cada número conectado soma memória. Com muitas instâncias, aumente a RAM do app pelo painel.
  • A Evolution API usa o WhatsApp Web, não a API oficial da Meta. Use um número dedicado: automação fora das regras pode banir o número.
  • Disparo em massa e spam são proibidos pelos Termos de Uso e levam à suspensão da conta.
  • A versão é fixa e a atualização é sua: troque a versão no Dockerfile e faça um novo deploy.

Quanto custa

Preço fixo em reais, sem cobrança por mensagem.

Pix ou cartão. A Evolution API cabe a partir do plano Hobby, de R$ 14,90 por mês.

Hobby

R$ 14,90/mês

1 GB de RAM, até 1 vCPU, 10 GB de disco

Dev

R$ 24,90/mês

2 GB de RAM, até 2 vCPU, 20 GB de disco

Pro

R$ 44,90/mês

4 GB de RAM, até 3 vCPU, 40 GB de disco

Studio

R$ 79,90/mês

8 GB de RAM, até 4 vCPU, 80 GB de disco

Apps ilimitados dentro da RAM do plano. Bancos gerenciados saem do mesmo pool (mínimo 512 MB cada) e têm backup diário de 7 dias, menos o Redis. No anual, dois meses saem de graça.

Dúvidas

Perguntas frequentes

É a Evolution API oficial?

É. O template usa a imagem oficial (evoapicloud/evolution-api) na versão v2.3.7, a última estável, sem alteração. A instalação é só sua: os números conectados e as mensagens não passam por nenhum outro cliente.

Preciso de VPS ou saber Docker?

Não. No console, em Templates, você escolhe a Evolution API e a plataforma cria o Postgres, gera a chave da API, liga o volume das instâncias, configura o HTTPS e faz o primeiro deploy. Não há servidor para atualizar nem firewall para abrir.

Por que o plano Hobby?

O template ocupa 1 GB da cota: a API com 512 MB e o Postgres com 512 MB. Medimos antes de publicar: a API parada usa uns 215 MB. Cada número conectado soma memória, então, com muitas instâncias, aumente a RAM do app pelo painel, dentro do pool do plano.

Quantos números de WhatsApp posso conectar?

Não há limite de instâncias na LumaHost: o limite é a RAM do plano. Comece com o que o template reserva e acompanhe o gráfico de memória no painel. Se ele encostar no limite, aumente a RAM do app ou passe para um plano maior.

A sessão cai a cada deploy?

Não. Os dados das instâncias ficam no Postgres e na pasta persistente do app, que sobrevivem a deploy e reinício. Uma instância desconectada também não é apagada sozinha: o template desliga a exclusão automática.

Funciona com n8n, Typebot, Chatwoot ou o meu sistema?

Funciona com qualquer coisa que fale HTTP. Você chama a API REST com a chave no cabeçalho apikey e recebe os eventos (mensagem recebida, status, conexão) no webhook que configurar por instância.

Meu número pode ser banido?

Pode. A Evolution API conecta pelo WhatsApp Web, o que não é a API oficial da Meta, e automação fora das regras do WhatsApp leva a banimento. Use um número dedicado, responda quem falou com você e não dispare mensagens em massa. A LumaHost não tem como reverter um banimento.

Posso usar para disparo em massa?

Não. Spam e envio em massa não solicitado são proibidos pelos Termos de Uso e levam à suspensão da conta, sem reembolso. Atendimento, notificações para quem pediu e chatbots são bem-vindos.

Tem backup?

O Postgres tem backup diário com 7 dias de retenção, guardado fora do servidor dos apps. Antes de mudanças grandes, dá para tirar um snapshot do app pelo painel.

Como atualizo a versão?

O código do app é um Dockerfile com a versão fixa. Para atualizar, troque a versão nele e faça um novo deploy. Antes de pular uma versão grande, leia as notas de atualização do projeto.

Continue lendo

Guias e documentação.

Outros guias

Sua API de WhatsApp, no ar hoje.

Escolha um plano, suba a Evolution API em um clique e, se não for o que esperava, devolvemos o dinheiro em até 30 dias.

30 dias de garantia, reembolso via Pix. Sem fidelidade.