EvolutionAPI · GABRIEL-PI · Dec 4, 2025 · Dec 4, 2025 · Dec 4, 2025 · DavidsonGomes
diff --git a/DEPLOY-MULTIDEVICE-FIX.md b/DEPLOY-MULTIDEVICE-FIX.md
@@ -0,0 +1,274 @@
+# 🚀 Evolution API - Multi-Device Fix
+
+## 📋 Resumo da Alteração
+
+**Problema:** A Evolution API estava caindo/desconectando quando o WhatsApp Android estava ativo, porque se identificava como "WebClient" (WhatsApp Web), ocupando o slot de sessão web.
+
+**Solução:** Remover a identificação de browser para usar o modo Multi-Device nativo do Baileys 7.x, que não conflita com outras sessões.
+
+---
+
+## 🔧 Alteração no Código
+
+### Arquivo: `src/api/integrations/channel/whatsapp/whatsapp.baileys.service.ts`
+
+**ANTES (WebClient - CAI):**
+```typescript
+const session = this.configService.get<ConfigSessionPhone>('CONFIG_SESSION_PHONE');
+
+let browserOptions = {};
+
+if (number || this.phoneNumber) {
+  this.phoneNumber = number;
+  this.logger.info(`Phone number: ${number}`);
+} else {
+  const browser: WABrowserDescription = [session.CLIENT, session.NAME, release()];
+  browserOptions = { browser };
+  this.logger.info(`Browser: ${browser}`);
+}
+
+// ... no socketConfig:
+...browserOptions,
+```
+
+**DEPOIS (Multi-Device nativo - NÃO CAI):**
+```typescript
+if (number || this.phoneNumber) {
+  this.phoneNumber = number;
+  this.logger.info(`Phone number: ${number}`);
+}
+
+// Multi-Device mode: não definimos browser para evitar ser tratado como WebClient
+// Isso faz o Baileys usar o modo MD nativo, que não conflita com outras sessões
+this.logger.info('Using Multi-Device native mode (no browser identification)');
+
+// ... no socketConfig:
+// Removido browserOptions para usar Multi-Device nativo (não WebClient)
+```
+
+### Imports removidos:
+- `ConfigSessionPhone` do `@config/env.config`
+- `WABrowserDescription` do `baileys`
+- `release` do `os`
+
+---
+
+## 📦 Repositório Fork
+
+**URL:** https://github.com/joinads/evolution-api
+
+**Commit:** `5dbf3e93` - "fix: usar Multi-Device nativo para evitar desconexões"
+
+---
+
+## 🐳 Deploy na VPS com Docker Compose
+
+### Pré-requisitos
+- Docker e Docker Compose instalados
+- Acesso SSH à VPS
+- Volumes existentes com dados (PostgreSQL, Redis, Instances)
+
+### Volumes Utilizados (externos)
+```
+evolution-clean_evolution_instances  # Dados das instâncias WhatsApp
+evolution-clean_evolution_redis      # Cache Redis
+evolution-clean_postgres_data        # Banco de dados PostgreSQL
+```
+
+---
+
+## 📝 Comandos de Deploy
+
+### 1. Clone o repositório
+```bash
+cd ~
+git clone https://github.com/joinads/evolution-api.git evolution-api-custom
+cd evolution-api-custom
+```
+
+### 2. Copie o .env existente
+```bash
+cp ~/evolution-clean/.env .
+```
+
+### 3. Crie o docker-compose.prod.yaml
+```bash
+cat > docker-compose.prod.yaml << 'EOF'
+services:
+  api:
+    container_name: evolution_api
+    build:
+      context: .
+      dockerfile: Dockerfile
+    image: evolution-api:v2.3.4-multidevice
+    restart: always
+    depends_on:
+      - redis
+      - postgres
+    ports:
+      - 8080:8080
+    volumes:
+      - evolution-clean_evolution_instances:/evolution/instances
+    networks:
+      - evolution-net
+    env_file:
+      - .env
+    expose:
+      - 8080
+
+  redis:
+    image: redis:latest
+    networks:
+      - evolution-net
+    container_name: redis
+    command: >
+      redis-server --port 6379 --appendonly yes
+    volumes:
+      - evolution-clean_evolution_redis:/data
+    ports:
+      - 6379:6379
+
+  postgres:
+    container_name: postgres
+    image: postgres:15
+    networks:
+      - evolution-net
+    command: ["postgres", "-c", "max_connections=1000", "-c", "listen_addresses=*"]
+    restart: always
+    ports:
+      - 5432:5432
+    environment:
+      - POSTGRES_USER=caio
+      - POSTGRES_PASSWORD=caio123
+      - POSTGRES_DB=evolution
+      - POSTGRES_HOST_AUTH_METHOD=trust
+    volumes:
+      - evolution-clean_postgres_data:/var/lib/postgresql/data
+    expose:
+      - 5432
+
+volumes:
+  evolution-clean_evolution_instances:
+    external: true
+  evolution-clean_evolution_redis:
+    external: true
+  evolution-clean_postgres_data:
+    external: true
+
+networks:
+  evolution-net:
+    name: evolution-net
+    driver: bridge
+EOF
+```
+
+### 4. Pare a Evolution antiga (se estiver rodando)
+```bash
+cd ~/evolution-clean
+docker-compose down
+```
+
+### 5. Build da nova imagem
+```bash
+cd ~/evolution-api-custom
+docker-compose -f docker-compose.prod.yaml build --no-cache
+```
+
+### 6. Suba os containers
+```bash
+docker-compose -f docker-compose.prod.yaml up -d
+```
+
+### 7. Verifique os logs
+```bash
+docker-compose -f docker-compose.prod.yaml logs -f api
+```
+
+---
+
+## 🔄 Comandos Úteis
+
+### Ver status dos containers
+```bash
+docker-compose -f docker-compose.prod.yaml ps
+```
+
+### Reiniciar a API
+```bash
+docker-compose -f docker-compose.prod.yaml restart api
+```
+
+### Ver logs em tempo real
+```bash
+docker-compose -f docker-compose.prod.yaml logs -f api
+```
+
+### Parar todos os containers
+```bash
+docker-compose -f docker-compose.prod.yaml down
+```
+
+### Rebuild após alterações no código
+```bash
+git pull origin main
+docker-compose -f docker-compose.prod.yaml build --no-cache
+docker-compose -f docker-compose.prod.yaml up -d
+```
+
+---
+
+## 🔍 Verificar se o Fix está Funcionando
+
+Nos logs da API, você deve ver:
+```
+Using Multi-Device native mode (no browser identification)
+```
+
+**NÃO deve mais aparecer:**
+```
+Browser: ['Evolution API', 'Chrome', ...]
+```
+
+---
+
+## ⚠️ Notas Importantes
+
+1. **Instâncias existentes:** Continuam funcionando normalmente. As credenciais salvas não dependem do parâmetro `browser`.
+
+2. **Novas conexões:** Usarão o modo Multi-Device nativo automaticamente.
+
+3. **Se uma sessão expirar:** Ao reconectar via QR Code, já usará o novo modo.
+
+4. **Volumes externos:** O docker-compose usa `external: true` para apontar para os volumes existentes, preservando todos os dados.
+
+---
+
+## 📊 Comparação: Antes vs Depois
+
+| Aspecto | Antes (v2.3.4 oficial) | Depois (com fix) |
+|---------|------------------------|------------------|
+| Identificação | `['Evolution API', 'Chrome', OS]` | Nenhuma (MD nativo) |
+| Tipo de sessão | WebClient | Multi-Device |
+| Aparece como | "WhatsApp Web" | Dispositivo vinculado |
+| Conflita com Android | ✅ SIM | ❌ NÃO |
+| Cai quando Android ativo | ✅ SIM | ❌ NÃO |
+
+---
+
+## 🆘 Rollback (Voltar para versão oficial)
+
+Se precisar voltar para a versão oficial:
+
+```bash
+cd ~/evolution-api-custom
+docker-compose -f docker-compose.prod.yaml down
+
+cd ~/evolution-clean
+docker-compose up -d
+```
+
+## 🔗 Links
+- Fork: https://github.com/joinads/evolution-api
+- Original: https://github.com/EvolutionAPI/evolution-api
+- Baileys: https://github.com/WhiskeySockets/Baileys
+
diff --git a/deploy-vps.sh b/deploy-vps.sh
@@ -0,0 +1,66 @@
+#!/bin/bash
+
+# ===========================================
+# SCRIPT DE DEPLOY - Evolution API Multi-Device
+# ===========================================
+
+set -e
+
+echo "🚀 Iniciando deploy da Evolution API com Multi-Device fix..."
+
+# Cores para output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+# Verificar se está no diretório correto
+if [ ! -f "docker-compose.prod.yaml" ]; then
+    echo -e "${RED}❌ Erro: Execute este script no diretório da Evolution API${NC}"
+    exit 1
+fi
+
+# Backup do docker-compose atual (se existir)
+if [ -f "docker-compose.yaml" ]; then
+    echo -e "${YELLOW}📦 Fazendo backup do docker-compose.yaml atual...${NC}"
+    cp docker-compose.yaml docker-compose.yaml.backup.$(date +%Y%m%d_%H%M%S)
+fi
+
+# Parar containers existentes (mantém volumes)
+echo -e "${YELLOW}⏹️  Parando containers existentes...${NC}"
+docker compose -f docker-compose.prod.yaml down 2>/dev/null || docker-compose -f docker-compose.prod.yaml down 2>/dev/null || true
+
+# Build da nova imagem
+echo -e "${YELLOW}🔨 Buildando imagem com Multi-Device fix...${NC}"
+docker compose -f docker-compose.prod.yaml build --no-cache api
+
+# Subir containers
+echo -e "${YELLOW}🚀 Iniciando containers...${NC}"
+docker compose -f docker-compose.prod.yaml up -d
+
+# Aguardar API iniciar
+echo -e "${YELLOW}⏳ Aguardando API iniciar...${NC}"
+sleep 10
+
+# Verificar status
+echo -e "${GREEN}✅ Deploy concluído!${NC}"
+echo ""
+echo "📊 Status dos containers:"
+docker compose -f docker-compose.prod.yaml ps
+
+echo ""
+echo "📋 Últimos logs da API:"
+docker compose -f docker-compose.prod.yaml logs api --tail 20
+
+echo ""
+echo -e "${GREEN}========================================${NC}"
+echo -e "${GREEN}🎉 Evolution API Multi-Device está rodando!${NC}"
+echo -e "${GREEN}========================================${NC}"
+echo ""
+echo "🔗 Acesse: http://SEU_IP:8080"
+echo "📚 Docs: http://SEU_IP:8080/docs"
+echo "🖥️  Manager: http://SEU_IP:8080/manager"
+echo ""
+echo "💡 Para ver logs em tempo real:"
+echo "   docker compose -f docker-compose.prod.yaml logs -f api"
+