Pré-requisitos
Antes de iniciar, configure os serviços de infraestrutura necessários:Banco de Dados
PostgreSQL ou MySQL com Prisma ORM
Redis
Cache distribuído para alta performance
Métodos de instalação
Escolha o método mais adequado para o seu cenário:Docker
Recomendado para produção. Inclui Docker Compose standalone e Docker Swarm com Traefik para alta disponibilidade.
NVM
Instalação local com Node Version Manager. Ideal para desenvolvimento ou quando você precisa de controle total sobre o ambiente.
Nginx e SSL
Configuração de proxy reverso com Nginx e certificado SSL via Let’s Encrypt.
SetupOrion
Instalador automatizado com Traefik, Portainer e Docker Swarm. Ideal para VPS limpa.
Easypanel
Painel de controle baseado em Docker com template 1-clique e SSL automático. Ideal para quem quer simplicidade sem abrir mão do self-hosted.
Verificação rápida
Após instalar por qualquer método, verifique se a API está funcionando:Teste de saúde
Crie sua primeira instância WhatsApp
Obtenha o QR Code para conectar
Verifique o status da conexão
Próximos passos
Variáveis de Ambiente
Referência completa de todas as variáveis de configuração
Webhooks
Configure webhooks para receber eventos em tempo real
Integrações
Conecte com Chatwoot, Typebot, OpenAI, Dify e mais
Atualização
Mantenha sua instância sempre atualizada