docs: adiciona documentação do deploy Multi-Device fix

Author: GABRIEL-PI

DEPLOY-MULTIDEVICE-FIX.md

@@ -0,0 +1,282 @@
+# 🚀 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
+```
+
+---
+
+## 📅 Data da Alteração
+**04 de Dezembro de 2025**
+
+## 👤 Autor
+Alteração realizada com auxílio de IA (Claude/Cursor)
+
+## 🔗 Links
+- Fork: https://github.com/joinads/evolution-api
+- Original: https://github.com/EvolutionAPI/evolution-api
+- Baileys: https://github.com/WhiskeySockets/Baileys
+