Pular para o conteúdo principal
Este guia irá ajudá-lo a instalar e configurar a Evolution API, nossa API REST principal para integração com WhatsApp.

​
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.

​
Verificação rápida

Após instalar por qualquer método, verifique se a API está funcionando:

​
Teste de saúde

curl http://localhost:8080/

​
Crie sua primeira instância WhatsApp

curl -X POST http://localhost:8080/instance/create \
  -H "Content-Type: application/json" \
  -H "apikey: sua-chave-segura-aqui" \
  -d '{
    "instanceName": "minha-instancia",
    "integration": "WHATSAPP-BAILEYS",
    "qrcode": true
  }'

​
Obtenha o QR Code para conectar

curl http://localhost:8080/instance/connect/minha-instancia \
  -H "apikey: sua-chave-segura-aqui"
Escaneie o QR Code com o WhatsApp do seu celular para conectar a instância.

​
Verifique o status da conexão

curl http://localhost:8080/instance/connectionState/minha-instancia \
  -H "apikey: sua-chave-segura-aqui"

​
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