Merge branch 'release/2.3.7'

fix(baileys): prevent message loss from WhatsApp stub placeholders

.cursor/rules/README.md

@@ -0,0 +1,107 @@
+# Evolution API Cursor Rules
+
+Este diretório contém as regras e configurações do Cursor IDE para o projeto Evolution API.
+
+## Estrutura dos Arquivos
+
+### Arquivos Principais (alwaysApply: true)
+- **`core-development.mdc`** - Princípios fundamentais de desenvolvimento
+- **`project-context.mdc`** - Contexto específico do projeto Evolution API
+- **`cursor.json`** - Configurações do Cursor IDE
+
+### Regras Especializadas (alwaysApply: false)
+Estas regras são ativadas automaticamente quando você trabalha nos arquivos correspondentes:
+
+#### Camadas da Aplicação
+- **`specialized-rules/service-rules.mdc`** - Padrões para services (`src/api/services/`)
+- **`specialized-rules/controller-rules.mdc`** - Padrões para controllers (`src/api/controllers/`)
+- **`specialized-rules/dto-rules.mdc`** - Padrões para DTOs (`src/api/dto/`)
+- **`specialized-rules/guard-rules.mdc`** - Padrões para guards (`src/api/guards/`)
+- **`specialized-rules/route-rules.mdc`** - Padrões para routers (`src/api/routes/`)
+
+#### Tipos e Validação
+- **`specialized-rules/type-rules.mdc`** - Definições TypeScript (`src/api/types/`)
+- **`specialized-rules/validate-rules.mdc`** - Schemas de validação (`src/validate/`)
+
+#### Utilitários
+- **`specialized-rules/util-rules.mdc`** - Funções utilitárias (`src/utils/`)
+
+#### Integrações
+- **`specialized-rules/integration-channel-rules.mdc`** - Integrações de canal (`src/api/integrations/channel/`)
+- **`specialized-rules/integration-chatbot-rules.mdc`** - Integrações de chatbot (`src/api/integrations/chatbot/`)
+- **`specialized-rules/integration-storage-rules.mdc`** - Integrações de storage (`src/api/integrations/storage/`)
+- **`specialized-rules/integration-event-rules.mdc`** - Integrações de eventos (`src/api/integrations/event/`)
+
+## Como Usar
+
+### Referências Cruzadas
+Os arquivos principais fazem referência aos especializados usando a sintaxe `@specialized-rules/nome-do-arquivo.mdc`. Quando você trabalha em um arquivo específico, o Cursor automaticamente carrega as regras relevantes.
+
+### Exemplo de Uso
+Quando você edita um arquivo em `src/api/services/`, o Cursor automaticamente:
+1. Carrega `core-development.mdc` (sempre ativo)
+2. Carrega `project-context.mdc` (sempre ativo)
+3. Carrega `specialized-rules/service-rules.mdc` (ativado pelo glob pattern)
+
+### Padrões de Código
+Cada arquivo de regras contém:
+- **Estruturas padrão** - Como organizar o código
+- **Padrões de nomenclatura** - Convenções de nomes
+- **Exemplos práticos** - Código de exemplo
+- **Anti-padrões** - O que evitar
+- **Testes** - Como testar o código
+- **Padrões de Commit** - Conventional Commits com commitlint
+
+## Configuração do Cursor
+
+O arquivo `cursor.json` contém:
+- Configurações de formatação
+- Padrões de código específicos do Evolution API
+- Diretórios principais do projeto
+- Integrações e tecnologias utilizadas
+
+## Manutenção
+
+Para manter as regras atualizadas:
+1. Analise novos padrões no código
+2. Atualize as regras especializadas correspondentes
+3. Mantenha os exemplos sincronizados com o código real
+4. Documente mudanças significativas
+
+## Tecnologias Cobertas
+
+- **Backend**: Node.js 20+ + TypeScript 5+ + Express.js
+- **Database**: Prisma ORM (PostgreSQL/MySQL)
+- **Cache**: Redis + Node-cache
+- **Queue**: RabbitMQ + Amazon SQS
+- **Real-time**: Socket.io
+- **Storage**: AWS S3 + Minio
+- **Validation**: JSONSchema7
+- **Logging**: Pino
+- **WhatsApp**: Baileys + Meta Business API
+- **Integrations**: Chatwoot, Typebot, OpenAI, Dify
+
+## Estrutura do Projeto
+
+```
+src/
+├── api/
+│   ├── controllers/     # Controllers (HTTP handlers)
+│   ├── services/        # Business logic
+│   ├── dto/            # Data Transfer Objects
+│   ├── guards/         # Authentication/Authorization
+│   ├── routes/         # Express routers
+│   ├── types/          # TypeScript definitions
+│   └── integrations/   # External integrations
+│       ├── channel/    # WhatsApp channels (Baileys, Business API)
+│       ├── chatbot/    # Chatbot integrations
+│       ├── event/      # Event integrations
+│       └── storage/    # Storage integrations
+├── cache/              # Cache implementations
+├── config/             # Configuration files
+├── utils/              # Utility functions
+├── validate/           # Validation schemas
+└── exceptions/         # Custom exceptions
+```
+
+Este sistema de regras garante consistência no código e facilita o desenvolvimento seguindo os padrões estabelecidos do Evolution API.

.cursor/rules/core-development.mdc

@@ -0,0 +1,167 @@
+---
+description: Core development principles and standards for Evolution API development
+globs:
+alwaysApply: true
+---
+
+# Evolution API Development Standards
+
+## Cross-References
+- **Project Context**: @project-context.mdc for Evolution API-specific patterns
+- **Specialized Rules**: 
+  - @specialized-rules/service-rules.mdc for service layer patterns
+  - @specialized-rules/controller-rules.mdc for controller patterns
+  - @specialized-rules/dto-rules.mdc for DTO validation patterns
+  - @specialized-rules/guard-rules.mdc for authentication/authorization
+  - @specialized-rules/route-rules.mdc for router patterns
+  - @specialized-rules/type-rules.mdc for TypeScript definitions
+  - @specialized-rules/util-rules.mdc for utility functions
+  - @specialized-rules/validate-rules.mdc for validation schemas
+  - @specialized-rules/integration-channel-rules.mdc for channel integrations
+  - @specialized-rules/integration-chatbot-rules.mdc for chatbot integrations
+  - @specialized-rules/integration-storage-rules.mdc for storage integrations
+  - @specialized-rules/integration-event-rules.mdc for event integrations
+- **TypeScript/Node.js**: Node.js 20+ + TypeScript 5+ best practices
+- **Express/Prisma**: Express.js + Prisma ORM patterns
+- **WhatsApp Integrations**: Baileys + Meta Business API patterns
+
+## Senior Engineer Context - Evolution API Platform
+- You are a senior software engineer working on a WhatsApp API platform
+- Focus on Node.js + TypeScript + Express.js full-stack development
+- Specialized in real-time messaging, WhatsApp integrations, and event-driven architecture
+- Apply scalable patterns for multi-tenant API platform
+- Consider WhatsApp integration workflow implications and performance at scale
+
+## Fundamental Principles
+
+### Code Quality Standards
+- **Simplicity First**: Always prefer simple solutions over complex ones
+- **DRY Principle**: Avoid code duplication - check for existing similar functionality before implementing
+- **Single Responsibility**: Each function/class should have one clear purpose
+- **Readable Code**: Write code that tells a story - clear naming and structure
+
+### Problem Resolution Approach
+- **Follow Existing Patterns**: Use established Service patterns, DTOs, and Integration patterns
+- **Event-Driven First**: Leverage EventEmitter2 for event publishing when adding new features
+- **Integration Pattern**: Follow existing WhatsApp integration patterns for new channels
+- **Conservative Changes**: Prefer extending existing services over creating new architecture
+- **Clean Migration**: Remove deprecated patterns when introducing new ones
+- **Incremental Changes**: Break large changes into smaller, testable increments with proper migrations
+
+### File and Function Organization - Node.js/TypeScript Structure
+- **Services**: Keep services focused and under 200 lines
+- **Controllers**: Keep controllers thin - only routing and validation
+- **DTOs**: Use JSONSchema7 for all input validation
+- **Integrations**: Follow `src/api/integrations/` structure for new integrations
+- **Utils**: Extract common functionality into well-named utilities
+- **Types**: Define clear TypeScript interfaces and types
+
+### Code Analysis and Reflection
+- After writing code, deeply reflect on scalability and maintainability
+- Provide 1-2 paragraph analysis of code changes
+- Suggest improvements or next steps based on reflection
+- Consider performance, security, and maintenance implications
+
+## Development Standards
+
+### TypeScript Standards
+- **Strict Mode**: Always use TypeScript strict mode
+- **No Any**: Avoid `any` type - use proper typing
+- **Interfaces**: Define clear contracts with interfaces
+- **Enums**: Use enums for constants and status values
+- **Generics**: Use generics for reusable components
+
+### Error Handling Standards
+- **HTTP Exceptions**: Use appropriate HTTP status codes
+- **Logging**: Structured logging with context
+- **Retry Logic**: Implement retry for external services
+- **Graceful Degradation**: Handle service failures gracefully
+
+### Security Standards
+- **Input Validation**: Validate all inputs with JSONSchema7
+- **Authentication**: Use API keys and JWT tokens
+- **Rate Limiting**: Implement rate limiting for APIs
+- **Data Sanitization**: Sanitize sensitive data in logs
+
+### Performance Standards
+- **Caching**: Use Redis for frequently accessed data
+- **Database**: Optimize Prisma queries with proper indexing
+- **Memory**: Monitor memory usage and implement cleanup
+- **Async**: Use async/await properly with error handling
+
+## Communication Standards
+
+### Language Requirements
+- **User Communication**: Always respond in Portuguese (PT-BR)
+- **Code Comments**: English for technical documentation
+- **API Documentation**: English for consistency
+- **Error Messages**: Portuguese for user-facing errors
+
+### Documentation Standards
+- **Code Comments**: Document complex business logic
+- **API Documentation**: Document all public endpoints
+- **README**: Keep project documentation updated
+- **Changelog**: Document breaking changes
+
+## Quality Assurance
+
+### Testing Standards
+- **Unit Tests**: Test business logic in services
+- **Integration Tests**: Test API endpoints
+- **Mocks**: Mock external dependencies
+- **Coverage**: Aim for 70%+ test coverage
+
+### Code Review Standards
+- **Peer Review**: All code must be reviewed
+- **Automated Checks**: ESLint, Prettier, TypeScript
+- **Security Review**: Check for security vulnerabilities
+- **Performance Review**: Check for performance issues
+
+### Commit Standards (Conventional Commits)
+- **Format**: `type(scope): subject` (max 100 characters)
+- **Types**: 
+  - `feat` - New feature
+  - `fix` - Bug fix
+  - `docs` - Documentation changes
+  - `style` - Code style changes (formatting, etc)
+  - `refactor` - Code refactoring
+  - `perf` - Performance improvements
+  - `test` - Adding or updating tests
+  - `chore` - Maintenance tasks
+  - `ci` - CI/CD changes
+  - `build` - Build system changes
+  - `revert` - Reverting changes
+  - `security` - Security fixes
+- **Examples**:
+  - `feat(api): add WhatsApp message status endpoint`
+  - `fix(baileys): resolve connection timeout issue`
+  - `docs(readme): update installation instructions`
+  - `refactor(service): extract common message validation logic`
+- **Tools**: Use `npm run commit` (Commitizen) for guided commits
+- **Validation**: Enforced by commitlint on commit-msg hook
+
+## Evolution API Specific Patterns
+
+### WhatsApp Integration Patterns
+- **Connection Management**: One connection per instance
+- **Event Handling**: Proper event listeners for Baileys
+- **Message Processing**: Queue-based message processing
+- **Error Recovery**: Automatic reconnection logic
+
+### Multi-Database Support
+- **Schema Compatibility**: Support PostgreSQL and MySQL
+- **Migration Sync**: Keep migrations synchronized
+- **Type Safety**: Use Prisma generated types
+- **Connection Pooling**: Proper database connection management
+
+### Cache Strategy
+- **Redis Primary**: Use Redis for distributed caching
+- **Local Fallback**: Node-cache for local fallback
+- **TTL Strategy**: Appropriate TTL for different data types
+- **Cache Invalidation**: Proper cache invalidation patterns
+
+### Event System
+- **EventEmitter2**: Use for internal events
+- **WebSocket**: Socket.io for real-time updates
+- **Queue Systems**: RabbitMQ/SQS for async processing
+- **Webhook Processing**: Proper webhook validation and processing

.cursor/rules/cursor.json

@@ -0,0 +1,179 @@
+{
+  "version": "1.0",
+  "description": "Cursor IDE configuration for Evolution API project",
+  "rules": {
+    "general": {
+      "max_line_length": 120,
+      "indent_size": 2,
+      "end_of_line": "lf",
+      "charset": "utf-8",
+      "trim_trailing_whitespace": true,
+      "insert_final_newline": true
+    },
+    "typescript": {
+      "quotes": "single",
+      "semi": true,
+      "trailing_comma": "es5",
+      "bracket_spacing": true,
+      "arrow_parens": "avoid",
+      "print_width": 120,
+      "tab_width": 2,
+      "use_tabs": false,
+      "single_quote": true,
+      "end_of_line": "lf",
+      "strict": true,
+      "no_implicit_any": true,
+      "strict_null_checks": true
+    },
+    "javascript": {
+      "quotes": "single",
+      "semi": true,
+      "trailing_comma": "es5",
+      "bracket_spacing": true,
+      "arrow_parens": "avoid",
+      "print_width": 120,
+      "tab_width": 2,
+      "use_tabs": false,
+      "single_quote": true,
+      "end_of_line": "lf",
+      "style_guide": "eslint-airbnb"
+    },
+    "json": {
+      "tab_width": 2,
+      "use_tabs": false,
+      "parser": "json"
+    },
+    "ignore": {
+      "files": [
+        "node_modules/**",
+        "dist/**",
+        "build/**",
+        ".git/**",
+        "*.min.js",
+        "*.min.css",
+        ".env",
+        ".env.*",
+        ".env.example",
+        "coverage/**",
+        "*.log",
+        "*.lock",
+        "pnpm-lock.yaml",
+        "package-lock.json",
+        "yarn.lock",
+        "log/**",
+        "tmp/**",
+        "instances/**",
+        "public/uploads/**",
+        "*.dump",
+        "*.rdb",
+        "*.mmdb",
+        ".DS_Store",
+        "*.swp",
+        "*.swo",
+        "*.un~",
+        ".jest-cache",
+        ".idea/**",
+        ".vscode/**",
+        ".yalc/**",
+        "yalc.lock",
+        "*.local",
+        "prisma/migrations/**",
+        "prisma/mysql-migrations/**",
+        "prisma/postgresql-migrations/**"
+      ]
+    },
+    "search": {
+      "exclude_patterns": [
+        "**/node_modules/**",
+        "**/dist/**",
+        "**/build/**",
+        "**/.git/**",
+        "**/coverage/**",
+        "**/log/**",
+        "**/tmp/**",
+        "**/instances/**",
+        "**/public/uploads/**",
+        "**/*.min.js",
+        "**/*.min.css",
+        "**/*.log",
+        "**/*.lock",
+        "**/pnpm-lock.yaml",
+        "**/package-lock.json",
+        "**/yarn.lock",
+        "**/*.dump",
+        "**/*.rdb",
+        "**/*.mmdb",
+        "**/.DS_Store",
+        "**/*.swp",
+        "**/*.swo",
+        "**/*.un~",
+        "**/.jest-cache",
+        "**/.idea/**",
+        "**/.vscode/**",
+        "**/.yalc/**",
+        "**/yalc.lock",
+        "**/*.local",
+        "**/prisma/migrations/**",
+        "**/prisma/mysql-migrations/**",
+        "**/prisma/postgresql-migrations/**"
+      ]
+    },
+    "evolution_api": {
+      "project_type": "nodejs_typescript_api",
+      "backend_framework": "express_prisma",
+      "database": ["postgresql", "mysql"],
+      "cache": ["redis", "node_cache"],
+      "queue": ["rabbitmq", "sqs"],
+      "real_time": "socket_io",
+      "file_storage": ["aws_s3", "minio"],
+      "validation": "class_validator",
+      "logging": "pino",
+      "main_directories": {
+        "source": "src/",
+        "api": "src/api/",
+        "controllers": "src/api/controllers/",
+        "services": "src/api/services/",
+        "integrations": "src/api/integrations/",
+        "dto": "src/api/dto/",
+        "types": "src/api/types/",
+        "guards": "src/api/guards/",
+        "routes": "src/api/routes/",
+        "cache": "src/cache/",
+        "config": "src/config/",
+        "utils": "src/utils/",
+        "exceptions": "src/exceptions/",
+        "validate": "src/validate/",
+        "prisma": "prisma/",
+        "tests": "test/",
+        "docs": "docs/"
+      },
+      "key_patterns": [
+        "whatsapp_integration",
+        "multi_database_support",
+        "instance_management",
+        "event_driven_architecture",
+        "service_layer_pattern",
+        "dto_validation",
+        "webhook_processing",
+        "message_queuing",
+        "real_time_communication",
+        "file_storage_integration"
+      ],
+      "whatsapp_integrations": [
+        "baileys",
+        "meta_business_api",
+        "whatsapp_cloud_api"
+      ],
+      "external_integrations": [
+        "chatwoot",
+        "typebot",
+        "openai",
+        "dify",
+        "rabbitmq",
+        "sqs",
+        "s3",
+        "minio"
+      ]
+    }
+  }
+}

.cursor/rules/project-context.mdc

@@ -0,0 +1,174 @@
+---
+description: Evolution API project-specific context and constraints
+globs:
+alwaysApply: true
+---
+
+# Evolution API Project Context
+
+## Cross-References
+- **Core Development**: @core-development.mdc for fundamental development principles
+- **Specialized Rules**: Reference specific specialized rules when working on:
+  - Services: @specialized-rules/service-rules.mdc
+  - Controllers: @specialized-rules/controller-rules.mdc
+  - DTOs: @specialized-rules/dto-rules.mdc
+  - Guards: @specialized-rules/guard-rules.mdc
+  - Routes: @specialized-rules/route-rules.mdc
+  - Types: @specialized-rules/type-rules.mdc
+  - Utils: @specialized-rules/util-rules.mdc
+  - Validation: @specialized-rules/validate-rules.mdc
+  - Channel Integrations: @specialized-rules/integration-channel-rules.mdc
+  - Chatbot Integrations: @specialized-rules/integration-chatbot-rules.mdc
+  - Storage Integrations: @specialized-rules/integration-storage-rules.mdc
+  - Event Integrations: @specialized-rules/integration-event-rules.mdc
+- **TypeScript/Node.js**: Node.js 20+ + TypeScript 5+ backend standards
+- **Express/Prisma**: Express.js + Prisma ORM patterns
+- **WhatsApp Integrations**: Baileys, Meta Business API, and other messaging platforms
+
+## Technology Stack
+- **Backend**: Node.js 20+ + TypeScript 5+ + Express.js
+- **Database**: Prisma ORM (PostgreSQL/MySQL support)
+- **Cache**: Redis + Node-cache for local fallback
+- **Queue**: RabbitMQ + Amazon SQS for message processing
+- **Real-time**: Socket.io for WebSocket connections
+- **Storage**: AWS S3 + Minio for file storage
+- **Validation**: JSONSchema7 for input validation
+- **Logging**: Pino for structured logging
+- **Architecture**: Multi-tenant API with WhatsApp integrations
+
+## Project-Specific Patterns
+
+### WhatsApp Integration Architecture
+- **MANDATORY**: All WhatsApp integrations must follow established patterns
+- **BAILEYS**: Use `whatsapp.baileys.service.ts` patterns for WhatsApp Web
+- **META BUSINESS**: Use `whatsapp.business.service.ts` for official API
+- **CONNECTION MANAGEMENT**: One connection per instance with proper lifecycle
+- **EVENT HANDLING**: Proper event listeners and error handling
+
+### Multi-Database Architecture
+- **CRITICAL**: Support both PostgreSQL and MySQL
+- **SCHEMAS**: Use appropriate schema files (postgresql-schema.prisma / mysql-schema.prisma)
+- **MIGRATIONS**: Keep migrations synchronized between databases
+- **TYPES**: Use database-specific types (@db.JsonB vs @db.Json)
+- **COMPATIBILITY**: Ensure feature parity between databases
+
+### API Integration Workflow
+- **CORE FEATURE**: REST API for WhatsApp communication
+- **COMPLEXITY**: High - involves webhook processing, message routing, and instance management
+- **COMPONENTS**: Instance management, message handling, media processing
+- **INTEGRATIONS**: Baileys, Meta Business API, Chatwoot, Typebot, OpenAI, Dify
+
+### Multi-Tenant Instance Architecture
+- **CRITICAL**: All operations must be scoped by instance
+- **ISOLATION**: Complete data isolation between instances
+- **SECURITY**: Validate instance ownership before operations
+- **SCALING**: Support thousands of concurrent instances
+- **AUTHENTICATION**: API key-based authentication per instance
+
+## Documentation Requirements
+
+### Implementation Documentation
+- **MANDATORY**: Document complex integration patterns
+- **LOCATION**: Use inline comments for business logic
+- **API DOCS**: Document all public endpoints
+- **WEBHOOK DOCS**: Document webhook payloads and signatures
+
+### Change Documentation
+- **CHANGELOG**: Document breaking changes
+- **MIGRATION GUIDES**: Document database migrations
+- **INTEGRATION GUIDES**: Document new integration patterns
+
+## Environment and Security
+
+### Environment Variables
+- **CRITICAL**: Never hardcode sensitive values
+- **VALIDATION**: Validate required environment variables on startup
+- **SECURITY**: Use secure defaults and proper encryption
+- **DOCUMENTATION**: Document all environment variables
+
+### File Organization - Node.js/TypeScript Structure
+- **CONTROLLERS**: Organized by feature (`api/controllers/`)
+- **SERVICES**: Business logic in service classes (`api/services/`)
+- **INTEGRATIONS**: External integrations (`api/integrations/`)
+- **DTOS**: Data transfer objects (`api/dto/`)
+- **TYPES**: TypeScript types (`api/types/`)
+- **UTILS**: Utility functions (`utils/`)
+
+## Integration Points
+
+### WhatsApp Providers
+- **BAILEYS**: WhatsApp Web integration with QR code
+- **META BUSINESS**: Official WhatsApp Business API
+- **CLOUD API**: WhatsApp Cloud API integration
+- **WEBHOOK PROCESSING**: Proper webhook validation and processing
+
+### External Integrations
+- **CHATWOOT**: Customer support platform integration
+- **TYPEBOT**: Chatbot flow integration
+- **OPENAI**: AI-powered chat integration
+- **DIFY**: AI workflow integration
+- **STORAGE**: S3/Minio for media file storage
+
+### Event-Driven Communication
+- **EVENTEMITTER2**: Internal event system
+- **SOCKET.IO**: Real-time WebSocket communication
+- **RABBITMQ**: Message queue for async processing
+- **SQS**: Amazon SQS for cloud-based queuing
+- **WEBHOOKS**: Outbound webhook system
+
+## Development Constraints
+
+### Language Requirements
+- **USER COMMUNICATION**: Always respond in Portuguese (PT-BR)
+- **CODE/COMMENTS**: English for code and technical documentation
+- **API RESPONSES**: English for consistency
+- **ERROR MESSAGES**: Portuguese for user-facing errors
+
+### Performance Constraints
+- **MEMORY**: Efficient memory usage for multiple instances
+- **DATABASE**: Optimized queries with proper indexing
+- **CACHE**: Strategic caching for frequently accessed data
+- **CONNECTIONS**: Proper connection pooling and management
+
+### Security Constraints
+- **AUTHENTICATION**: API key validation for all endpoints
+- **AUTHORIZATION**: Instance-based access control
+- **INPUT VALIDATION**: Validate all inputs with JSONSchema7
+- **RATE LIMITING**: Prevent abuse with rate limiting
+- **WEBHOOK SECURITY**: Validate webhook signatures
+
+## Quality Standards
+- **TYPE SAFETY**: Full TypeScript coverage with strict mode
+- **ERROR HANDLING**: Comprehensive error scenarios with proper logging
+- **TESTING**: Unit and integration tests for critical paths
+- **MONITORING**: Proper logging and error tracking
+- **DOCUMENTATION**: Clear API documentation and code comments
+- **PERFORMANCE**: Optimized for high-throughput message processing
+- **SECURITY**: Secure by default with proper validation
+- **SCALABILITY**: Design for horizontal scaling
+
+## Evolution API Specific Development Patterns
+
+### Instance Management
+- **LIFECYCLE**: Proper instance creation, connection, and cleanup
+- **STATE MANAGEMENT**: Track connection status and health
+- **RECOVERY**: Automatic reconnection and error recovery
+- **MONITORING**: Health checks and status reporting
+
+### Message Processing
+- **QUEUE-BASED**: Use queues for message processing
+- **RETRY LOGIC**: Implement exponential backoff for failures
+- **MEDIA HANDLING**: Proper media upload and processing
+- **WEBHOOK DELIVERY**: Reliable webhook delivery with retries
+
+### Integration Patterns
+- **SERVICE LAYER**: Business logic in service classes
+- **DTO VALIDATION**: Input validation with JSONSchema7
+- **ERROR HANDLING**: Consistent error responses
+- **LOGGING**: Structured logging with correlation IDs
+
+### Database Patterns
+- **PRISMA**: Use Prisma ORM for all database operations
+- **TRANSACTIONS**: Use transactions for multi-step operations
+- **MIGRATIONS**: Proper migration management
+- **INDEXING**: Optimize queries with appropriate indexes

.cursor/rules/specialized-rules/controller-rules.mdc

@@ -0,0 +1,342 @@
+---
+description: Controller patterns for Evolution API
+globs:
+  - "src/api/controllers/**/*.ts"
+  - "src/api/integrations/**/controllers/*.ts"
+alwaysApply: false
+---
+
+# Evolution API Controller Rules
+
+## Controller Structure Pattern
+
+### Standard Controller Class
+```typescript
+export class ExampleController {
+  constructor(private readonly exampleService: ExampleService) {}
+
+  public async createExample(instance: InstanceDto, data: ExampleDto) {
+    return this.exampleService.create(instance, data);
+  }
+
+  public async findExample(instance: InstanceDto) {
+    return this.exampleService.find(instance);
+  }
+}
+```
+
+## Dependency Injection Pattern
+
+### Service Injection
+```typescript
+// CORRECT - Evolution API pattern
+export class ChatController {
+  constructor(private readonly waMonitor: WAMonitoringService) {}
+
+  public async whatsappNumber({ instanceName }: InstanceDto, data: WhatsAppNumberDto) {
+    return await this.waMonitor.waInstances[instanceName].getWhatsAppNumbers(data);
+  }
+}
+
+// INCORRECT - Don't inject multiple services when waMonitor is sufficient
+export class ChatController {
+  constructor(
+    private readonly waMonitor: WAMonitoringService,
+    private readonly prismaRepository: PrismaRepository, // ❌ Unnecessary if waMonitor has access
+    private readonly configService: ConfigService, // ❌ Unnecessary if waMonitor has access
+  ) {}
+}
+```
+
+## Method Signature Pattern
+
+### Instance Parameter Pattern
+```typescript
+// CORRECT - Evolution API pattern (destructuring instanceName)
+public async fetchCatalog({ instanceName }: InstanceDto, data: getCatalogDto) {
+  return await this.waMonitor.waInstances[instanceName].fetchCatalog(instanceName, data);
+}
+
+// CORRECT - Alternative pattern for full instance (when using services)
+public async createTemplate(instance: InstanceDto, data: TemplateDto) {
+  return this.templateService.create(instance, data);
+}
+
+// INCORRECT - Don't use generic method names
+public async methodName(instance: InstanceDto, data: DataDto) { // ❌ Use specific names
+  return this.service.performAction(instance, data);
+}
+```
+
+## WAMonitor Access Pattern
+
+### Direct WAMonitor Usage
+```typescript
+// CORRECT - Standard pattern in controllers
+export class CallController {
+  constructor(private readonly waMonitor: WAMonitoringService) {}
+
+  public async offerCall({ instanceName }: InstanceDto, data: OfferCallDto) {
+    return await this.waMonitor.waInstances[instanceName].offerCall(data);
+  }
+}
+```
+
+## Controller Registration Pattern
+
+### Server Module Registration
+```typescript
+// In server.module.ts
+export const templateController = new TemplateController(templateService);
+export const businessController = new BusinessController(waMonitor);
+export const chatController = new ChatController(waMonitor);
+export const callController = new CallController(waMonitor);
+```
+
+## Error Handling in Controllers
+
+### Let Services Handle Errors
+```typescript
+// CORRECT - Let service handle errors
+public async fetchCatalog(instance: InstanceDto, data: getCatalogDto) {
+  return await this.waMonitor.waInstances[instance.instanceName].fetchCatalog(instance.instanceName, data);
+}
+
+// INCORRECT - Don't add try-catch in controllers unless specific handling needed
+public async fetchCatalog(instance: InstanceDto, data: getCatalogDto) {
+  try {
+    return await this.waMonitor.waInstances[instance.instanceName].fetchCatalog(instance.instanceName, data);
+  } catch (error) {
+    throw error; // ❌ Unnecessary try-catch
+  }
+}
+```
+
+## Complex Controller Pattern
+
+### Instance Controller Pattern
+```typescript
+export class InstanceController {
+  constructor(
+    private readonly waMonitor: WAMonitoringService,
+    private readonly configService: ConfigService,
+    private readonly prismaRepository: PrismaRepository,
+    private readonly eventEmitter: EventEmitter2,
+    private readonly chatwootService: ChatwootService,
+    private readonly settingsService: SettingsService,
+    private readonly proxyService: ProxyController,
+    private readonly cache: CacheService,
+    private readonly chatwootCache: CacheService,
+    private readonly baileysCache: CacheService,
+    private readonly providerFiles: ProviderFiles,
+  ) {}
+
+  private readonly logger = new Logger('InstanceController');
+
+  // Multiple methods handling different aspects
+  public async createInstance(data: InstanceDto) {
+    // Complex instance creation logic
+  }
+
+  public async deleteInstance({ instanceName }: InstanceDto) {
+    // Complex instance deletion logic
+  }
+}
+```
+
+## Channel Controller Pattern
+
+### Base Channel Controller
+```typescript
+export class ChannelController {
+  public prismaRepository: PrismaRepository;
+  public waMonitor: WAMonitoringService;
+
+  constructor(prismaRepository: PrismaRepository, waMonitor: WAMonitoringService) {
+    this.prisma = prismaRepository;
+    this.monitor = waMonitor;
+  }
+
+  // Getters and setters for dependency access
+  public set prisma(prisma: PrismaRepository) {
+    this.prismaRepository = prisma;
+  }
+
+  public get prisma() {
+    return this.prismaRepository;
+  }
+
+  public set monitor(waMonitor: WAMonitoringService) {
+    this.waMonitor = waMonitor;
+  }
+
+  public get monitor() {
+    return this.waMonitor;
+  }
+}
+```
+
+### Extended Channel Controller
+```typescript
+export class EvolutionController extends ChannelController implements ChannelControllerInterface {
+  private readonly logger = new Logger('EvolutionController');
+
+  constructor(prismaRepository: PrismaRepository, waMonitor: WAMonitoringService) {
+    super(prismaRepository, waMonitor);
+  }
+
+  integrationEnabled: boolean;
+
+  public async receiveWebhook(data: any) {
+    const numberId = data.numberId;
+
+    if (!numberId) {
+      this.logger.error('WebhookService -> receiveWebhookEvolution -> numberId not found');
+      return;
+    }
+
+    const instance = await this.prismaRepository.instance.findFirst({
+      where: { number: numberId },
+    });
+
+    if (!instance) {
+      this.logger.error('WebhookService -> receiveWebhook -> instance not found');
+      return;
+    }
+
+    await this.waMonitor.waInstances[instance.name].connectToWhatsapp(data);
+
+    return {
+      status: 'success',
+    };
+  }
+}
+```
+
+## Chatbot Controller Pattern
+
+### Base Chatbot Controller
+```typescript
+export abstract class BaseChatbotController<BotType = any, BotData extends BaseChatbotDto = BaseChatbotDto>
+  extends ChatbotController
+  implements ChatbotControllerInterface
+{
+  public readonly logger: Logger;
+  integrationEnabled: boolean;
+  
+  // Abstract methods to be implemented
+  protected abstract readonly integrationName: string;
+  protected abstract processBot(/* parameters */): Promise<void>;
+  protected abstract getFallbackBotId(settings: any): string | undefined;
+
+  constructor(prismaRepository: PrismaRepository, waMonitor: WAMonitoringService) {
+    super(prismaRepository, waMonitor);
+  }
+
+  // Base implementation methods
+  public async createBot(instance: InstanceDto, data: BotData) {
+    // Common bot creation logic
+  }
+}
+```
+
+## Method Naming Conventions
+
+### Standard Method Names
+- `create*()` - Create operations
+- `find*()` - Find operations  
+- `fetch*()` - Fetch from external APIs
+- `send*()` - Send operations
+- `receive*()` - Receive webhook/data
+- `handle*()` - Handle specific actions
+- `offer*()` - Offer services (like calls)
+
+## Return Patterns
+
+### Direct Return Pattern
+```typescript
+// CORRECT - Direct return from service
+public async createTemplate(instance: InstanceDto, data: TemplateDto) {
+  return this.templateService.create(instance, data);
+}
+
+// CORRECT - Direct return from waMonitor
+public async offerCall({ instanceName }: InstanceDto, data: OfferCallDto) {
+  return await this.waMonitor.waInstances[instanceName].offerCall(data);
+}
+```
+
+## Controller Testing Pattern
+
+### Unit Test Structure
+```typescript
+describe('ExampleController', () => {
+  let controller: ExampleController;
+  let service: jest.Mocked<ExampleService>;
+
+  beforeEach(() => {
+    const mockService = {
+      create: jest.fn(),
+      find: jest.fn(),
+    };
+
+    controller = new ExampleController(mockService as any);
+    service = mockService as any;
+  });
+
+  describe('createExample', () => {
+    it('should call service create method', async () => {
+      const instance = { instanceName: 'test' };
+      const data = { test: 'data' };
+      const expectedResult = { success: true };
+
+      service.create.mockResolvedValue(expectedResult);
+
+      const result = await controller.createExample(instance, data);
+
+      expect(service.create).toHaveBeenCalledWith(instance, data);
+      expect(result).toEqual(expectedResult);
+    });
+  });
+});
+```
+
+## Interface Implementation
+
+### Controller Interface Pattern
+```typescript
+export interface ChannelControllerInterface {
+  integrationEnabled: boolean;
+}
+
+export interface ChatbotControllerInterface {
+  integrationEnabled: boolean;
+  createBot(instance: InstanceDto, data: any): Promise<any>;
+  findBot(instance: InstanceDto): Promise<any>;
+  // ... other methods
+}
+```
+
+## Controller Organization
+
+### File Naming Convention
+- `*.controller.ts` - Main controllers
+- `*/*.controller.ts` - Integration-specific controllers
+
+### Method Organization
+1. Constructor
+2. Public methods (alphabetical order)
+3. Private methods (if any)
+
+### Import Organization
+```typescript
+// DTOs first
+import { InstanceDto } from '@api/dto/instance.dto';
+import { ExampleDto } from '@api/dto/example.dto';
+
+// Services
+import { ExampleService } from '@api/services/example.service';
+
+// Types
+import { WAMonitoringService } from '@api/services/monitor.service';
+```

.cursor/rules/specialized-rules/dto-rules.mdc

@@ -0,0 +1,433 @@
+---
+description: DTO patterns and validation for Evolution API
+globs:
+  - "src/api/dto/**/*.ts"
+  - "src/api/integrations/**/dto/*.ts"
+alwaysApply: false
+---
+
+# Evolution API DTO Rules
+
+## DTO Structure Pattern
+
+### Basic DTO Class
+```typescript
+export class ExampleDto {
+  name: string;
+  category: string;
+  allowCategoryChange: boolean;
+  language: string;
+  components: any;
+  webhookUrl?: string;
+}
+```
+
+## Inheritance Pattern
+
+### DTO Inheritance
+```typescript
+// CORRECT - Evolution API pattern
+export class InstanceDto extends IntegrationDto {
+  instanceName: string;
+  instanceId?: string;
+  qrcode?: boolean;
+  businessId?: string;
+  number?: string;
+  integration?: string;
+  token?: string;
+  status?: string;
+  ownerJid?: string;
+  profileName?: string;
+  profilePicUrl?: string;
+  
+  // Settings
+  rejectCall?: boolean;
+  msgCall?: string;
+  groupsIgnore?: boolean;
+  alwaysOnline?: boolean;
+  readMessages?: boolean;
+  readStatus?: boolean;
+  syncFullHistory?: boolean;
+  wavoipToken?: string;
+  
+  // Proxy settings
+  proxyHost?: string;
+  proxyPort?: string;
+  proxyProtocol?: string;
+  proxyUsername?: string;
+  proxyPassword?: string;
+  
+  // Webhook configuration
+  webhook?: {
+    enabled?: boolean;
+    events?: string[];
+    headers?: JsonValue;
+    url?: string;
+    byEvents?: boolean;
+    base64?: boolean;
+  };
+  
+  // Chatwoot integration
+  chatwootAccountId?: string;
+  chatwootConversationPending?: boolean;
+  chatwootAutoCreate?: boolean;
+  chatwootDaysLimitImportMessages?: number;
+  chatwootImportContacts?: boolean;
+  chatwootImportMessages?: boolean;
+  chatwootLogo?: string;
+  chatwootMergeBrazilContacts?: boolean;
+  chatwootNameInbox?: string;
+  chatwootOrganization?: string;
+  chatwootReopenConversation?: boolean;
+  chatwootSignMsg?: boolean;
+  chatwootToken?: string;
+  chatwootUrl?: string;
+}
+```
+
+## Base DTO Pattern
+
+### Base Chatbot DTO
+```typescript
+/**
+ * Base DTO for all chatbot integrations
+ * Contains common properties shared by all chatbot types
+ */
+export class BaseChatbotDto {
+  enabled?: boolean;
+  description: string;
+  expire?: number;
+  keywordFinish?: string;
+  delayMessage?: number;
+  unknownMessage?: string;
+  listeningFromMe?: boolean;
+  stopBotFromMe?: boolean;
+  keepOpen?: boolean;
+  debounceTime?: number;
+  triggerType: TriggerType;
+  triggerOperator?: TriggerOperator;
+  triggerValue?: string;
+  ignoreJids?: string[];
+  splitMessages?: boolean;
+  timePerChar?: number;
+}
+
+/**
+ * Base settings DTO for all chatbot integrations
+ */
+export class BaseChatbotSettingDto {
+  expire?: number;
+  keywordFinish?: string;
+  delayMessage?: number;
+  unknownMessage?: string;
+  listeningFromMe?: boolean;
+  stopBotFromMe?: boolean;
+  keepOpen?: boolean;
+  debounceTime?: number;
+  ignoreJids?: string[];
+  splitMessages?: boolean;
+  timePerChar?: number;
+}
+```
+
+## Message DTO Patterns
+
+### Send Message DTOs
+```typescript
+export class Metadata {
+  number: string;
+  delay?: number;
+}
+
+export class SendTextDto extends Metadata {
+  text: string;
+  linkPreview?: boolean;
+  mentionsEveryOne?: boolean;
+  mentioned?: string[];
+}
+
+export class SendListDto extends Metadata {
+  title: string;
+  description: string;
+  buttonText: string;
+  footerText?: string;
+
+  sections: Section[];
+}
+
+export class ContactMessage {
+  fullName: string;
+  wuid: string;
+  phoneNumber: string;
+  organization?: string;
+  email?: string;
+  url?: string;
+}
+
+export class SendTemplateDto extends Metadata {
+  name: string;
+  language: string;
+  components: any;
+}
+```
+
+## Simple DTO Patterns
+
+### Basic DTOs
+```typescript
+export class NumberDto {
+  number: string;
+}
+
+export class LabelDto {
+  id?: string;
+  name: string;
+  color: string;
+  predefinedId?: string;
+}
+
+export class HandleLabelDto {
+  number: string;
+  labelId: string;
+}
+
+export class ProfileNameDto {
+  name: string;
+}
+
+export class WhatsAppNumberDto {
+  numbers: string[];
+}
+```
+
+## Complex DTO Patterns
+
+### Business DTOs
+```typescript
+export class getCatalogDto {
+  number?: string;
+  limit?: number;
+  cursor?: string;
+}
+
+export class getCollectionsDto {
+  number?: string;
+  limit?: number;
+  cursor?: string;
+}
+
+export class NumberBusiness {
+  number: string;
+  name?: string;
+  description?: string;
+  email?: string;
+  websites?: string[];
+  latitude?: number;
+  longitude?: number;
+  address?: string;
+  profilehandle?: string;
+}
+```
+
+## Settings DTO Pattern
+
+### Settings Configuration
+```typescript
+export class SettingsDto {
+  rejectCall?: boolean;
+  msgCall?: string;
+  groupsIgnore?: boolean;
+  alwaysOnline?: boolean;
+  readMessages?: boolean;
+  readStatus?: boolean;
+  syncFullHistory?: boolean;
+  wavoipToken?: string;
+}
+
+export class ProxyDto {
+  host?: string;
+  port?: string;
+  protocol?: string;
+  username?: string;
+  password?: string;
+}
+```
+
+## Presence DTO Pattern
+
+### WhatsApp Presence
+```typescript
+export class SetPresenceDto {
+  presence: WAPresence;
+}
+
+export class SendPresenceDto {
+  number: string;
+  presence: WAPresence;
+}
+```
+
+## DTO Structure (No Decorators)
+
+### Simple DTO Classes (Evolution API Pattern)
+```typescript
+// CORRECT - Evolution API pattern (no decorators)
+export class ExampleDto {
+  name: string;
+  description?: string;
+  enabled: boolean;
+  items?: string[];
+  timeout?: number;
+}
+
+// INCORRECT - Don't use class-validator decorators
+export class ValidatedDto {
+  @IsString() // ❌ Evolution API doesn't use decorators
+  name: string;
+}
+```
+
+## Type Safety Patterns
+
+### Prisma Type Integration
+```typescript
+import { JsonValue } from '@prisma/client/runtime/library';
+import { WAPresence } from 'baileys';
+import { TriggerOperator, TriggerType } from '@prisma/client';
+
+export class TypeSafeDto {
+  presence: WAPresence;
+  triggerType: TriggerType;
+  triggerOperator?: TriggerOperator;
+  metadata?: JsonValue;
+}
+```
+
+## DTO Documentation
+
+### JSDoc Comments
+```typescript
+/**
+ * DTO for creating WhatsApp templates
+ * Used by Meta Business API integration
+ */
+export class TemplateDto {
+  /** Template name - must be unique */
+  name: string;
+  
+  /** Template category (MARKETING, UTILITY, AUTHENTICATION) */
+  category: string;
+  
+  /** Whether category can be changed after creation */
+  allowCategoryChange: boolean;
+  
+  /** Language code (e.g., 'pt_BR', 'en_US') */
+  language: string;
+  
+  /** Template components (header, body, footer, buttons) */
+  components: any;
+  
+  /** Optional webhook URL for template status updates */
+  webhookUrl?: string;
+}
+```
+
+## DTO Naming Conventions
+
+### Standard Naming Patterns
+- `*Dto` - Data transfer objects
+- `Create*Dto` - Creation DTOs
+- `Update*Dto` - Update DTOs
+- `Send*Dto` - Message sending DTOs
+- `Get*Dto` - Query DTOs
+- `Handle*Dto` - Action DTOs
+
+## File Organization
+
+### DTO File Structure
+```
+src/api/dto/
+├── instance.dto.ts          # Main instance DTO
+├── template.dto.ts          # Template management
+├── sendMessage.dto.ts       # Message sending DTOs
+├── chat.dto.ts             # Chat operations
+├── business.dto.ts         # Business API DTOs
+├── group.dto.ts            # Group management
+├── label.dto.ts            # Label management
+├── proxy.dto.ts            # Proxy configuration
+├── settings.dto.ts         # Instance settings
+└── call.dto.ts             # Call operations
+```
+
+## Integration DTO Patterns
+
+### Chatbot Integration DTOs
+```typescript
+// Base for all chatbot DTOs
+export class BaseChatbotDto {
+  enabled?: boolean;
+  description: string;
+  // ... common properties
+}
+
+// Specific chatbot DTOs extend base
+export class TypebotDto extends BaseChatbotDto {
+  url: string;
+  typebot: string;
+  // ... typebot-specific properties
+}
+
+export class OpenaiDto extends BaseChatbotDto {
+  apiKey: string;
+  model: string;
+  // ... openai-specific properties
+}
+```
+
+## DTO Testing Pattern
+
+### DTO Validation Tests
+```typescript
+describe('ExampleDto', () => {
+  it('should validate required fields', () => {
+    const dto = new ExampleDto();
+    dto.name = 'test';
+    dto.category = 'MARKETING';
+    dto.allowCategoryChange = true;
+    dto.language = 'pt_BR';
+    dto.components = {};
+
+    expect(dto.name).toBe('test');
+    expect(dto.category).toBe('MARKETING');
+  });
+
+  it('should handle optional fields', () => {
+    const dto = new ExampleDto();
+    dto.name = 'test';
+    dto.category = 'MARKETING';
+    dto.allowCategoryChange = true;
+    dto.language = 'pt_BR';
+    dto.components = {};
+    dto.webhookUrl = 'https://example.com/webhook';
+
+    expect(dto.webhookUrl).toBe('https://example.com/webhook');
+  });
+});
+```
+
+## DTO Transformation
+
+### Request to DTO Mapping (Evolution API Pattern)
+```typescript
+// CORRECT - Evolution API uses RouterBroker dataValidate
+const response = await this.dataValidate<ExampleDto>({
+  request: req,
+  schema: exampleSchema, // JSONSchema7
+  ClassRef: ExampleDto,
+  execute: (instance, data) => controller.method(instance, data),
+});
+
+// INCORRECT - Don't use class-validator
+const dto = plainToClass(ExampleDto, req.body); // ❌ Not used in Evolution API
+const errors = await validate(dto); // ❌ Not used in Evolution API
+```

.cursor/rules/specialized-rules/guard-rules.mdc

@@ -0,0 +1,416 @@
+---
+description: Guard patterns for authentication and authorization in Evolution API
+globs:
+  - "src/api/guards/**/*.ts"
+alwaysApply: false
+---
+
+# Evolution API Guard Rules
+
+## Guard Structure Pattern
+
+### Standard Guard Function
+```typescript
+import { NextFunction, Request, Response } from 'express';
+import { Logger } from '@config/logger.config';
+import { UnauthorizedException, ForbiddenException } from '@exceptions';
+
+const logger = new Logger('GUARD');
+
+async function guardFunction(req: Request, _: Response, next: NextFunction) {
+  // Guard logic here
+  
+  if (validationFails) {
+    throw new UnauthorizedException();
+  }
+  
+  return next();
+}
+
+export const guardName = { guardFunction };
+```
+
+## Authentication Guard Pattern
+
+### API Key Authentication
+```typescript
+async function apikey(req: Request, _: Response, next: NextFunction) {
+  const env = configService.get<Auth>('AUTHENTICATION').API_KEY;
+  const key = req.get('apikey');
+  const db = configService.get<Database>('DATABASE');
+
+  if (!key) {
+    throw new UnauthorizedException();
+  }
+
+  // Global API key check
+  if (env.KEY === key) {
+    return next();
+  }
+
+  // Special routes handling
+  if ((req.originalUrl.includes('/instance/create') || req.originalUrl.includes('/instance/fetchInstances')) && !key) {
+    throw new ForbiddenException('Missing global api key', 'The global api key must be set');
+  }
+
+  const param = req.params as unknown as InstanceDto;
+
+  try {
+    if (param?.instanceName) {
+      const instance = await prismaRepository.instance.findUnique({
+        where: { name: param.instanceName },
+      });
+      if (instance.token === key) {
+        return next();
+      }
+    } else {
+      if (req.originalUrl.includes('/instance/fetchInstances') && db.SAVE_DATA.INSTANCE) {
+        const instanceByKey = await prismaRepository.instance.findFirst({
+          where: { token: key },
+        });
+        if (instanceByKey) {
+          return next();
+        }
+      }
+    }
+  } catch (error) {
+    logger.error(error);
+  }
+
+  throw new UnauthorizedException();
+}
+
+export const authGuard = { apikey };
+```
+
+## Instance Validation Guards
+
+### Instance Exists Guard
+```typescript
+async function getInstance(instanceName: string) {
+  try {
+    const cacheConf = configService.get<CacheConf>('CACHE');
+
+    const exists = !!waMonitor.waInstances[instanceName];
+
+    if (cacheConf.REDIS.ENABLED && cacheConf.REDIS.SAVE_INSTANCES) {
+      const keyExists = await cache.has(instanceName);
+      return exists || keyExists;
+    }
+
+    return exists || (await prismaRepository.instance.findMany({ where: { name: instanceName } })).length > 0;
+  } catch (error) {
+    throw new InternalServerErrorException(error?.toString());
+  }
+}
+
+export async function instanceExistsGuard(req: Request, _: Response, next: NextFunction) {
+  if (req.originalUrl.includes('/instance/create')) {
+    return next();
+  }
+
+  const param = req.params as unknown as InstanceDto;
+  if (!param?.instanceName) {
+    throw new BadRequestException('"instanceName" not provided.');
+  }
+
+  if (!(await getInstance(param.instanceName))) {
+    throw new NotFoundException(`The "${param.instanceName}" instance does not exist`);
+  }
+
+  next();
+}
+```
+
+### Instance Logged Guard
+```typescript
+export async function instanceLoggedGuard(req: Request, _: Response, next: NextFunction) {
+  if (req.originalUrl.includes('/instance/create')) {
+    const instance = req.body as InstanceDto;
+    if (await getInstance(instance.instanceName)) {
+      throw new ForbiddenException(`This name "${instance.instanceName}" is already in use.`);
+    }
+
+    if (waMonitor.waInstances[instance.instanceName]) {
+      delete waMonitor.waInstances[instance.instanceName];
+    }
+  }
+
+  next();
+}
+```
+
+## Telemetry Guard Pattern
+
+### Telemetry Collection
+```typescript
+class Telemetry {
+  public collectTelemetry(req: Request, res: Response, next: NextFunction): void {
+    // Collect telemetry data
+    const telemetryData = {
+      route: req.originalUrl,
+      method: req.method,
+      timestamp: new Date(),
+      userAgent: req.get('User-Agent'),
+    };
+
+    // Send telemetry asynchronously (don't block request)
+    setImmediate(() => {
+      this.sendTelemetry(telemetryData);
+    });
+
+    next();
+  }
+
+  private async sendTelemetry(data: any): Promise<void> {
+    try {
+      // Send telemetry data
+    } catch (error) {
+      // Silently fail - don't affect main request
+    }
+  }
+}
+
+export default Telemetry;
+```
+
+## Guard Composition Pattern
+
+### Multiple Guards Usage
+```typescript
+// In router setup
+const guards = [instanceExistsGuard, instanceLoggedGuard, authGuard['apikey']];
+
+router
+  .use('/instance', new InstanceRouter(configService, ...guards).router)
+  .use('/message', new MessageRouter(...guards).router)
+  .use('/chat', new ChatRouter(...guards).router);
+```
+
+## Error Handling in Guards
+
+### Proper Exception Throwing
+```typescript
+// CORRECT - Use proper HTTP exceptions
+if (!apiKey) {
+  throw new UnauthorizedException('API key required');
+}
+
+if (instanceExists) {
+  throw new ForbiddenException('Instance already exists');
+}
+
+if (!instanceFound) {
+  throw new NotFoundException('Instance not found');
+}
+
+if (validationFails) {
+  throw new BadRequestException('Invalid request parameters');
+}
+
+// INCORRECT - Don't use generic Error
+if (!apiKey) {
+  throw new Error('API key required'); // ❌ Use specific exceptions
+}
+```
+
+## Configuration Access in Guards
+
+### Config Service Usage
+```typescript
+async function configAwareGuard(req: Request, _: Response, next: NextFunction) {
+  const authConfig = configService.get<Auth>('AUTHENTICATION');
+  const cacheConfig = configService.get<CacheConf>('CACHE');
+  const dbConfig = configService.get<Database>('DATABASE');
+
+  // Use configuration for guard logic
+  if (authConfig.API_KEY.KEY === providedKey) {
+    return next();
+  }
+
+  throw new UnauthorizedException();
+}
+```
+
+## Database Access in Guards
+
+### Prisma Repository Usage
+```typescript
+async function databaseGuard(req: Request, _: Response, next: NextFunction) {
+  try {
+    const param = req.params as unknown as InstanceDto;
+    
+    const instance = await prismaRepository.instance.findUnique({
+      where: { name: param.instanceName },
+    });
+
+    if (!instance) {
+      throw new NotFoundException('Instance not found');
+    }
+
+    // Additional validation logic
+    if (instance.status !== 'active') {
+      throw new ForbiddenException('Instance not active');
+    }
+
+    return next();
+  } catch (error) {
+    logger.error('Database guard error:', error);
+    throw new InternalServerErrorException('Database access failed');
+  }
+}
+```
+
+## Cache Integration in Guards
+
+### Cache Service Usage
+```typescript
+async function cacheAwareGuard(req: Request, _: Response, next: NextFunction) {
+  const cacheConf = configService.get<CacheConf>('CACHE');
+  
+  if (cacheConf.REDIS.ENABLED) {
+    const cached = await cache.get(`guard:${req.params.instanceName}`);
+    if (cached) {
+      // Use cached validation result
+      return next();
+    }
+  }
+
+  // Perform validation and cache result
+  const isValid = await performValidation(req.params.instanceName);
+  
+  if (cacheConf.REDIS.ENABLED) {
+    await cache.set(`guard:${req.params.instanceName}`, isValid, 300); // 5 min TTL
+  }
+
+  if (isValid) {
+    return next();
+  }
+
+  throw new UnauthorizedException();
+}
+```
+
+## Logging in Guards
+
+### Structured Logging
+```typescript
+const logger = new Logger('GUARD');
+
+async function loggedGuard(req: Request, _: Response, next: NextFunction) {
+  logger.log(`Guard validation started for ${req.originalUrl}`);
+
+  try {
+    // Guard logic
+    const isValid = await validateRequest(req);
+    
+    if (isValid) {
+      logger.log(`Guard validation successful for ${req.params.instanceName}`);
+      return next();
+    }
+
+    logger.warn(`Guard validation failed for ${req.params.instanceName}`);
+    throw new UnauthorizedException();
+  } catch (error) {
+    logger.error(`Guard validation error: ${error.message}`, error.stack);
+    throw error;
+  }
+}
+```
+
+## Guard Testing Pattern
+
+### Unit Test Structure
+```typescript
+describe('authGuard', () => {
+  let req: Partial<Request>;
+  let res: Partial<Response>;
+  let next: NextFunction;
+
+  beforeEach(() => {
+    req = {
+      get: jest.fn(),
+      params: {},
+      originalUrl: '/test',
+    };
+    res = {};
+    next = jest.fn();
+  });
+
+  describe('apikey', () => {
+    it('should pass with valid global API key', async () => {
+      (req.get as jest.Mock).mockReturnValue('valid-global-key');
+      
+      await authGuard.apikey(req as Request, res as Response, next);
+      
+      expect(next).toHaveBeenCalled();
+    });
+
+    it('should throw UnauthorizedException with no API key', async () => {
+      (req.get as jest.Mock).mockReturnValue(undefined);
+      
+      await expect(
+        authGuard.apikey(req as Request, res as Response, next)
+      ).rejects.toThrow(UnauthorizedException);
+    });
+
+    it('should pass with valid instance token', async () => {
+      (req.get as jest.Mock).mockReturnValue('instance-token');
+      req.params = { instanceName: 'test-instance' };
+      
+      // Mock prisma repository
+      jest.spyOn(prismaRepository.instance, 'findUnique').mockResolvedValue({
+        token: 'instance-token',
+      } as any);
+      
+      await authGuard.apikey(req as Request, res as Response, next);
+      
+      expect(next).toHaveBeenCalled();
+    });
+  });
+});
+```
+
+## Guard Performance Considerations
+
+### Efficient Validation
+```typescript
+// CORRECT - Efficient guard with early returns
+async function efficientGuard(req: Request, _: Response, next: NextFunction) {
+  // Quick checks first
+  if (req.originalUrl.includes('/public')) {
+    return next(); // Skip validation for public routes
+  }
+
+  const apiKey = req.get('apikey');
+  if (!apiKey) {
+    throw new UnauthorizedException(); // Fail fast
+  }
+
+  // More expensive checks only if needed
+  if (apiKey === globalKey) {
+    return next(); // Skip database check
+  }
+
+  // Database check only as last resort
+  const isValid = await validateInDatabase(apiKey);
+  if (isValid) {
+    return next();
+  }
+
+  throw new UnauthorizedException();
+}
+
+// INCORRECT - Inefficient guard
+async function inefficientGuard(req: Request, _: Response, next: NextFunction) {
+  // Always do expensive database check first
+  const dbResult = await expensiveDatabaseQuery(); // ❌ Expensive operation first
+  
+  const apiKey = req.get('apikey');
+  if (!apiKey && dbResult) { // ❌ Complex logic
+    throw new UnauthorizedException();
+  }
+  
+  next();
+}
+```

.cursor/rules/specialized-rules/integration-channel-rules.mdc

@@ -0,0 +1,552 @@
+---
+description: Channel integration patterns for Evolution API
+globs:
+  - "src/api/integrations/channel/**/*.ts"
+alwaysApply: false
+---
+
+# Evolution API Channel Integration Rules
+
+## Channel Controller Pattern
+
+### Base Channel Controller
+```typescript
+export interface ChannelControllerInterface {
+  integrationEnabled: boolean;
+}
+
+export class ChannelController {
+  public prismaRepository: PrismaRepository;
+  public waMonitor: WAMonitoringService;
+
+  constructor(prismaRepository: PrismaRepository, waMonitor: WAMonitoringService) {
+    this.prisma = prismaRepository;
+    this.monitor = waMonitor;
+  }
+
+  public set prisma(prisma: PrismaRepository) {
+    this.prismaRepository = prisma;
+  }
+
+  public get prisma() {
+    return this.prismaRepository;
+  }
+
+  public set monitor(waMonitor: WAMonitoringService) {
+    this.waMonitor = waMonitor;
+  }
+
+  public get monitor() {
+    return this.waMonitor;
+  }
+
+  public init(instanceData: InstanceDto, data: ChannelDataType) {
+    if (!instanceData.token && instanceData.integration === Integration.WHATSAPP_BUSINESS) {
+      throw new BadRequestException('token is required');
+    }
+
+    if (instanceData.integration === Integration.WHATSAPP_BUSINESS) {
+      return new BusinessStartupService(/* dependencies */);
+    }
+
+    if (instanceData.integration === Integration.EVOLUTION) {
+      return new EvolutionStartupService(/* dependencies */);
+    }
+
+    if (instanceData.integration === Integration.WHATSAPP_BAILEYS) {
+      return new BaileysStartupService(/* dependencies */);
+    }
+
+    return null;
+  }
+}
+```
+
+### Extended Channel Controller
+```typescript
+export class EvolutionController extends ChannelController implements ChannelControllerInterface {
+  private readonly logger = new Logger('EvolutionController');
+
+  constructor(prismaRepository: PrismaRepository, waMonitor: WAMonitoringService) {
+    super(prismaRepository, waMonitor);
+  }
+
+  integrationEnabled: boolean;
+
+  public async receiveWebhook(data: any) {
+    const numberId = data.numberId;
+
+    if (!numberId) {
+      this.logger.error('WebhookService -> receiveWebhookEvolution -> numberId not found');
+      return;
+    }
+
+    const instance = await this.prismaRepository.instance.findFirst({
+      where: { number: numberId },
+    });
+
+    if (!instance) {
+      this.logger.error('WebhookService -> receiveWebhook -> instance not found');
+      return;
+    }
+
+    await this.waMonitor.waInstances[instance.name].connectToWhatsapp(data);
+
+    return {
+      status: 'success',
+    };
+  }
+}
+```
+
+## Channel Service Pattern
+
+### Base Channel Service
+```typescript
+export class ChannelStartupService {
+  constructor(
+    private readonly configService: ConfigService,
+    private readonly eventEmitter: EventEmitter2,
+    private readonly prismaRepository: PrismaRepository,
+    public readonly cache: CacheService,
+    public readonly chatwootCache: CacheService,
+  ) {}
+
+  public readonly logger = new Logger('ChannelStartupService');
+
+  public client: WASocket;
+  public readonly instance: wa.Instance = {};
+  public readonly localChatwoot: wa.LocalChatwoot = {};
+  public readonly localProxy: wa.LocalProxy = {};
+  public readonly localSettings: wa.LocalSettings = {};
+  public readonly localWebhook: wa.LocalWebHook = {};
+
+  public setInstance(instance: InstanceDto) {
+    this.logger.setInstance(instance.instanceName);
+
+    this.instance.name = instance.instanceName;
+    this.instance.id = instance.instanceId;
+    this.instance.integration = instance.integration;
+    this.instance.number = instance.number;
+    this.instance.token = instance.token;
+    this.instance.businessId = instance.businessId;
+
+    if (this.configService.get<Chatwoot>('CHATWOOT').ENABLED && this.localChatwoot?.enabled) {
+      this.chatwootService.eventWhatsapp(
+        Events.STATUS_INSTANCE,
+        { instanceName: this.instance.name },
+        {
+          instance: this.instance.name,
+          status: 'created',
+        },
+      );
+    }
+  }
+
+  public set instanceName(name: string) {
+    this.logger.setInstance(name);
+    this.instance.name = name;
+  }
+
+  public get instanceName() {
+    return this.instance.name;
+  }
+}
+```
+
+### Extended Channel Service
+```typescript
+export class EvolutionStartupService extends ChannelStartupService {
+  constructor(
+    configService: ConfigService,
+    eventEmitter: EventEmitter2,
+    prismaRepository: PrismaRepository,
+    cache: CacheService,
+    chatwootCache: CacheService,
+  ) {
+    super(configService, eventEmitter, prismaRepository, cache, chatwootCache);
+  }
+
+  public async sendMessage(data: SendTextDto): Promise<any> {
+    // Evolution-specific message sending logic
+    const response = await this.evolutionApiCall('/send-message', data);
+    return response;
+  }
+
+  public async connectToWhatsapp(data: any): Promise<void> {
+    // Evolution-specific connection logic
+    this.logger.log('Connecting to Evolution API');
+    
+    // Set up webhook listeners
+    this.setupWebhookHandlers();
+    
+    // Initialize connection
+    await this.initializeConnection(data);
+  }
+
+  private async evolutionApiCall(endpoint: string, data: any): Promise<any> {
+    const config = this.configService.get<Evolution>('EVOLUTION');
+    
+    try {
+      const response = await axios.post(`${config.API_URL}${endpoint}`, data, {
+        headers: {
+          'Authorization': `Bearer ${this.instance.token}`,
+          'Content-Type': 'application/json',
+        },
+      });
+      
+      return response.data;
+    } catch (error) {
+      this.logger.error(`Evolution API call failed: ${error.message}`);
+      throw new InternalServerErrorException('Evolution API call failed');
+    }
+  }
+
+  private setupWebhookHandlers(): void {
+    // Set up webhook event handlers
+  }
+
+  private async initializeConnection(data: any): Promise<void> {
+    // Initialize connection with Evolution API
+  }
+}
+```
+
+## Business API Service Pattern
+
+### Meta Business Service
+```typescript
+export class BusinessStartupService extends ChannelStartupService {
+  constructor(
+    configService: ConfigService,
+    eventEmitter: EventEmitter2,
+    prismaRepository: PrismaRepository,
+    cache: CacheService,
+    chatwootCache: CacheService,
+    baileysCache: CacheService,
+    providerFiles: ProviderFiles,
+  ) {
+    super(configService, eventEmitter, prismaRepository, cache, chatwootCache);
+  }
+
+  public async sendMessage(data: SendTextDto): Promise<any> {
+    const businessConfig = this.configService.get<WaBusiness>('WA_BUSINESS');
+    
+    const payload = {
+      messaging_product: 'whatsapp',
+      to: data.number,
+      type: 'text',
+      text: {
+        body: data.text,
+      },
+    };
+
+    try {
+      const response = await axios.post(
+        `${businessConfig.URL}/${businessConfig.VERSION}/${this.instance.businessId}/messages`,
+        payload,
+        {
+          headers: {
+            'Authorization': `Bearer ${this.instance.token}`,
+            'Content-Type': 'application/json',
+          },
+        }
+      );
+
+      return response.data;
+    } catch (error) {
+      this.logger.error(`Business API call failed: ${error.message}`);
+      throw new BadRequestException('Failed to send message via Business API');
+    }
+  }
+
+  public async receiveWebhook(data: any): Promise<void> {
+    // Process incoming webhook from Meta Business API
+    const { entry } = data;
+    
+    for (const entryItem of entry) {
+      const { changes } = entryItem;
+      
+      for (const change of changes) {
+        if (change.field === 'messages') {
+          await this.processMessage(change.value);
+        }
+      }
+    }
+  }
+
+  private async processMessage(messageData: any): Promise<void> {
+    // Process incoming message from Business API
+    const { messages, contacts } = messageData;
+    
+    if (messages) {
+      for (const message of messages) {
+        await this.handleIncomingMessage(message, contacts);
+      }
+    }
+  }
+
+  private async handleIncomingMessage(message: any, contacts: any[]): Promise<void> {
+    // Handle individual message
+    const contact = contacts?.find(c => c.wa_id === message.from);
+    
+    // Emit event for message processing
+    this.eventEmitter.emit(Events.MESSAGES_UPSERT, {
+      instanceName: this.instance.name,
+      message,
+      contact,
+    });
+  }
+}
+```
+
+## Baileys Service Pattern
+
+### Baileys Integration Service
+```typescript
+export class BaileysStartupService extends ChannelStartupService {
+  constructor(
+    configService: ConfigService,
+    eventEmitter: EventEmitter2,
+    prismaRepository: PrismaRepository,
+    cache: CacheService,
+    chatwootCache: CacheService,
+    baileysCache: CacheService,
+    providerFiles: ProviderFiles,
+  ) {
+    super(configService, eventEmitter, prismaRepository, cache, chatwootCache);
+  }
+
+  public async connectToWhatsapp(): Promise<void> {
+    const authPath = path.join(INSTANCE_DIR, this.instance.name);
+    const { state, saveCreds } = await useMultiFileAuthState(authPath);
+
+    this.client = makeWASocket({
+      auth: state,
+      logger: P({ level: 'error' }),
+      printQRInTerminal: false,
+      browser: ['Evolution API', 'Chrome', '4.0.0'],
+      defaultQueryTimeoutMs: 60000,
+    });
+
+    this.setupEventHandlers();
+    this.client.ev.on('creds.update', saveCreds);
+  }
+
+  private setupEventHandlers(): void {
+    this.client.ev.on('connection.update', (update) => {
+      this.handleConnectionUpdate(update);
+    });
+
+    this.client.ev.on('messages.upsert', ({ messages, type }) => {
+      this.handleIncomingMessages(messages, type);
+    });
+
+    this.client.ev.on('messages.update', (updates) => {
+      this.handleMessageUpdates(updates);
+    });
+
+    this.client.ev.on('contacts.upsert', (contacts) => {
+      this.handleContactsUpdate(contacts);
+    });
+
+    this.client.ev.on('chats.upsert', (chats) => {
+      this.handleChatsUpdate(chats);
+    });
+  }
+
+  private async handleConnectionUpdate(update: ConnectionUpdate): Promise<void> {
+    const { connection, lastDisconnect, qr } = update;
+
+    if (qr) {
+      this.instance.qrcode = {
+        count: this.instance.qrcode?.count ? this.instance.qrcode.count + 1 : 1,
+        base64: qr,
+      };
+
+      this.eventEmitter.emit(Events.QRCODE_UPDATED, {
+        instanceName: this.instance.name,
+        qrcode: this.instance.qrcode,
+      });
+    }
+
+    if (connection === 'close') {
+      const shouldReconnect = (lastDisconnect?.error as Boom)?.output?.statusCode !== DisconnectReason.loggedOut;
+      
+      if (shouldReconnect) {
+        this.logger.log('Connection closed, reconnecting...');
+        await this.connectToWhatsapp();
+      } else {
+        this.logger.log('Connection closed, logged out');
+        this.eventEmitter.emit(Events.LOGOUT_INSTANCE, {
+          instanceName: this.instance.name,
+        });
+      }
+    }
+
+    if (connection === 'open') {
+      this.logger.log('Connection opened successfully');
+      this.instance.wuid = this.client.user?.id;
+      
+      this.eventEmitter.emit(Events.CONNECTION_UPDATE, {
+        instanceName: this.instance.name,
+        state: 'open',
+      });
+    }
+  }
+
+  public async sendMessage(data: SendTextDto): Promise<any> {
+    const jid = createJid(data.number);
+    
+    const message = {
+      text: data.text,
+    };
+
+    if (data.linkPreview !== undefined) {
+      message.linkPreview = data.linkPreview;
+    }
+
+    if (data.mentionsEveryOne) {
+      // Handle mentions
+    }
+
+    try {
+      const response = await this.client.sendMessage(jid, message);
+      return response;
+    } catch (error) {
+      this.logger.error(`Failed to send message: ${error.message}`);
+      throw new BadRequestException('Failed to send message');
+    }
+  }
+}
+```
+
+## Channel Router Pattern
+
+### Channel Router Structure
+```typescript
+export class ChannelRouter {
+  public readonly router: Router;
+
+  constructor(configService: any, ...guards: any[]) {
+    this.router = Router();
+
+    this.router.use('/', new EvolutionRouter(configService).router);
+    this.router.use('/', new MetaRouter(configService).router);
+    this.router.use('/baileys', new BaileysRouter(...guards).router);
+  }
+}
+```
+
+### Specific Channel Router
+```typescript
+export class EvolutionRouter extends RouterBroker {
+  constructor(private readonly configService: ConfigService) {
+    super();
+    this.router
+      .post(this.routerPath('webhook'), async (req, res) => {
+        const response = await evolutionController.receiveWebhook(req.body);
+        return res.status(HttpStatus.OK).json(response);
+      });
+  }
+
+  public readonly router: Router = Router();
+}
+```
+
+## Integration Types
+
+### Channel Data Types
+```typescript
+type ChannelDataType = {
+  configService: ConfigService;
+  eventEmitter: EventEmitter2;
+  prismaRepository: PrismaRepository;
+  cache: CacheService;
+  chatwootCache: CacheService;
+  baileysCache: CacheService;
+  providerFiles: ProviderFiles;
+};
+
+export enum Integration {
+  WHATSAPP_BUSINESS = 'WHATSAPP-BUSINESS',
+  WHATSAPP_BAILEYS = 'WHATSAPP-BAILEYS',
+  EVOLUTION = 'EVOLUTION',
+}
+```
+
+## Error Handling in Channels
+
+### Channel-Specific Error Handling
+```typescript
+// CORRECT - Channel-specific error handling
+public async sendMessage(data: SendTextDto): Promise<any> {
+  try {
+    const response = await this.channelSpecificSend(data);
+    return response;
+  } catch (error) {
+    this.logger.error(`${this.constructor.name} send failed: ${error.message}`);
+    
+    if (error.response?.status === 401) {
+      throw new UnauthorizedException('Invalid token for channel');
+    }
+    
+    if (error.response?.status === 429) {
+      throw new BadRequestException('Rate limit exceeded');
+    }
+    
+    throw new InternalServerErrorException('Channel communication failed');
+  }
+}
+```
+
+## Channel Testing Pattern
+
+### Channel Service Testing
+```typescript
+describe('EvolutionStartupService', () => {
+  let service: EvolutionStartupService;
+  let configService: jest.Mocked<ConfigService>;
+  let eventEmitter: jest.Mocked<EventEmitter2>;
+
+  beforeEach(() => {
+    const mockConfig = {
+      get: jest.fn().mockReturnValue({
+        API_URL: 'https://api.evolution.com',
+      }),
+    };
+
+    service = new EvolutionStartupService(
+      mockConfig as any,
+      eventEmitter,
+      prismaRepository,
+      cache,
+      chatwootCache,
+    );
+  });
+
+  describe('sendMessage', () => {
+    it('should send message successfully', async () => {
+      const data = { number: '5511999999999', text: 'Test message' };
+      
+      // Mock axios response
+      jest.spyOn(axios, 'post').mockResolvedValue({
+        data: { success: true, messageId: '123' },
+      });
+
+      const result = await service.sendMessage(data);
+
+      expect(result.success).toBe(true);
+      expect(axios.post).toHaveBeenCalledWith(
+        expect.stringContaining('/send-message'),
+        data,
+        expect.objectContaining({
+          headers: expect.objectContaining({
+            'Authorization': expect.stringContaining('Bearer'),
+          }),
+        })
+      );
+    });
+  });
+});
+```

.cursor/rules/specialized-rules/integration-chatbot-rules.mdc

@@ -0,0 +1,597 @@
+---
+description: Chatbot integration patterns for Evolution API
+globs:
+  - "src/api/integrations/chatbot/**/*.ts"
+alwaysApply: false
+---
+
+# Evolution API Chatbot Integration Rules
+
+## Base Chatbot Pattern
+
+### Base Chatbot DTO
+```typescript
+/**
+ * Base DTO for all chatbot integrations
+ * Contains common properties shared by all chatbot types
+ */
+export class BaseChatbotDto {
+  enabled?: boolean;
+  description: string;
+  expire?: number;
+  keywordFinish?: string;
+  delayMessage?: number;
+  unknownMessage?: string;
+  listeningFromMe?: boolean;
+  stopBotFromMe?: boolean;
+  keepOpen?: boolean;
+  debounceTime?: number;
+  triggerType: TriggerType;
+  triggerOperator?: TriggerOperator;
+  triggerValue?: string;
+  ignoreJids?: string[];
+  splitMessages?: boolean;
+  timePerChar?: number;
+}
+```
+
+### Base Chatbot Controller
+```typescript
+export abstract class BaseChatbotController<BotType = any, BotData extends BaseChatbotDto = BaseChatbotDto>
+  extends ChatbotController
+  implements ChatbotControllerInterface
+{
+  public readonly logger: Logger;
+  integrationEnabled: boolean;
+  botRepository: any;
+  settingsRepository: any;
+  sessionRepository: any;
+  userMessageDebounce: { [key: string]: { message: string; timeoutId: NodeJS.Timeout } } = {};
+
+  // Abstract methods to be implemented by specific chatbots
+  protected abstract readonly integrationName: string;
+  protected abstract processBot(
+    waInstance: any,
+    remoteJid: string,
+    bot: BotType,
+    session: any,
+    settings: ChatbotSettings,
+    content: string,
+    pushName?: string,
+    msg?: any,
+  ): Promise<void>;
+  protected abstract getFallbackBotId(settings: any): string | undefined;
+
+  constructor(prismaRepository: PrismaRepository, waMonitor: WAMonitoringService) {
+    super(prismaRepository, waMonitor);
+    this.sessionRepository = this.prismaRepository.integrationSession;
+  }
+
+  // Base implementation methods
+  public async createBot(instance: InstanceDto, data: BotData) {
+    if (!data.enabled) {
+      throw new BadRequestException(`${this.integrationName} is disabled`);
+    }
+
+    // Common bot creation logic
+    const bot = await this.botRepository.create({
+      data: {
+        ...data,
+        instanceId: instance.instanceId,
+      },
+    });
+
+    return bot;
+  }
+}
+```
+
+### Base Chatbot Service
+```typescript
+/**
+ * Base class for all chatbot service implementations
+ * Contains common methods shared across different chatbot integrations
+ */
+export abstract class BaseChatbotService<BotType = any, SettingsType = any> {
+  protected readonly logger: Logger;
+  protected readonly waMonitor: WAMonitoringService;
+  protected readonly prismaRepository: PrismaRepository;
+  protected readonly configService?: ConfigService;
+
+  constructor(
+    waMonitor: WAMonitoringService,
+    prismaRepository: PrismaRepository,
+    loggerName: string,
+    configService?: ConfigService,
+  ) {
+    this.waMonitor = waMonitor;
+    this.prismaRepository = prismaRepository;
+    this.logger = new Logger(loggerName);
+    this.configService = configService;
+  }
+
+  /**
+   * Check if a message contains an image
+   */
+  protected isImageMessage(content: string): boolean {
+    return content.includes('imageMessage');
+  }
+
+  /**
+   * Extract text content from message
+   */
+  protected getMessageContent(msg: any): string {
+    return getConversationMessage(msg);
+  }
+
+  /**
+   * Send typing indicator
+   */
+  protected async sendTyping(instanceName: string, remoteJid: string): Promise<void> {
+    await this.waMonitor.waInstances[instanceName].sendPresence(remoteJid, 'composing');
+  }
+}
+```
+
+## Typebot Integration Pattern
+
+### Typebot Service
+```typescript
+export class TypebotService extends BaseChatbotService<TypebotModel, any> {
+  constructor(
+    waMonitor: WAMonitoringService,
+    configService: ConfigService,
+    prismaRepository: PrismaRepository,
+    private readonly openaiService: OpenaiService,
+  ) {
+    super(waMonitor, prismaRepository, 'TypebotService', configService);
+  }
+
+  public async sendTypebotMessage(
+    instanceName: string,
+    remoteJid: string,
+    typebot: TypebotModel,
+    content: string,
+  ): Promise<void> {
+    try {
+      const response = await axios.post(
+        `${typebot.url}/api/v1/typebots/${typebot.typebot}/startChat`,
+        {
+          message: content,
+          sessionId: `${instanceName}-${remoteJid}`,
+        },
+        {
+          headers: {
+            'Content-Type': 'application/json',
+          },
+        }
+      );
+
+      const { messages } = response.data;
+      
+      for (const message of messages) {
+        await this.processTypebotMessage(instanceName, remoteJid, message);
+      }
+    } catch (error) {
+      this.logger.error(`Typebot API error: ${error.message}`);
+      throw new InternalServerErrorException('Typebot communication failed');
+    }
+  }
+
+  private async processTypebotMessage(
+    instanceName: string,
+    remoteJid: string,
+    message: any,
+  ): Promise<void> {
+    const waInstance = this.waMonitor.waInstances[instanceName];
+    
+    if (message.type === 'text') {
+      await waInstance.sendMessage({
+        number: remoteJid.split('@')[0],
+        text: message.content.richText[0].children[0].text,
+      });
+    }
+    
+    if (message.type === 'image') {
+      await waInstance.sendMessage({
+        number: remoteJid.split('@')[0],
+        mediaMessage: {
+          mediatype: 'image',
+          media: message.content.url,
+        },
+      });
+    }
+  }
+}
+```
+
+## OpenAI Integration Pattern
+
+### OpenAI Service
+```typescript
+export class OpenaiService extends BaseChatbotService<OpenaiModel, any> {
+  constructor(
+    waMonitor: WAMonitoringService,
+    prismaRepository: PrismaRepository,
+    configService: ConfigService,
+  ) {
+    super(waMonitor, prismaRepository, 'OpenaiService', configService);
+  }
+
+  public async sendOpenaiMessage(
+    instanceName: string,
+    remoteJid: string,
+    openai: OpenaiModel,
+    content: string,
+    pushName?: string,
+  ): Promise<void> {
+    try {
+      const openaiConfig = this.configService.get<Openai>('OPENAI');
+      
+      const response = await axios.post(
+        'https://api.openai.com/v1/chat/completions',
+        {
+          model: openai.model || 'gpt-3.5-turbo',
+          messages: [
+            {
+              role: 'system',
+              content: openai.systemMessage || 'You are a helpful assistant.',
+            },
+            {
+              role: 'user',
+              content: content,
+            },
+          ],
+          max_tokens: openai.maxTokens || 1000,
+          temperature: openai.temperature || 0.7,
+        },
+        {
+          headers: {
+            'Authorization': `Bearer ${openai.apiKey || openaiConfig.API_KEY}`,
+            'Content-Type': 'application/json',
+          },
+        }
+      );
+
+      const aiResponse = response.data.choices[0].message.content;
+      
+      await this.waMonitor.waInstances[instanceName].sendMessage({
+        number: remoteJid.split('@')[0],
+        text: aiResponse,
+      });
+    } catch (error) {
+      this.logger.error(`OpenAI API error: ${error.message}`);
+      
+      // Send fallback message
+      await this.waMonitor.waInstances[instanceName].sendMessage({
+        number: remoteJid.split('@')[0],
+        text: openai.unknownMessage || 'Desculpe, não consegui processar sua mensagem.',
+      });
+    }
+  }
+}
+```
+
+## Chatwoot Integration Pattern
+
+### Chatwoot Service
+```typescript
+export class ChatwootService extends BaseChatbotService<any, any> {
+  constructor(
+    waMonitor: WAMonitoringService,
+    configService: ConfigService,
+    prismaRepository: PrismaRepository,
+    private readonly chatwootCache: CacheService,
+  ) {
+    super(waMonitor, prismaRepository, 'ChatwootService', configService);
+  }
+
+  public async eventWhatsapp(
+    event: Events,
+    instanceName: { instanceName: string },
+    data: any,
+  ): Promise<void> {
+    const chatwootConfig = this.configService.get<Chatwoot>('CHATWOOT');
+    
+    if (!chatwootConfig.ENABLED) {
+      return;
+    }
+
+    try {
+      const instance = await this.prismaRepository.instance.findUnique({
+        where: { name: instanceName.instanceName },
+      });
+
+      if (!instance?.chatwootAccountId) {
+        return;
+      }
+
+      const webhook = {
+        event,
+        instance: instanceName.instanceName,
+        data,
+        timestamp: new Date().toISOString(),
+      };
+
+      await axios.post(
+        `${instance.chatwootUrl}/api/v1/accounts/${instance.chatwootAccountId}/webhooks`,
+        webhook,
+        {
+          headers: {
+            'Authorization': `Bearer ${instance.chatwootToken}`,
+            'Content-Type': 'application/json',
+          },
+        }
+      );
+    } catch (error) {
+      this.logger.error(`Chatwoot webhook error: ${error.message}`);
+    }
+  }
+
+  public async createConversation(
+    instanceName: string,
+    contact: any,
+    message: any,
+  ): Promise<void> {
+    // Create conversation in Chatwoot
+    const instance = await this.prismaRepository.instance.findUnique({
+      where: { name: instanceName },
+    });
+
+    if (!instance?.chatwootAccountId) {
+      return;
+    }
+
+    try {
+      const conversation = await axios.post(
+        `${instance.chatwootUrl}/api/v1/accounts/${instance.chatwootAccountId}/conversations`,
+        {
+          source_id: contact.id,
+          inbox_id: instance.chatwootInboxId,
+          contact_id: contact.chatwootContactId,
+        },
+        {
+          headers: {
+            'Authorization': `Bearer ${instance.chatwootToken}`,
+            'Content-Type': 'application/json',
+          },
+        }
+      );
+
+      // Cache conversation
+      await this.chatwootCache.set(
+        `conversation:${instanceName}:${contact.id}`,
+        conversation.data,
+        3600
+      );
+    } catch (error) {
+      this.logger.error(`Chatwoot conversation creation error: ${error.message}`);
+    }
+  }
+}
+```
+
+## Dify Integration Pattern
+
+### Dify Service
+```typescript
+export class DifyService extends BaseChatbotService<DifyModel, any> {
+  constructor(
+    waMonitor: WAMonitoringService,
+    prismaRepository: PrismaRepository,
+    configService: ConfigService,
+    private readonly openaiService: OpenaiService,
+  ) {
+    super(waMonitor, prismaRepository, 'DifyService', configService);
+  }
+
+  public async sendDifyMessage(
+    instanceName: string,
+    remoteJid: string,
+    dify: DifyModel,
+    content: string,
+  ): Promise<void> {
+    try {
+      const response = await axios.post(
+        `${dify.apiUrl}/v1/chat-messages`,
+        {
+          inputs: {},
+          query: content,
+          user: remoteJid,
+          conversation_id: `${instanceName}-${remoteJid}`,
+          response_mode: 'blocking',
+        },
+        {
+          headers: {
+            'Authorization': `Bearer ${dify.apiKey}`,
+            'Content-Type': 'application/json',
+          },
+        }
+      );
+
+      const aiResponse = response.data.answer;
+      
+      await this.waMonitor.waInstances[instanceName].sendMessage({
+        number: remoteJid.split('@')[0],
+        text: aiResponse,
+      });
+    } catch (error) {
+      this.logger.error(`Dify API error: ${error.message}`);
+      
+      // Fallback to OpenAI if configured
+      if (dify.fallbackOpenai && this.openaiService) {
+        await this.openaiService.sendOpenaiMessage(instanceName, remoteJid, dify.openaiBot, content);
+      }
+    }
+  }
+}
+```
+
+## Chatbot Router Pattern
+
+### Chatbot Router Structure (Evolution API Real Pattern)
+```typescript
+export class ChatbotRouter {
+  public readonly router: Router;
+
+  constructor(...guards: any[]) {
+    this.router = Router();
+
+    // Real Evolution API chatbot integrations
+    this.router.use('/evolutionBot', new EvolutionBotRouter(...guards).router);
+    this.router.use('/chatwoot', new ChatwootRouter(...guards).router);
+    this.router.use('/typebot', new TypebotRouter(...guards).router);
+    this.router.use('/openai', new OpenaiRouter(...guards).router);
+    this.router.use('/dify', new DifyRouter(...guards).router);
+    this.router.use('/flowise', new FlowiseRouter(...guards).router);
+    this.router.use('/n8n', new N8nRouter(...guards).router);
+    this.router.use('/evoai', new EvoaiRouter(...guards).router);
+  }
+}
+```
+
+## Chatbot Validation Patterns
+
+### Chatbot Schema Validation (Evolution API Pattern)
+```typescript
+import { JSONSchema7 } from 'json-schema';
+import { v4 } from 'uuid';
+
+const isNotEmpty = (...fields: string[]) => {
+  const properties = {};
+  fields.forEach((field) => {
+    properties[field] = {
+      if: { properties: { [field]: { type: 'string' } } },
+      then: { properties: { [field]: { minLength: 1 } } },
+    };
+  });
+
+  return {
+    allOf: Object.values(properties),
+  };
+};
+
+export const evolutionBotSchema: JSONSchema7 = {
+  $id: v4(),
+  type: 'object',
+  properties: {
+    enabled: { type: 'boolean' },
+    description: { type: 'string' },
+    apiUrl: { type: 'string' },
+    apiKey: { type: 'string' },
+    triggerType: { type: 'string', enum: ['all', 'keyword', 'none', 'advanced'] },
+    triggerOperator: { type: 'string', enum: ['equals', 'contains', 'startsWith', 'endsWith', 'regex'] },
+    triggerValue: { type: 'string' },
+    expire: { type: 'integer' },
+    keywordFinish: { type: 'string' },
+    delayMessage: { type: 'integer' },
+    unknownMessage: { type: 'string' },
+    listeningFromMe: { type: 'boolean' },
+    stopBotFromMe: { type: 'boolean' },
+    keepOpen: { type: 'boolean' },
+    debounceTime: { type: 'integer' },
+    ignoreJids: { type: 'array', items: { type: 'string' } },
+    splitMessages: { type: 'boolean' },
+    timePerChar: { type: 'integer' },
+  },
+  required: ['enabled', 'apiUrl', 'triggerType'],
+  ...isNotEmpty('enabled', 'apiUrl', 'triggerType'),
+};
+
+function validateKeywordTrigger(
+  content: string,
+  operator: TriggerOperator,
+  value: string,
+): boolean {
+  const normalizedContent = content.toLowerCase().trim();
+  const normalizedValue = value.toLowerCase().trim();
+
+  switch (operator) {
+    case TriggerOperator.EQUALS:
+      return normalizedContent === normalizedValue;
+    case TriggerOperator.CONTAINS:
+      return normalizedContent.includes(normalizedValue);
+    case TriggerOperator.STARTS_WITH:
+      return normalizedContent.startsWith(normalizedValue);
+    case TriggerOperator.ENDS_WITH:
+      return normalizedContent.endsWith(normalizedValue);
+    default:
+      return false;
+  }
+}
+```
+
+## Session Management Pattern
+
+### Chatbot Session Handling
+```typescript
+export class ChatbotSessionManager {
+  constructor(
+    private readonly prismaRepository: PrismaRepository,
+    private readonly cache: CacheService,
+  ) {}
+
+  public async getSession(
+    instanceName: string,
+    remoteJid: string,
+    botId: string,
+  ): Promise<IntegrationSession | null> {
+    const cacheKey = `session:${instanceName}:${remoteJid}:${botId}`;
+    
+    // Try cache first
+    let session = await this.cache.get(cacheKey);
+    if (session) {
+      return session;
+    }
+
+    // Query database
+    session = await this.prismaRepository.integrationSession.findFirst({
+      where: {
+        instanceId: instanceName,
+        remoteJid,
+        botId,
+        status: 'opened',
+      },
+    });
+
+    // Cache result
+    if (session) {
+      await this.cache.set(cacheKey, session, 300); // 5 min TTL
+    }
+
+    return session;
+  }
+
+  public async createSession(
+    instanceName: string,
+    remoteJid: string,
+    botId: string,
+  ): Promise<IntegrationSession> {
+    const session = await this.prismaRepository.integrationSession.create({
+      data: {
+        instanceId: instanceName,
+        remoteJid,
+        botId,
+        status: 'opened',
+        createdAt: new Date(),
+      },
+    });
+
+    // Cache new session
+    const cacheKey = `session:${instanceName}:${remoteJid}:${botId}`;
+    await this.cache.set(cacheKey, session, 300);
+
+    return session;
+  }
+
+  public async closeSession(sessionId: string): Promise<void> {
+    await this.prismaRepository.integrationSession.update({
+      where: { id: sessionId },
+      data: { status: 'closed', updatedAt: new Date() },
+    });
+
+    // Invalidate cache
+    // Note: In a real implementation, you'd need to track cache keys by session ID
+  }
+}
+```

.cursor/rules/specialized-rules/integration-event-rules.mdc

@@ -0,0 +1,851 @@
+---
+description: Event integration patterns for Evolution API
+globs:
+  - "src/api/integrations/event/**/*.ts"
+alwaysApply: false
+---
+
+# Evolution API Event Integration Rules
+
+## Event Manager Pattern
+
+### Event Manager Structure
+```typescript
+import { PrismaRepository } from '@api/repository/repository.service';
+import { ConfigService } from '@config/env.config';
+import { Logger } from '@config/logger.config';
+import { Server } from 'http';
+
+export class EventManager {
+  private prismaRepository: PrismaRepository;
+  private configService: ConfigService;
+  private logger = new Logger('EventManager');
+
+  // Event integrations
+  private webhook: WebhookController;
+  private websocket: WebsocketController;
+  private rabbitmq: RabbitmqController;
+  private nats: NatsController;
+  private sqs: SqsController;
+  private pusher: PusherController;
+
+  constructor(
+    prismaRepository: PrismaRepository,
+    configService: ConfigService,
+    server?: Server,
+  ) {
+    this.prismaRepository = prismaRepository;
+    this.configService = configService;
+
+    // Initialize event controllers
+    this.webhook = new WebhookController(prismaRepository, configService);
+    this.websocket = new WebsocketController(prismaRepository, configService, server);
+    this.rabbitmq = new RabbitmqController(prismaRepository, configService);
+    this.nats = new NatsController(prismaRepository, configService);
+    this.sqs = new SqsController(prismaRepository, configService);
+    this.pusher = new PusherController(prismaRepository, configService);
+  }
+
+  public async emit(eventData: {
+    instanceName: string;
+    origin: string;
+    event: string;
+    data: Object;
+    serverUrl: string;
+    dateTime: string;
+    sender: string;
+    apiKey?: string;
+    local?: boolean;
+    integration?: string[];
+  }): Promise<void> {
+    this.logger.log(`Emitting event ${eventData.event} for instance ${eventData.instanceName}`);
+
+    // Emit to all configured integrations
+    await Promise.allSettled([
+      this.webhook.emit(eventData),
+      this.websocket.emit(eventData),
+      this.rabbitmq.emit(eventData),
+      this.nats.emit(eventData),
+      this.sqs.emit(eventData),
+      this.pusher.emit(eventData),
+    ]);
+  }
+
+  public async setInstance(instanceName: string, data: any): Promise<any> {
+    const promises = [];
+
+    if (data.websocket) {
+      promises.push(
+        this.websocket.set(instanceName, {
+          websocket: {
+            enabled: true,
+            events: data.websocket?.events,
+          },
+        })
+      );
+    }
+
+    if (data.rabbitmq) {
+      promises.push(
+        this.rabbitmq.set(instanceName, {
+          rabbitmq: {
+            enabled: true,
+            events: data.rabbitmq?.events,
+          },
+        })
+      );
+    }
+
+    if (data.webhook) {
+      promises.push(
+        this.webhook.set(instanceName, {
+          webhook: {
+            enabled: true,
+            events: data.webhook?.events,
+            url: data.webhook?.url,
+            headers: data.webhook?.headers,
+            base64: data.webhook?.base64,
+            byEvents: data.webhook?.byEvents,
+          },
+        })
+      );
+    }
+
+    // Set other integrations...
+
+    await Promise.allSettled(promises);
+  }
+}
+```
+
+## Base Event Controller Pattern
+
+### Abstract Event Controller
+```typescript
+import { PrismaRepository } from '@api/repository/repository.service';
+import { ConfigService } from '@config/env.config';
+import { Logger } from '@config/logger.config';
+
+export type EmitData = {
+  instanceName: string;
+  origin: string;
+  event: string;
+  data: Object;
+  serverUrl: string;
+  dateTime: string;
+  sender: string;
+  apiKey?: string;
+  local?: boolean;
+  integration?: string[];
+};
+
+export interface EventControllerInterface {
+  integrationEnabled: boolean;
+  emit(data: EmitData): Promise<void>;
+  set(instanceName: string, data: any): Promise<any>;
+}
+
+export abstract class EventController implements EventControllerInterface {
+  protected readonly logger: Logger;
+  protected readonly prismaRepository: PrismaRepository;
+  protected readonly configService: ConfigService;
+
+  public integrationEnabled: boolean = false;
+
+  // Available events for all integrations
+  public static readonly events = [
+    'APPLICATION_STARTUP',
+    'INSTANCE_CREATE',
+    'INSTANCE_DELETE',
+    'QRCODE_UPDATED',
+    'CONNECTION_UPDATE',
+    'STATUS_INSTANCE',
+    'MESSAGES_SET',
+    'MESSAGES_UPSERT',
+    'MESSAGES_EDITED',
+    'MESSAGES_UPDATE',
+    'MESSAGES_DELETE',
+    'SEND_MESSAGE',
+    'CONTACTS_SET',
+    'CONTACTS_UPSERT',
+    'CONTACTS_UPDATE',
+    'PRESENCE_UPDATE',
+    'CHATS_SET',
+    'CHATS_UPDATE',
+    'CHATS_UPSERT',
+    'CHATS_DELETE',
+    'GROUPS_UPSERT',
+    'GROUPS_UPDATE',
+    'GROUP_PARTICIPANTS_UPDATE',
+    'CALL',
+    'TYPEBOT_START',
+    'TYPEBOT_CHANGE_STATUS',
+    'LABELS_EDIT',
+    'LABELS_ASSOCIATION',
+    'CREDS_UPDATE',
+    'MESSAGING_HISTORY_SET',
+    'REMOVE_INSTANCE',
+    'LOGOUT_INSTANCE',
+  ];
+
+  constructor(
+    prismaRepository: PrismaRepository,
+    configService: ConfigService,
+    loggerName: string,
+  ) {
+    this.prismaRepository = prismaRepository;
+    this.configService = configService;
+    this.logger = new Logger(loggerName);
+  }
+
+  // Abstract methods to be implemented by specific integrations
+  public abstract emit(data: EmitData): Promise<void>;
+  public abstract set(instanceName: string, data: any): Promise<any>;
+
+  // Helper method to check if event should be processed
+  protected shouldProcessEvent(eventName: string, configuredEvents?: string[]): boolean {
+    if (!configuredEvents || configuredEvents.length === 0) {
+      return true; // Process all events if none specified
+    }
+    return configuredEvents.includes(eventName);
+  }
+
+  // Helper method to get instance configuration
+  protected async getInstanceConfig(instanceName: string): Promise<any> {
+    try {
+      const instance = await this.prismaRepository.instance.findUnique({
+        where: { name: instanceName },
+      });
+      return instance;
+    } catch (error) {
+      this.logger.error(`Failed to get instance config for ${instanceName}:`, error);
+      return null;
+    }
+  }
+}
+```
+
+## Webhook Integration Pattern
+
+### Webhook Controller Implementation
+```typescript
+export class WebhookController extends EventController {
+  constructor(
+    prismaRepository: PrismaRepository,
+    configService: ConfigService,
+  ) {
+    super(prismaRepository, configService, 'WebhookController');
+  }
+
+  public async emit(data: EmitData): Promise<void> {
+    try {
+      const instance = await this.getInstanceConfig(data.instanceName);
+      if (!instance?.webhook?.enabled) {
+        return;
+      }
+
+      const webhookConfig = instance.webhook;
+      
+      if (!this.shouldProcessEvent(data.event, webhookConfig.events)) {
+        return;
+      }
+
+      const payload = {
+        event: data.event,
+        instance: data.instanceName,
+        data: data.data,
+        timestamp: data.dateTime,
+        sender: data.sender,
+        server: {
+          version: process.env.npm_package_version,
+          url: data.serverUrl,
+        },
+      };
+
+      // Encode data as base64 if configured
+      if (webhookConfig.base64) {
+        payload.data = Buffer.from(JSON.stringify(payload.data)).toString('base64');
+      }
+
+      const headers = {
+        'Content-Type': 'application/json',
+        'User-Agent': 'Evolution-API-Webhook',
+        ...webhookConfig.headers,
+      };
+
+      if (webhookConfig.byEvents) {
+        // Send to event-specific endpoint
+        const eventUrl = `${webhookConfig.url}/${data.event.toLowerCase()}`;
+        await this.sendWebhook(eventUrl, payload, headers);
+      } else {
+        // Send to main webhook URL
+        await this.sendWebhook(webhookConfig.url, payload, headers);
+      }
+
+      this.logger.log(`Webhook sent for event ${data.event} to instance ${data.instanceName}`);
+    } catch (error) {
+      this.logger.error(`Webhook emission failed for ${data.instanceName}:`, error);
+    }
+  }
+
+  public async set(instanceName: string, data: any): Promise<any> {
+    try {
+      const webhookData = data.webhook;
+      
+      await this.prismaRepository.instance.update({
+        where: { name: instanceName },
+        data: {
+          webhook: webhookData,
+        },
+      });
+
+      this.logger.log(`Webhook configuration set for instance ${instanceName}`);
+      return { webhook: webhookData };
+    } catch (error) {
+      this.logger.error(`Failed to set webhook config for ${instanceName}:`, error);
+      throw error;
+    }
+  }
+
+  private async sendWebhook(url: string, payload: any, headers: any): Promise<void> {
+    try {
+      const response = await axios.post(url, payload, {
+        headers,
+        timeout: 30000,
+        maxRedirects: 3,
+      });
+
+      if (response.status >= 200 && response.status < 300) {
+        this.logger.log(`Webhook delivered successfully to ${url}`);
+      } else {
+        this.logger.warn(`Webhook returned status ${response.status} for ${url}`);
+      }
+    } catch (error) {
+      this.logger.error(`Webhook delivery failed to ${url}:`, error.message);
+      
+      // Implement retry logic here if needed
+      if (error.response?.status >= 500) {
+        // Server error - might be worth retrying
+        this.logger.log(`Server error detected, webhook might be retried later`);
+      }
+    }
+  }
+}
+```
+
+## WebSocket Integration Pattern
+
+### WebSocket Controller Implementation
+```typescript
+import { Server as SocketIOServer } from 'socket.io';
+import { Server } from 'http';
+
+export class WebsocketController extends EventController {
+  private io: SocketIOServer;
+
+  constructor(
+    prismaRepository: PrismaRepository,
+    configService: ConfigService,
+    server?: Server,
+  ) {
+    super(prismaRepository, configService, 'WebsocketController');
+    
+    if (server) {
+      this.io = new SocketIOServer(server, {
+        cors: {
+          origin: "*",
+          methods: ["GET", "POST"],
+        },
+      });
+
+      this.setupSocketHandlers();
+    }
+  }
+
+  private setupSocketHandlers(): void {
+    this.io.on('connection', (socket) => {
+      this.logger.log(`WebSocket client connected: ${socket.id}`);
+
+      socket.on('join-instance', (instanceName: string) => {
+        socket.join(`instance:${instanceName}`);
+        this.logger.log(`Client ${socket.id} joined instance ${instanceName}`);
+      });
+
+      socket.on('leave-instance', (instanceName: string) => {
+        socket.leave(`instance:${instanceName}`);
+        this.logger.log(`Client ${socket.id} left instance ${instanceName}`);
+      });
+
+      socket.on('disconnect', () => {
+        this.logger.log(`WebSocket client disconnected: ${socket.id}`);
+      });
+    });
+  }
+
+  public async emit(data: EmitData): Promise<void> {
+    if (!this.io) {
+      return;
+    }
+
+    try {
+      const instance = await this.getInstanceConfig(data.instanceName);
+      if (!instance?.websocket?.enabled) {
+        return;
+      }
+
+      const websocketConfig = instance.websocket;
+      
+      if (!this.shouldProcessEvent(data.event, websocketConfig.events)) {
+        return;
+      }
+
+      const payload = {
+        event: data.event,
+        instance: data.instanceName,
+        data: data.data,
+        timestamp: data.dateTime,
+        sender: data.sender,
+      };
+
+      // Emit to specific instance room
+      this.io.to(`instance:${data.instanceName}`).emit('evolution-event', payload);
+      
+      // Also emit to global room for monitoring
+      this.io.emit('global-event', payload);
+
+      this.logger.log(`WebSocket event ${data.event} emitted for instance ${data.instanceName}`);
+    } catch (error) {
+      this.logger.error(`WebSocket emission failed for ${data.instanceName}:`, error);
+    }
+  }
+
+  public async set(instanceName: string, data: any): Promise<any> {
+    try {
+      const websocketData = data.websocket;
+      
+      await this.prismaRepository.instance.update({
+        where: { name: instanceName },
+        data: {
+          websocket: websocketData,
+        },
+      });
+
+      this.logger.log(`WebSocket configuration set for instance ${instanceName}`);
+      return { websocket: websocketData };
+    } catch (error) {
+      this.logger.error(`Failed to set WebSocket config for ${instanceName}:`, error);
+      throw error;
+    }
+  }
+}
+```
+
+## Queue Integration Patterns
+
+### RabbitMQ Controller Implementation
+```typescript
+import amqp from 'amqplib';
+
+export class RabbitmqController extends EventController {
+  private connection: amqp.Connection | null = null;
+  private channel: amqp.Channel | null = null;
+
+  constructor(
+    prismaRepository: PrismaRepository,
+    configService: ConfigService,
+  ) {
+    super(prismaRepository, configService, 'RabbitmqController');
+    this.initializeConnection();
+  }
+
+  private async initializeConnection(): Promise<void> {
+    try {
+      const rabbitmqConfig = this.configService.get('RABBITMQ');
+      if (!rabbitmqConfig?.ENABLED) {
+        return;
+      }
+
+      this.connection = await amqp.connect(rabbitmqConfig.URI);
+      this.channel = await this.connection.createChannel();
+
+      // Declare exchange for Evolution API events
+      await this.channel.assertExchange('evolution-events', 'topic', { durable: true });
+
+      this.logger.log('RabbitMQ connection established');
+    } catch (error) {
+      this.logger.error('Failed to initialize RabbitMQ connection:', error);
+    }
+  }
+
+  public async emit(data: EmitData): Promise<void> {
+    if (!this.channel) {
+      return;
+    }
+
+    try {
+      const instance = await this.getInstanceConfig(data.instanceName);
+      if (!instance?.rabbitmq?.enabled) {
+        return;
+      }
+
+      const rabbitmqConfig = instance.rabbitmq;
+      
+      if (!this.shouldProcessEvent(data.event, rabbitmqConfig.events)) {
+        return;
+      }
+
+      const payload = {
+        event: data.event,
+        instance: data.instanceName,
+        data: data.data,
+        timestamp: data.dateTime,
+        sender: data.sender,
+      };
+
+      const routingKey = `evolution.${data.instanceName}.${data.event.toLowerCase()}`;
+      
+      await this.channel.publish(
+        'evolution-events',
+        routingKey,
+        Buffer.from(JSON.stringify(payload)),
+        {
+          persistent: true,
+          timestamp: Date.now(),
+          messageId: `${data.instanceName}-${Date.now()}`,
+        }
+      );
+
+      this.logger.log(`RabbitMQ message published for event ${data.event} to instance ${data.instanceName}`);
+    } catch (error) {
+      this.logger.error(`RabbitMQ emission failed for ${data.instanceName}:`, error);
+    }
+  }
+
+  public async set(instanceName: string, data: any): Promise<any> {
+    try {
+      const rabbitmqData = data.rabbitmq;
+      
+      await this.prismaRepository.instance.update({
+        where: { name: instanceName },
+        data: {
+          rabbitmq: rabbitmqData,
+        },
+      });
+
+      this.logger.log(`RabbitMQ configuration set for instance ${instanceName}`);
+      return { rabbitmq: rabbitmqData };
+    } catch (error) {
+      this.logger.error(`Failed to set RabbitMQ config for ${instanceName}:`, error);
+      throw error;
+    }
+  }
+}
+```
+
+### SQS Controller Implementation
+```typescript
+import { SQSClient, SendMessageCommand } from '@aws-sdk/client-sqs';
+
+export class SqsController extends EventController {
+  private sqsClient: SQSClient | null = null;
+
+  constructor(
+    prismaRepository: PrismaRepository,
+    configService: ConfigService,
+  ) {
+    super(prismaRepository, configService, 'SqsController');
+    this.initializeSQSClient();
+  }
+
+  private initializeSQSClient(): void {
+    try {
+      const sqsConfig = this.configService.get('SQS');
+      if (!sqsConfig?.ENABLED) {
+        return;
+      }
+
+      this.sqsClient = new SQSClient({
+        region: sqsConfig.REGION,
+        credentials: {
+          accessKeyId: sqsConfig.ACCESS_KEY_ID,
+          secretAccessKey: sqsConfig.SECRET_ACCESS_KEY,
+        },
+      });
+
+      this.logger.log('SQS client initialized');
+    } catch (error) {
+      this.logger.error('Failed to initialize SQS client:', error);
+    }
+  }
+
+  public async emit(data: EmitData): Promise<void> {
+    if (!this.sqsClient) {
+      return;
+    }
+
+    try {
+      const instance = await this.getInstanceConfig(data.instanceName);
+      if (!instance?.sqs?.enabled) {
+        return;
+      }
+
+      const sqsConfig = instance.sqs;
+      
+      if (!this.shouldProcessEvent(data.event, sqsConfig.events)) {
+        return;
+      }
+
+      const payload = {
+        event: data.event,
+        instance: data.instanceName,
+        data: data.data,
+        timestamp: data.dateTime,
+        sender: data.sender,
+      };
+
+      const command = new SendMessageCommand({
+        QueueUrl: sqsConfig.queueUrl,
+        MessageBody: JSON.stringify(payload),
+        MessageAttributes: {
+          event: {
+            DataType: 'String',
+            StringValue: data.event,
+          },
+          instance: {
+            DataType: 'String',
+            StringValue: data.instanceName,
+          },
+        },
+        MessageGroupId: data.instanceName, // For FIFO queues
+        MessageDeduplicationId: `${data.instanceName}-${Date.now()}`, // For FIFO queues
+      });
+
+      await this.sqsClient.send(command);
+
+      this.logger.log(`SQS message sent for event ${data.event} to instance ${data.instanceName}`);
+    } catch (error) {
+      this.logger.error(`SQS emission failed for ${data.instanceName}:`, error);
+    }
+  }
+
+  public async set(instanceName: string, data: any): Promise<any> {
+    try {
+      const sqsData = data.sqs;
+      
+      await this.prismaRepository.instance.update({
+        where: { name: instanceName },
+        data: {
+          sqs: sqsData,
+        },
+      });
+
+      this.logger.log(`SQS configuration set for instance ${instanceName}`);
+      return { sqs: sqsData };
+    } catch (error) {
+      this.logger.error(`Failed to set SQS config for ${instanceName}:`, error);
+      throw error;
+    }
+  }
+}
+```
+
+## Event DTO Pattern
+
+### Event Configuration DTO
+```typescript
+import { JsonValue } from '@prisma/client/runtime/library';
+
+export class EventDto {
+  webhook?: {
+    enabled?: boolean;
+    events?: string[];
+    url?: string;
+    headers?: JsonValue;
+    byEvents?: boolean;
+    base64?: boolean;
+  };
+
+  websocket?: {
+    enabled?: boolean;
+    events?: string[];
+  };
+
+  sqs?: {
+    enabled?: boolean;
+    events?: string[];
+    queueUrl?: string;
+  };
+
+  rabbitmq?: {
+    enabled?: boolean;
+    events?: string[];
+    exchange?: string;
+  };
+
+  nats?: {
+    enabled?: boolean;
+    events?: string[];
+    subject?: string;
+  };
+
+  pusher?: {
+    enabled?: boolean;
+    appId?: string;
+    key?: string;
+    secret?: string;
+    cluster?: string;
+    useTLS?: boolean;
+    events?: string[];
+  };
+}
+```
+
+## Event Router Pattern
+
+### Event Router Structure
+```typescript
+import { NatsRouter } from '@api/integrations/event/nats/nats.router';
+import { PusherRouter } from '@api/integrations/event/pusher/pusher.router';
+import { RabbitmqRouter } from '@api/integrations/event/rabbitmq/rabbitmq.router';
+import { SqsRouter } from '@api/integrations/event/sqs/sqs.router';
+import { WebhookRouter } from '@api/integrations/event/webhook/webhook.router';
+import { WebsocketRouter } from '@api/integrations/event/websocket/websocket.router';
+import { Router } from 'express';
+
+export class EventRouter {
+  public readonly router: Router;
+
+  constructor(configService: any, ...guards: any[]) {
+    this.router = Router();
+
+    this.router.use('/webhook', new WebhookRouter(configService, ...guards).router);
+    this.router.use('/websocket', new WebsocketRouter(...guards).router);
+    this.router.use('/rabbitmq', new RabbitmqRouter(...guards).router);
+    this.router.use('/nats', new NatsRouter(...guards).router);
+    this.router.use('/pusher', new PusherRouter(...guards).router);
+    this.router.use('/sqs', new SqsRouter(...guards).router);
+  }
+}
+```
+
+## Event Validation Schema
+
+### Event Configuration Validation
+```typescript
+import Joi from 'joi';
+import { EventController } from '@api/integrations/event/event.controller';
+
+const eventListSchema = Joi.array().items(
+  Joi.string().valid(...EventController.events)
+).optional();
+
+export const webhookSchema = Joi.object({
+  enabled: Joi.boolean().required(),
+  url: Joi.string().when('enabled', {
+    is: true,
+    then: Joi.required().uri({ scheme: ['http', 'https'] }),
+    otherwise: Joi.optional(),
+  }),
+  events: eventListSchema,
+  headers: Joi.object().pattern(Joi.string(), Joi.string()).optional(),
+  byEvents: Joi.boolean().optional().default(false),
+  base64: Joi.boolean().optional().default(false),
+}).required();
+
+export const websocketSchema = Joi.object({
+  enabled: Joi.boolean().required(),
+  events: eventListSchema,
+}).required();
+
+export const rabbitmqSchema = Joi.object({
+  enabled: Joi.boolean().required(),
+  events: eventListSchema,
+  exchange: Joi.string().optional().default('evolution-events'),
+}).required();
+
+export const sqsSchema = Joi.object({
+  enabled: Joi.boolean().required(),
+  events: eventListSchema,
+  queueUrl: Joi.string().when('enabled', {
+    is: true,
+    then: Joi.required().uri(),
+    otherwise: Joi.optional(),
+  }),
+}).required();
+
+export const eventSchema = Joi.object({
+  webhook: webhookSchema.optional(),
+  websocket: websocketSchema.optional(),
+  rabbitmq: rabbitmqSchema.optional(),
+  sqs: sqsSchema.optional(),
+  nats: Joi.object({
+    enabled: Joi.boolean().required(),
+    events: eventListSchema,
+    subject: Joi.string().optional().default('evolution.events'),
+  }).optional(),
+  pusher: Joi.object({
+    enabled: Joi.boolean().required(),
+    appId: Joi.string().when('enabled', { is: true, then: Joi.required() }),
+    key: Joi.string().when('enabled', { is: true, then: Joi.required() }),
+    secret: Joi.string().when('enabled', { is: true, then: Joi.required() }),
+    cluster: Joi.string().when('enabled', { is: true, then: Joi.required() }),
+    useTLS: Joi.boolean().optional().default(true),
+    events: eventListSchema,
+  }).optional(),
+}).min(1).required();
+```
+
+## Event Testing Pattern
+
+### Event Controller Testing
+```typescript
+describe('WebhookController', () => {
+  let controller: WebhookController;
+  let prismaRepository: jest.Mocked<PrismaRepository>;
+  let configService: jest.Mocked<ConfigService>;
+
+  beforeEach(() => {
+    controller = new WebhookController(prismaRepository, configService);
+  });
+
+  describe('emit', () => {
+    it('should send webhook when enabled', async () => {
+      const mockInstance = {
+        webhook: {
+          enabled: true,
+          url: 'https://example.com/webhook',
+          events: ['MESSAGES_UPSERT'],
+        },
+      };
+
+      prismaRepository.instance.findUnique.mockResolvedValue(mockInstance);
+      jest.spyOn(axios, 'post').mockResolvedValue({ status: 200 });
+
+      const eventData = {
+        instanceName: 'test-instance',
+        event: 'MESSAGES_UPSERT',
+        data: { message: 'test' },
+        origin: 'test',
+        serverUrl: 'http://localhost',
+        dateTime: new Date().toISOString(),
+        sender: 'test',
+      };
+
+      await controller.emit(eventData);
+
+      expect(axios.post).toHaveBeenCalledWith(
+        'https://example.com/webhook',
+        expect.objectContaining({
+          event: 'MESSAGES_UPSERT',
+          instance: 'test-instance',
+        }),
+        expect.objectContaining({
+          headers: expect.objectContaining({
+            'Content-Type': 'application/json',
+          }),
+        })
+      );
+    });
+  });
+});
+```

.cursor/rules/specialized-rules/integration-storage-rules.mdc

@@ -0,0 +1,608 @@
+---
+description: Storage integration patterns for Evolution API
+globs:
+  - "src/api/integrations/storage/**/*.ts"
+alwaysApply: false
+---
+
+# Evolution API Storage Integration Rules
+
+## Storage Service Pattern
+
+### Base Storage Service Structure
+```typescript
+import { InstanceDto } from '@api/dto/instance.dto';
+import { PrismaRepository } from '@api/repository/repository.service';
+import { Logger } from '@config/logger.config';
+import { BadRequestException } from '@exceptions';
+
+export class StorageService {
+  constructor(private readonly prismaRepository: PrismaRepository) {}
+
+  private readonly logger = new Logger('StorageService');
+
+  public async getMedia(instance: InstanceDto, query?: MediaDto) {
+    try {
+      const where: any = {
+        instanceId: instance.instanceId,
+        ...query,
+      };
+
+      const media = await this.prismaRepository.media.findMany({
+        where,
+        select: {
+          id: true,
+          fileName: true,
+          type: true,
+          mimetype: true,
+          createdAt: true,
+          Message: true,
+        },
+      });
+
+      if (!media || media.length === 0) {
+        throw 'Media not found';
+      }
+
+      return media;
+    } catch (error) {
+      throw new BadRequestException(error);
+    }
+  }
+
+  public async getMediaUrl(instance: InstanceDto, data: MediaDto) {
+    const media = (await this.getMedia(instance, { id: data.id }))[0];
+    const mediaUrl = await this.generateUrl(media.fileName, data.expiry);
+    return {
+      mediaUrl,
+      ...media,
+    };
+  }
+
+  protected abstract generateUrl(fileName: string, expiry?: number): Promise<string>;
+}
+```
+
+## S3/MinIO Integration Pattern
+
+### MinIO Client Setup
+```typescript
+import { ConfigService, S3 } from '@config/env.config';
+import { Logger } from '@config/logger.config';
+import { BadRequestException } from '@exceptions';
+import * as MinIo from 'minio';
+import { join } from 'path';
+import { Readable, Transform } from 'stream';
+
+const logger = new Logger('S3 Service');
+const BUCKET = new ConfigService().get<S3>('S3');
+
+interface Metadata extends MinIo.ItemBucketMetadata {
+  instanceId: string;
+  messageId?: string;
+}
+
+const minioClient = (() => {
+  if (BUCKET?.ENABLE) {
+    return new MinIo.Client({
+      endPoint: BUCKET.ENDPOINT,
+      port: BUCKET.PORT,
+      useSSL: BUCKET.USE_SSL,
+      accessKey: BUCKET.ACCESS_KEY,
+      secretKey: BUCKET.SECRET_KEY,
+      region: BUCKET.REGION,
+    });
+  }
+})();
+
+const bucketName = process.env.S3_BUCKET;
+```
+
+### Bucket Management Functions
+```typescript
+const bucketExists = async (): Promise<boolean> => {
+  if (minioClient) {
+    try {
+      const list = await minioClient.listBuckets();
+      return !!list.find((bucket) => bucket.name === bucketName);
+    } catch (error) {
+      logger.error('Error checking bucket existence:', error);
+      return false;
+    }
+  }
+  return false;
+};
+
+const setBucketPolicy = async (): Promise<void> => {
+  if (minioClient && bucketName) {
+    try {
+      const policy = {
+        Version: '2012-10-17',
+        Statement: [
+          {
+            Effect: 'Allow',
+            Principal: { AWS: ['*'] },
+            Action: ['s3:GetObject'],
+            Resource: [`arn:aws:s3:::${bucketName}/*`],
+          },
+        ],
+      };
+
+      await minioClient.setBucketPolicy(bucketName, JSON.stringify(policy));
+      logger.log('Bucket policy set successfully');
+    } catch (error) {
+      logger.error('Error setting bucket policy:', error);
+    }
+  }
+};
+
+const createBucket = async (): Promise<void> => {
+  if (minioClient && bucketName) {
+    try {
+      const exists = await bucketExists();
+      if (!exists) {
+        await minioClient.makeBucket(bucketName, BUCKET.REGION || 'us-east-1');
+        await setBucketPolicy();
+        logger.log(`Bucket ${bucketName} created successfully`);
+      }
+    } catch (error) {
+      logger.error('Error creating bucket:', error);
+    }
+  }
+};
+```
+
+### File Upload Functions
+```typescript
+export const uploadFile = async (
+  fileName: string,
+  buffer: Buffer,
+  mimetype: string,
+  metadata?: Metadata,
+): Promise<string> => {
+  if (!minioClient || !bucketName) {
+    throw new BadRequestException('S3 storage not configured');
+  }
+
+  try {
+    await createBucket();
+
+    const uploadMetadata = {
+      'Content-Type': mimetype,
+      ...metadata,
+    };
+
+    await minioClient.putObject(bucketName, fileName, buffer, buffer.length, uploadMetadata);
+    
+    logger.log(`File ${fileName} uploaded successfully`);
+    return fileName;
+  } catch (error) {
+    logger.error(`Error uploading file ${fileName}:`, error);
+    throw new BadRequestException(`Failed to upload file: ${error.message}`);
+  }
+};
+
+export const uploadStream = async (
+  fileName: string,
+  stream: Readable,
+  size: number,
+  mimetype: string,
+  metadata?: Metadata,
+): Promise<string> => {
+  if (!minioClient || !bucketName) {
+    throw new BadRequestException('S3 storage not configured');
+  }
+
+  try {
+    await createBucket();
+
+    const uploadMetadata = {
+      'Content-Type': mimetype,
+      ...metadata,
+    };
+
+    await minioClient.putObject(bucketName, fileName, stream, size, uploadMetadata);
+    
+    logger.log(`Stream ${fileName} uploaded successfully`);
+    return fileName;
+  } catch (error) {
+    logger.error(`Error uploading stream ${fileName}:`, error);
+    throw new BadRequestException(`Failed to upload stream: ${error.message}`);
+  }
+};
+```
+
+### File Download Functions
+```typescript
+export const getObject = async (fileName: string): Promise<Buffer> => {
+  if (!minioClient || !bucketName) {
+    throw new BadRequestException('S3 storage not configured');
+  }
+
+  try {
+    const stream = await minioClient.getObject(bucketName, fileName);
+    const chunks: Buffer[] = [];
+
+    return new Promise((resolve, reject) => {
+      stream.on('data', (chunk) => chunks.push(chunk));
+      stream.on('end', () => resolve(Buffer.concat(chunks)));
+      stream.on('error', reject);
+    });
+  } catch (error) {
+    logger.error(`Error getting object ${fileName}:`, error);
+    throw new BadRequestException(`Failed to get object: ${error.message}`);
+  }
+};
+
+export const getObjectUrl = async (fileName: string, expiry: number = 3600): Promise<string> => {
+  if (!minioClient || !bucketName) {
+    throw new BadRequestException('S3 storage not configured');
+  }
+
+  try {
+    const url = await minioClient.presignedGetObject(bucketName, fileName, expiry);
+    logger.log(`Generated URL for ${fileName} with expiry ${expiry}s`);
+    return url;
+  } catch (error) {
+    logger.error(`Error generating URL for ${fileName}:`, error);
+    throw new BadRequestException(`Failed to generate URL: ${error.message}`);
+  }
+};
+
+export const getObjectStream = async (fileName: string): Promise<Readable> => {
+  if (!minioClient || !bucketName) {
+    throw new BadRequestException('S3 storage not configured');
+  }
+
+  try {
+    const stream = await minioClient.getObject(bucketName, fileName);
+    return stream;
+  } catch (error) {
+    logger.error(`Error getting object stream ${fileName}:`, error);
+    throw new BadRequestException(`Failed to get object stream: ${error.message}`);
+  }
+};
+```
+
+### File Management Functions
+```typescript
+export const deleteObject = async (fileName: string): Promise<void> => {
+  if (!minioClient || !bucketName) {
+    throw new BadRequestException('S3 storage not configured');
+  }
+
+  try {
+    await minioClient.removeObject(bucketName, fileName);
+    logger.log(`File ${fileName} deleted successfully`);
+  } catch (error) {
+    logger.error(`Error deleting file ${fileName}:`, error);
+    throw new BadRequestException(`Failed to delete file: ${error.message}`);
+  }
+};
+
+export const listObjects = async (prefix?: string): Promise<MinIo.BucketItem[]> => {
+  if (!minioClient || !bucketName) {
+    throw new BadRequestException('S3 storage not configured');
+  }
+
+  try {
+    const objects: MinIo.BucketItem[] = [];
+    const stream = minioClient.listObjects(bucketName, prefix, true);
+
+    return new Promise((resolve, reject) => {
+      stream.on('data', (obj) => objects.push(obj));
+      stream.on('end', () => resolve(objects));
+      stream.on('error', reject);
+    });
+  } catch (error) {
+    logger.error('Error listing objects:', error);
+    throw new BadRequestException(`Failed to list objects: ${error.message}`);
+  }
+};
+
+export const objectExists = async (fileName: string): Promise<boolean> => {
+  if (!minioClient || !bucketName) {
+    return false;
+  }
+
+  try {
+    await minioClient.statObject(bucketName, fileName);
+    return true;
+  } catch (error) {
+    return false;
+  }
+};
+```
+
+## Storage Controller Pattern
+
+### S3 Controller Implementation
+```typescript
+import { InstanceDto } from '@api/dto/instance.dto';
+import { MediaDto } from '@api/integrations/storage/s3/dto/media.dto';
+import { S3Service } from '@api/integrations/storage/s3/services/s3.service';
+
+export class S3Controller {
+  constructor(private readonly s3Service: S3Service) {}
+
+  public async getMedia(instance: InstanceDto, data: MediaDto) {
+    return this.s3Service.getMedia(instance, data);
+  }
+
+  public async getMediaUrl(instance: InstanceDto, data: MediaDto) {
+    return this.s3Service.getMediaUrl(instance, data);
+  }
+
+  public async uploadMedia(instance: InstanceDto, data: UploadMediaDto) {
+    return this.s3Service.uploadMedia(instance, data);
+  }
+
+  public async deleteMedia(instance: InstanceDto, data: MediaDto) {
+    return this.s3Service.deleteMedia(instance, data);
+  }
+}
+```
+
+## Storage Router Pattern
+
+### Storage Router Structure
+```typescript
+import { S3Router } from '@api/integrations/storage/s3/routes/s3.router';
+import { Router } from 'express';
+
+export class StorageRouter {
+  public readonly router: Router;
+
+  constructor(...guards: any[]) {
+    this.router = Router();
+
+    this.router.use('/s3', new S3Router(...guards).router);
+    // Add other storage providers here
+    // this.router.use('/gcs', new GCSRouter(...guards).router);
+    // this.router.use('/azure', new AzureRouter(...guards).router);
+  }
+}
+```
+
+### S3 Specific Router
+```typescript
+import { RouterBroker } from '@api/abstract/abstract.router';
+import { MediaDto } from '@api/integrations/storage/s3/dto/media.dto';
+import { s3Schema, s3UrlSchema } from '@api/integrations/storage/s3/validate/s3.schema';
+import { HttpStatus } from '@api/routes/index.router';
+import { s3Controller } from '@api/server.module';
+import { RequestHandler, Router } from 'express';
+
+export class S3Router extends RouterBroker {
+  constructor(...guards: RequestHandler[]) {
+    super();
+    this.router
+      .post(this.routerPath('getMedia'), ...guards, async (req, res) => {
+        const response = await this.dataValidate<MediaDto>({
+          request: req,
+          schema: s3Schema,
+          ClassRef: MediaDto,
+          execute: (instance, data) => s3Controller.getMedia(instance, data),
+        });
+
+        res.status(HttpStatus.OK).json(response);
+      })
+      .post(this.routerPath('getMediaUrl'), ...guards, async (req, res) => {
+        const response = await this.dataValidate<MediaDto>({
+          request: req,
+          schema: s3UrlSchema,
+          ClassRef: MediaDto,
+          execute: (instance, data) => s3Controller.getMediaUrl(instance, data),
+        });
+
+        res.status(HttpStatus.OK).json(response);
+      })
+      .post(this.routerPath('uploadMedia'), ...guards, async (req, res) => {
+        const response = await this.dataValidate<UploadMediaDto>({
+          request: req,
+          schema: uploadSchema,
+          ClassRef: UploadMediaDto,
+          execute: (instance, data) => s3Controller.uploadMedia(instance, data),
+        });
+
+        res.status(HttpStatus.CREATED).json(response);
+      })
+      .delete(this.routerPath('deleteMedia'), ...guards, async (req, res) => {
+        const response = await this.dataValidate<MediaDto>({
+          request: req,
+          schema: s3Schema,
+          ClassRef: MediaDto,
+          execute: (instance, data) => s3Controller.deleteMedia(instance, data),
+        });
+
+        res.status(HttpStatus.OK).json(response);
+      });
+  }
+
+  public readonly router: Router = Router();
+}
+```
+
+## Storage DTO Pattern
+
+### Media DTO
+```typescript
+export class MediaDto {
+  id?: string;
+  fileName?: string;
+  type?: string;
+  mimetype?: string;
+  expiry?: number;
+}
+
+export class UploadMediaDto {
+  fileName: string;
+  mimetype: string;
+  buffer?: Buffer;
+  base64?: string;
+  url?: string;
+  metadata?: {
+    instanceId: string;
+    messageId?: string;
+    contactId?: string;
+    [key: string]: any;
+  };
+}
+```
+
+## Storage Validation Schema
+
+### S3 Validation Schemas
+```typescript
+import Joi from 'joi';
+
+export const s3Schema = Joi.object({
+  id: Joi.string().optional(),
+  fileName: Joi.string().optional(),
+  type: Joi.string().optional().valid('image', 'video', 'audio', 'document'),
+  mimetype: Joi.string().optional(),
+  expiry: Joi.number().optional().min(60).max(604800).default(3600), // 1 min to 7 days
+}).min(1).required();
+
+export const s3UrlSchema = Joi.object({
+  id: Joi.string().required(),
+  expiry: Joi.number().optional().min(60).max(604800).default(3600),
+}).required();
+
+export const uploadSchema = Joi.object({
+  fileName: Joi.string().required().max(255),
+  mimetype: Joi.string().required(),
+  buffer: Joi.binary().optional(),
+  base64: Joi.string().base64().optional(),
+  url: Joi.string().uri().optional(),
+  metadata: Joi.object({
+    instanceId: Joi.string().required(),
+    messageId: Joi.string().optional(),
+    contactId: Joi.string().optional(),
+  }).optional(),
+}).xor('buffer', 'base64', 'url').required(); // Exactly one of these must be present
+```
+
+## Error Handling in Storage
+
+### Storage-Specific Error Handling
+```typescript
+// CORRECT - Storage-specific error handling
+public async uploadFile(fileName: string, buffer: Buffer): Promise<string> {
+  try {
+    const result = await this.storageClient.upload(fileName, buffer);
+    return result;
+  } catch (error) {
+    this.logger.error(`Storage upload failed: ${error.message}`);
+    
+    if (error.code === 'NoSuchBucket') {
+      throw new BadRequestException('Storage bucket not found');
+    }
+    
+    if (error.code === 'AccessDenied') {
+      throw new UnauthorizedException('Storage access denied');
+    }
+    
+    if (error.code === 'EntityTooLarge') {
+      throw new BadRequestException('File too large');
+    }
+    
+    throw new InternalServerErrorException('Storage operation failed');
+  }
+}
+```
+
+## Storage Configuration Pattern
+
+### Environment Configuration
+```typescript
+export interface S3Config {
+  ENABLE: boolean;
+  ENDPOINT: string;
+  PORT: number;
+  USE_SSL: boolean;
+  ACCESS_KEY: string;
+  SECRET_KEY: string;
+  REGION: string;
+  BUCKET: string;
+}
+
+// Usage in service
+const s3Config = this.configService.get<S3Config>('S3');
+if (!s3Config.ENABLE) {
+  throw new BadRequestException('S3 storage is disabled');
+}
+```
+
+## Storage Testing Pattern
+
+### Storage Service Testing
+```typescript
+describe('S3Service', () => {
+  let service: S3Service;
+  let prismaRepository: jest.Mocked<PrismaRepository>;
+
+  beforeEach(() => {
+    service = new S3Service(prismaRepository);
+  });
+
+  describe('getMedia', () => {
+    it('should return media list', async () => {
+      const instance = { instanceId: 'test-instance' };
+      const mockMedia = [
+        { id: '1', fileName: 'test.jpg', type: 'image', mimetype: 'image/jpeg' },
+      ];
+
+      prismaRepository.media.findMany.mockResolvedValue(mockMedia);
+
+      const result = await service.getMedia(instance);
+
+      expect(result).toEqual(mockMedia);
+      expect(prismaRepository.media.findMany).toHaveBeenCalledWith({
+        where: { instanceId: 'test-instance' },
+        select: expect.objectContaining({
+          id: true,
+          fileName: true,
+          type: true,
+          mimetype: true,
+        }),
+      });
+    });
+
+    it('should throw error when no media found', async () => {
+      const instance = { instanceId: 'test-instance' };
+      prismaRepository.media.findMany.mockResolvedValue([]);
+
+      await expect(service.getMedia(instance)).rejects.toThrow(BadRequestException);
+    });
+  });
+});
+```
+
+## Storage Performance Considerations
+
+### Efficient File Handling
+```typescript
+// CORRECT - Stream-based upload for large files
+public async uploadLargeFile(fileName: string, stream: Readable, size: number): Promise<string> {
+  const uploadStream = new Transform({
+    transform(chunk, encoding, callback) {
+      // Optional: Add compression, encryption, etc.
+      callback(null, chunk);
+    },
+  });
+
+  return new Promise((resolve, reject) => {
+    stream
+      .pipe(uploadStream)
+      .on('error', reject)
+      .on('finish', () => resolve(fileName));
+  });
+}
+
+// INCORRECT - Loading entire file into memory
+public async uploadLargeFile(fileName: string, filePath: string): Promise<string> {
+  const buffer = fs.readFileSync(filePath); // ❌ Memory intensive for large files
+  return await this.uploadFile(fileName, buffer);
+}
+```

.cursor/rules/specialized-rules/route-rules.mdc

@@ -0,0 +1,416 @@
+---
+description: Router patterns for Evolution API
+globs:
+  - "src/api/routes/**/*.ts"
+alwaysApply: false
+---
+
+# Evolution API Route Rules
+
+## Router Base Pattern
+
+### RouterBroker Extension
+```typescript
+import { RouterBroker } from '@api/abstract/abstract.router';
+import { RequestHandler, Router } from 'express';
+import { HttpStatus } from './index.router';
+
+export class ExampleRouter extends RouterBroker {
+  constructor(...guards: RequestHandler[]) {
+    super();
+    this.router
+      .get(this.routerPath('findExample'), ...guards, async (req, res) => {
+        const response = await this.dataValidate<ExampleDto>({
+          request: req,
+          schema: null,
+          ClassRef: ExampleDto,
+          execute: (instance) => exampleController.find(instance),
+        });
+
+        return res.status(HttpStatus.OK).json(response);
+      })
+      .post(this.routerPath('createExample'), ...guards, async (req, res) => {
+        const response = await this.dataValidate<ExampleDto>({
+          request: req,
+          schema: exampleSchema,
+          ClassRef: ExampleDto,
+          execute: (instance, data) => exampleController.create(instance, data),
+        });
+
+        return res.status(HttpStatus.CREATED).json(response);
+      });
+  }
+
+  public readonly router: Router = Router();
+}
+```
+
+## Main Router Pattern
+
+### Index Router Structure
+```typescript
+import { Router } from 'express';
+import { authGuard } from '@api/guards/auth.guard';
+import { instanceExistsGuard, instanceLoggedGuard } from '@api/guards/instance.guard';
+import Telemetry from '@api/guards/telemetry.guard';
+
+enum HttpStatus {
+  OK = 200,
+  CREATED = 201,
+  NOT_FOUND = 404,
+  FORBIDDEN = 403,
+  BAD_REQUEST = 400,
+  UNAUTHORIZED = 401,
+  INTERNAL_SERVER_ERROR = 500,
+}
+
+const router: Router = Router();
+const guards = [instanceExistsGuard, instanceLoggedGuard, authGuard['apikey']];
+const telemetry = new Telemetry();
+
+router
+  .use((req, res, next) => telemetry.collectTelemetry(req, res, next))
+  .get('/', async (req, res) => {
+    res.status(HttpStatus.OK).json({
+      status: HttpStatus.OK,
+      message: 'Welcome to the Evolution API, it is working!',
+      version: packageJson.version,
+      clientName: process.env.DATABASE_CONNECTION_CLIENT_NAME,
+      manager: !serverConfig.DISABLE_MANAGER ? `${req.protocol}://${req.get('host')}/manager` : undefined,
+      documentation: `https://doc.evolution-api.com`,
+      whatsappWebVersion: (await fetchLatestWaWebVersion({})).version.join('.'),
+    });
+  })
+  .use('/instance', new InstanceRouter(configService, ...guards).router)
+  .use('/message', new MessageRouter(...guards).router)
+  .use('/chat', new ChatRouter(...guards).router)
+  .use('/business', new BusinessRouter(...guards).router);
+
+export { HttpStatus, router };
+```
+
+## Data Validation Pattern
+
+### RouterBroker dataValidate Usage
+```typescript
+// CORRECT - Standard validation pattern
+.post(this.routerPath('createTemplate'), ...guards, async (req, res) => {
+  const response = await this.dataValidate<TemplateDto>({
+    request: req,
+    schema: templateSchema,
+    ClassRef: TemplateDto,
+    execute: (instance, data) => templateController.create(instance, data),
+  });
+
+  return res.status(HttpStatus.CREATED).json(response);
+})
+
+// CORRECT - No schema validation (for simple DTOs)
+.get(this.routerPath('findTemplate'), ...guards, async (req, res) => {
+  const response = await this.dataValidate<InstanceDto>({
+    request: req,
+    schema: null,
+    ClassRef: InstanceDto,
+    execute: (instance) => templateController.find(instance),
+  });
+
+  return res.status(HttpStatus.OK).json(response);
+})
+```
+
+## Error Handling in Routes
+
+### Try-Catch Pattern
+```typescript
+// CORRECT - Error handling with utility function
+.post(this.routerPath('getCatalog'), ...guards, async (req, res) => {
+  try {
+    const response = await this.dataValidate<NumberDto>({
+      request: req,
+      schema: catalogSchema,
+      ClassRef: NumberDto,
+      execute: (instance, data) => businessController.fetchCatalog(instance, data),
+    });
+
+    return res.status(HttpStatus.OK).json(response);
+  } catch (error) {
+    // Log error for debugging
+    console.error('Business catalog error:', error);
+
+    // Use utility function to create standardized error response
+    const errorResponse = createMetaErrorResponse(error, 'business_catalog');
+    return res.status(errorResponse.status).json(errorResponse);
+  }
+})
+
+// INCORRECT - Let RouterBroker handle errors (when possible)
+.post(this.routerPath('simpleOperation'), ...guards, async (req, res) => {
+  try {
+    const response = await this.dataValidate<SimpleDto>({
+      request: req,
+      schema: simpleSchema,
+      ClassRef: SimpleDto,
+      execute: (instance, data) => controller.simpleOperation(instance, data),
+    });
+
+    return res.status(HttpStatus.OK).json(response);
+  } catch (error) {
+    throw error; // ❌ Unnecessary - RouterBroker handles this
+  }
+})
+```
+
+## Route Path Pattern
+
+### routerPath Usage
+```typescript
+// CORRECT - Use routerPath for consistent naming
+.get(this.routerPath('findLabels'), ...guards, async (req, res) => {
+  // Implementation
+})
+.post(this.routerPath('handleLabel'), ...guards, async (req, res) => {
+  // Implementation
+})
+
+// INCORRECT - Hardcoded paths
+.get('/labels', ...guards, async (req, res) => { // ❌ Use routerPath
+  // Implementation
+})
+```
+
+## Guard Application Pattern
+
+### Guards Usage
+```typescript
+// CORRECT - Apply guards to protected routes
+export class ProtectedRouter extends RouterBroker {
+  constructor(...guards: RequestHandler[]) {
+    super();
+    this.router
+      .get(this.routerPath('protectedAction'), ...guards, async (req, res) => {
+        // Protected action
+      })
+      .post(this.routerPath('anotherAction'), ...guards, async (req, res) => {
+        // Another protected action
+      });
+  }
+}
+
+// CORRECT - No guards for public routes
+export class PublicRouter extends RouterBroker {
+  constructor() {
+    super();
+    this.router
+      .get('/health', async (req, res) => {
+        res.status(HttpStatus.OK).json({ status: 'healthy' });
+      })
+      .get('/version', async (req, res) => {
+        res.status(HttpStatus.OK).json({ version: packageJson.version });
+      });
+  }
+}
+```
+
+## Static File Serving Pattern
+
+### Static Assets Route
+```typescript
+// CORRECT - Secure static file serving
+router.get('/assets/*', (req, res) => {
+  const fileName = req.params[0];
+  
+  // Security: Reject paths containing traversal patterns
+  if (!fileName || fileName.includes('..') || fileName.includes('\\') || path.isAbsolute(fileName)) {
+    return res.status(403).send('Forbidden');
+  }
+  
+  const basePath = path.join(process.cwd(), 'manager', 'dist');
+  const assetsPath = path.join(basePath, 'assets');
+  const filePath = path.join(assetsPath, fileName);
+  
+  // Security: Ensure the resolved path is within the assets directory
+  const resolvedPath = path.resolve(filePath);
+  const resolvedAssetsPath = path.resolve(assetsPath);
+  
+  if (!resolvedPath.startsWith(resolvedAssetsPath + path.sep) && resolvedPath !== resolvedAssetsPath) {
+    return res.status(403).send('Forbidden');
+  }
+
+  if (fs.existsSync(resolvedPath)) {
+    res.set('Content-Type', mimeTypes.lookup(resolvedPath) || 'text/css');
+    res.send(fs.readFileSync(resolvedPath));
+  } else {
+    res.status(404).send('File not found');
+  }
+});
+```
+
+## Special Route Patterns
+
+### Manager Route Pattern
+```typescript
+export class ViewsRouter extends RouterBroker {
+  public readonly router: Router;
+
+  constructor() {
+    super();
+    this.router = Router();
+
+    const basePath = path.join(process.cwd(), 'manager', 'dist');
+    const indexPath = path.join(basePath, 'index.html');
+
+    this.router.use(express.static(basePath));
+
+    this.router.get('*', (req, res) => {
+      res.sendFile(indexPath);
+    });
+  }
+}
+```
+
+### Webhook Route Pattern
+```typescript
+// CORRECT - Webhook without guards
+.post('/webhook/evolution', async (req, res) => {
+  const response = await evolutionController.receiveWebhook(req.body);
+  return res.status(HttpStatus.OK).json(response);
+})
+
+// CORRECT - Webhook with signature validation
+.post('/webhook/meta', validateWebhookSignature, async (req, res) => {
+  const response = await metaController.receiveWebhook(req.body);
+  return res.status(HttpStatus.OK).json(response);
+})
+```
+
+## Response Pattern
+
+### Standard Response Format
+```typescript
+// CORRECT - Standard success response
+return res.status(HttpStatus.OK).json(response);
+
+// CORRECT - Created response
+return res.status(HttpStatus.CREATED).json(response);
+
+// CORRECT - Custom response with additional data
+return res.status(HttpStatus.OK).json({
+  ...response,
+  timestamp: new Date().toISOString(),
+  instanceName: req.params.instanceName,
+});
+```
+
+## Route Organization
+
+### File Structure
+```
+src/api/routes/
+├── index.router.ts          # Main router with all route registrations
+├── instance.router.ts       # Instance management routes
+├── sendMessage.router.ts    # Message sending routes
+├── chat.router.ts          # Chat operations routes
+├── business.router.ts      # Business API routes
+├── group.router.ts         # Group management routes
+├── label.router.ts         # Label management routes
+├── proxy.router.ts         # Proxy configuration routes
+├── settings.router.ts      # Instance settings routes
+├── template.router.ts      # Template management routes
+├── call.router.ts          # Call operations routes
+└── view.router.ts          # Frontend views routes
+```
+
+## Route Testing Pattern
+
+### Router Testing
+```typescript
+describe('ExampleRouter', () => {
+  let app: express.Application;
+  let router: ExampleRouter;
+
+  beforeEach(() => {
+    app = express();
+    router = new ExampleRouter();
+    app.use('/api', router.router);
+    app.use(express.json());
+  });
+
+  describe('GET /findExample', () => {
+    it('should return example data', async () => {
+      const response = await request(app)
+        .get('/api/findExample/test-instance')
+        .set('apikey', 'test-key')
+        .expect(200);
+
+      expect(response.body).toBeDefined();
+      expect(response.body.instanceName).toBe('test-instance');
+    });
+
+    it('should return 401 without API key', async () => {
+      await request(app)
+        .get('/api/findExample/test-instance')
+        .expect(401);
+    });
+  });
+
+  describe('POST /createExample', () => {
+    it('should create example successfully', async () => {
+      const data = {
+        name: 'Test Example',
+        description: 'Test Description',
+      };
+
+      const response = await request(app)
+        .post('/api/createExample/test-instance')
+        .set('apikey', 'test-key')
+        .send(data)
+        .expect(201);
+
+      expect(response.body.name).toBe(data.name);
+    });
+
+    it('should validate required fields', async () => {
+      const data = {
+        description: 'Test Description',
+        // Missing required 'name' field
+      };
+
+      await request(app)
+        .post('/api/createExample/test-instance')
+        .set('apikey', 'test-key')
+        .send(data)
+        .expect(400);
+    });
+  });
+});
+```
+
+## Route Documentation
+
+### JSDoc for Routes
+```typescript
+/**
+ * @route GET /api/template/findTemplate/:instanceName
+ * @description Find template for instance
+ * @param {string} instanceName - Instance name
+ * @returns {TemplateDto} Template data
+ * @throws {404} Template not found
+ * @throws {401} Unauthorized
+ */
+.get(this.routerPath('findTemplate'), ...guards, async (req, res) => {
+  // Implementation
+})
+
+/**
+ * @route POST /api/template/createTemplate/:instanceName
+ * @description Create new template
+ * @param {string} instanceName - Instance name
+ * @body {TemplateDto} Template data
+ * @returns {TemplateDto} Created template
+ * @throws {400} Validation error
+ * @throws {401} Unauthorized
+ */
+.post(this.routerPath('createTemplate'), ...guards, async (req, res) => {
+  // Implementation
+})
+```

.cursor/rules/specialized-rules/service-rules.mdc

@@ -0,0 +1,294 @@
+---
+description: Service layer patterns for Evolution API
+globs:
+  - "src/api/services/**/*.ts"
+  - "src/api/integrations/**/services/*.ts"
+alwaysApply: false
+---
+
+# Evolution API Service Rules
+
+## Service Structure Pattern
+
+### Standard Service Class
+```typescript
+export class ExampleService {
+  constructor(private readonly waMonitor: WAMonitoringService) {}
+
+  private readonly logger = new Logger('ExampleService');
+
+  public async create(instance: InstanceDto, data: ExampleDto) {
+    await this.waMonitor.waInstances[instance.instanceName].setData(data);
+    return { example: { ...instance, data } };
+  }
+
+  public async find(instance: InstanceDto): Promise<ExampleDto> {
+    try {
+      const result = await this.waMonitor.waInstances[instance.instanceName].findData();
+
+      if (Object.keys(result).length === 0) {
+        throw new Error('Data not found');
+      }
+
+      return result;
+    } catch (error) {
+      return null; // Evolution pattern - return null on error
+    }
+  }
+}
+```
+
+## Dependency Injection Pattern
+
+### Constructor Pattern
+```typescript
+// CORRECT - Evolution API pattern
+constructor(
+  private readonly waMonitor: WAMonitoringService,
+  private readonly prismaRepository: PrismaRepository,
+  private readonly configService: ConfigService,
+) {}
+
+// INCORRECT - Don't use
+constructor(waMonitor, prismaRepository, configService) {} // ❌ No types
+```
+
+## Logger Pattern
+
+### Standard Logger Usage
+```typescript
+// CORRECT - Evolution API pattern
+private readonly logger = new Logger('ServiceName');
+
+// Usage
+this.logger.log('Operation started');
+this.logger.error('Operation failed', error);
+
+// INCORRECT
+console.log('Operation started'); // ❌ Use Logger
+```
+
+## WAMonitor Integration Pattern
+
+### Instance Access Pattern
+```typescript
+// CORRECT - Standard pattern
+public async operation(instance: InstanceDto, data: DataDto) {
+  await this.waMonitor.waInstances[instance.instanceName].performAction(data);
+  return { result: { ...instance, data } };
+}
+
+// Instance validation
+const waInstance = this.waMonitor.waInstances[instance.instanceName];
+if (!waInstance) {
+  throw new NotFoundException('Instance not found');
+}
+```
+
+## Error Handling Pattern
+
+### Try-Catch Pattern
+```typescript
+// CORRECT - Evolution API pattern
+public async find(instance: InstanceDto): Promise<DataDto> {
+  try {
+    const result = await this.waMonitor.waInstances[instance.instanceName].findData();
+    
+    if (Object.keys(result).length === 0) {
+      throw new Error('Data not found');
+    }
+
+    return result;
+  } catch (error) {
+    this.logger.error('Find operation failed', error);
+    return null; // Return null on error (Evolution pattern)
+  }
+}
+```
+
+## Cache Integration Pattern
+
+### Cache Service Usage
+```typescript
+export class CacheAwareService {
+  constructor(
+    private readonly cache: CacheService,
+    private readonly chatwootCache: CacheService,
+    private readonly baileysCache: CacheService,
+  ) {}
+
+  public async getCachedData(key: string): Promise<any> {
+    const cached = await this.cache.get(key);
+    if (cached) return cached;
+
+    const data = await this.fetchFromSource(key);
+    await this.cache.set(key, data, 300); // 5 min TTL
+    return data;
+  }
+}
+```
+
+## Integration Service Patterns
+
+### Chatbot Service Base Pattern
+```typescript
+export class ChatbotService extends BaseChatbotService<BotType, SettingsType> {
+  constructor(
+    waMonitor: WAMonitoringService,
+    prismaRepository: PrismaRepository,
+    configService: ConfigService,
+  ) {
+    super(waMonitor, prismaRepository, 'ChatbotService', configService);
+  }
+
+  protected async processBot(
+    waInstance: any,
+    remoteJid: string,
+    bot: BotType,
+    session: any,
+    settings: any,
+    content: string,
+  ): Promise<void> {
+    // Implementation
+  }
+}
+```
+
+### Channel Service Pattern
+```typescript
+export class ChannelService extends ChannelStartupService {
+  constructor(
+    configService: ConfigService,
+    eventEmitter: EventEmitter2,
+    prismaRepository: PrismaRepository,
+    cache: CacheService,
+    chatwootCache: CacheService,
+    baileysCache: CacheService,
+  ) {
+    super(configService, eventEmitter, prismaRepository, cache, chatwootCache, baileysCache);
+  }
+
+  public readonly logger = new Logger('ChannelService');
+  public client: WASocket;
+  public readonly instance: wa.Instance = {};
+}
+```
+
+## Service Initialization Pattern
+
+### Service Registration
+```typescript
+// In server.module.ts pattern
+export const templateService = new TemplateService(
+  waMonitor,
+  prismaRepository,
+  configService,
+);
+
+export const settingsService = new SettingsService(waMonitor);
+```
+
+## Async Operation Patterns
+
+### Promise Handling
+```typescript
+// CORRECT - Evolution API pattern
+public async sendMessage(instance: InstanceDto, data: MessageDto) {
+  const waInstance = this.waMonitor.waInstances[instance.instanceName];
+  return await waInstance.sendMessage(data);
+}
+
+// INCORRECT - Don't use .then()
+public sendMessage(instance: InstanceDto, data: MessageDto) {
+  return this.waMonitor.waInstances[instance.instanceName]
+    .sendMessage(data)
+    .then(result => result); // ❌ Use async/await
+}
+```
+
+## Configuration Access Pattern
+
+### Config Service Usage
+```typescript
+// CORRECT - Evolution API pattern
+const serverConfig = this.configService.get<HttpServer>('SERVER');
+const authConfig = this.configService.get<Auth>('AUTHENTICATION');
+const dbConfig = this.configService.get<Database>('DATABASE');
+
+// Type-safe configuration access
+if (this.configService.get<Chatwoot>('CHATWOOT').ENABLED) {
+  // Chatwoot logic
+}
+```
+
+## Event Emission Pattern
+
+### EventEmitter2 Usage
+```typescript
+// CORRECT - Evolution API pattern
+this.eventEmitter.emit(Events.INSTANCE_CREATE, {
+  instanceName: instance.name,
+  status: 'created',
+});
+
+// Chatwoot event pattern
+if (this.configService.get<Chatwoot>('CHATWOOT').ENABLED && this.localChatwoot?.enabled) {
+  this.chatwootService.eventWhatsapp(
+    Events.STATUS_INSTANCE,
+    { instanceName: this.instance.name },
+    {
+      instance: this.instance.name,
+      status: 'created',
+    },
+  );
+}
+```
+
+## Service Method Naming
+
+### Standard Method Names
+- `create()` - Create new resource
+- `find()` - Find single resource
+- `findAll()` - Find multiple resources
+- `update()` - Update resource
+- `delete()` - Delete resource
+- `fetch*()` - Fetch from external API
+- `send*()` - Send data/messages
+- `process*()` - Process data
+
+## Service Testing Pattern
+
+### Unit Test Structure
+```typescript
+describe('ExampleService', () => {
+  let service: ExampleService;
+  let waMonitor: jest.Mocked<WAMonitoringService>;
+  let prismaRepository: jest.Mocked<PrismaRepository>;
+
+  beforeEach(() => {
+    const mockWaMonitor = {
+      waInstances: {
+        'test-instance': {
+          performAction: jest.fn(),
+        },
+      },
+    };
+
+    service = new ExampleService(
+      mockWaMonitor as any,
+      prismaRepository,
+      configService,
+    );
+  });
+
+  it('should perform action successfully', async () => {
+    const instance = { instanceName: 'test-instance' };
+    const data = { test: 'data' };
+
+    const result = await service.create(instance, data);
+
+    expect(result).toBeDefined();
+    expect(waMonitor.waInstances['test-instance'].performAction).toHaveBeenCalledWith(data);
+  });
+});
+```

.cursor/rules/specialized-rules/type-rules.mdc

@@ -0,0 +1,490 @@
+---
+description: Type definitions and interfaces for Evolution API
+globs:
+  - "src/api/types/**/*.ts"
+  - "src/@types/**/*.ts"
+alwaysApply: false
+---
+
+# Evolution API Type Rules
+
+## Namespace Pattern
+
+### WhatsApp Types Namespace
+```typescript
+/* eslint-disable @typescript-eslint/no-namespace */
+import { JsonValue } from '@prisma/client/runtime/library';
+import { AuthenticationState, WAConnectionState } from 'baileys';
+
+export declare namespace wa {
+  export type QrCode = {
+    count?: number;
+    pairingCode?: string;
+    base64?: string;
+    code?: string;
+  };
+
+  export type Instance = {
+    id?: string;
+    qrcode?: QrCode;
+    pairingCode?: string;
+    authState?: { state: AuthenticationState; saveCreds: () => void };
+    name?: string;
+    wuid?: string;
+    profileName?: string;
+    profilePictureUrl?: string;
+    token?: string;
+    number?: string;
+    integration?: string;
+    businessId?: string;
+  };
+
+  export type LocalChatwoot = {
+    enabled?: boolean;
+    accountId?: string;
+    token?: string;
+    url?: string;
+    nameInbox?: string;
+    mergeBrazilContacts?: boolean;
+    importContacts?: boolean;
+    importMessages?: boolean;
+    daysLimitImportMessages?: number;
+    organization?: string;
+    logo?: string;
+  };
+
+  export type LocalProxy = {
+    enabled?: boolean;
+    host?: string;
+    port?: string;
+    protocol?: string;
+    username?: string;
+    password?: string;
+  };
+
+  export type LocalSettings = {
+    rejectCall?: boolean;
+    msgCall?: string;
+    groupsIgnore?: boolean;
+    alwaysOnline?: boolean;
+    readMessages?: boolean;
+    readStatus?: boolean;
+    syncFullHistory?: boolean;
+  };
+
+  export type LocalWebHook = {
+    enabled?: boolean;
+    url?: string;
+    events?: string[];
+    headers?: JsonValue;
+    byEvents?: boolean;
+    base64?: boolean;
+  };
+
+  export type StatusMessage = 'ERROR' | 'PENDING' | 'SERVER_ACK' | 'DELIVERY_ACK' | 'READ' | 'DELETED' | 'PLAYED';
+}
+```
+
+## Enum Definitions
+
+### Events Enum
+```typescript
+export enum Events {
+  APPLICATION_STARTUP = 'application.startup',
+  INSTANCE_CREATE = 'instance.create',
+  INSTANCE_DELETE = 'instance.delete',
+  QRCODE_UPDATED = 'qrcode.updated',
+  CONNECTION_UPDATE = 'connection.update',
+  STATUS_INSTANCE = 'status.instance',
+  MESSAGES_SET = 'messages.set',
+  MESSAGES_UPSERT = 'messages.upsert',
+  MESSAGES_EDITED = 'messages.edited',
+  MESSAGES_UPDATE = 'messages.update',
+  MESSAGES_DELETE = 'messages.delete',
+  SEND_MESSAGE = 'send.message',
+  SEND_MESSAGE_UPDATE = 'send.message.update',
+  CONTACTS_SET = 'contacts.set',
+  CONTACTS_UPSERT = 'contacts.upsert',
+  CONTACTS_UPDATE = 'contacts.update',
+  PRESENCE_UPDATE = 'presence.update',
+  CHATS_SET = 'chats.set',
+  CHATS_UPDATE = 'chats.update',
+  CHATS_UPSERT = 'chats.upsert',
+  CHATS_DELETE = 'chats.delete',
+  GROUPS_UPSERT = 'groups.upsert',
+  GROUPS_UPDATE = 'groups.update',
+  GROUP_PARTICIPANTS_UPDATE = 'group-participants.update',
+  CALL = 'call',
+  TYPEBOT_START = 'typebot.start',
+  TYPEBOT_CHANGE_STATUS = 'typebot.change-status',
+  LABELS_EDIT = 'labels.edit',
+  LABELS_ASSOCIATION = 'labels.association',
+  CREDS_UPDATE = 'creds.update',
+  MESSAGING_HISTORY_SET = 'messaging-history.set',
+  REMOVE_INSTANCE = 'remove.instance',
+  LOGOUT_INSTANCE = 'logout.instance',
+}
+```
+
+### Integration Types
+```typescript
+export const Integration = {
+  WHATSAPP_BUSINESS: 'WHATSAPP-BUSINESS',
+  WHATSAPP_BAILEYS: 'WHATSAPP-BAILEYS',
+  EVOLUTION: 'EVOLUTION',
+} as const;
+
+export type IntegrationType = typeof Integration[keyof typeof Integration];
+```
+
+## Constant Arrays
+
+### Message Type Constants
+```typescript
+export const TypeMediaMessage = [
+  'imageMessage',
+  'documentMessage',
+  'audioMessage',
+  'videoMessage',
+  'stickerMessage',
+  'ptvMessage', // Evolution API includes this
+];
+
+export const MessageSubtype = [
+  'ephemeralMessage',
+  'documentWithCaptionMessage',
+  'viewOnceMessage',
+  'viewOnceMessageV2',
+];
+
+export type MediaMessageType = typeof TypeMediaMessage[number];
+export type MessageSubtypeType = typeof MessageSubtype[number];
+```
+
+## Interface Definitions
+
+### Service Interfaces
+```typescript
+export interface ServiceInterface {
+  create(instance: InstanceDto, data: any): Promise<any>;
+  find(instance: InstanceDto): Promise<any>;
+  update?(instance: InstanceDto, data: any): Promise<any>;
+  delete?(instance: InstanceDto): Promise<any>;
+}
+
+export interface ChannelServiceInterface extends ServiceInterface {
+  sendMessage(data: SendMessageDto): Promise<any>;
+  connectToWhatsapp(data?: any): Promise<void>;
+  receiveWebhook?(data: any): Promise<void>;
+}
+
+export interface ChatbotServiceInterface extends ServiceInterface {
+  processMessage(
+    instanceName: string,
+    remoteJid: string,
+    message: any,
+    pushName?: string,
+  ): Promise<void>;
+}
+```
+
+## Configuration Types
+
+### Environment Configuration Types
+```typescript
+export interface DatabaseConfig {
+  CONNECTION: {
+    URI: string;
+    DB_PREFIX_NAME: string;
+    CLIENT_NAME?: string;
+  };
+  ENABLED: boolean;
+  SAVE_DATA: {
+    INSTANCE: boolean;
+    NEW_MESSAGE: boolean;
+    MESSAGE_UPDATE: boolean;
+    CONTACTS: boolean;
+    CHATS: boolean;
+  };
+}
+
+export interface AuthConfig {
+  TYPE: 'apikey' | 'jwt';
+  API_KEY: {
+    KEY: string;
+  };
+  JWT?: {
+    EXPIRIN_IN: number;
+    SECRET: string;
+  };
+}
+
+export interface CacheConfig {
+  REDIS: {
+    ENABLED: boolean;
+    URI: string;
+    PREFIX_KEY: string;
+    SAVE_INSTANCES: boolean;
+  };
+  LOCAL: {
+    ENABLED: boolean;
+    TTL: number;
+  };
+}
+```
+
+## Message Types
+
+### Message Structure Types
+```typescript
+export interface MessageContent {
+  text?: string;
+  caption?: string;
+  media?: Buffer | string;
+  mediatype?: 'image' | 'video' | 'audio' | 'document' | 'sticker';
+  fileName?: string;
+  mimetype?: string;
+}
+
+export interface MessageOptions {
+  delay?: number;
+  presence?: 'unavailable' | 'available' | 'composing' | 'recording' | 'paused';
+  linkPreview?: boolean;
+  mentionsEveryOne?: boolean;
+  mentioned?: string[];
+  quoted?: {
+    key: {
+      remoteJid: string;
+      fromMe: boolean;
+      id: string;
+    };
+    message: any;
+  };
+}
+
+export interface SendMessageRequest {
+  number: string;
+  content: MessageContent;
+  options?: MessageOptions;
+}
+```
+
+## Webhook Types
+
+### Webhook Payload Types
+```typescript
+export interface WebhookPayload {
+  event: Events;
+  instance: string;
+  data: any;
+  timestamp: string;
+  server?: {
+    version: string;
+    host: string;
+  };
+}
+
+export interface WebhookConfig {
+  enabled: boolean;
+  url: string;
+  events: Events[];
+  headers?: Record<string, string>;
+  byEvents?: boolean;
+  base64?: boolean;
+}
+```
+
+## Error Types
+
+### Custom Error Types
+```typescript
+export interface ApiError {
+  status: number;
+  message: string;
+  error?: string;
+  details?: any;
+  timestamp: string;
+  path: string;
+}
+
+export interface ValidationError extends ApiError {
+  status: 400;
+  validationErrors: Array<{
+    field: string;
+    message: string;
+    value?: any;
+  }>;
+}
+
+export interface AuthenticationError extends ApiError {
+  status: 401;
+  message: 'Unauthorized' | 'Invalid API Key' | 'Token Expired';
+}
+```
+
+## Utility Types
+
+### Generic Utility Types
+```typescript
+export type Optional<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
+
+export type RequiredFields<T, K extends keyof T> = T & Required<Pick<T, K>>;
+
+export type DeepPartial<T> = {
+  [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
+};
+
+export type NonEmptyArray<T> = [T, ...T[]];
+
+export type StringKeys<T> = {
+  [K in keyof T]: T[K] extends string ? K : never;
+}[keyof T];
+```
+
+## Response Types
+
+### API Response Types
+```typescript
+export interface ApiResponse<T = any> {
+  success: boolean;
+  data?: T;
+  message?: string;
+  error?: string;
+  timestamp: string;
+}
+
+export interface PaginatedResponse<T> extends ApiResponse<T[]> {
+  pagination: {
+    page: number;
+    limit: number;
+    total: number;
+    totalPages: number;
+    hasNext: boolean;
+    hasPrev: boolean;
+  };
+}
+
+export interface InstanceResponse extends ApiResponse {
+  instance: {
+    instanceName: string;
+    status: 'connecting' | 'open' | 'close' | 'qr';
+    qrcode?: string;
+    profileName?: string;
+    profilePicUrl?: string;
+  };
+}
+```
+
+## Integration-Specific Types
+
+### Baileys Types Extension
+```typescript
+import { WASocket, ConnectionState, DisconnectReason } from 'baileys';
+
+export interface BaileysInstance {
+  client: WASocket;
+  state: ConnectionState;
+  qrRetry: number;
+  authPath: string;
+}
+
+export interface BaileysConfig {
+  qrTimeout: number;
+  maxQrRetries: number;
+  authTimeout: number;
+  reconnectInterval: number;
+}
+```
+
+### Business API Types
+```typescript
+export interface BusinessApiConfig {
+  version: string;
+  baseUrl: string;
+  timeout: number;
+  retries: number;
+}
+
+export interface BusinessApiMessage {
+  messaging_product: 'whatsapp';
+  to: string;
+  type: 'text' | 'image' | 'document' | 'audio' | 'video' | 'template';
+  text?: {
+    body: string;
+    preview_url?: boolean;
+  };
+  image?: {
+    link?: string;
+    id?: string;
+    caption?: string;
+  };
+  template?: {
+    name: string;
+    language: {
+      code: string;
+    };
+    components?: any[];
+  };
+}
+```
+
+## Type Guards
+
+### Type Guard Functions
+```typescript
+export function isMediaMessage(message: any): message is MediaMessage {
+  return message && TypeMediaMessage.some(type => message[type]);
+}
+
+export function isTextMessage(message: any): message is TextMessage {
+  return message && message.conversation;
+}
+
+export function isValidIntegration(integration: string): integration is IntegrationType {
+  return Object.values(Integration).includes(integration as IntegrationType);
+}
+
+export function isValidEvent(event: string): event is Events {
+  return Object.values(Events).includes(event as Events);
+}
+```
+
+## Module Augmentation
+
+### Express Request Extension
+```typescript
+declare global {
+  namespace Express {
+    interface Request {
+      instanceName?: string;
+      instanceData?: InstanceDto;
+      user?: {
+        id: string;
+        apiKey: string;
+      };
+    }
+  }
+}
+```
+
+## Type Documentation
+
+### JSDoc Type Documentation
+```typescript
+/**
+ * WhatsApp instance configuration
+ * @interface InstanceConfig
+ * @property {string} name - Unique instance name
+ * @property {IntegrationType} integration - Integration type
+ * @property {string} [token] - API token for business integrations
+ * @property {WebhookConfig} [webhook] - Webhook configuration
+ * @property {ProxyConfig} [proxy] - Proxy configuration
+ */
+export interface InstanceConfig {
+  name: string;
+  integration: IntegrationType;
+  token?: string;
+  webhook?: WebhookConfig;
+  proxy?: ProxyConfig;
+}
+```

.cursor/rules/specialized-rules/util-rules.mdc

@@ -0,0 +1,653 @@
+---
+description: Utility functions and helpers for Evolution API
+globs:
+  - "src/utils/**/*.ts"
+alwaysApply: false
+---
+
+# Evolution API Utility Rules
+
+## Utility Function Structure
+
+### Standard Utility Pattern
+```typescript
+import { Logger } from '@config/logger.config';
+
+const logger = new Logger('UtilityName');
+
+export function utilityFunction(param: ParamType): ReturnType {
+  try {
+    // Utility logic
+    return result;
+  } catch (error) {
+    logger.error(`Utility function failed: ${error.message}`);
+    throw error;
+  }
+}
+
+export default utilityFunction;
+```
+
+## Authentication Utilities
+
+### Multi-File Auth State Pattern
+```typescript
+import { AuthenticationState } from 'baileys';
+import { CacheService } from '@api/services/cache.service';
+import fs from 'fs/promises';
+import path from 'path';
+
+export default async function useMultiFileAuthStatePrisma(
+  sessionId: string,
+  cache: CacheService,
+): Promise<{
+  state: AuthenticationState;
+  saveCreds: () => Promise<void>;
+}> {
+  const localFolder = path.join(INSTANCE_DIR, sessionId);
+  const localFile = (key: string) => path.join(localFolder, fixFileName(key) + '.json');
+  await fs.mkdir(localFolder, { recursive: true });
+
+  async function writeData(data: any, key: string): Promise<any> {
+    const dataString = JSON.stringify(data, BufferJSON.replacer);
+
+    if (key !== 'creds') {
+      if (process.env.CACHE_REDIS_ENABLED === 'true') {
+        return await cache.hSet(sessionId, key, data);
+      } else {
+        await fs.writeFile(localFile(key), dataString);
+        return;
+      }
+    }
+    await saveKey(sessionId, dataString);
+    return;
+  }
+
+  async function readData(key: string): Promise<any> {
+    try {
+      let rawData;
+
+      if (key !== 'creds') {
+        if (process.env.CACHE_REDIS_ENABLED === 'true') {
+          return await cache.hGet(sessionId, key);
+        } else {
+          if (!(await fileExists(localFile(key)))) return null;
+          rawData = await fs.readFile(localFile(key), { encoding: 'utf-8' });
+          return JSON.parse(rawData, BufferJSON.reviver);
+        }
+      } else {
+        rawData = await getAuthKey(sessionId);
+      }
+
+      const parsedData = JSON.parse(rawData, BufferJSON.reviver);
+      return parsedData;
+    } catch (error) {
+      return null;
+    }
+  }
+
+  async function removeData(key: string): Promise<any> {
+    try {
+      if (key !== 'creds') {
+        if (process.env.CACHE_REDIS_ENABLED === 'true') {
+          return await cache.hDelete(sessionId, key);
+        } else {
+          await fs.unlink(localFile(key));
+        }
+      } else {
+        await deleteAuthKey(sessionId);
+      }
+    } catch (error) {
+      return;
+    }
+  }
+
+  let creds = await readData('creds');
+  if (!creds) {
+    creds = initAuthCreds();
+    await writeData(creds, 'creds');
+  }
+
+  return {
+    state: {
+      creds,
+      keys: {
+        get: async (type, ids) => {
+          const data = {};
+          await Promise.all(
+            ids.map(async (id) => {
+              let value = await readData(`${type}-${id}`);
+              if (type === 'app-state-sync-key' && value) {
+                value = proto.Message.AppStateSyncKeyData.fromObject(value);
+              }
+              data[id] = value;
+            })
+          );
+          return data;
+        },
+        set: async (data) => {
+          const tasks = [];
+          for (const category in data) {
+            for (const id in data[category]) {
+              const value = data[category][id];
+              const key = `${category}-${id}`;
+              tasks.push(value ? writeData(value, key) : removeData(key));
+            }
+          }
+          await Promise.all(tasks);
+        },
+      },
+    },
+    saveCreds: () => writeData(creds, 'creds'),
+  };
+}
+```
+
+## Message Processing Utilities
+
+### Message Content Extraction
+```typescript
+export const getConversationMessage = (msg: any): string => {
+  const types = getTypeMessage(msg);
+  const messageContent = getMessageContent(types);
+  return messageContent;
+};
+
+const getTypeMessage = (msg: any): any => {
+  return Object.keys(msg?.message || msg || {})[0];
+};
+
+const getMessageContent = (type: string, msg?: any): string => {
+  const typeKey = type?.replace('Message', '');
+  
+  const types = {
+    conversation: msg?.message?.conversation,
+    extendedTextMessage: msg?.message?.extendedTextMessage?.text,
+    imageMessage: msg?.message?.imageMessage?.caption || 'Image',
+    videoMessage: msg?.message?.videoMessage?.caption || 'Video',
+    audioMessage: 'Audio',
+    documentMessage: msg?.message?.documentMessage?.caption || 'Document',
+    stickerMessage: 'Sticker',
+    contactMessage: 'Contact',
+    locationMessage: 'Location',
+    liveLocationMessage: 'Live Location',
+    viewOnceMessage: 'View Once',
+    reactionMessage: 'Reaction',
+    pollCreationMessage: 'Poll',
+    pollUpdateMessage: 'Poll Update',
+  };
+
+  let result = types[typeKey] || types[type] || 'Unknown';
+  
+  if (!result || result === 'Unknown') {
+    result = JSON.stringify(msg);
+  }
+
+  return result;
+};
+```
+
+### JID Creation Utility
+```typescript
+export const createJid = (number: string): string => {
+  if (number.includes('@')) {
+    return number;
+  }
+
+  // Remove any non-numeric characters except +
+  let cleanNumber = number.replace(/[^\d+]/g, '');
+  
+  // Remove + if present
+  if (cleanNumber.startsWith('+')) {
+    cleanNumber = cleanNumber.substring(1);
+  }
+
+  // Add country code if missing (assuming Brazil as default)
+  if (cleanNumber.length === 11 && cleanNumber.startsWith('11')) {
+    cleanNumber = '55' + cleanNumber;
+  } else if (cleanNumber.length === 10) {
+    cleanNumber = '5511' + cleanNumber;
+  }
+
+  // Determine if it's a group or individual
+  const isGroup = cleanNumber.includes('-');
+  const domain = isGroup ? 'g.us' : 's.whatsapp.net';
+
+  return `${cleanNumber}@${domain}`;
+};
+```
+
+## Cache Utilities
+
+### WhatsApp Number Cache
+```typescript
+interface ISaveOnWhatsappCacheParams {
+  remoteJid: string;
+  lid?: string;
+}
+
+function getAvailableNumbers(remoteJid: string): string[] {
+  const numbersAvailable: string[] = [];
+
+  if (remoteJid.startsWith('+')) {
+    remoteJid = remoteJid.slice(1);
+  }
+
+  const [number, domain] = remoteJid.split('@');
+
+  // Brazilian numbers
+  if (remoteJid.startsWith('55')) {
+    const numberWithDigit =
+      number.slice(4, 5) === '9' && number.length === 13 ? number : `${number.slice(0, 4)}9${number.slice(4)}`;
+    const numberWithoutDigit = number.length === 12 ? number : number.slice(0, 4) + number.slice(5);
+
+    numbersAvailable.push(numberWithDigit);
+    numbersAvailable.push(numberWithoutDigit);
+  }
+  // Mexican/Argentina numbers
+  else if (number.startsWith('52') || number.startsWith('54')) {
+    let prefix = '';
+    if (number.startsWith('52')) {
+      prefix = '1';
+    }
+    if (number.startsWith('54')) {
+      prefix = '9';
+    }
+
+    const numberWithDigit =
+      number.slice(2, 3) === prefix && number.length === 13
+        ? number
+        : `${number.slice(0, 2)}${prefix}${number.slice(2)}`;
+    const numberWithoutDigit = number.length === 12 ? number : number.slice(0, 2) + number.slice(3);
+
+    numbersAvailable.push(numberWithDigit);
+    numbersAvailable.push(numberWithoutDigit);
+  }
+  // Other countries
+  else {
+    numbersAvailable.push(remoteJid);
+  }
+
+  return numbersAvailable.map((number) => `${number}@${domain}`);
+}
+
+export async function saveOnWhatsappCache(params: ISaveOnWhatsappCacheParams): Promise<void> {
+  const { remoteJid, lid } = params;
+  const db = configService.get<Database>('DATABASE');
+
+  if (!db.SAVE_DATA.CONTACTS) {
+    return;
+  }
+
+  try {
+    const numbersAvailable = getAvailableNumbers(remoteJid);
+    
+    const existingContact = await prismaRepository.contact.findFirst({
+      where: {
+        OR: numbersAvailable.map(number => ({ id: number })),
+      },
+    });
+
+    if (!existingContact) {
+      await prismaRepository.contact.create({
+        data: {
+          id: remoteJid,
+          pushName: '',
+          profilePicUrl: '',
+          isOnWhatsapp: true,
+          lid: lid || null,
+          createdAt: new Date(),
+          updatedAt: new Date(),
+        },
+      });
+    } else {
+      await prismaRepository.contact.update({
+        where: { id: existingContact.id },
+        data: {
+          isOnWhatsapp: true,
+          lid: lid || existingContact.lid,
+          updatedAt: new Date(),
+        },
+      });
+    }
+  } catch (error) {
+    console.error('Error saving WhatsApp cache:', error);
+  }
+}
+```
+
+## Search Utilities
+
+### Advanced Search Operators
+```typescript
+function normalizeString(str: string): string {
+  return str
+    .toLowerCase()
+    .normalize('NFD')
+    .replace(/[\u0300-\u036f]/g, '');
+}
+
+export function advancedOperatorsSearch(data: string, query: string): boolean {
+  const normalizedData = normalizeString(data);
+  const normalizedQuery = normalizeString(query);
+
+  // Exact phrase search with quotes
+  if (normalizedQuery.startsWith('"') && normalizedQuery.endsWith('"')) {
+    const phrase = normalizedQuery.slice(1, -1);
+    return normalizedData.includes(phrase);
+  }
+
+  // OR operator
+  if (normalizedQuery.includes(' OR ')) {
+    const terms = normalizedQuery.split(' OR ');
+    return terms.some(term => normalizedData.includes(term.trim()));
+  }
+
+  // AND operator (default behavior)
+  if (normalizedQuery.includes(' AND ')) {
+    const terms = normalizedQuery.split(' AND ');
+    return terms.every(term => normalizedData.includes(term.trim()));
+  }
+
+  // NOT operator
+  if (normalizedQuery.startsWith('NOT ')) {
+    const term = normalizedQuery.slice(4);
+    return !normalizedData.includes(term);
+  }
+
+  // Wildcard search
+  if (normalizedQuery.includes('*')) {
+    const regex = new RegExp(normalizedQuery.replace(/\*/g, '.*'), 'i');
+    return regex.test(normalizedData);
+  }
+
+  // Default: simple contains search
+  return normalizedData.includes(normalizedQuery);
+}
+```
+
+## Proxy Utilities
+
+### Proxy Agent Creation
+```typescript
+import { HttpsProxyAgent } from 'https-proxy-agent';
+import { SocksProxyAgent } from 'socks-proxy-agent';
+
+type Proxy = {
+  host: string;
+  port: string;
+  protocol: 'http' | 'https' | 'socks4' | 'socks5';
+  username?: string;
+  password?: string;
+};
+
+function selectProxyAgent(proxyUrl: string): HttpsProxyAgent<string> | SocksProxyAgent {
+  const url = new URL(proxyUrl);
+  
+  if (url.protocol === 'socks4:' || url.protocol === 'socks5:') {
+    return new SocksProxyAgent(proxyUrl);
+  } else {
+    return new HttpsProxyAgent(proxyUrl);
+  }
+}
+
+export function makeProxyAgent(proxy: Proxy): HttpsProxyAgent<string> | SocksProxyAgent | null {
+  if (!proxy.host || !proxy.port) {
+    return null;
+  }
+
+  let proxyUrl = `${proxy.protocol}://`;
+  
+  if (proxy.username && proxy.password) {
+    proxyUrl += `${proxy.username}:${proxy.password}@`;
+  }
+  
+  proxyUrl += `${proxy.host}:${proxy.port}`;
+
+  try {
+    return selectProxyAgent(proxyUrl);
+  } catch (error) {
+    console.error('Failed to create proxy agent:', error);
+    return null;
+  }
+}
+```
+
+## Telemetry Utilities
+
+### Telemetry Data Collection
+```typescript
+export interface TelemetryData {
+  route: string;
+  apiVersion: string;
+  timestamp: Date;
+  method?: string;
+  statusCode?: number;
+  responseTime?: number;
+  userAgent?: string;
+  instanceName?: string;
+}
+
+export const sendTelemetry = async (route: string): Promise<void> => {
+  try {
+    const telemetryData: TelemetryData = {
+      route,
+      apiVersion: packageJson.version,
+      timestamp: new Date(),
+    };
+
+    // Only send telemetry if enabled
+    if (process.env.DISABLE_TELEMETRY === 'true') {
+      return;
+    }
+
+    // Send to telemetry service (implement as needed)
+    await axios.post('https://telemetry.evolution-api.com/collect', telemetryData, {
+      timeout: 5000,
+    });
+  } catch (error) {
+    // Silently fail - don't affect main application
+    console.debug('Telemetry failed:', error.message);
+  }
+};
+```
+
+## Internationalization Utilities
+
+### i18n Setup
+```typescript
+import { ConfigService, Language } from '@config/env.config';
+import fs from 'fs';
+import i18next from 'i18next';
+import path from 'path';
+
+const __dirname = path.resolve(process.cwd(), 'src', 'utils');
+const languages = ['en', 'pt-BR', 'es'];
+const translationsPath = path.join(__dirname, 'translations');
+const configService: ConfigService = new ConfigService();
+
+const resources: any = {};
+
+languages.forEach((language) => {
+  const languagePath = path.join(translationsPath, `${language}.json`);
+  if (fs.existsSync(languagePath)) {
+    const translationContent = fs.readFileSync(languagePath, 'utf8');
+    resources[language] = {
+      translation: JSON.parse(translationContent),
+    };
+  }
+});
+
+i18next.init({
+  resources,
+  fallbackLng: 'en',
+  lng: configService.get<Language>('LANGUAGE') || 'pt-BR',
+  interpolation: {
+    escapeValue: false,
+  },
+});
+
+export const t = i18next.t.bind(i18next);
+export default i18next;
+```
+
+## Bot Trigger Utilities
+
+### Bot Trigger Matching
+```typescript
+import { TriggerOperator, TriggerType } from '@prisma/client';
+
+export function findBotByTrigger(
+  bots: any[],
+  content: string,
+  remoteJid: string,
+): any | null {
+  for (const bot of bots) {
+    if (!bot.enabled) continue;
+    
+    // Check ignore list
+    if (bot.ignoreJids && bot.ignoreJids.includes(remoteJid)) {
+      continue;
+    }
+
+    // Check trigger
+    if (matchesTrigger(content, bot.triggerType, bot.triggerOperator, bot.triggerValue)) {
+      return bot;
+    }
+  }
+
+  return null;
+}
+
+function matchesTrigger(
+  content: string,
+  triggerType: TriggerType,
+  triggerOperator: TriggerOperator,
+  triggerValue: string,
+): boolean {
+  const normalizedContent = content.toLowerCase().trim();
+  const normalizedValue = triggerValue.toLowerCase().trim();
+
+  switch (triggerType) {
+    case TriggerType.ALL:
+      return true;
+
+    case TriggerType.KEYWORD:
+      return matchesKeyword(normalizedContent, triggerOperator, normalizedValue);
+
+    case TriggerType.REGEX:
+      try {
+        const regex = new RegExp(triggerValue, 'i');
+        return regex.test(content);
+      } catch {
+        return false;
+      }
+
+    default:
+      return false;
+  }
+}
+
+function matchesKeyword(
+  content: string,
+  operator: TriggerOperator,
+  value: string,
+): boolean {
+  switch (operator) {
+    case TriggerOperator.EQUALS:
+      return content === value;
+    case TriggerOperator.CONTAINS:
+      return content.includes(value);
+    case TriggerOperator.STARTS_WITH:
+      return content.startsWith(value);
+    case TriggerOperator.ENDS_WITH:
+      return content.endsWith(value);
+    default:
+      return false;
+  }
+}
+```
+
+## Server Utilities
+
+### Server Status Check
+```typescript
+export class ServerUP {
+  private static instance: ServerUP;
+  private isServerUp: boolean = false;
+
+  private constructor() {}
+
+  public static getInstance(): ServerUP {
+    if (!ServerUP.instance) {
+      ServerUP.instance = new ServerUP();
+    }
+    return ServerUP.instance;
+  }
+
+  public setServerStatus(status: boolean): void {
+    this.isServerUp = status;
+  }
+
+  public getServerStatus(): boolean {
+    return this.isServerUp;
+  }
+
+  public async waitForServer(timeout: number = 30000): Promise<boolean> {
+    const startTime = Date.now();
+    
+    while (!this.isServerUp && (Date.now() - startTime) < timeout) {
+      await new Promise(resolve => setTimeout(resolve, 100));
+    }
+    
+    return this.isServerUp;
+  }
+}
+```
+
+## Error Response Utilities
+
+### Standardized Error Responses
+```typescript
+export function createMetaErrorResponse(error: any, context: string) {
+  const timestamp = new Date().toISOString();
+  
+  if (error.response?.data) {
+    return {
+      status: error.response.status || 500,
+      error: {
+        message: error.response.data.error?.message || 'External API error',
+        type: error.response.data.error?.type || 'api_error',
+        code: error.response.data.error?.code || 'unknown_error',
+        context,
+        timestamp,
+      },
+    };
+  }
+
+  return {
+    status: 500,
+    error: {
+      message: error.message || 'Internal server error',
+      type: 'internal_error',
+      code: 'server_error',
+      context,
+      timestamp,
+    },
+  };
+}
+
+export function createValidationErrorResponse(errors: any[], context: string) {
+  return {
+    status: 400,
+    error: {
+      message: 'Validation failed',
+      type: 'validation_error',
+      code: 'invalid_input',
+      context,
+      details: errors,
+      timestamp: new Date().toISOString(),
+    },
+  };
+}
+```

.cursor/rules/specialized-rules/validate-rules.mdc

@@ -0,0 +1,498 @@
+---
+description: Validation schemas and patterns for Evolution API
+globs:
+  - "src/validate/**/*.ts"
+alwaysApply: false
+---
+
+# Evolution API Validation Rules
+
+## Validation Schema Structure
+
+### JSONSchema7 Pattern (Evolution API Standard)
+```typescript
+import { JSONSchema7 } from 'json-schema';
+import { v4 } from 'uuid';
+
+const isNotEmpty = (...fields: string[]) => {
+  const properties = {};
+  fields.forEach((field) => {
+    properties[field] = {
+      if: { properties: { [field]: { type: 'string' } } },
+      then: { properties: { [field]: { minLength: 1 } } },
+    };
+  });
+
+  return {
+    allOf: Object.values(properties),
+  };
+};
+
+export const exampleSchema: JSONSchema7 = {
+  $id: v4(),
+  type: 'object',
+  properties: {
+    name: { type: 'string' },
+    description: { type: 'string' },
+    enabled: { type: 'boolean' },
+    settings: {
+      type: 'object',
+      properties: {
+        timeout: { type: 'number', minimum: 1000, maximum: 60000 },
+        retries: { type: 'number', minimum: 0, maximum: 5 },
+      },
+    },
+    tags: {
+      type: 'array',
+      items: { type: 'string' },
+    },
+  },
+  required: ['name', 'enabled'],
+  ...isNotEmpty('name'),
+};
+```
+
+## Message Validation Schemas
+
+### Send Message Validation
+```typescript
+const numberDefinition = {
+  type: 'string',
+  pattern: '^\\d+[\\.@\\w-]+',
+  description: 'Invalid number',
+};
+
+export const sendTextSchema: JSONSchema7 = {
+  $id: v4(),
+  type: 'object',
+  properties: {
+    number: numberDefinition,
+    text: { type: 'string', minLength: 1, maxLength: 4096 },
+    delay: { type: 'number', minimum: 0, maximum: 60000 },
+    linkPreview: { type: 'boolean' },
+    mentionsEveryOne: { type: 'boolean' },
+    mentioned: {
+      type: 'array',
+      items: { type: 'string' },
+    },
+  },
+  required: ['number', 'text'],
+  ...isNotEmpty('number', 'text'),
+};
+
+export const sendMediaSchema = Joi.object({
+  number: Joi.string().required().pattern(/^\d+$/),
+  mediatype: Joi.string().required().valid('image', 'video', 'audio', 'document'),
+  media: Joi.alternatives().try(
+    Joi.string().uri(),
+    Joi.string().base64(),
+  ).required(),
+  caption: Joi.string().optional().max(1024),
+  fileName: Joi.string().optional().max(255),
+  delay: Joi.number().optional().min(0).max(60000),
+}).required();
+
+export const sendButtonsSchema = Joi.object({
+  number: Joi.string().required().pattern(/^\d+$/),
+  title: Joi.string().required().max(1024),
+  description: Joi.string().optional().max(1024),
+  footer: Joi.string().optional().max(60),
+  buttons: Joi.array().items(
+    Joi.object({
+      type: Joi.string().required().valid('replyButton', 'urlButton', 'callButton'),
+      displayText: Joi.string().required().max(20),
+      id: Joi.string().when('type', {
+        is: 'replyButton',
+        then: Joi.required().max(256),
+        otherwise: Joi.optional(),
+      }),
+      url: Joi.string().when('type', {
+        is: 'urlButton',
+        then: Joi.required().uri(),
+        otherwise: Joi.optional(),
+      }),
+      phoneNumber: Joi.string().when('type', {
+        is: 'callButton',
+        then: Joi.required().pattern(/^\+?\d+$/),
+        otherwise: Joi.optional(),
+      }),
+    })
+  ).min(1).max(3).required(),
+}).required();
+```
+
+## Instance Validation Schemas
+
+### Instance Creation Validation
+```typescript
+export const instanceSchema = Joi.object({
+  instanceName: Joi.string().required().min(1).max(100).pattern(/^[a-zA-Z0-9_-]+$/),
+  integration: Joi.string().required().valid('WHATSAPP-BAILEYS', 'WHATSAPP-BUSINESS', 'EVOLUTION'),
+  token: Joi.string().when('integration', {
+    is: Joi.valid('WHATSAPP-BUSINESS', 'EVOLUTION'),
+    then: Joi.required().min(10),
+    otherwise: Joi.optional(),
+  }),
+  qrcode: Joi.boolean().optional().default(false),
+  number: Joi.string().optional().pattern(/^\d+$/),
+  businessId: Joi.string().when('integration', {
+    is: 'WHATSAPP-BUSINESS',
+    then: Joi.required(),
+    otherwise: Joi.optional(),
+  }),
+}).required();
+
+export const settingsSchema = Joi.object({
+  rejectCall: Joi.boolean().optional(),
+  msgCall: Joi.string().optional().max(500),
+  groupsIgnore: Joi.boolean().optional(),
+  alwaysOnline: Joi.boolean().optional(),
+  readMessages: Joi.boolean().optional(),
+  readStatus: Joi.boolean().optional(),
+  syncFullHistory: Joi.boolean().optional(),
+  wavoipToken: Joi.string().optional(),
+}).optional();
+
+export const proxySchema = Joi.object({
+  host: Joi.string().required().hostname(),
+  port: Joi.string().required().pattern(/^\d+$/).custom((value) => {
+    const port = parseInt(value);
+    if (port < 1 || port > 65535) {
+      throw new Error('Port must be between 1 and 65535');
+    }
+    return value;
+  }),
+  protocol: Joi.string().required().valid('http', 'https', 'socks4', 'socks5'),
+  username: Joi.string().optional(),
+  password: Joi.string().optional(),
+}).optional();
+```
+
+## Webhook Validation Schemas
+
+### Webhook Configuration Validation
+```typescript
+export const webhookSchema = Joi.object({
+  enabled: Joi.boolean().required(),
+  url: Joi.string().when('enabled', {
+    is: true,
+    then: Joi.required().uri({ scheme: ['http', 'https'] }),
+    otherwise: Joi.optional(),
+  }),
+  events: Joi.array().items(
+    Joi.string().valid(
+      'APPLICATION_STARTUP',
+      'INSTANCE_CREATE',
+      'INSTANCE_DELETE',
+      'QRCODE_UPDATED',
+      'CONNECTION_UPDATE',
+      'STATUS_INSTANCE',
+      'MESSAGES_SET',
+      'MESSAGES_UPSERT',
+      'MESSAGES_UPDATE',
+      'MESSAGES_DELETE',
+      'CONTACTS_SET',
+      'CONTACTS_UPSERT',
+      'CONTACTS_UPDATE',
+      'CHATS_SET',
+      'CHATS_UPDATE',
+      'CHATS_UPSERT',
+      'CHATS_DELETE',
+      'GROUPS_UPSERT',
+      'GROUPS_UPDATE',
+      'GROUP_PARTICIPANTS_UPDATE',
+      'CALL'
+    )
+  ).min(1).when('enabled', {
+    is: true,
+    then: Joi.required(),
+    otherwise: Joi.optional(),
+  }),
+  headers: Joi.object().pattern(
+    Joi.string(),
+    Joi.string()
+  ).optional(),
+  byEvents: Joi.boolean().optional().default(false),
+  base64: Joi.boolean().optional().default(false),
+}).required();
+```
+
+## Chatbot Validation Schemas
+
+### Base Chatbot Validation
+```typescript
+export const baseChatbotSchema = Joi.object({
+  enabled: Joi.boolean().required(),
+  description: Joi.string().required().min(1).max(500),
+  expire: Joi.number().optional().min(0).max(86400), // 24 hours in seconds
+  keywordFinish: Joi.string().optional().max(100),
+  delayMessage: Joi.number().optional().min(0).max(10000),
+  unknownMessage: Joi.string().optional().max(1000),
+  listeningFromMe: Joi.boolean().optional().default(false),
+  stopBotFromMe: Joi.boolean().optional().default(false),
+  keepOpen: Joi.boolean().optional().default(false),
+  debounceTime: Joi.number().optional().min(0).max(60000),
+  triggerType: Joi.string().required().valid('ALL', 'KEYWORD', 'REGEX'),
+  triggerOperator: Joi.string().when('triggerType', {
+    is: 'KEYWORD',
+    then: Joi.required().valid('EQUALS', 'CONTAINS', 'STARTS_WITH', 'ENDS_WITH'),
+    otherwise: Joi.optional(),
+  }),
+  triggerValue: Joi.string().when('triggerType', {
+    is: Joi.valid('KEYWORD', 'REGEX'),
+    then: Joi.required().min(1).max(500),
+    otherwise: Joi.optional(),
+  }),
+  ignoreJids: Joi.array().items(Joi.string()).optional(),
+  splitMessages: Joi.boolean().optional().default(false),
+  timePerChar: Joi.number().optional().min(10).max(1000).default(100),
+}).required();
+
+export const typebotSchema = baseChatbotSchema.keys({
+  url: Joi.string().required().uri({ scheme: ['http', 'https'] }),
+  typebot: Joi.string().required().min(1).max(100),
+  apiVersion: Joi.string().optional().valid('v1', 'v2').default('v1'),
+}).required();
+
+export const openaiSchema = baseChatbotSchema.keys({
+  apiKey: Joi.string().required().min(10),
+  model: Joi.string().optional().valid(
+    'gpt-3.5-turbo',
+    'gpt-3.5-turbo-16k',
+    'gpt-4',
+    'gpt-4-32k',
+    'gpt-4-turbo-preview'
+  ).default('gpt-3.5-turbo'),
+  systemMessage: Joi.string().optional().max(2000),
+  maxTokens: Joi.number().optional().min(1).max(4000).default(1000),
+  temperature: Joi.number().optional().min(0).max(2).default(0.7),
+}).required();
+```
+
+## Business API Validation Schemas
+
+### Template Validation
+```typescript
+export const templateSchema = Joi.object({
+  name: Joi.string().required().min(1).max(512).pattern(/^[a-z0-9_]+$/),
+  category: Joi.string().required().valid('MARKETING', 'UTILITY', 'AUTHENTICATION'),
+  allowCategoryChange: Joi.boolean().required(),
+  language: Joi.string().required().pattern(/^[a-z]{2}_[A-Z]{2}$/), // e.g., pt_BR, en_US
+  components: Joi.array().items(
+    Joi.object({
+      type: Joi.string().required().valid('HEADER', 'BODY', 'FOOTER', 'BUTTONS'),
+      format: Joi.string().when('type', {
+        is: 'HEADER',
+        then: Joi.valid('TEXT', 'IMAGE', 'VIDEO', 'DOCUMENT'),
+        otherwise: Joi.optional(),
+      }),
+      text: Joi.string().when('type', {
+        is: Joi.valid('HEADER', 'BODY', 'FOOTER'),
+        then: Joi.required().min(1).max(1024),
+        otherwise: Joi.optional(),
+      }),
+      buttons: Joi.array().when('type', {
+        is: 'BUTTONS',
+        then: Joi.items(
+          Joi.object({
+            type: Joi.string().required().valid('QUICK_REPLY', 'URL', 'PHONE_NUMBER'),
+            text: Joi.string().required().min(1).max(25),
+            url: Joi.string().when('type', {
+              is: 'URL',
+              then: Joi.required().uri(),
+              otherwise: Joi.optional(),
+            }),
+            phone_number: Joi.string().when('type', {
+              is: 'PHONE_NUMBER',
+              then: Joi.required().pattern(/^\+?\d+$/),
+              otherwise: Joi.optional(),
+            }),
+          })
+        ).min(1).max(10),
+        otherwise: Joi.optional(),
+      }),
+    })
+  ).min(1).required(),
+  webhookUrl: Joi.string().optional().uri({ scheme: ['http', 'https'] }),
+}).required();
+
+export const catalogSchema = Joi.object({
+  number: Joi.string().optional().pattern(/^\d+$/),
+  limit: Joi.number().optional().min(1).max(1000).default(10),
+  cursor: Joi.string().optional(),
+}).optional();
+```
+
+## Group Validation Schemas
+
+### Group Management Validation
+```typescript
+export const createGroupSchema = Joi.object({
+  subject: Joi.string().required().min(1).max(100),
+  description: Joi.string().optional().max(500),
+  participants: Joi.array().items(
+    Joi.string().pattern(/^\d+$/)
+  ).min(1).max(256).required(),
+  promoteParticipants: Joi.boolean().optional().default(false),
+}).required();
+
+export const updateGroupSchema = Joi.object({
+  subject: Joi.string().optional().min(1).max(100),
+  description: Joi.string().optional().max(500),
+}).min(1).required();
+
+export const groupParticipantsSchema = Joi.object({
+  participants: Joi.array().items(
+    Joi.string().pattern(/^\d+$/)
+  ).min(1).max(50).required(),
+  action: Joi.string().required().valid('add', 'remove', 'promote', 'demote'),
+}).required();
+```
+
+## Label Validation Schemas
+
+### Label Management Validation
+```typescript
+export const labelSchema = Joi.object({
+  name: Joi.string().required().min(1).max(100),
+  color: Joi.string().required().pattern(/^#[0-9A-Fa-f]{6}$/), // Hex color
+  predefinedId: Joi.string().optional(),
+}).required();
+
+export const handleLabelSchema = Joi.object({
+  number: Joi.string().required().pattern(/^\d+$/),
+  labelId: Joi.string().required(),
+  action: Joi.string().required().valid('add', 'remove'),
+}).required();
+```
+
+## Custom Validation Functions
+
+### Phone Number Validation
+```typescript
+export function validatePhoneNumber(number: string): boolean {
+  // Remove any non-digit characters
+  const cleaned = number.replace(/\D/g, '');
+  
+  // Check minimum and maximum length
+  if (cleaned.length < 10 || cleaned.length > 15) {
+    return false;
+  }
+  
+  // Check for valid country codes (basic validation)
+  const validCountryCodes = ['1', '7', '20', '27', '30', '31', '32', '33', '34', '36', '39', '40', '41', '43', '44', '45', '46', '47', '48', '49', '51', '52', '53', '54', '55', '56', '57', '58', '60', '61', '62', '63', '64', '65', '66', '81', '82', '84', '86', '90', '91', '92', '93', '94', '95', '98'];
+  
+  // Check if starts with valid country code
+  const startsWithValidCode = validCountryCodes.some(code => cleaned.startsWith(code));
+  
+  return startsWithValidCode;
+}
+
+export const phoneNumberValidator = Joi.string().custom((value, helpers) => {
+  if (!validatePhoneNumber(value)) {
+    return helpers.error('any.invalid');
+  }
+  return value;
+}, 'Phone number validation');
+```
+
+### Base64 Validation
+```typescript
+export function validateBase64(base64: string): boolean {
+  try {
+    // Check if it's a valid base64 string
+    const decoded = Buffer.from(base64, 'base64').toString('base64');
+    return decoded === base64;
+  } catch {
+    return false;
+  }
+}
+
+export const base64Validator = Joi.string().custom((value, helpers) => {
+  if (!validateBase64(value)) {
+    return helpers.error('any.invalid');
+  }
+  return value;
+}, 'Base64 validation');
+```
+
+### URL Validation with Protocol Check
+```typescript
+export function validateWebhookUrl(url: string): boolean {
+  try {
+    const parsed = new URL(url);
+    return ['http:', 'https:'].includes(parsed.protocol);
+  } catch {
+    return false;
+  }
+}
+
+export const webhookUrlValidator = Joi.string().custom((value, helpers) => {
+  if (!validateWebhookUrl(value)) {
+    return helpers.error('any.invalid');
+  }
+  return value;
+}, 'Webhook URL validation');
+```
+
+## Validation Error Handling
+
+### Error Message Customization
+```typescript
+export const validationMessages = {
+  'any.required': 'O campo {#label} é obrigatório',
+  'string.empty': 'O campo {#label} não pode estar vazio',
+  'string.min': 'O campo {#label} deve ter pelo menos {#limit} caracteres',
+  'string.max': 'O campo {#label} deve ter no máximo {#limit} caracteres',
+  'string.pattern.base': 'O campo {#label} possui formato inválido',
+  'number.min': 'O campo {#label} deve ser maior ou igual a {#limit}',
+  'number.max': 'O campo {#label} deve ser menor ou igual a {#limit}',
+  'array.min': 'O campo {#label} deve ter pelo menos {#limit} itens',
+  'array.max': 'O campo {#label} deve ter no máximo {#limit} itens',
+  'any.only': 'O campo {#label} deve ser um dos valores: {#valids}',
+};
+
+export function formatValidationError(error: Joi.ValidationError): any {
+  return {
+    message: 'Dados de entrada inválidos',
+    details: error.details.map(detail => ({
+      field: detail.path.join('.'),
+      message: detail.message,
+      value: detail.context?.value,
+    })),
+  };
+}
+```
+
+## Schema Composition
+
+### Reusable Schema Components
+```typescript
+export const commonFields = {
+  instanceName: Joi.string().required().min(1).max(100).pattern(/^[a-zA-Z0-9_-]+$/),
+  number: phoneNumberValidator.required(),
+  delay: Joi.number().optional().min(0).max(60000),
+  enabled: Joi.boolean().optional().default(true),
+};
+
+export const mediaFields = {
+  mediatype: Joi.string().required().valid('image', 'video', 'audio', 'document'),
+  media: Joi.alternatives().try(
+    Joi.string().uri(),
+    base64Validator,
+  ).required(),
+  caption: Joi.string().optional().max(1024),
+  fileName: Joi.string().optional().max(255),
+};
+
+// Compose schemas using common fields
+export const quickMessageSchema = Joi.object({
+  ...commonFields,
+  text: Joi.string().required().min(1).max(4096),
+}).required();
+
+export const quickMediaSchema = Joi.object({
+  ...commonFields,
+  ...mediaFields,
+}).required();
+```

.env.example

@@ -1,3 +1,4 @@
+SERVER_NAME=evolution
 SERVER_TYPE=http
 SERVER_PORT=8080
 # Server URL - Set your application url
@@ -8,6 +9,28 @@ SSL_CONF_FULLCHAIN=/path/to/cert.crt
 
 SENTRY_DSN=
 
+# Telemetry - Set to false to disable telemetry
+TELEMETRY_ENABLED=true
+TELEMETRY_URL=
+
+# Prometheus metrics - Set to true to enable Prometheus metrics
+PROMETHEUS_METRICS=false
+METRICS_AUTH_REQUIRED=true
+METRICS_USER=prometheus
+METRICS_PASSWORD=secure_random_password_here
+METRICS_ALLOWED_IPS=127.0.0.1,10.0.0.100,192.168.1.50
+
+# Proxy configuration (optional)
+PROXY_HOST=
+PROXY_PORT=
+PROXY_PROTOCOL=
+PROXY_USERNAME=
+PROXY_PASSWORD=
+
+# Audio converter API (optional)
+API_AUDIO_CONVERTER=
+API_AUDIO_CONVERTER_KEY=
+
 # Cors - * for all or set separate by commas -  ex.: 'yourdomain1.com, yourdomain2.com'
 CORS_ORIGIN=*
 CORS_METHODS=GET,POST,PUT,DELETE
@@ -96,9 +119,40 @@ SQS_SECRET_ACCESS_KEY=
 SQS_ACCOUNT_ID=
 SQS_REGION=
 
+SQS_GLOBAL_ENABLED=false
+SQS_GLOBAL_FORCE_SINGLE_QUEUE=false
+SQS_GLOBAL_APPLICATION_STARTUP=false
+SQS_GLOBAL_CALL=false
+SQS_GLOBAL_CHATS_DELETE=false
+SQS_GLOBAL_CHATS_SET=false
+SQS_GLOBAL_CHATS_UPDATE=false
+SQS_GLOBAL_CHATS_UPSERT=false
+SQS_GLOBAL_CONNECTION_UPDATE=false
+SQS_GLOBAL_CONTACTS_SET=false
+SQS_GLOBAL_CONTACTS_UPDATE=false
+SQS_GLOBAL_CONTACTS_UPSERT=false
+SQS_GLOBAL_GROUP_PARTICIPANTS_UPDATE=false
+SQS_GLOBAL_GROUPS_UPDATE=false
+SQS_GLOBAL_GROUPS_UPSERT=false
+SQS_GLOBAL_LABELS_ASSOCIATION=false
+SQS_GLOBAL_LABELS_EDIT=false
+SQS_GLOBAL_LOGOUT_INSTANCE=false
+SQS_GLOBAL_MESSAGES_DELETE=false
+SQS_GLOBAL_MESSAGES_EDITED=false
+SQS_GLOBAL_MESSAGES_SET=false
+SQS_GLOBAL_MESSAGES_UPDATE=false
+SQS_GLOBAL_MESSAGES_UPSERT=false
+SQS_GLOBAL_PRESENCE_UPDATE=false
+SQS_GLOBAL_QRCODE_UPDATED=false
+SQS_GLOBAL_REMOVE_INSTANCE=false
+SQS_GLOBAL_SEND_MESSAGE=false
+SQS_GLOBAL_TYPEBOT_CHANGE_STATUS=false
+SQS_GLOBAL_TYPEBOT_START=false
+
 # Websocket - Environment variables
 WEBSOCKET_ENABLED=false
 WEBSOCKET_GLOBAL_EVENTS=false
+WEBSOCKET_ALLOWED_HOSTS=127.0.0.1,::1,::ffff:127.0.0.1
 
 # Pusher - Environment variables
 PUSHER_ENABLED=false
@@ -136,6 +190,60 @@ PUSHER_EVENTS_CALL=true
 PUSHER_EVENTS_TYPEBOT_START=false
 PUSHER_EVENTS_TYPEBOT_CHANGE_STATUS=false
 
+# Kafka - Environment variables
+KAFKA_ENABLED=false
+KAFKA_CLIENT_ID=evolution-api
+KAFKA_BROKERS=localhost:9092
+KAFKA_CONNECTION_TIMEOUT=3000
+KAFKA_REQUEST_TIMEOUT=30000
+# Global events - By enabling this variable, events from all instances are sent to global Kafka topics.
+KAFKA_GLOBAL_ENABLED=false
+KAFKA_CONSUMER_GROUP_ID=evolution-api-consumers
+KAFKA_TOPIC_PREFIX=evolution
+KAFKA_NUM_PARTITIONS=1
+KAFKA_REPLICATION_FACTOR=1
+KAFKA_AUTO_CREATE_TOPICS=false
+# Choose the events you want to send to Kafka
+KAFKA_EVENTS_APPLICATION_STARTUP=false
+KAFKA_EVENTS_INSTANCE_CREATE=false
+KAFKA_EVENTS_INSTANCE_DELETE=false
+KAFKA_EVENTS_QRCODE_UPDATED=false
+KAFKA_EVENTS_MESSAGES_SET=false
+KAFKA_EVENTS_MESSAGES_UPSERT=false
+KAFKA_EVENTS_MESSAGES_EDITED=false
+KAFKA_EVENTS_MESSAGES_UPDATE=false
+KAFKA_EVENTS_MESSAGES_DELETE=false
+KAFKA_EVENTS_SEND_MESSAGE=false
+KAFKA_EVENTS_SEND_MESSAGE_UPDATE=false
+KAFKA_EVENTS_CONTACTS_SET=false
+KAFKA_EVENTS_CONTACTS_UPSERT=false
+KAFKA_EVENTS_CONTACTS_UPDATE=false
+KAFKA_EVENTS_PRESENCE_UPDATE=false
+KAFKA_EVENTS_CHATS_SET=false
+KAFKA_EVENTS_CHATS_UPSERT=false
+KAFKA_EVENTS_CHATS_UPDATE=false
+KAFKA_EVENTS_CHATS_DELETE=false
+KAFKA_EVENTS_GROUPS_UPSERT=false
+KAFKA_EVENTS_GROUPS_UPDATE=false
+KAFKA_EVENTS_GROUP_PARTICIPANTS_UPDATE=false
+KAFKA_EVENTS_CONNECTION_UPDATE=false
+KAFKA_EVENTS_LABELS_EDIT=false
+KAFKA_EVENTS_LABELS_ASSOCIATION=false
+KAFKA_EVENTS_CALL=false
+KAFKA_EVENTS_TYPEBOT_START=false
+KAFKA_EVENTS_TYPEBOT_CHANGE_STATUS=false
+# SASL Authentication (optional)
+KAFKA_SASL_ENABLED=false
+KAFKA_SASL_MECHANISM=plain
+KAFKA_SASL_USERNAME=
+KAFKA_SASL_PASSWORD=
+# SSL Configuration (optional)
+KAFKA_SSL_ENABLED=false
+KAFKA_SSL_REJECT_UNAUTHORIZED=true
+KAFKA_SSL_CA=
+KAFKA_SSL_KEY=
+KAFKA_SSL_CERT=
+
 # WhatsApp Business API - Environment variables
 # Token used to validate the webhook on the Facebook APP
 WA_BUSINESS_TOKEN_WEBHOOK=evolution

.eslintrc.js

@@ -31,16 +31,9 @@ module.exports = {
     'import/no-duplicates': 'error',
     'simple-import-sort/imports': 'error',
     'simple-import-sort/exports': 'error',
-    '@typescript-eslint/ban-types': [
-      'error',
-      {
-        extendDefaults: true,
-        types: {
-          '{}': false,
-          Object: false,
-        },
-      },
-    ],
+    '@typescript-eslint/no-empty-object-type': 'off',
+    '@typescript-eslint/no-wrapper-object-types': 'off',
+    '@typescript-eslint/no-unused-expressions': 'off',
     'prettier/prettier': ['error', { endOfLine: 'auto' }],
   },
 };

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,81 @@
+name: 🐛 Bug Report
+description: Report a bug or unexpected behavior
+title: "[BUG] "
+labels: ["bug", "needs-triage"]
+assignees: []
+
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to fill out this bug report! 
+        Please search existing issues before creating a new one.
+
+  - type: textarea
+    id: description
+    attributes:
+      label: 📋 Bug Description
+      description: A clear and concise description of what the bug is.
+      placeholder: Describe the bug...
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: 🔄 Steps to Reproduce
+      description: Steps to reproduce the behavior
+      placeholder: |
+        1. Go to '...'
+        2. Click on '....'
+        3. Scroll down to '....'
+        4. See error
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: ✅ Expected Behavior
+      description: A clear and concise description of what you expected to happen.
+      placeholder: What should happen?
+    validations:
+      required: true
+
+  - type: textarea
+    id: actual
+    attributes:
+      label: ❌ Actual Behavior
+      description: A clear and concise description of what actually happened.
+      placeholder: What actually happened?
+    validations:
+      required: true
+
+  - type: textarea
+    id: environment
+    attributes:
+      label: 🌍 Environment
+      description: Please provide information about your environment
+      value: |
+        - OS: [e.g. Ubuntu 20.04, Windows 10, macOS 12.0]
+        - Node.js version: [e.g. 18.17.0]
+        - Evolution API version: [e.g. 2.3.7]
+        - Database: [e.g. PostgreSQL 14, MySQL 8.0]
+        - Connection type: [e.g. Baileys, WhatsApp Business API]
+    validations:
+      required: true
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: 📋 Logs
+      description: If applicable, add logs to help explain your problem.
+      placeholder: Paste relevant logs here...
+      render: shell
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: 📝 Additional Context
+      description: Add any other context about the problem here.
+      placeholder: Any additional information...

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,85 @@
+name: ✨ Feature Request
+description: Suggest a new feature or enhancement
+title: "[FEATURE] "
+labels: ["enhancement", "needs-triage"]
+assignees: []
+
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for suggesting a new feature! 
+        Please check our [Feature Requests on Canny](https://evolutionapi.canny.io/feature-requests) first.
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: 🎯 Problem Statement
+      description: Is your feature request related to a problem? Please describe.
+      placeholder: A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+    validations:
+      required: true
+
+  - type: textarea
+    id: solution
+    attributes:
+      label: 💡 Proposed Solution
+      description: Describe the solution you'd like
+      placeholder: A clear and concise description of what you want to happen.
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: 🔄 Alternatives Considered
+      description: Describe alternatives you've considered
+      placeholder: A clear and concise description of any alternative solutions or features you've considered.
+
+  - type: dropdown
+    id: priority
+    attributes:
+      label: 📊 Priority
+      description: How important is this feature to you?
+      options:
+        - Low - Nice to have
+        - Medium - Would be helpful
+        - High - Important for my use case
+        - Critical - Blocking my work
+    validations:
+      required: true
+
+  - type: dropdown
+    id: component
+    attributes:
+      label: 🧩 Component
+      description: Which component does this feature relate to?
+      options:
+        - WhatsApp Integration (Baileys)
+        - WhatsApp Business API
+        - Chatwoot Integration
+        - Typebot Integration
+        - OpenAI Integration
+        - Dify Integration
+        - API Endpoints
+        - Database
+        - Authentication
+        - Webhooks
+        - File Storage
+        - Other
+
+  - type: textarea
+    id: use_case
+    attributes:
+      label: 🎯 Use Case
+      description: Describe your specific use case for this feature
+      placeholder: How would you use this feature? What problem does it solve for you?
+    validations:
+      required: true
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: 📝 Additional Context
+      description: Add any other context, screenshots, or examples about the feature request here.
+      placeholder: Any additional information, mockups, or examples...

.github/pull_request_template.md

@@ -0,0 +1,41 @@
+## 📋 Description
+<!-- Describe your changes in detail -->
+
+## 🔗 Related Issue
+<!-- Link to the issue this PR addresses -->
+Closes #(issue_number)
+
+## 🧪 Type of Change
+<!-- Mark with an `x` all the checkboxes that apply -->
+- [ ] 🐛 Bug fix (non-breaking change which fixes an issue)
+- [ ] ✨ New feature (non-breaking change which adds functionality)
+- [ ] 💥 Breaking change (fix or feature that would cause existing functionality to not work as expected)
+- [ ] 📚 Documentation update
+- [ ] 🔧 Refactoring (no functional changes)
+- [ ] ⚡ Performance improvement
+- [ ] 🧹 Code cleanup
+- [ ] 🔒 Security fix
+
+## 🧪 Testing
+<!-- Describe the testing you performed to verify your changes -->
+- [ ] Manual testing completed
+- [ ] Functionality verified in development environment
+- [ ] No breaking changes introduced
+- [ ] Tested with different connection types (if applicable)
+
+## 📸 Screenshots (if applicable)
+<!-- Add screenshots to help explain your changes -->
+
+## ✅ Checklist
+<!-- Mark with an `x` all the checkboxes that apply -->
+- [ ] My code follows the project's style guidelines
+- [ ] I have performed a self-review of my code
+- [ ] I have commented my code, particularly in hard-to-understand areas
+- [ ] I have made corresponding changes to the documentation
+- [ ] My changes generate no new warnings
+- [ ] I have manually tested my changes thoroughly
+- [ ] I have verified the changes work with different scenarios
+- [ ] Any dependent changes have been merged and published
+
+## 📝 Additional Notes
+<!-- Any additional information, concerns, or questions -->

.github/workflows/check_code_quality.yml

@@ -1,6 +1,10 @@
 name: Check Code Quality
 
-on: [pull_request]
+on: 
+  pull_request:
+    branches: [ main, develop ]
+  push:
+    branches: [ main, develop ]
 
 jobs:
   check-lint-and-build:
@@ -8,20 +12,30 @@ jobs:
     timeout-minutes: 10
 
     steps:
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v5
+      with:
+        submodules: recursive
 
     - name: Install Node
-      uses: actions/setup-node@v1
+      uses: actions/setup-node@v5
       with:
         node-version: 20.x
 
+    - name: Cache node modules
+      uses: actions/cache@v4
+      with:
+        path: ~/.npm
+        key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }}
+        restore-keys: |
+          ${{ runner.os }}-node-
+
     - name: Install packages
-      run: npm install
+      run: npm ci
     
     - name: Check linting
       run: npm run lint:check
 
-    - name: Check build
+    - name: Generate Prisma client
       run: npm run db:generate
 
     - name: Check build

.github/workflows/publish_docker_image.yml

@@ -14,7 +14,9 @@ jobs:
       packages: write
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
+        with:
+          submodules: recursive
 
       - name: Docker meta
         id: meta
@@ -37,7 +39,7 @@ jobs:
 
       - name: Build and push
         id: docker_build
-        uses: docker/build-push-action@v5
+        uses: docker/build-push-action@v6
         with:
           platforms: linux/amd64,linux/arm64
           push: true

.github/workflows/publish_docker_image_homolog.yml

@@ -14,7 +14,9 @@ jobs:
       packages: write
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
+        with:
+          submodules: recursive
 
       - name: Docker meta
         id: meta
@@ -37,7 +39,7 @@ jobs:
 
       - name: Build and push
         id: docker_build
-        uses: docker/build-push-action@v5
+        uses: docker/build-push-action@v6
         with:
           platforms: linux/amd64,linux/arm64
           push: true

.github/workflows/publish_docker_image_latest.yml

@@ -14,7 +14,9 @@ jobs:
       packages: write
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
+        with:
+          submodules: recursive
 
       - name: Docker meta
         id: meta
@@ -37,7 +39,7 @@ jobs:
 
       - name: Build and push
         id: docker_build
-        uses: docker/build-push-action@v5
+        uses: docker/build-push-action@v6
         with:
           platforms: linux/amd64,linux/arm64
           push: true

.github/workflows/security.yml

@@ -0,0 +1,55 @@
+name: Security Scan
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main, develop ]
+  schedule:
+    - cron: '0 0 * * 1' # Weekly on Mondays
+
+jobs:
+  codeql:
+    name: CodeQL Analysis
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    permissions:
+      actions: read
+      contents: read
+      security-events: write
+
+    strategy:
+      fail-fast: false
+      matrix:
+        language: [ 'javascript' ]
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v5
+      with:
+        submodules: recursive
+
+    - name: Initialize CodeQL
+      uses: github/codeql-action/init@v3
+      with:
+        languages: ${{ matrix.language }}
+
+    - name: Autobuild
+      uses: github/codeql-action/autobuild@v3
+
+    - name: Perform CodeQL Analysis
+      uses: github/codeql-action/analyze@v3
+      with:
+        category: "/language:${{matrix.language}}"
+
+  dependency-review:
+    name: Dependency Review
+    runs-on: ubuntu-latest
+    if: github.event_name == 'pull_request'
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v5
+        with:
+          submodules: recursive
+      - name: Dependency Review
+        uses: actions/dependency-review-action@v4

.gitignore

@@ -1,13 +1,11 @@
+# Repo
+Baileys
 # compiled output
 /dist
 /node_modules
 
-.cursor*
-
 /Docker/.env
 
-.vscode
-
 # Logs
 logs/**.json
 *.log

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "evolution-manager-v2"]
+	path = evolution-manager-v2
+	url = https://github.com/EvolutionAPI/evolution-manager-v2.git

.husky/README.md

@@ -0,0 +1,51 @@
+# Git Hooks Configuration
+
+Este projeto usa [Husky](https://typicode.github.io/husky/) para automatizar verificações de qualidade de código.
+
+## Hooks Configurados
+
+### Pre-commit
+- **Arquivo**: `.husky/pre-commit`
+- **Executa**: `npx lint-staged`
+- **Função**: Executa lint e correções automáticas apenas nos arquivos modificados
+
+### Pre-push  
+- **Arquivo**: `.husky/pre-push`
+- **Executa**: `npm run build` + `npm run lint:check`
+- **Função**: Verifica se o projeto compila e não tem erros de lint antes do push
+
+## Lint-staged Configuration
+
+Configurado no `package.json`:
+
+```json
+"lint-staged": {
+  "src/**/*.{ts,js}": [
+    "eslint --fix",
+    "git add"
+  ],
+  "src/**/*.ts": [
+    "npm run build"
+  ]
+}
+```
+
+## Como funciona
+
+1. **Ao fazer commit**: Executa lint apenas nos arquivos modificados
+2. **Ao fazer push**: Executa build completo e verificação de lint
+3. **Se houver erros**: O commit/push é bloqueado até correção
+
+## Comandos úteis
+
+```bash
+# Pular hooks (não recomendado)
+git commit --no-verify
+git push --no-verify
+
+# Executar lint manualmente
+npm run lint
+
+# Executar build manualmente  
+npm run build
+```

.husky/commit-msg

@@ -0,0 +1 @@
+npx --no -- commitlint --edit $1

.husky/pre-commit

@@ -0,0 +1 @@
+npx lint-staged

.husky/pre-push

@@ -0,0 +1,2 @@
+npm run build
+npm run lint:check

AGENTS.md

@@ -0,0 +1,355 @@
+# Evolution API - AI Agent Guidelines
+
+This document provides comprehensive guidelines for AI agents (Claude, GPT, Cursor, etc.) working with the Evolution API codebase.
+
+## Project Overview
+
+**Evolution API** is a production-ready, multi-tenant WhatsApp API platform built with Node.js, TypeScript, and Express.js. It supports multiple WhatsApp providers and extensive integrations with chatbots, CRM systems, and messaging platforms.
+
+## Project Structure & Module Organization
+
+### Core Directories
+- **`src/`** – TypeScript source code with modular architecture
+  - `api/controllers/` – HTTP route handlers (thin layer)
+  - `api/services/` – Business logic (core functionality)
+  - `api/routes/` – Express route definitions (RouterBroker pattern)
+  - `api/integrations/` – External service integrations
+    - `channel/` – WhatsApp providers (Baileys, Business API, Evolution)
+    - `chatbot/` – AI/Bot integrations (OpenAI, Dify, Typebot, Chatwoot)
+    - `event/` – Event systems (WebSocket, RabbitMQ, SQS, NATS, Pusher)
+    - `storage/` – File storage (S3, MinIO)
+  - `dto/` – Data Transfer Objects (simple classes, no decorators)
+  - `guards/` – Authentication/authorization middleware
+  - `types/` – TypeScript type definitions
+  - `repository/` – Data access layer (Prisma)
+- **`prisma/`** – Database schemas and migrations
+  - `postgresql-schema.prisma` / `mysql-schema.prisma` – Provider-specific schemas
+  - `postgresql-migrations/` / `mysql-migrations/` – Provider-specific migrations
+- **`config/`** – Environment and application configuration
+- **`utils/`** – Shared utilities and helper functions
+- **`validate/`** – JSONSchema7 validation schemas
+- **`exceptions/`** – Custom HTTP exception classes
+- **`cache/`** – Redis and local cache implementations
+
+### Build & Deployment
+- **`dist/`** – Build output (do not edit directly)
+- **`public/`** – Static assets and media files
+- **`Docker*`**, **`docker-compose*.yaml`** – Containerization and local development stack
+
+## Build, Test, and Development Commands
+
+### Development Workflow
+```bash
+# Development server with hot reload
+npm run dev:server
+
+# Direct execution for testing
+npm start
+
+# Production build and run
+npm run build
+npm run start:prod
+```
+
+### Code Quality
+```bash
+# Linting and formatting
+npm run lint        # ESLint with auto-fix
+npm run lint:check  # ESLint check only
+
+# Commit with conventional commits
+npm run commit      # Interactive commit with Commitizen
+```
+
+### Database Management
+```bash
+# Set database provider first (CRITICAL)
+export DATABASE_PROVIDER=postgresql  # or mysql
+
+# Generate Prisma client
+npm run db:generate
+
+# Development migrations (with provider sync)
+npm run db:migrate:dev      # Unix/Mac
+npm run db:migrate:dev:win  # Windows
+
+# Production deployment
+npm run db:deploy      # Unix/Mac
+npm run db:deploy:win  # Windows
+
+# Database tools
+npm run db:studio      # Open Prisma Studio
+```
+
+### Docker Development
+```bash
+# Start local services (Redis, PostgreSQL, etc.)
+docker-compose up -d
+
+# Full development stack
+docker-compose -f docker-compose.dev.yaml up -d
+```
+
+## Coding Standards & Architecture Patterns
+
+### Code Style (Enforced by ESLint + Prettier)
+- **TypeScript strict mode** with full type coverage
+- **2-space indentation**, single quotes, trailing commas
+- **120-character line limit**
+- **Import order** via `simple-import-sort`
+- **File naming**: `feature.kind.ts` (e.g., `whatsapp.baileys.service.ts`)
+- **Naming conventions**:
+  - Classes: `PascalCase`
+  - Functions/variables: `camelCase`
+  - Constants: `UPPER_SNAKE_CASE`
+  - Files: `kebab-case.type.ts`
+
+### Architecture Patterns
+
+#### Service Layer Pattern
+```typescript
+export class ExampleService {
+  constructor(private readonly waMonitor: WAMonitoringService) {}
+  
+  private readonly logger = new Logger('ExampleService');
+  
+  public async create(instance: InstanceDto, data: ExampleDto) {
+    // Business logic here
+    return { example: { ...instance, data } };
+  }
+  
+  public async find(instance: InstanceDto): Promise<ExampleDto | null> {
+    try {
+      const result = await this.waMonitor.waInstances[instance.instanceName].findData();
+      return result || null; // Return null on not found (Evolution pattern)
+    } catch (error) {
+      this.logger.error('Error finding data:', error);
+      return null; // Return null on error (Evolution pattern)
+    }
+  }
+}
+```
+
+#### Controller Pattern (Thin Layer)
+```typescript
+export class ExampleController {
+  constructor(private readonly exampleService: ExampleService) {}
+  
+  public async createExample(instance: InstanceDto, data: ExampleDto) {
+    return this.exampleService.create(instance, data);
+  }
+}
+```
+
+#### RouterBroker Pattern
+```typescript
+export class ExampleRouter extends RouterBroker {
+  constructor(...guards: any[]) {
+    super();
+    this.router.post(this.routerPath('create'), ...guards, async (req, res) => {
+      const response = await this.dataValidate<ExampleDto>({
+        request: req,
+        schema: exampleSchema, // JSONSchema7
+        ClassRef: ExampleDto,
+        execute: (instance, data) => controller.createExample(instance, data),
+      });
+      res.status(201).json(response);
+    });
+  }
+}
+```
+
+#### DTO Pattern (Simple Classes)
+```typescript
+// CORRECT - Evolution API pattern (no decorators)
+export class ExampleDto {
+  name: string;
+  description?: string;
+  enabled: boolean;
+}
+
+// INCORRECT - Don't use class-validator decorators
+export class BadExampleDto {
+  @IsString() // ❌ Evolution API doesn't use decorators
+  name: string;
+}
+```
+
+#### Validation Pattern (JSONSchema7)
+```typescript
+import { JSONSchema7 } from 'json-schema';
+import { v4 } from 'uuid';
+
+export const exampleSchema: JSONSchema7 = {
+  $id: v4(),
+  type: 'object',
+  properties: {
+    name: { type: 'string' },
+    description: { type: 'string' },
+    enabled: { type: 'boolean' },
+  },
+  required: ['name', 'enabled'],
+};
+```
+
+## Multi-Tenant Architecture
+
+### Instance Isolation
+- **CRITICAL**: All operations must be scoped by `instanceName` or `instanceId`
+- **Database queries**: Always include `where: { instanceId: ... }`
+- **Authentication**: Validate instance ownership before operations
+- **Data isolation**: Complete separation between tenant instances
+
+### WhatsApp Instance Management
+```typescript
+// Access instance via WAMonitoringService
+const waInstance = this.waMonitor.waInstances[instance.instanceName];
+if (!waInstance) {
+  throw new NotFoundException(`Instance ${instance.instanceName} not found`);
+}
+```
+
+## Database Patterns
+
+### Multi-Provider Support
+- **PostgreSQL**: Uses `@db.Integer`, `@db.JsonB`, `@default(now())`
+- **MySQL**: Uses `@db.Int`, `@db.Json`, `@default(now())`
+- **Environment**: Set `DATABASE_PROVIDER=postgresql` or `mysql`
+- **Migrations**: Provider-specific folders auto-selected
+
+### Prisma Repository Pattern
+```typescript
+// Always use PrismaRepository for database operations
+const result = await this.prismaRepository.instance.findUnique({
+  where: { name: instanceName },
+});
+```
+
+## Integration Patterns
+
+### Channel Integration (WhatsApp Providers)
+- **Baileys**: WhatsApp Web with QR code authentication
+- **Business API**: Official Meta WhatsApp Business API  
+- **Evolution API**: Custom WhatsApp integration
+- **Pattern**: Extend base channel service classes
+
+### Chatbot Integration
+- **Base classes**: Extend `BaseChatbotService` and `BaseChatbotController`
+- **Trigger system**: Support keyword, regex, and advanced triggers
+- **Session management**: Handle conversation state per user
+- **Available integrations**: EvolutionBot, OpenAI, Dify, Typebot, Chatwoot, Flowise, N8N, EvoAI
+
+### Event Integration
+- **Internal events**: EventEmitter2 for application events
+- **External events**: WebSocket, RabbitMQ, SQS, NATS, Pusher
+- **Webhook delivery**: Reliable delivery with retry logic
+
+## Testing Guidelines
+
+### Current State
+- **No formal test suite** currently implemented
+- **Manual testing** is the primary approach
+- **Integration testing** in development environment
+
+### Testing Strategy
+```typescript
+// Place tests in test/ directory as *.test.ts
+// Run: npm test (watches test/all.test.ts)
+
+describe('ExampleService', () => {
+  it('should create example', async () => {
+    // Mock external dependencies
+    // Test business logic
+    // Assert expected behavior
+  });
+});
+```
+
+### Recommended Approach
+- Focus on **critical business logic** in services
+- **Mock external dependencies** (WhatsApp APIs, databases)
+- **Integration tests** for API endpoints
+- **Manual testing** for WhatsApp connection flows
+
+## Commit & Pull Request Guidelines
+
+### Conventional Commits (Enforced by commitlint)
+```bash
+# Use interactive commit tool
+npm run commit
+
+# Commit format: type(scope): subject (max 100 chars)
+# Types: feat, fix, docs, style, refactor, perf, test, chore, ci, build, revert, security
+```
+
+### Examples
+- `feat(api): add WhatsApp message status endpoint`
+- `fix(baileys): resolve connection timeout issue`
+- `docs(readme): update installation instructions`
+- `refactor(service): extract common message validation logic`
+
+### Pull Request Requirements
+- **Clear description** of changes and motivation
+- **Linked issues** if applicable
+- **Migration impact** (specify database provider)
+- **Local testing steps** with screenshots/logs
+- **Breaking changes** clearly documented
+
+## Security & Configuration
+
+### Environment Setup
+```bash
+# Copy example environment file
+cp .env.example .env
+
+# NEVER commit secrets to version control
+# Set DATABASE_PROVIDER before database commands
+export DATABASE_PROVIDER=postgresql  # or mysql
+```
+
+### Security Best Practices
+- **API key authentication** via `apikey` header
+- **Input validation** with JSONSchema7
+- **Rate limiting** on all endpoints
+- **Webhook signature validation**
+- **Instance-based access control**
+- **Secure defaults** for all configurations
+
+### Vulnerability Reporting
+- See `SECURITY.md` for security vulnerability reporting process
+- Contact: `contato@evolution-api.com`
+
+## Communication Standards
+
+### Language Requirements
+- **User communication**: Always respond in Portuguese (PT-BR)
+- **Code/comments**: English for technical documentation
+- **API responses**: English for consistency
+- **Error messages**: Portuguese for user-facing errors
+
+### Documentation Standards
+- **Inline comments**: Document complex business logic
+- **API documentation**: Document all public endpoints
+- **Integration guides**: Document new integration patterns
+- **Migration guides**: Document database schema changes
+
+## Performance & Scalability
+
+### Caching Strategy
+- **Redis primary**: Distributed caching for production
+- **Node-cache fallback**: Local caching when Redis unavailable
+- **TTL strategy**: Appropriate cache expiration per data type
+- **Cache invalidation**: Proper invalidation on data changes
+
+### Connection Management
+- **Database**: Prisma connection pooling
+- **WhatsApp**: One connection per instance with lifecycle management
+- **Redis**: Connection pooling and retry logic
+- **External APIs**: Rate limiting and retry with exponential backoff
+
+### Monitoring & Observability
+- **Structured logging**: Pino logger with correlation IDs
+- **Error tracking**: Comprehensive error scenarios
+- **Health checks**: Instance status and connection monitoring
+- **Telemetry**: Usage analytics (non-sensitive data only)
+

CHANGELOG.md

@@ -1,3 +1,328 @@
+# 2.3.7 (2025-12-05)
+
+### Features
+
+* **WhatsApp Business Meta Templates**: Add update and delete endpoints for Meta templates
+  - New endpoints to edit and delete WhatsApp Business templates
+  - Added DTOs and validation schemas for template management
+  - Enhanced template lifecycle management capabilities
+
+* **Events API**: Add isLatest and progress to messages.set event
+  - Allows consumers to know when history sync is complete (isLatest=true)
+  - Track sync progress percentage through webhooks
+  - Added extra field to EmitData type for additional payload properties
+  - Updated all event controllers (webhook, rabbitmq, sqs, websocket, pusher, kafka, nats)
+
+* **N8N Integration**: Add quotedMessage to payload in sendMessageToBot
+  - Support for quoted messages in N8N chatbot integration
+  - Enhanced message context information
+
+* **WebSocket**: Add wildcard "*" to allow all hosts to connect via websocket
+  - More flexible host configuration for WebSocket connections
+  - Improved host validation logic in WebsocketController
+
+* **Pix Support**: Handle interactive button message for pix
+  - Support for interactive Pix button messages
+  - Enhanced payment flow integration
+
+### Fixed
+
+* **Baileys Message Processor**: Fix incoming message events not working after reconnection
+  - Added cleanup logic in mount() to prevent memory leaks from multiple subscriptions
+  - Recreate messageSubject if it was completed during logout
+  - Remount messageProcessor in connectToWhatsapp() to ensure subscription is active
+  - Fixed issue where onDestroy() calls complete() on RxJS Subject, making it permanently closed
+  - Ensures old subscriptions are properly cleaned up before creating new ones
+
+* **Baileys Authentication**: Resolve "waiting for message" state after reconnection
+  - Fixed Redis keys not being properly removed during instance logout
+  - Prevented loading of old/invalid cryptographic keys on reconnection
+  - Fixed blocking state where instances authenticate but cannot send messages
+  - Ensures new credentials (creds) are properly used after reconnection
+
+* **OnWhatsapp Cache**: Prevent unique constraint errors and optimize database writes
+  - Fixed `Unique constraint failed on the fields: (remoteJid)` error when sending to groups
+  - Refactored query to use OR condition finding by jidOptions or remoteJid
+  - Added deep comparison to skip unnecessary database updates
+  - Replaced sequential processing with Promise.allSettled for parallel execution
+  - Sorted JIDs alphabetically in jidOptions for accurate change detection
+  - Added normalizeJid helper function for cleaner code
+
+* **Proxy Integration**: Fix "Media upload failed on all hosts" error when using proxy
+  - Created makeProxyAgentUndici() for Undici-compatible proxy agents
+  - Fixed compatibility with Node.js 18+ native fetch() implementation
+  - Replaced traditional HttpsProxyAgent/SocksProxyAgent with Undici ProxyAgent
+  - Maintained legacy makeProxyAgent() for Axios compatibility
+  - Fixed protocol handling in makeProxyAgent to prevent undefined errors
+
+* **WhatsApp Business API**: Fix base64, filename and caption handling
+  - Corrected base64 media conversion in Business API
+  - Fixed filename handling for document messages
+  - Improved caption processing for media messages
+  - Enhanced remoteJid validation and processing
+
+* **Chat Service**: Fix fetchChats and message panel errors
+  - Fixed cleanMessageData errors in Manager message panel
+  - Improved chat fetching reliability
+  - Enhanced message data sanitization
+
+* **Contact Filtering**: Apply where filters correctly in findContacts endpoint
+  - Fixed endpoint to process all where clause fields (id, remoteJid, pushName)
+  - Previously only processed remoteJid field, ignoring other filters
+  - Added remoteJid field to contactValidateSchema for proper validation
+  - Maintained multi-tenant isolation with instanceId filtering
+  - Allows filtering contacts by any supported field instead of returning all contacts
+
+* **Chatwoot and Baileys Integration**: Multiple integration improvements
+  - Enhanced code formatting and consistency
+  - Fixed integration issues between Chatwoot and Baileys services
+  - Improved message handling and delivery
+
+* **Baileys Message Loss**: Prevent message loss from WhatsApp stub placeholders
+  - Fixed messages being lost and not saved to database, especially for channels/newsletters (@lid)
+  - Detects WhatsApp stubs through messageStubParameters containing 'Message absent from node'
+  - Prevents adding stubs to duplicate message cache
+  - Allows real message to be processed when it arrives after decryption
+  - Maintains stub discard to avoid saving empty placeholders
+
+* **Database Contacts**: Respect DATABASE_SAVE_DATA_CONTACTS in contact updates
+  - Added missing conditional checks for DATABASE_SAVE_DATA_CONTACTS configuration
+  - Fixed profile picture updates attempting to save when database save is disabled
+  - Fixed unawaited promise in contacts.upsert handler
+
+* **Prisma/PostgreSQL**: Add unique constraint to Chat model
+  - Generated migration to add unique index on instanceId and remoteJid
+  - Added deduplication step before creating index to prevent constraint violations
+  - Prevents chat duplication in database
+
+* **MinIO Upload**: Handle messageContextInfo in media upload to prevent MinIO errors
+  - Prevents errors when uploading media with messageContextInfo metadata
+  - Improved error handling for media storage operations
+
+* **Typebot**: Fix message routing for @lid JIDs
+  - Typebot now responds to messages from JIDs ending with @lid
+  - Maintains complete JID for @lid instead of extracting only number
+  - Fixed condition: `remoteJid.includes('@lid') ? remoteJid : remoteJid.split('@')[0]`
+  - Handles both @s.whatsapp.net and @lid message formats
+
+* **Message Filtering**: Unify remoteJid filtering using OR with remoteJidAlt
+  - Improved message filtering with alternative JID support
+  - Better handling of messages with different JID formats
+
+* **@lid Integration**: Multiple fixes for @lid problems, message events and chatwoot errors
+  - Reorganized imports and improved message handling in BaileysStartupService
+  - Enhanced remoteJid processing to handle @lid cases
+  - Improved jid normalization and type safety in Chatwoot integration
+  - Streamlined message handling logic and cache management
+  - Refactored message handling and polling updates with decryption logic for poll votes
+  - Improved event processing flow for various message types
+
+* **Chatwoot Contacts**: Fix contact duplication error on import
+  - Resolved 'ON CONFLICT DO UPDATE command cannot affect row a second time' error
+  - Removed attempt to update identifier field in conflict (part of constraint)
+  - Changed to update only updated_at field: `updated_at = NOW()`
+  - Allows duplicate contacts to be updated correctly without errors
+
+* **Chatwoot Service**: Fix async handling in update_last_seen method
+  - Added missing await for chatwootRequest in read message processing
+  - Prevents service failure when processing read messages
+
+* **Metrics Access**: Fix IP validation including x-forwarded-for
+  - Uses all IPs including x-forwarded-for header when checking metrics access
+  - Improved security and access control for metrics endpoint
+
+### Dependencies
+
+* **Baileys**: Updated to version 7.0.0-rc.9
+  - Latest release candidate with multiple improvements and bug fixes
+
+* **AWS SDK**: Updated packages to version 3.936.0
+  - Enhanced functionality and compatibility
+  - Performance improvements
+
+### Code Quality & Refactoring
+
+* **Template Management**: Remove unused template edit/delete DTOs after refactoring
+* **Proxy Utilities**: Improve makeProxyAgent for Undici compatibility
+* **Code Formatting**: Enhance code formatting and consistency across services
+* **BaileysStartupService**: Fix indentation and remove unnecessary blank lines
+* **Event Controllers**: Guard extra spread and prevent core field override in all event controllers
+* **Import Organization**: Reorganize imports for better code structure and maintainability
+
+# 2.3.6 (2025-10-21)
+
+### Features
+
+* **Baileys, Chatwoot, OnWhatsapp Cache**: Multiple implementations and fixes
+  - Fixed cache for PN, LID and g.us numbers to send correct number
+  - Fixed audio and document sending via Chatwoot in Baileys channel
+  - Multiple fixes in Chatwoot integration
+  - Fixed ignored messages when receiving leads
+
+### Fixed
+
+* **Baileys**: Fix buffer storage in database
+  - Correctly save Uint8Array values to database
+* **Baileys**: Simplify logging of messageSent object
+  - Fixed "this.isZero not is function" error
+
+### Chore
+
+* **Version**: Bump version to 2.3.6 and update Baileys dependency to 7.0.0-rc.6
+* **Workflows**: Update checkout step to include submodules
+  - Added 'submodules: recursive' option to checkout step in multiple workflow files to ensure submodules are properly initialized during CI/CD processes
+* **Manager**: Update asset files and install process
+  - Updated subproject reference in evolution-manager-v2 to the latest commit
+  - Enhanced the manager_install.sh script to include npm install and build steps
+  - Replaced old JavaScript asset file with a new version for improved performance
+  - Added a new CSS file for consistent styling across the application
+
+# 2.3.5 (2025-10-15)
+
+### Features
+
+* **Chatwoot Enhancements**: Comprehensive improvements to message handling, editing, deletion and i18n
+* **Participants Data**: Add participantsData field maintaining backward compatibility for group participants
+* **LID to Phone Number**: Convert LID to phoneNumber on group participants
+* **Docker Configurations**: Add Kafka and frontend services to Docker configurations
+
+### Fixed
+
+* **Kafka Migration**: Fixed PostgreSQL migration error for Kafka integration
+  - Corrected table reference from `"public"."Instance"` to `"Instance"` in foreign key constraint
+  - Fixed `ERROR: relation "public.Instance" does not exist` issue in migration `20250918182355_add_kafka_integration`
+  - Aligned table naming convention with other Evolution API migrations for consistency
+  - Resolved database migration failure that prevented Kafka integration setup
+* **Update Baileys Version**: v7.0.0-rc.5 with compatibility fixes
+  - Fixed assertSessions signature compatibility using type assertion
+  - Fixed incompatibility in voice call (wavoip) with new Baileys version
+  - Handle undefined status in update by defaulting to 'DELETED'
+* **Chatwoot Improvements**: Multiple fixes for enhanced reliability
+  - Correct chatId extraction for non-group JIDs
+  - Resolve webhook timeout on deletion with 5+ images
+  - Improve error handling in Chatwoot messages
+  - Adjust conversation verification logic and cache
+  - Optimize conversation reopening logic and connection notification
+  - Fix conversation reopening and connection loop
+* **Baileys Message Handling**: Enhanced message processing
+  - Add warning log for messages not found
+  - Fix message verification in Baileys service
+  - Simplify linkPreview handling in BaileysStartupService
+* **Media Validation**: Fix media content validation
+* **PostgreSQL Connection**: Refactor connection with PostgreSQL and improve message handling
+
+### Code Quality & Refactoring
+
+* **Exponential Backoff**: Implement exponential backoff patterns and extract magic numbers to constants
+* **TypeScript Build**: Update TypeScript build process and dependencies
+
+### 
+
+# 2.3.4 (2025-09-23)
+
+### Features
+
+* **Kafka Integration**: Added Apache Kafka event integration for real-time event streaming
+  - New Kafka controller, router, and schema for event publishing
+  - Support for instance-specific and global event topics
+  - Configurable SASL/SSL authentication and connection settings
+  - Auto-creation of topics with configurable partitions and replication
+  - Consumer group management for reliable event processing
+  - Integration with existing event manager for seamless event distribution
+
+* **Evolution Manager v2 Open Source**: Evolution Manager v2 is now available as open source
+  - Added as git submodule with HTTPS URL for easy access
+  - Complete open source setup with Apache 2.0 license + Evolution API custom conditions
+  - GitHub templates for issues, pull requests, and workflows
+  - Comprehensive documentation and contribution guidelines
+  - Docker support for development and production environments
+  - CI/CD workflows for code quality, security audits, and automated builds
+  - Multi-language support (English, Portuguese, Spanish, French)
+  - Modern React + TypeScript + Vite frontend with Tailwind CSS
+
+* **EvolutionBot Enhancements**: Improved EvolutionBot functionality and message handling
+  - Implemented splitMessages functionality for better message segmentation
+  - Added linkPreview support for enhanced message presentation
+  - Centralized split logic across chatbot services for consistency
+  - Enhanced message formatting and delivery capabilities
+
+### Fixed
+
+* **MySQL Schema**: Fixed invalid default value errors for `createdAt` fields in `Evoai` and `EvoaiSetting` models
+  - Changed `@default(now())` to `@default(dbgenerated("CURRENT_TIMESTAMP"))` for MySQL compatibility
+  - Added missing relation fields (`N8n`, `N8nSetting`, `Evoai`, `EvoaiSetting`) in Instance model
+  - Resolved Prisma schema validation errors for MySQL provider
+
+* **Prisma Schema Validation**: Fixed `instanceName` field error in message creation
+  - Removed invalid `instanceName` field from message objects before database insertion
+  - Resolved `Unknown argument 'instanceName'` Prisma validation error
+  - Streamlined message data structure to match Prisma schema requirements
+
+* **Media Message Processing**: Enhanced media handling across chatbot services
+  - Fixed base64 conversion in EvoAI service for proper image processing
+  - Converted ArrayBuffer to base64 string using `Buffer.from().toString('base64')`
+  - Improved media URL handling and base64 encoding for better chatbot integration
+  - Enhanced image message detection and processing workflow
+
+* **Evolution Manager v2 Linting**: Resolved ESLint configuration conflicts
+  - Disabled conflicting Prettier rules in ESLint configuration
+  - Added comprehensive rule overrides for TypeScript and React patterns
+  - Fixed import ordering and code formatting issues
+  - Updated security vulnerabilities in dependencies (Vite, esbuild)
+
+### Code Quality & Refactoring
+
+* **Chatbot Services**: Streamlined media message handling across all chatbot integrations
+  - Standardized base64 and mediaUrl processing patterns
+  - Improved code readability and maintainability in media handling logic
+  - Enhanced error handling for media download and conversion processes
+  - Unified image message detection across different chatbot services
+
+* **Database Operations**: Improved data consistency and validation
+  - Enhanced Prisma schema compliance across all message operations
+  - Removed redundant instance name references for better data integrity
+  - Optimized message creation workflow with proper field validation
+
+### Environment Variables
+
+* Added comprehensive Kafka configuration options:
+  - `KAFKA_ENABLED`, `KAFKA_CLIENT_ID`, `KAFKA_BROKERS`
+  - `KAFKA_CONSUMER_GROUP_ID`, `KAFKA_TOPIC_PREFIX`
+  - `KAFKA_SASL_*` and `KAFKA_SSL_*` for authentication
+  - `KAFKA_EVENTS_*` for event type configuration
+
+# 2.3.3 (2025-09-18)
+
+### Features
+
+* Add extra fields to object sent to Flowise bot
+* Add Prometheus-compatible /metrics endpoint (gated by PROMETHEUS_METRICS)
+* Implement linkPreview support for Evolution Bot
+
+### Fixed
+
+* Address Path Traversal vulnerability in /assets endpoint by implementing security checks
+* Configure Husky and lint-staged for automated code quality checks on commits and pushes
+* Convert mediaKey from media messages to avoid bad decrypt errors
+* Improve code formatting for better readability in WhatsApp service files
+* Format messageGroupId assignment for improved readability
+* Improve linkPreview implementation based on PR feedback
+* Clean up code formatting for linkPreview implementation
+* Use 'unknown' as fallback for clientName label
+* Remove abort process when status is paused, allowing the chatbot return after the time expires and after being paused due to human interaction (stopBotFromMe)
+* Enhance message content sanitization in Baileys service and improve message retrieval logic in Chatwoot service
+* Integrate Typebot status change events for webhook in chatbot controller and service
+* Mimetype of videos video
+
+### Security
+
+* **CRITICAL**: Fixed Path Traversal vulnerability in /assets endpoint that allowed unauthenticated local file read
+* Customizable Websockets Security
+
+### Testing
+
+* Baileys Updates: v7.0.0-rc.3 ([Link](https://github.com/WhiskeySockets/Baileys/releases/tag/v7.0.0-rc.3))
+
 # 2.3.2 (2025-09-02)
 
 ### Features

CLAUDE.md

@@ -0,0 +1,223 @@
+# CLAUDE.md
+
+This file provides comprehensive guidance to Claude AI when working with the Evolution API codebase.
+
+## Project Overview
+
+**Evolution API** is a powerful, production-ready REST API for WhatsApp communication that supports multiple WhatsApp providers:
+- **Baileys** (WhatsApp Web) - Open-source WhatsApp Web client
+- **Meta Business API** - Official WhatsApp Business API
+- **Evolution API** - Custom WhatsApp integration
+
+Built with **Node.js 20+**, **TypeScript 5+**, and **Express.js**, it provides extensive integrations with chatbots, CRM systems, and messaging platforms in a **multi-tenant architecture**.
+
+## Common Development Commands
+
+### Build and Run
+```bash
+# Development
+npm run dev:server    # Run in development with hot reload (tsx watch)
+
+# Production
+npm run build        # TypeScript check + tsup build
+npm run start:prod   # Run production build
+
+# Direct execution
+npm start           # Run with tsx
+```
+
+### Code Quality
+```bash
+npm run lint        # ESLint with auto-fix
+npm run lint:check  # ESLint check only
+npm run commit      # Interactive commit with commitizen
+```
+
+### Database Management
+```bash
+# Set database provider first
+export DATABASE_PROVIDER=postgresql  # or mysql
+
+# Generate Prisma client (automatically uses DATABASE_PROVIDER env)
+npm run db:generate
+
+# Deploy migrations (production)
+npm run db:deploy      # Unix/Mac
+npm run db:deploy:win  # Windows
+
+# Development migrations (with sync to provider folder)
+npm run db:migrate:dev      # Unix/Mac
+npm run db:migrate:dev:win  # Windows
+
+# Open Prisma Studio
+npm run db:studio
+
+# Development migrations
+npm run db:migrate:dev      # Unix/Mac
+npm run db:migrate:dev:win  # Windows
+```
+
+### Testing
+```bash
+npm test    # Run tests with watch mode
+```
+
+## Architecture Overview
+
+### Core Structure
+- **Multi-tenant SaaS**: Complete instance isolation with per-tenant authentication
+- **Multi-provider database**: PostgreSQL and MySQL via Prisma ORM with provider-specific schemas and migrations
+- **WhatsApp integrations**: Baileys, Meta Business API, and Evolution API with unified interface
+- **Event-driven architecture**: EventEmitter2 for internal events + WebSocket, RabbitMQ, SQS, NATS, Pusher for external events
+- **Microservices pattern**: Modular integrations for chatbots, storage, and external services
+
+### Directory Layout
+```
+src/
+├── api/
+│   ├── controllers/     # HTTP route handlers (thin layer)
+│   ├── services/        # Business logic (core functionality)
+│   ├── repository/      # Data access layer (Prisma)
+│   ├── dto/            # Data Transfer Objects (simple classes)
+│   ├── guards/         # Authentication/authorization middleware
+│   ├── integrations/   # External service integrations
+│   │   ├── channel/    # WhatsApp providers (Baileys, Business API, Evolution)
+│   │   ├── chatbot/    # AI/Bot integrations (OpenAI, Dify, Typebot, Chatwoot)
+│   │   ├── event/      # Event systems (WebSocket, RabbitMQ, SQS, NATS, Pusher)
+│   │   └── storage/    # File storage (S3, MinIO)
+│   ├── routes/         # Express route definitions (RouterBroker pattern)
+│   └── types/          # TypeScript type definitions
+├── config/             # Environment and app configuration
+├── cache/             # Redis and local cache implementations
+├── exceptions/        # Custom HTTP exception classes
+├── utils/            # Shared utilities and helpers
+└── validate/         # JSONSchema7 validation schemas
+```
+
+### Key Integration Points
+
+**Channel Integrations** (`src/api/integrations/channel/`):
+- **Baileys**: WhatsApp Web client with QR code authentication
+- **Business API**: Official Meta WhatsApp Business API
+- **Evolution API**: Custom WhatsApp integration
+- Connection lifecycle management per instance with automatic reconnection
+
+**Chatbot Integrations** (`src/api/integrations/chatbot/`):
+- **EvolutionBot**: Native chatbot with trigger system
+- **Chatwoot**: Customer service platform integration
+- **Typebot**: Visual chatbot flow builder
+- **OpenAI**: AI capabilities including GPT and Whisper (audio transcription)
+- **Dify**: AI agent workflow platform
+- **Flowise**: LangChain visual builder
+- **N8N**: Workflow automation platform
+- **EvoAI**: Custom AI integration
+
+**Event Integrations** (`src/api/integrations/event/`):
+- **WebSocket**: Real-time Socket.io connections
+- **RabbitMQ**: Message queue for async processing
+- **Amazon SQS**: Cloud-based message queuing
+- **NATS**: High-performance messaging system
+- **Pusher**: Real-time push notifications
+
+**Storage Integrations** (`src/api/integrations/storage/`):
+- **AWS S3**: Cloud object storage
+- **MinIO**: Self-hosted S3-compatible storage
+- Media file management and URL generation
+
+### Database Schema Management
+- Separate schema files: `postgresql-schema.prisma` and `mysql-schema.prisma`
+- Environment variable `DATABASE_PROVIDER` determines active database
+- Migration folders are provider-specific and auto-selected during deployment
+
+### Authentication & Security
+- **API key-based authentication** via `apikey` header (global or per-instance)
+- **Instance-specific tokens** for WhatsApp connection authentication
+- **Guards system** for route protection and authorization
+- **Input validation** using JSONSchema7 with RouterBroker `dataValidate`
+- **Rate limiting** and security middleware
+- **Webhook signature validation** for external integrations
+
+## Important Implementation Details
+
+### WhatsApp Instance Management
+- Each WhatsApp connection is an "instance" with unique name
+- Instance data stored in database with connection state
+- Session persistence in database or file system (configurable)
+- Automatic reconnection handling with exponential backoff
+
+### Message Queue Architecture
+- Supports RabbitMQ, Amazon SQS, and WebSocket for events
+- Event types: message.received, message.sent, connection.update, etc.
+- Configurable per instance which events to send
+
+### Media Handling
+- Local storage or S3/Minio for media files
+- Automatic media download from WhatsApp
+- Media URL generation for external access
+- Support for audio transcription via OpenAI
+
+### Multi-tenancy Support
+- Instance isolation at database level
+- Separate webhook configurations per instance
+- Independent integration settings per instance
+
+## Environment Configuration
+
+Key environment variables are defined in `.env.example`. The system uses a strongly-typed configuration system via `src/config/env.config.ts`.
+
+Critical configurations:
+- `DATABASE_PROVIDER`: postgresql or mysql
+- `DATABASE_CONNECTION_URI`: Database connection string
+- `AUTHENTICATION_API_KEY`: Global API authentication
+- `REDIS_ENABLED`: Enable Redis cache
+- `RABBITMQ_ENABLED`/`SQS_ENABLED`: Message queue options
+
+## Development Guidelines
+
+The project follows comprehensive development standards defined in `.cursor/rules/`:
+
+### Core Principles
+- **Always respond in Portuguese (PT-BR)** for user communication
+- **Follow established architecture patterns** (Service Layer, RouterBroker, etc.)
+- **Robust error handling** with retry logic and graceful degradation
+- **Multi-database compatibility** (PostgreSQL and MySQL)
+- **Security-first approach** with input validation and rate limiting
+- **Performance optimizations** with Redis caching and connection pooling
+
+### Code Standards
+- **TypeScript strict mode** with full type coverage
+- **JSONSchema7** for input validation (not class-validator)
+- **Conventional Commits** enforced by commitlint
+- **ESLint + Prettier** for code formatting
+- **Service Object pattern** for business logic
+- **RouterBroker pattern** for route handling with `dataValidate`
+
+### Architecture Patterns
+- **Multi-tenant isolation** at database and instance level
+- **Event-driven communication** with EventEmitter2
+- **Microservices integration** pattern for external services
+- **Connection pooling** and lifecycle management
+- **Caching strategy** with Redis primary and Node-cache fallback
+
+## Testing Approach
+
+Currently, the project has minimal formal testing infrastructure:
+- **Manual testing** is the primary approach
+- **Integration testing** in development environment
+- **No unit test suite** currently implemented
+- Test files can be placed in `test/` directory as `*.test.ts`
+- Run `npm test` for watch mode development testing
+
+### Recommended Testing Strategy
+- Focus on **critical business logic** in services
+- **Mock external dependencies** (WhatsApp APIs, databases)
+- **Integration tests** for API endpoints
+- **Manual testing** for WhatsApp connection flows
+
+## Deployment Considerations
+
+- Docker support with `Dockerfile` and `docker-compose.yaml`
+- Graceful shutdown handling for connections
+- Health check endpoints for monitoring
+- Sentry integration for error tracking
+- Telemetry for usage analytics (non-sensitive data only)

Docker/kafka/docker-compose.yaml

@@ -0,0 +1,51 @@
+version: '3.3'
+
+services:
+  zookeeper:
+    container_name: zookeeper
+    image: confluentinc/cp-zookeeper:7.5.0
+    environment:
+      - ZOOKEEPER_CLIENT_PORT=2181
+      - ZOOKEEPER_TICK_TIME=2000
+      - ZOOKEEPER_SYNC_LIMIT=2
+    volumes:
+      - zookeeper_data:/var/lib/zookeeper/
+    ports:
+      - 2181:2181
+
+  kafka:
+    container_name: kafka
+    image: confluentinc/cp-kafka:7.5.0
+    depends_on:
+      - zookeeper
+    environment:
+      - KAFKA_BROKER_ID=1
+      - KAFKA_ZOOKEEPER_CONNECT=zookeeper:2181
+      - KAFKA_LISTENER_SECURITY_PROTOCOL_MAP=PLAINTEXT:PLAINTEXT,PLAINTEXT_HOST:PLAINTEXT,OUTSIDE:PLAINTEXT
+      - KAFKA_ADVERTISED_LISTENERS=PLAINTEXT://kafka:29092,PLAINTEXT_HOST://localhost:9092,OUTSIDE://host.docker.internal:9094
+      - KAFKA_INTER_BROKER_LISTENER_NAME=PLAINTEXT
+      - KAFKA_OFFSETS_TOPIC_REPLICATION_FACTOR=1
+      - KAFKA_TRANSACTION_STATE_LOG_MIN_ISR=1
+      - KAFKA_TRANSACTION_STATE_LOG_REPLICATION_FACTOR=1
+      - KAFKA_GROUP_INITIAL_REBALANCE_DELAY_MS=0
+      - KAFKA_AUTO_CREATE_TOPICS_ENABLE=true
+      - KAFKA_LOG_RETENTION_HOURS=168
+      - KAFKA_LOG_SEGMENT_BYTES=1073741824
+      - KAFKA_LOG_RETENTION_CHECK_INTERVAL_MS=300000
+      - KAFKA_COMPRESSION_TYPE=gzip
+    ports:
+      - 29092:29092
+      - 9092:9092
+      - 9094:9094
+    volumes:
+      - kafka_data:/var/lib/kafka/data
+
+volumes:
+  zookeeper_data:
+  kafka_data:
+
+
+networks:
+  evolution-net:
+    name: evolution-net
+    driver: bridge

Docker/swarm/evolution_api_v2.yaml

@@ -2,7 +2,7 @@ version: "3.7"
 
 services:
   evolution_v2:
-    image: evoapicloud/evolution-api:v2.3.1
+    image: evoapicloud/evolution-api:v2.3.7
     volumes:
       - evolution_instances:/evolution/instances
     networks:

Dockerfile

@@ -1,4 +1,4 @@
-FROM node:20-alpine AS builder
+FROM node:24-alpine AS builder
 
 RUN apk update && \
     apk add --no-cache git ffmpeg wget curl bash openssl
@@ -30,7 +30,7 @@ RUN ./Docker/scripts/generate_database.sh
 
 RUN npm run build
 
-FROM node:20-alpine AS final
+FROM node:24-alpine AS final
 
 RUN apk update && \
     apk add tzdata ffmpeg bash openssl

Dockerfile.metrics

@@ -0,0 +1,19 @@
+FROM evoapicloud/evolution-api:latest AS base
+WORKDIR /evolution
+
+# Copiamos apenas o necessário para recompilar o dist com as mudanças locais
+COPY tsconfig.json tsup.config.ts package.json ./
+COPY src ./src
+
+# Recompila usando os node_modules já presentes na imagem base
+RUN npm run build
+
+# Runtime final: reaproveita a imagem oficial e apenas sobrepõe o dist
+FROM evoapicloud/evolution-api:latest AS final
+WORKDIR /evolution
+COPY --from=base /evolution/dist ./dist
+
+ENV PROMETHEUS_METRICS=true
+
+# Entrada original da imagem oficial já sobe o app em /evolution
+

LICENSE

@@ -17,5 +17,5 @@ b. Your contributed code may be used for commercial purposes, including but not
 
 Apart from the specific conditions mentioned above, all other rights and restrictions follow the Apache License 2.0. Detailed information about the Apache License 2.0 can be found at http://www.apache.org/licenses/LICENSE-2.0.
 
-© 2024 Evolution API
+© 2025 Evolution API
 

README.md

@@ -7,6 +7,9 @@
 [![Discord Community](https://img.shields.io/badge/Discord-Community-blue)](https://evolution-api.com/discord)
 [![Postman Collection](https://img.shields.io/badge/Postman-Collection-orange)](https://evolution-api.com/postman) 
 [![Documentation](https://img.shields.io/badge/Documentation-Official-green)](https://doc.evolution-api.com)
+[![Feature Requests](https://img.shields.io/badge/Feature-Requests-purple)](https://evolutionapi.canny.io/feature-requests)
+[![Roadmap](https://img.shields.io/badge/Roadmap-Community-blue)](https://evolutionapi.canny.io/feature-requests)
+[![Changelog](https://img.shields.io/badge/Changelog-Updates-green)](https://evolutionapi.canny.io/changelog)
 [![License](https://img.shields.io/badge/license-Apache--2.0-blue)](./LICENSE)
 [![Support](https://img.shields.io/badge/Donation-picpay-green)](https://app.picpay.com/user/davidsongomes1998)
 [![Sponsors](https://img.shields.io/badge/Github-sponsor-orange)](https://github.com/sponsors/EvolutionAPI)
@@ -52,6 +55,9 @@ Evolution API supports various integrations to enhance its functionality. Below
 - [RabbitMQ](https://www.rabbitmq.com/):
   - Receive events from the Evolution API via RabbitMQ.
 
+- [Apache Kafka](https://kafka.apache.org/):
+  - Receive events from the Evolution API via Apache Kafka for real-time event streaming and processing.
+
 - [Amazon SQS](https://aws.amazon.com/pt/sqs/):
   - Receive events from the Evolution API via Amazon SQS.
 
@@ -67,6 +73,24 @@ Evolution API supports various integrations to enhance its functionality. Below
 - Amazon S3 / Minio:
   - Store media files received in [Amazon S3](https://aws.amazon.com/pt/s3/) or [Minio](https://min.io/).
 
+## Community & Feedback
+
+We value community input and feedback to continuously improve Evolution API:
+
+### 🚀 Feature Requests & Roadmap
+- **[Feature Requests](https://evolutionapi.canny.io/feature-requests)**: Submit new feature ideas and vote on community proposals
+- **[Roadmap](https://evolutionapi.canny.io/feature-requests)**: View planned features and development progress
+- **[Changelog](https://evolutionapi.canny.io/changelog)**: Stay updated with the latest releases and improvements
+
+### 💬 Community Support
+- **[WhatsApp Group](https://evolution-api.com/whatsapp)**: Join our community for support and discussions
+- **[Discord Community](https://evolution-api.com/discord)**: Real-time chat with developers and users
+- **[GitHub Issues](https://github.com/EvolutionAPI/evolution-api/issues)**: Report bugs and technical issues
+
+### 🔒 Security
+- **[Security Policy](./SECURITY.md)**: Guidelines for reporting security vulnerabilities
+- **Security Contact**: contato@evolution-api.com
+
 ## Telemetry Notice
 
 To continuously improve our services, we have implemented telemetry that collects data on the routes used, the most accessed routes, and the version of the API in use. We would like to assure you that no sensitive or personal data is collected during this process. The telemetry helps us identify improvements and provide a better experience for users.

SECURITY.md

@@ -0,0 +1,99 @@
+# Security Policy
+
+## Supported Versions
+
+We actively support the following versions of Evolution API with security updates:
+
+| Version | Supported          |
+| ------- | ------------------ |
+| 2.3.x   | ✅ Yes             |
+| 2.2.x   | ✅ Yes             |
+| 2.1.x   | ⚠️ Critical fixes only |
+| < 2.1   | ❌ No              |
+
+## Reporting a Vulnerability
+
+We take security vulnerabilities seriously. If you discover a security vulnerability in Evolution API, please help us by reporting it responsibly.
+
+### 🔒 Private Disclosure Process
+
+**Please DO NOT create a public GitHub issue for security vulnerabilities.**
+
+Instead, please report security vulnerabilities via email to:
+
+**📧 contato@evolution-api.com**
+
+### 📋 What to Include
+
+When reporting a vulnerability, please include:
+
+- **Description**: A clear description of the vulnerability
+- **Impact**: What an attacker could achieve by exploiting this vulnerability
+- **Steps to Reproduce**: Detailed steps to reproduce the issue
+- **Proof of Concept**: If possible, include a minimal proof of concept
+- **Environment**: Version of Evolution API, OS, Node.js version, etc.
+- **Suggested Fix**: If you have ideas for how to fix the issue
+
+### 🕐 Response Timeline
+
+We will acknowledge receipt of your vulnerability report within **48 hours** and will send you regular updates about our progress.
+
+- **Initial Response**: Within 48 hours
+- **Status Update**: Within 7 days
+- **Resolution Timeline**: Varies based on complexity, typically 30-90 days
+
+### 🎯 Scope
+
+This security policy applies to:
+
+- Evolution API core application
+- Official Docker images
+- Documentation that could lead to security issues
+
+### 🚫 Out of Scope
+
+The following are generally considered out of scope:
+
+- Third-party integrations (Chatwoot, Typebot, etc.) - please report to respective projects
+- Issues in dependencies - please report to the dependency maintainers
+- Social engineering attacks
+- Physical attacks
+- Denial of Service attacks
+
+### 🏆 Recognition
+
+We believe in recognizing security researchers who help us keep Evolution API secure:
+
+- We will acknowledge your contribution in our security advisories (unless you prefer to remain anonymous)
+- For significant vulnerabilities, we may feature you in our Hall of Fame
+- We will work with you on coordinated disclosure timing
+
+### 📚 Security Best Practices
+
+For users deploying Evolution API:
+
+- Always use the latest supported version
+- Keep your dependencies up to date
+- Use strong authentication methods
+- Implement proper network security
+- Monitor your logs for suspicious activity
+- Follow the principle of least privilege
+
+### 🔄 Security Updates
+
+Security updates will be:
+
+- Released as patch versions (e.g., 2.3.1 → 2.3.2)
+- Documented in our [CHANGELOG.md](./CHANGELOG.md)
+- Announced in our community channels
+- Tagged with security labels in GitHub releases
+
+## Contact
+
+For any questions about this security policy, please contact:
+
+- **Email**: contato@evolution-api.com
+
+---
+
+Thank you for helping keep Evolution API and our community safe! 🛡️

commitlint.config.js

@@ -0,0 +1,34 @@
+module.exports = {
+  extends: ['@commitlint/config-conventional'],
+  rules: {
+    'type-enum': [
+      2,
+      'always',
+      [
+        'feat',     // New feature
+        'fix',      // Bug fix
+        'docs',     // Documentation changes
+        'style',    // Code style changes (formatting, etc)
+        'refactor', // Code refactoring
+        'perf',     // Performance improvements
+        'test',     // Adding or updating tests
+        'chore',    // Maintenance tasks
+        'ci',       // CI/CD changes
+        'build',    // Build system changes
+        'revert',   // Reverting changes
+        'security', // Security fixes
+      ],
+    ],
+    'type-case': [2, 'always', 'lower-case'],
+    'type-empty': [2, 'never'],
+    'scope-case': [2, 'always', 'lower-case'],
+    'subject-case': [2, 'never', ['sentence-case', 'start-case', 'pascal-case', 'upper-case']],
+    'subject-empty': [2, 'never'],
+    'subject-full-stop': [2, 'never', '.'],
+    'header-max-length': [2, 'always', 100],
+    'body-leading-blank': [1, 'always'],
+    'body-max-line-length': [0, 'always', 150],
+    'footer-leading-blank': [1, 'always'],
+    'footer-max-line-length': [0, 'always', 150],
+  },
+};

docker-compose.dev.yaml

@@ -15,6 +15,16 @@ services:
     expose:
       - 8080
 
+  frontend:
+    container_name: evolution_frontend
+    image: evolution/manager:local
+    build: ./evolution-manager-v2
+    restart: always
+    ports:
+      - "3000:80"
+    networks:
+      - evolution-net
+
 volumes:
   evolution_instances:
 

docker-compose.yaml

@@ -20,6 +20,15 @@ services:
     expose:
       - "8080"
 
+  frontend:
+    container_name: evolution_frontend
+    image: evoapicloud/evolution-manager:latest
+    restart: always
+    ports:
+      - "3000:80"
+    networks:
+      - evolution-net
+
   redis:
     container_name: evolution_redis
     image: redis:latest

env.example

@@ -0,0 +1,302 @@
+# ===========================================
+# EVOLUTION API - CONFIGURAÇÃO DE AMBIENTE
+# ===========================================
+
+# ===========================================
+# SERVIDOR
+# ===========================================
+SERVER_NAME=evolution
+SERVER_TYPE=http
+SERVER_PORT=8080
+SERVER_URL=http://localhost:8080
+SERVER_DISABLE_DOCS=false
+SERVER_DISABLE_MANAGER=false
+
+# ===========================================
+# CORS
+# ===========================================
+CORS_ORIGIN=*
+CORS_METHODS=POST,GET,PUT,DELETE
+CORS_CREDENTIALS=true
+
+# ===========================================
+# SSL (opcional)
+# ===========================================
+SSL_CONF_PRIVKEY=
+SSL_CONF_FULLCHAIN=
+
+# ===========================================
+# BANCO DE DADOS
+# ===========================================
+DATABASE_PROVIDER=postgresql
+DATABASE_CONNECTION_URI=postgresql://username:password@localhost:5432/evolution_api
+DATABASE_CONNECTION_CLIENT_NAME=evolution
+
+# Configurações de salvamento de dados
+DATABASE_SAVE_DATA_INSTANCE=true
+DATABASE_SAVE_DATA_NEW_MESSAGE=true
+DATABASE_SAVE_MESSAGE_UPDATE=true
+DATABASE_SAVE_DATA_CONTACTS=true
+DATABASE_SAVE_DATA_CHATS=true
+DATABASE_SAVE_DATA_HISTORIC=true
+DATABASE_SAVE_DATA_LABELS=true
+DATABASE_SAVE_IS_ON_WHATSAPP=true
+DATABASE_SAVE_IS_ON_WHATSAPP_DAYS=7
+DATABASE_DELETE_MESSAGE=false
+
+# ===========================================
+# REDIS
+# ===========================================
+CACHE_REDIS_ENABLED=true
+CACHE_REDIS_URI=redis://localhost:6379
+CACHE_REDIS_PREFIX_KEY=evolution-cache
+CACHE_REDIS_TTL=604800
+CACHE_REDIS_SAVE_INSTANCES=true
+
+# Cache local (fallback)
+CACHE_LOCAL_ENABLED=true
+CACHE_LOCAL_TTL=86400
+
+# ===========================================
+# AUTENTICAÇÃO
+# ===========================================
+AUTHENTICATION_API_KEY=BQYHJGJHJ
+AUTHENTICATION_EXPOSE_IN_FETCH_INSTANCES=false
+
+# ===========================================
+# LOGS
+# ===========================================
+LOG_LEVEL=ERROR,WARN,DEBUG,INFO,LOG,VERBOSE,DARK,WEBHOOKS,WEBSOCKET
+LOG_COLOR=true
+LOG_BAILEYS=error
+
+# ===========================================
+# INSTÂNCIAS
+# ===========================================
+DEL_INSTANCE=false
+DEL_TEMP_INSTANCES=true
+
+# ===========================================
+# IDIOMA
+# ===========================================
+LANGUAGE=pt-BR
+
+# ===========================================
+# WEBHOOK
+# ===========================================
+WEBHOOK_GLOBAL_URL=
+WEBHOOK_GLOBAL_ENABLED=false
+WEBHOOK_GLOBAL_WEBHOOK_BY_EVENTS=false
+
+# Eventos de webhook
+WEBHOOK_EVENTS_APPLICATION_STARTUP=false
+WEBHOOK_EVENTS_INSTANCE_CREATE=false
+WEBHOOK_EVENTS_INSTANCE_DELETE=false
+WEBHOOK_EVENTS_QRCODE_UPDATED=false
+WEBHOOK_EVENTS_MESSAGES_SET=false
+WEBHOOK_EVENTS_MESSAGES_UPSERT=false
+WEBHOOK_EVENTS_MESSAGES_EDITED=false
+WEBHOOK_EVENTS_MESSAGES_UPDATE=false
+WEBHOOK_EVENTS_MESSAGES_DELETE=false
+WEBHOOK_EVENTS_SEND_MESSAGE=false
+WEBHOOK_EVENTS_SEND_MESSAGE_UPDATE=false
+WEBHOOK_EVENTS_CONTACTS_SET=false
+WEBHOOK_EVENTS_CONTACTS_UPDATE=false
+WEBHOOK_EVENTS_CONTACTS_UPSERT=false
+WEBHOOK_EVENTS_PRESENCE_UPDATE=false
+WEBHOOK_EVENTS_CHATS_SET=false
+WEBHOOK_EVENTS_CHATS_UPDATE=false
+WEBHOOK_EVENTS_CHATS_UPSERT=false
+WEBHOOK_EVENTS_CHATS_DELETE=false
+WEBHOOK_EVENTS_CONNECTION_UPDATE=false
+WEBHOOK_EVENTS_LABELS_EDIT=false
+WEBHOOK_EVENTS_LABELS_ASSOCIATION=false
+WEBHOOK_EVENTS_GROUPS_UPSERT=false
+WEBHOOK_EVENTS_GROUPS_UPDATE=false
+WEBHOOK_EVENTS_GROUP_PARTICIPANTS_UPDATE=false
+WEBHOOK_EVENTS_CALL=false
+WEBHOOK_EVENTS_TYPEBOT_START=false
+WEBHOOK_EVENTS_TYPEBOT_CHANGE_STATUS=false
+WEBHOOK_EVENTS_ERRORS=false
+WEBHOOK_EVENTS_ERRORS_WEBHOOK=
+
+# Configurações de webhook
+WEBHOOK_REQUEST_TIMEOUT_MS=30000
+WEBHOOK_RETRY_MAX_ATTEMPTS=10
+WEBHOOK_RETRY_INITIAL_DELAY_SECONDS=5
+WEBHOOK_RETRY_USE_EXPONENTIAL_BACKOFF=true
+WEBHOOK_RETRY_MAX_DELAY_SECONDS=300
+WEBHOOK_RETRY_JITTER_FACTOR=0.2
+WEBHOOK_RETRY_NON_RETRYABLE_STATUS_CODES=400,401,403,404,422
+
+# ===========================================
+# WEBSOCKET
+# ===========================================
+WEBSOCKET_ENABLED=true
+WEBSOCKET_GLOBAL_EVENTS=true
+WEBSOCKET_ALLOWED_HOSTS=
+
+# ===========================================
+# RABBITMQ
+# ===========================================
+RABBITMQ_ENABLED=false
+RABBITMQ_GLOBAL_ENABLED=false
+RABBITMQ_PREFIX_KEY=
+RABBITMQ_EXCHANGE_NAME=evolution_exchange
+RABBITMQ_URI=
+RABBITMQ_FRAME_MAX=8192
+
+# ===========================================
+# NATS
+# ===========================================
+NATS_ENABLED=false
+NATS_GLOBAL_ENABLED=false
+NATS_PREFIX_KEY=
+NATS_EXCHANGE_NAME=evolution_exchange
+NATS_URI=
+
+# ===========================================
+# SQS
+# ===========================================
+SQS_ENABLED=false
+SQS_GLOBAL_ENABLED=false
+SQS_GLOBAL_FORCE_SINGLE_QUEUE=false
+SQS_GLOBAL_PREFIX_NAME=global
+SQS_ACCESS_KEY_ID=
+SQS_SECRET_ACCESS_KEY=
+SQS_ACCOUNT_ID=
+SQS_REGION=
+SQS_MAX_PAYLOAD_SIZE=1048576
+
+# ===========================================
+# PUSHER
+# ===========================================
+PUSHER_ENABLED=false
+PUSHER_GLOBAL_ENABLED=false
+PUSHER_GLOBAL_APP_ID=
+PUSHER_GLOBAL_KEY=
+PUSHER_GLOBAL_SECRET=
+PUSHER_GLOBAL_CLUSTER=
+PUSHER_GLOBAL_USE_TLS=false
+
+# ===========================================
+# WHATSAPP BUSINESS
+# ===========================================
+WA_BUSINESS_TOKEN_WEBHOOK=evolution
+WA_BUSINESS_URL=https://graph.facebook.com
+WA_BUSINESS_VERSION=v18.0
+WA_BUSINESS_LANGUAGE=en
+
+# ===========================================
+# CONFIGURAÇÕES DE SESSÃO
+# ===========================================
+CONFIG_SESSION_PHONE_CLIENT=Evolution API
+CONFIG_SESSION_PHONE_NAME=Chrome
+
+# ===========================================
+# QR CODE
+# ===========================================
+QRCODE_LIMIT=30
+QRCODE_COLOR=#198754
+
+# ===========================================
+# INTEGRAÇÕES
+# ===========================================
+
+# Typebot
+TYPEBOT_ENABLED=false
+TYPEBOT_API_VERSION=old
+TYPEBOT_SEND_MEDIA_BASE64=false
+
+# Chatwoot
+CHATWOOT_ENABLED=false
+CHATWOOT_MESSAGE_DELETE=false
+CHATWOOT_MESSAGE_READ=false
+CHATWOOT_BOT_CONTACT=true
+CHATWOOT_IMPORT_DATABASE_CONNECTION_URI=
+CHATWOOT_IMPORT_PLACEHOLDER_MEDIA_MESSAGE=false
+
+# OpenAI
+OPENAI_ENABLED=false
+OPENAI_API_KEY_GLOBAL=
+
+# Dify
+DIFY_ENABLED=false
+
+# N8N
+N8N_ENABLED=false
+
+# EvoAI
+EVOAI_ENABLED=false
+
+# Flowise
+FLOWISE_ENABLED=false
+
+# ===========================================
+# S3 / MINIO
+# ===========================================
+S3_ENABLED=false
+S3_ACCESS_KEY=
+S3_SECRET_KEY=
+S3_ENDPOINT=
+S3_BUCKET=
+S3_PORT=9000
+S3_USE_SSL=false
+S3_REGION=
+S3_SKIP_POLICY=false
+S3_SAVE_VIDEO=false
+
+# ===========================================
+# MÉTRICAS
+# ===========================================
+PROMETHEUS_METRICS=false
+METRICS_AUTH_REQUIRED=false
+METRICS_USER=
+METRICS_PASSWORD=
+METRICS_ALLOWED_IPS=
+
+# ===========================================
+# TELEMETRIA
+# ===========================================
+TELEMETRY_ENABLED=true
+TELEMETRY_URL=
+
+# ===========================================
+# PROXY
+# ===========================================
+PROXY_HOST=
+PROXY_PORT=
+PROXY_PROTOCOL=
+PROXY_USERNAME=
+PROXY_PASSWORD=
+
+# ===========================================
+# CONVERSOR DE ÁUDIO
+# ===========================================
+API_AUDIO_CONVERTER=
+API_AUDIO_CONVERTER_KEY=
+
+# ===========================================
+# FACEBOOK
+# ===========================================
+FACEBOOK_APP_ID=
+FACEBOOK_CONFIG_ID=
+FACEBOOK_USER_TOKEN=
+
+# ===========================================
+# SENTRY
+# ===========================================
+SENTRY_DSN=
+
+# ===========================================
+# EVENT EMITTER
+# ===========================================
+EVENT_EMITTER_MAX_LISTENERS=50
+
+# ===========================================
+# PROVIDER
+# ===========================================
+PROVIDER_ENABLED=false
+PROVIDER_HOST=
+PROVIDER_PORT=5656
+PROVIDER_PREFIX=evolution

grafana-dashboard.json.example

@@ -0,0 +1,238 @@
+{
+  "dashboard": {
+    "id": null,
+    "title": "Evolution API Monitoring",
+    "tags": ["evolution-api", "whatsapp", "monitoring"],
+    "style": "dark",
+    "timezone": "browser",
+    "panels": [
+      {
+        "id": 1,
+        "title": "API Status",
+        "type": "stat",
+        "targets": [
+          {
+            "expr": "up{job=\"evolution-api\"}",
+            "legendFormat": "API Status"
+          }
+        ],
+        "fieldConfig": {
+          "defaults": {
+            "mappings": [
+              {
+                "options": {
+                  "0": {
+                    "text": "DOWN",
+                    "color": "red"
+                  },
+                  "1": {
+                    "text": "UP",
+                    "color": "green"
+                  }
+                },
+                "type": "value"
+              }
+            ]
+          }
+        },
+        "gridPos": {
+          "h": 8,
+          "w": 12,
+          "x": 0,
+          "y": 0
+        }
+      },
+      {
+        "id": 2,
+        "title": "Total Instances",
+        "type": "stat",
+        "targets": [
+          {
+            "expr": "evolution_instances_total",
+            "legendFormat": "Total Instances"
+          }
+        ],
+        "gridPos": {
+          "h": 8,
+          "w": 12,
+          "x": 12,
+          "y": 0
+        }
+      },
+      {
+        "id": 3,
+        "title": "Instance Status Overview",
+        "type": "piechart",
+        "targets": [
+          {
+            "expr": "sum by (state) (evolution_instance_state)",
+            "legendFormat": "{{ state }}"
+          }
+        ],
+        "gridPos": {
+          "h": 9,
+          "w": 12,
+          "x": 0,
+          "y": 8
+        }
+      },
+      {
+        "id": 4,
+        "title": "Instances by Integration Type",
+        "type": "piechart",
+        "targets": [
+          {
+            "expr": "sum by (integration) (evolution_instance_up)",
+            "legendFormat": "{{ integration }}"
+          }
+        ],
+        "gridPos": {
+          "h": 9,
+          "w": 12,
+          "x": 12,
+          "y": 8
+        }
+      },
+      {
+        "id": 5,
+        "title": "Instance Uptime",
+        "type": "table",
+        "targets": [
+          {
+            "expr": "evolution_instance_up",
+            "format": "table",
+            "instant": true
+          }
+        ],
+        "transformations": [
+          {
+            "id": "organize",
+            "options": {
+              "excludeByName": {
+                "Time": true,
+                "__name__": true
+              },
+              "renameByName": {
+                "instance": "Instance Name",
+                "integration": "Integration Type",
+                "Value": "Status"
+              }
+            }
+          }
+        ],
+        "fieldConfig": {
+          "overrides": [
+            {
+              "matcher": {
+                "id": "byName",
+                "options": "Status"
+              },
+              "properties": [
+                {
+                  "id": "mappings",
+                  "value": [
+                    {
+                      "options": {
+                        "0": {
+                          "text": "DOWN",
+                          "color": "red"
+                        },
+                        "1": {
+                          "text": "UP",
+                          "color": "green"
+                        }
+                      },
+                      "type": "value"
+                    }
+                  ]
+                }
+              ]
+            }
+          ]
+        },
+        "gridPos": {
+          "h": 9,
+          "w": 24,
+          "x": 0,
+          "y": 17
+        }
+      },
+      {
+        "id": 6,
+        "title": "Instance Status Timeline",
+        "type": "timeseries",
+        "targets": [
+          {
+            "expr": "evolution_instance_up",
+            "legendFormat": "{{ instance }} ({{ integration }})"
+          }
+        ],
+        "fieldConfig": {
+          "defaults": {
+            "custom": {
+              "drawStyle": "line",
+              "lineInterpolation": "stepAfter",
+              "lineWidth": 2,
+              "fillOpacity": 10,
+              "gradientMode": "none",
+              "spanNulls": false,
+              "insertNulls": false,
+              "showPoints": "never",
+              "pointSize": 5,
+              "stacking": {
+                "mode": "none",
+                "group": "A"
+              },
+              "axisPlacement": "auto",
+              "axisLabel": "",
+              "scaleDistribution": {
+                "type": "linear"
+              },
+              "hideFrom": {
+                "legend": false,
+                "tooltip": false,
+                "vis": false
+              },
+              "thresholdsStyle": {
+                "mode": "off"
+              }
+            },
+            "min": 0,
+            "max": 1
+          }
+        },
+        "gridPos": {
+          "h": 8,
+          "w": 24,
+          "x": 0,
+          "y": 26
+        }
+      }
+    ],
+    "time": {
+      "from": "now-1h",
+      "to": "now"
+    },
+    "timepicker": {},
+    "templating": {
+      "list": []
+    },
+    "annotations": {
+      "list": [
+        {
+          "builtIn": 1,
+          "datasource": "-- Grafana --",
+          "enable": true,
+          "hide": true,
+          "iconColor": "rgba(0, 211, 255, 1)",
+          "name": "Annotations & Alerts",
+          "type": "dashboard"
+        }
+      ]
+    },
+    "refresh": "30s",
+    "schemaVersion": 27,
+    "version": 0,
+    "links": []
+  }
+}

manager/dist/index.html

@@ -5,8 +5,8 @@
     <link rel="icon" type="image/png" href="https://evolution-api.com/files/evo/favicon.svg" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>Evolution Manager</title>
-    <script type="module" crossorigin src="/assets/index-D-oOjDYe.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-CXH2BdD4.css">
+    <script type="module" crossorigin src="/assets/index-CO3NSIFj.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-DsIrum0U.css">
   </head>
   <body>
     <div id="root"></div>

manager_install.sh

@@ -0,0 +1,8 @@
+#! /bin/bash
+
+cd evolution-manager-v2
+npm install
+npm run build
+cd ..
+rm -rf manager/dist
+cp -r evolution-manager-v2/dist manager/dist

package.json

@@ -1,6 +1,6 @@
 {
   "name": "evolution-api",
-  "version": "2.3.2",
+  "version": "2.3.7",
   "description": "Rest api for communication with WhatsApp",
   "main": "./dist/main.js",
   "type": "commonjs",
@@ -12,12 +12,15 @@
     "test": "tsx watch ./test/all.test.ts",
     "lint": "eslint --fix --ext .ts src",
     "lint:check": "eslint --ext .ts src",
+    "commit": "cz",
+    "commitlint": "commitlint --edit",
     "db:generate": "node runWithProvider.js \"npx prisma generate --schema ./prisma/DATABASE_PROVIDER-schema.prisma\"",
     "db:deploy": "node runWithProvider.js \"rm -rf ./prisma/migrations && cp -r ./prisma/DATABASE_PROVIDER-migrations ./prisma/migrations && npx prisma migrate deploy --schema ./prisma/DATABASE_PROVIDER-schema.prisma\"",
     "db:deploy:win": "node runWithProvider.js \"xcopy /E /I prisma\\DATABASE_PROVIDER-migrations prisma\\migrations && npx prisma migrate deploy --schema prisma\\DATABASE_PROVIDER-schema.prisma\"",
     "db:studio": "node runWithProvider.js \"npx prisma studio --schema ./prisma/DATABASE_PROVIDER-schema.prisma\"",
     "db:migrate:dev": "node runWithProvider.js \"rm -rf ./prisma/migrations && cp -r ./prisma/DATABASE_PROVIDER-migrations ./prisma/migrations && npx prisma migrate dev --schema ./prisma/DATABASE_PROVIDER-schema.prisma && cp -r ./prisma/migrations/* ./prisma/DATABASE_PROVIDER-migrations\"",
-    "db:migrate:dev:win": "node runWithProvider.js \"xcopy /E /I prisma\\DATABASE_PROVIDER-migrations prisma\\migrations && npx prisma migrate dev --schema prisma\\DATABASE_PROVIDER-schema.prisma\""
+    "db:migrate:dev:win": "node runWithProvider.js \"xcopy /E /I prisma\\DATABASE_PROVIDER-migrations prisma\\migrations && npx prisma migrate dev --schema prisma\\DATABASE_PROVIDER-schema.prisma\"",
+    "prepare": "husky"
   },
   "repository": {
     "type": "git",
@@ -48,19 +51,33 @@
     "url": "https://github.com/EvolutionAPI/evolution-api/issues"
   },
   "homepage": "https://github.com/EvolutionAPI/evolution-api#readme",
+  "lint-staged": {
+    "src/**/*.{ts,js}": [
+      "eslint --fix"
+    ],
+    "src/**/*.ts": [
+      "sh -c 'tsc --noEmit'"
+    ]
+  },
+  "config": {
+    "commitizen": {
+      "path": "cz-conventional-changelog"
+    }
+  },
   "dependencies": {
     "@adiwajshing/keyed-db": "^0.2.4",
-    "@aws-sdk/client-sqs": "^3.723.0",
+    "@aws-sdk/client-sqs": "^3.891.0",
     "@ffmpeg-installer/ffmpeg": "^1.1.0",
     "@figuro/chatwoot-sdk": "^1.1.16",
     "@hapi/boom": "^10.0.1",
     "@paralleldrive/cuid2": "^2.2.2",
-    "@prisma/client": "^6.1.0",
-    "@sentry/node": "^8.47.0",
+    "@prisma/client": "^6.16.2",
+    "@sentry/node": "^10.12.0",
+    "@types/uuid": "^10.0.0",
     "amqplib": "^0.10.5",
     "audio-decode": "^2.2.3",
     "axios": "^1.7.9",
-    "baileys": "github:WhiskeySockets/Baileys",
+    "baileys": "7.0.0-rc.9",
     "class-validator": "^0.14.1",
     "compression": "^1.7.5",
     "cors": "^2.8.5",
@@ -73,24 +90,27 @@
     "fluent-ffmpeg": "^2.1.3",
     "form-data": "^4.0.1",
     "https-proxy-agent": "^7.0.6",
+    "fetch-socks": "^1.3.2",
     "i18next": "^23.7.19",
     "jimp": "^1.6.0",
     "json-schema": "^0.4.0",
     "jsonschema": "^1.4.1",
     "jsonwebtoken": "^9.0.2",
+    "kafkajs": "^2.2.4",
+    "libphonenumber-js": "^1.12.25",
     "link-preview-js": "^3.0.13",
     "long": "^5.2.3",
     "mediainfo.js": "^0.3.4",
     "mime": "^4.0.0",
     "mime-types": "^2.1.35",
     "minio": "^8.0.3",
-    "multer": "^1.4.5-lts.1",
+    "multer": "^2.0.2",
     "nats": "^2.29.1",
     "node-cache": "^5.1.2",
     "node-cron": "^3.0.3",
     "openai": "^4.77.3",
     "pg": "^8.13.1",
-    "pino": "^8.11.0",
+    "pino": "^9.10.0",
     "prisma": "^6.1.0",
     "pusher": "^5.2.0",
     "qrcode": "^1.5.4",
@@ -102,30 +122,37 @@
     "socket.io-client": "^4.8.1",
     "socks-proxy-agent": "^8.0.5",
     "swagger-ui-express": "^5.0.1",
-    "tsup": "^8.3.5"
+    "tsup": "^8.3.5",
+    "undici": "^7.16.0",
+    "uuid": "^13.0.0"
   },
   "devDependencies": {
+    "@commitlint/cli": "^19.8.1",
+    "@commitlint/config-conventional": "^19.8.1",
     "@types/compression": "^1.7.5",
     "@types/cors": "^2.8.17",
     "@types/express": "^4.17.18",
     "@types/json-schema": "^7.0.15",
     "@types/mime": "^4.0.0",
     "@types/mime-types": "^2.1.4",
-    "@types/node": "^22.10.5",
+    "@types/node": "^24.5.2",
     "@types/node-cron": "^3.0.11",
     "@types/qrcode": "^1.5.5",
     "@types/qrcode-terminal": "^0.12.2",
-    "@types/uuid": "^10.0.0",
-    "@typescript-eslint/eslint-plugin": "^6.21.0",
-    "@typescript-eslint/parser": "^6.21.0",
+    "@typescript-eslint/eslint-plugin": "^8.44.0",
+    "@typescript-eslint/parser": "^8.44.0",
+    "commitizen": "^4.3.1",
+    "cz-conventional-changelog": "^3.3.0",
     "eslint": "^8.45.0",
-    "eslint-config-prettier": "^9.1.0",
+    "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-import": "^2.31.0",
     "eslint-plugin-prettier": "^5.2.1",
-    "eslint-plugin-simple-import-sort": "^10.0.0",
+    "eslint-plugin-simple-import-sort": "^12.1.1",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.1.6",
     "prettier": "^3.4.2",
     "tsconfig-paths": "^4.2.0",
-    "tsx": "^4.20.3",
+    "tsx": "^4.20.5",
     "typescript": "^5.7.2"
   }
 }

prisma/mysql-migrations/20250918183910_add_kafka_integration/migration.sql

@@ -0,0 +1,231 @@
+/*
+  Warnings:
+
+  - You are about to alter the column `createdAt` on the `Chat` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `updatedAt` on the `Chat` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `createdAt` on the `Chatwoot` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `updatedAt` on the `Chatwoot` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `createdAt` on the `Contact` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `updatedAt` on the `Contact` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `createdAt` on the `Dify` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `updatedAt` on the `Dify` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `createdAt` on the `DifySetting` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `updatedAt` on the `DifySetting` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `createdAt` on the `Evoai` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `updatedAt` on the `Evoai` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `createdAt` on the `EvoaiSetting` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `updatedAt` on the `EvoaiSetting` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `createdAt` on the `EvolutionBot` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `updatedAt` on the `EvolutionBot` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `createdAt` on the `EvolutionBotSetting` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `updatedAt` on the `EvolutionBotSetting` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `createdAt` on the `Flowise` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `updatedAt` on the `Flowise` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `createdAt` on the `FlowiseSetting` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `updatedAt` on the `FlowiseSetting` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `disconnectionAt` on the `Instance` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `createdAt` on the `Instance` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `updatedAt` on the `Instance` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `createdAt` on the `IntegrationSession` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `updatedAt` on the `IntegrationSession` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to drop the column `lid` on the `IsOnWhatsapp` table. All the data in the column will be lost.
+  - You are about to alter the column `createdAt` on the `IsOnWhatsapp` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `updatedAt` on the `IsOnWhatsapp` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `createdAt` on the `Label` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `updatedAt` on the `Label` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `createdAt` on the `Media` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `createdAt` on the `N8n` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `updatedAt` on the `N8n` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `createdAt` on the `N8nSetting` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `updatedAt` on the `N8nSetting` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `createdAt` on the `Nats` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `updatedAt` on the `Nats` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `createdAt` on the `OpenaiBot` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `updatedAt` on the `OpenaiBot` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `createdAt` on the `OpenaiCreds` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `updatedAt` on the `OpenaiCreds` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `createdAt` on the `OpenaiSetting` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `updatedAt` on the `OpenaiSetting` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `createdAt` on the `Proxy` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `updatedAt` on the `Proxy` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `createdAt` on the `Pusher` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `updatedAt` on the `Pusher` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `createdAt` on the `Rabbitmq` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `updatedAt` on the `Rabbitmq` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `createdAt` on the `Session` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `createdAt` on the `Setting` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `updatedAt` on the `Setting` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `createdAt` on the `Sqs` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `updatedAt` on the `Sqs` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `createdAt` on the `Template` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `updatedAt` on the `Template` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to drop the column `splitMessages` on the `Typebot` table. All the data in the column will be lost.
+  - You are about to drop the column `timePerChar` on the `Typebot` table. All the data in the column will be lost.
+  - You are about to alter the column `createdAt` on the `Typebot` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `updatedAt` on the `Typebot` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to drop the column `splitMessages` on the `TypebotSetting` table. All the data in the column will be lost.
+  - You are about to drop the column `timePerChar` on the `TypebotSetting` table. All the data in the column will be lost.
+  - You are about to alter the column `createdAt` on the `TypebotSetting` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `updatedAt` on the `TypebotSetting` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `createdAt` on the `Webhook` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `updatedAt` on the `Webhook` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `createdAt` on the `Websocket` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+  - You are about to alter the column `updatedAt` on the `Websocket` table. The data in that column could be lost. The data in that column will be cast from `Timestamp(0)` to `Timestamp`.
+
+*/
+-- DropIndex
+DROP INDEX `unique_remote_instance` ON `Chat`;
+
+-- AlterTable
+ALTER TABLE `Chat` MODIFY `createdAt` TIMESTAMP NULL DEFAULT CURRENT_TIMESTAMP,
+    MODIFY `updatedAt` TIMESTAMP NULL;
+
+-- AlterTable
+ALTER TABLE `Chatwoot` MODIFY `createdAt` TIMESTAMP NULL DEFAULT CURRENT_TIMESTAMP,
+    MODIFY `updatedAt` TIMESTAMP NOT NULL;
+
+-- AlterTable
+ALTER TABLE `Contact` MODIFY `createdAt` TIMESTAMP NULL DEFAULT CURRENT_TIMESTAMP,
+    MODIFY `updatedAt` TIMESTAMP NULL;
+
+-- AlterTable
+ALTER TABLE `Dify` MODIFY `createdAt` TIMESTAMP NULL DEFAULT CURRENT_TIMESTAMP,
+    MODIFY `updatedAt` TIMESTAMP NOT NULL;
+
+-- AlterTable
+ALTER TABLE `DifySetting` MODIFY `createdAt` TIMESTAMP NULL DEFAULT CURRENT_TIMESTAMP,
+    MODIFY `updatedAt` TIMESTAMP NOT NULL;
+
+-- AlterTable
+ALTER TABLE `Evoai` MODIFY `triggerType` ENUM('all', 'keyword', 'none', 'advanced') NULL,
+    MODIFY `createdAt` TIMESTAMP NULL DEFAULT CURRENT_TIMESTAMP,
+    MODIFY `updatedAt` TIMESTAMP NOT NULL;
+
+-- AlterTable
+ALTER TABLE `EvoaiSetting` MODIFY `createdAt` TIMESTAMP NULL DEFAULT CURRENT_TIMESTAMP,
+    MODIFY `updatedAt` TIMESTAMP NOT NULL;
+
+-- AlterTable
+ALTER TABLE `EvolutionBot` MODIFY `createdAt` TIMESTAMP NULL DEFAULT CURRENT_TIMESTAMP,
+    MODIFY `updatedAt` TIMESTAMP NOT NULL;
+
+-- AlterTable
+ALTER TABLE `EvolutionBotSetting` MODIFY `createdAt` TIMESTAMP NULL DEFAULT CURRENT_TIMESTAMP,
+    MODIFY `updatedAt` TIMESTAMP NOT NULL;
+
+-- AlterTable
+ALTER TABLE `Flowise` MODIFY `createdAt` TIMESTAMP NULL DEFAULT CURRENT_TIMESTAMP,
+    MODIFY `updatedAt` TIMESTAMP NOT NULL;
+
+-- AlterTable
+ALTER TABLE `FlowiseSetting` MODIFY `createdAt` TIMESTAMP NULL DEFAULT CURRENT_TIMESTAMP,
+    MODIFY `updatedAt` TIMESTAMP NOT NULL;
+
+-- AlterTable
+ALTER TABLE `Instance` MODIFY `disconnectionAt` TIMESTAMP NULL,
+    MODIFY `createdAt` TIMESTAMP NULL DEFAULT CURRENT_TIMESTAMP,
+    MODIFY `updatedAt` TIMESTAMP NULL;
+
+-- AlterTable
+ALTER TABLE `IntegrationSession` MODIFY `createdAt` TIMESTAMP NULL DEFAULT CURRENT_TIMESTAMP,
+    MODIFY `updatedAt` TIMESTAMP NOT NULL;
+
+-- AlterTable
+ALTER TABLE `IsOnWhatsapp` DROP COLUMN `lid`,
+    MODIFY `createdAt` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    MODIFY `updatedAt` TIMESTAMP NOT NULL;
+
+-- AlterTable
+ALTER TABLE `Label` MODIFY `createdAt` TIMESTAMP NULL DEFAULT CURRENT_TIMESTAMP,
+    MODIFY `updatedAt` TIMESTAMP NOT NULL;
+
+-- AlterTable
+ALTER TABLE `Media` MODIFY `createdAt` TIMESTAMP NULL DEFAULT CURRENT_TIMESTAMP;
+
+-- AlterTable
+ALTER TABLE `N8n` MODIFY `triggerType` ENUM('all', 'keyword', 'none', 'advanced') NULL,
+    MODIFY `createdAt` TIMESTAMP NULL DEFAULT CURRENT_TIMESTAMP,
+    MODIFY `updatedAt` TIMESTAMP NOT NULL;
+
+-- AlterTable
+ALTER TABLE `N8nSetting` MODIFY `createdAt` TIMESTAMP NULL DEFAULT CURRENT_TIMESTAMP,
+    MODIFY `updatedAt` TIMESTAMP NOT NULL;
+
+-- AlterTable
+ALTER TABLE `Nats` MODIFY `createdAt` TIMESTAMP NULL DEFAULT CURRENT_TIMESTAMP,
+    MODIFY `updatedAt` TIMESTAMP NOT NULL;
+
+-- AlterTable
+ALTER TABLE `OpenaiBot` MODIFY `createdAt` TIMESTAMP NULL DEFAULT CURRENT_TIMESTAMP,
+    MODIFY `updatedAt` TIMESTAMP NOT NULL;
+
+-- AlterTable
+ALTER TABLE `OpenaiCreds` MODIFY `createdAt` TIMESTAMP NULL DEFAULT CURRENT_TIMESTAMP,
+    MODIFY `updatedAt` TIMESTAMP NOT NULL;
+
+-- AlterTable
+ALTER TABLE `OpenaiSetting` MODIFY `createdAt` TIMESTAMP NULL DEFAULT CURRENT_TIMESTAMP,
+    MODIFY `updatedAt` TIMESTAMP NOT NULL;
+
+-- AlterTable
+ALTER TABLE `Proxy` MODIFY `createdAt` TIMESTAMP NULL DEFAULT CURRENT_TIMESTAMP,
+    MODIFY `updatedAt` TIMESTAMP NOT NULL;
+
+-- AlterTable
+ALTER TABLE `Pusher` MODIFY `createdAt` TIMESTAMP NULL DEFAULT CURRENT_TIMESTAMP,
+    MODIFY `updatedAt` TIMESTAMP NOT NULL;
+
+-- AlterTable
+ALTER TABLE `Rabbitmq` MODIFY `createdAt` TIMESTAMP NULL DEFAULT CURRENT_TIMESTAMP,
+    MODIFY `updatedAt` TIMESTAMP NOT NULL;
+
+-- AlterTable
+ALTER TABLE `Session` MODIFY `createdAt` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP;
+
+-- AlterTable
+ALTER TABLE `Setting` MODIFY `createdAt` TIMESTAMP NULL DEFAULT CURRENT_TIMESTAMP,
+    MODIFY `updatedAt` TIMESTAMP NOT NULL;
+
+-- AlterTable
+ALTER TABLE `Sqs` MODIFY `createdAt` TIMESTAMP NULL DEFAULT CURRENT_TIMESTAMP,
+    MODIFY `updatedAt` TIMESTAMP NOT NULL;
+
+-- AlterTable
+ALTER TABLE `Template` MODIFY `createdAt` TIMESTAMP NULL DEFAULT CURRENT_TIMESTAMP,
+    MODIFY `updatedAt` TIMESTAMP NOT NULL;
+
+-- AlterTable
+ALTER TABLE `Typebot` DROP COLUMN `splitMessages`,
+    DROP COLUMN `timePerChar`,
+    MODIFY `createdAt` TIMESTAMP NULL DEFAULT CURRENT_TIMESTAMP,
+    MODIFY `updatedAt` TIMESTAMP NULL;
+
+-- AlterTable
+ALTER TABLE `TypebotSetting` DROP COLUMN `splitMessages`,
+    DROP COLUMN `timePerChar`,
+    MODIFY `createdAt` TIMESTAMP NULL DEFAULT CURRENT_TIMESTAMP,
+    MODIFY `updatedAt` TIMESTAMP NOT NULL;
+
+-- AlterTable
+ALTER TABLE `Webhook` MODIFY `createdAt` TIMESTAMP NULL DEFAULT CURRENT_TIMESTAMP,
+    MODIFY `updatedAt` TIMESTAMP NOT NULL;
+
+-- AlterTable
+ALTER TABLE `Websocket` MODIFY `createdAt` TIMESTAMP NULL DEFAULT CURRENT_TIMESTAMP,
+    MODIFY `updatedAt` TIMESTAMP NOT NULL;
+
+-- CreateTable
+CREATE TABLE `Kafka` (
+    `id` VARCHAR(191) NOT NULL,
+    `enabled` BOOLEAN NOT NULL DEFAULT false,
+    `events` JSON NOT NULL,
+    `createdAt` TIMESTAMP NULL DEFAULT CURRENT_TIMESTAMP,
+    `updatedAt` TIMESTAMP NOT NULL,
+    `instanceId` VARCHAR(191) NOT NULL,
+
+    UNIQUE INDEX `Kafka_instanceId_key`(`instanceId`),
+    PRIMARY KEY (`id`)
+) DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
+
+-- AddForeignKey
+ALTER TABLE `Kafka` ADD CONSTRAINT `Kafka_instanceId_fkey` FOREIGN KEY (`instanceId`) REFERENCES `Instance`(`id`) ON DELETE CASCADE ON UPDATE CASCADE;

prisma/mysql-schema.prisma

@@ -88,6 +88,7 @@ model Instance {
   Rabbitmq                Rabbitmq?
   Nats                    Nats?
   Sqs                     Sqs?
+  Kafka                   Kafka?
   Websocket               Websocket?
   Typebot                 Typebot[]
   Session                 Session?
@@ -105,8 +106,11 @@ model Instance {
   EvolutionBotSetting     EvolutionBotSetting?
   Flowise                 Flowise[]
   FlowiseSetting          FlowiseSetting?
-  Pusher                  Pusher?
   N8n                     N8n[]
+  N8nSetting              N8nSetting?
+  Evoai                   Evoai[]
+  EvoaiSetting            EvoaiSetting?
+  Pusher                  Pusher?
 }
 
 model Session {
@@ -309,6 +313,16 @@ model Sqs {
   instanceId String    @unique
 }
 
+model Kafka {
+  id         String    @id @default(cuid())
+  enabled    Boolean   @default(false)
+  events     Json      @db.Json
+  createdAt  DateTime? @default(dbgenerated("CURRENT_TIMESTAMP")) @db.Timestamp
+  updatedAt  DateTime  @updatedAt @db.Timestamp
+  Instance   Instance  @relation(fields: [instanceId], references: [id], onDelete: Cascade)
+  instanceId String    @unique
+}
+
 model Websocket {
   id         String    @id @default(cuid())
   enabled    Boolean   @default(false)
@@ -647,7 +661,7 @@ model IsOnWhatsapp {
 
 model N8n {
   id              String           @id @default(cuid())
-  enabled         Boolean          @default(true) @db.TinyInt(1)
+  enabled         Boolean          @default(true) @db.TinyInt()
   description     String?          @db.VarChar(255)
   webhookUrl      String?          @db.VarChar(255)
   basicAuthUser   String?          @db.VarChar(255)
@@ -666,7 +680,7 @@ model N8n {
   triggerType     TriggerType?
   triggerOperator TriggerOperator?
   triggerValue    String?
-  createdAt       DateTime?        @default(now()) @db.Timestamp
+  createdAt       DateTime?        @default(dbgenerated("CURRENT_TIMESTAMP")) @db.Timestamp
   updatedAt       DateTime         @updatedAt @db.Timestamp
   Instance        Instance         @relation(fields: [instanceId], references: [id], onDelete: Cascade)
   instanceId      String
@@ -686,7 +700,7 @@ model N8nSetting {
   ignoreJids      Json?
   splitMessages   Boolean?  @default(false)
   timePerChar     Int?      @default(50) @db.Int
-  createdAt       DateTime? @default(now()) @db.Timestamp
+  createdAt       DateTime? @default(dbgenerated("CURRENT_TIMESTAMP")) @db.Timestamp
   updatedAt       DateTime  @updatedAt @db.Timestamp
   Fallback        N8n?      @relation(fields: [n8nIdFallback], references: [id])
   n8nIdFallback   String?   @db.VarChar(100)
@@ -696,7 +710,7 @@ model N8nSetting {
 
 model Evoai {
   id              String           @id @default(cuid())
-  enabled         Boolean          @default(true) @db.TinyInt(1)
+  enabled         Boolean          @default(true) @db.TinyInt()
   description     String?          @db.VarChar(255)
   agentUrl        String?          @db.VarChar(255)
   apiKey          String?          @db.VarChar(255)
@@ -714,7 +728,7 @@ model Evoai {
   triggerType     TriggerType?
   triggerOperator TriggerOperator?
   triggerValue    String?
-  createdAt       DateTime?        @default(now()) @db.Timestamp
+  createdAt       DateTime?        @default(dbgenerated("CURRENT_TIMESTAMP")) @db.Timestamp
   updatedAt       DateTime         @updatedAt @db.Timestamp
   Instance        Instance         @relation(fields: [instanceId], references: [id], onDelete: Cascade)
   instanceId      String
@@ -734,7 +748,7 @@ model EvoaiSetting {
   ignoreJids      Json?
   splitMessages   Boolean?  @default(false)
   timePerChar     Int?      @default(50) @db.Int
-  createdAt       DateTime? @default(now()) @db.Timestamp
+  createdAt       DateTime? @default(dbgenerated("CURRENT_TIMESTAMP")) @db.Timestamp
   updatedAt       DateTime  @updatedAt @db.Timestamp
   Fallback        Evoai?    @relation(fields: [evoaiIdFallback], references: [id])
   evoaiIdFallback String?   @db.VarChar(100)

prisma/postgresql-migrations/20250918182355_add_kafka_integration/migration.sql

@@ -0,0 +1,17 @@
+-- CreateTable
+CREATE TABLE "Kafka" (
+    "id" TEXT NOT NULL,
+    "enabled" BOOLEAN NOT NULL DEFAULT false,
+    "events" JSONB NOT NULL,
+    "createdAt" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP NOT NULL,
+    "instanceId" TEXT NOT NULL,
+
+    CONSTRAINT "Kafka_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateIndex
+CREATE UNIQUE INDEX "Kafka_instanceId_key" ON "Kafka"("instanceId");
+
+-- AddForeignKey
+ALTER TABLE "Kafka" ADD CONSTRAINT "Kafka_instanceId_fkey" FOREIGN KEY ("instanceId") REFERENCES "Instance"("id") ON DELETE CASCADE ON UPDATE CASCADE;

prisma/postgresql-migrations/20251122003044_add_chat_instance_remotejid_unique/migration.sql

@@ -0,0 +1,16 @@
+-- 1. Cleanup: Remove duplicate chats, keeping the most recently updated one
+DELETE FROM "Chat"
+WHERE id IN (
+  SELECT id FROM (
+    SELECT id,
+           ROW_NUMBER() OVER (
+             PARTITION BY "instanceId", "remoteJid"
+             ORDER BY "updatedAt" DESC
+           ) as row_num
+    FROM "Chat"
+  ) t
+  WHERE t.row_num > 1
+);
+
+-- 2. Create the unique index (Constraint)
+CREATE UNIQUE INDEX "Chat_instanceId_remoteJid_key" ON "Chat"("instanceId", "remoteJid");

prisma/postgresql-schema.prisma

@@ -88,6 +88,7 @@ model Instance {
   Rabbitmq                Rabbitmq?
   Nats                    Nats?
   Sqs                     Sqs?
+  Kafka                   Kafka?
   Websocket               Websocket?
   Typebot                 Typebot[]
   Session                 Session?
@@ -131,6 +132,7 @@ model Chat {
   instanceId     String
   unreadMessages Int       @default(0)
 
+  @@unique([instanceId, remoteJid])
   @@index([instanceId])
   @@index([remoteJid])
 }
@@ -312,6 +314,16 @@ model Sqs {
   instanceId String    @unique
 }
 
+model Kafka {
+  id         String    @id @default(cuid())
+  enabled    Boolean   @default(false) @db.Boolean
+  events     Json      @db.JsonB
+  createdAt  DateTime? @default(now()) @db.Timestamp
+  updatedAt  DateTime  @updatedAt @db.Timestamp
+  Instance   Instance  @relation(fields: [instanceId], references: [id], onDelete: Cascade)
+  instanceId String    @unique
+}
+
 model Websocket {
   id         String    @id @default(cuid())
   enabled    Boolean   @default(false) @db.Boolean

prisma/psql_bouncer-schema.prisma

@@ -89,6 +89,7 @@ model Instance {
   Rabbitmq                Rabbitmq?
   Nats                    Nats?
   Sqs                     Sqs?
+  Kafka                   Kafka?
   Websocket               Websocket?
   Typebot                 Typebot[]
   Session                 Session?
@@ -313,6 +314,16 @@ model Sqs {
   instanceId String    @unique
 }
 
+model Kafka {
+  id         String    @id @default(cuid())
+  enabled    Boolean   @default(false) @db.Boolean
+  events     Json      @db.JsonB
+  createdAt  DateTime? @default(now()) @db.Timestamp
+  updatedAt  DateTime  @updatedAt @db.Timestamp
+  Instance   Instance  @relation(fields: [instanceId], references: [id], onDelete: Cascade)
+  instanceId String    @unique
+}
+
 model Websocket {
   id         String    @id @default(cuid())
   enabled    Boolean   @default(false) @db.Boolean

prometheus.yml.example

@@ -0,0 +1,76 @@
+# Prometheus configuration example for Evolution API
+# Copy this file to prometheus.yml and adjust the settings
+
+global:
+  scrape_interval: 15s
+  evaluation_interval: 15s
+
+rule_files:
+  # - "first_rules.yml"
+  # - "second_rules.yml"
+
+scrape_configs:
+  # Evolution API metrics
+  - job_name: 'evolution-api'
+    static_configs:
+      - targets: ['localhost:8080']  # Adjust to your Evolution API URL
+    
+    # Metrics endpoint path
+    metrics_path: '/metrics'
+    
+    # Scrape interval for this job
+    scrape_interval: 30s
+    
+    # Basic authentication (if METRICS_AUTH_REQUIRED=true)
+    basic_auth:
+      username: 'prometheus'  # Should match METRICS_USER
+      password: 'secure_random_password_here'  # Should match METRICS_PASSWORD
+    
+    # Optional: Add custom labels
+    relabel_configs:
+      - source_labels: [__address__]
+        target_label: __param_target
+      - source_labels: [__param_target]
+        target_label: instance
+      - target_label: __address__
+        replacement: localhost:8080  # Evolution API address
+
+# Alerting configuration (optional)
+alerting:
+  alertmanagers:
+    - static_configs:
+        - targets:
+          # - alertmanager:9093
+
+# Example alert rules for Evolution API
+# Create a file called evolution_alerts.yml with these rules:
+#
+# groups:
+#   - name: evolution-api
+#     rules:
+#       - alert: EvolutionAPIDown
+#         expr: up{job="evolution-api"} == 0
+#         for: 1m
+#         labels:
+#           severity: critical
+#         annotations:
+#           summary: "Evolution API is down"
+#           description: "Evolution API has been down for more than 1 minute."
+#       
+#       - alert: EvolutionInstanceDown
+#         expr: evolution_instance_up == 0
+#         for: 2m
+#         labels:
+#           severity: warning
+#         annotations:
+#           summary: "Evolution instance {{ $labels.instance }} is down"
+#           description: "Instance {{ $labels.instance }} has been down for more than 2 minutes."
+#       
+#       - alert: HighInstanceCount
+#         expr: evolution_instances_total > 100
+#         for: 5m
+#         labels:
+#           severity: warning
+#         annotations:
+#           summary: "High number of Evolution instances"
+#           description: "Evolution API is managing {{ $value }} instances."

src/api/controllers/instance.controller.ts

@@ -92,6 +92,15 @@ export class InstanceController {
         instanceId: instanceId,
       });
 
+      const instanceDto: InstanceDto = {
+        instanceName: instance.instanceName,
+        instanceId: instance.instanceId,
+        connectionStatus:
+          typeof instance.connectionStatus === 'string'
+            ? instance.connectionStatus
+            : instance.connectionStatus?.state || 'unknown',
+      };
+
       if (instanceData.proxyHost && instanceData.proxyPort && instanceData.proxyProtocol) {
         const testProxy = await this.proxyService.testProxy({
           host: instanceData.proxyHost,
@@ -103,8 +112,7 @@ export class InstanceController {
         if (!testProxy) {
           throw new BadRequestException('Invalid proxy');
         }
-
-        await this.proxyService.createProxy(instance, {
+        await this.proxyService.createProxy(instanceDto, {
           enabled: true,
           host: instanceData.proxyHost,
           port: instanceData.proxyPort,
@@ -125,7 +133,7 @@ export class InstanceController {
         wavoipToken: instanceData.wavoipToken || '',
       };
 
-      await this.settingsService.create(instance, settings);
+      await this.settingsService.create(instanceDto, settings);
 
       let webhookWaBusiness = null,
         accessTokenWaBusiness = '';
@@ -155,7 +163,10 @@ export class InstanceController {
             integration: instanceData.integration,
             webhookWaBusiness,
             accessTokenWaBusiness,
-            status: instance.connectionStatus.state,
+            status:
+              typeof instance.connectionStatus === 'string'
+                ? instance.connectionStatus
+                : instance.connectionStatus?.state || 'unknown',
           },
           hash,
           webhook: {
@@ -217,7 +228,7 @@ export class InstanceController {
       const urlServer = this.configService.get<HttpServer>('SERVER').URL;
 
       try {
-        this.chatwootService.create(instance, {
+        this.chatwootService.create(instanceDto, {
           enabled: true,
           accountId: instanceData.chatwootAccountId,
           token: instanceData.chatwootToken,
@@ -246,7 +257,10 @@ export class InstanceController {
           integration: instanceData.integration,
           webhookWaBusiness,
           accessTokenWaBusiness,
-          status: instance.connectionStatus.state,
+          status:
+            typeof instance.connectionStatus === 'string'
+              ? instance.connectionStatus
+              : instance.connectionStatus?.state || 'unknown',
         },
         hash,
         webhook: {
@@ -338,20 +352,38 @@ export class InstanceController {
         throw new BadRequestException('The "' + instanceName + '" instance does not exist');
       }
 
-      if (state == 'close') {
+      if (state === 'close') {
         throw new BadRequestException('The "' + instanceName + '" instance is not connected');
-      } else if (state == 'open') {
+      }
+      this.logger.info(`Restarting instance: ${instanceName}`);
+
+      if (typeof instance.restart === 'function') {
+        await instance.restart();
+        // Wait a bit for the reconnection to be established
+        await new Promise((r) => setTimeout(r, 2000));
+        return {
+          instance: {
+            instanceName: instanceName,
+            status: instance.connectionStatus?.state || 'connecting',
+          },
+        };
+      }
+
+      // Fallback for Baileys (uses different mechanism)
+      if (state === 'open' || state === 'connecting') {
         if (this.configService.get<Chatwoot>('CHATWOOT').ENABLED) instance.clearCacheChatwoot();
-        this.logger.info('restarting instance' + instanceName);
 
-        instance.client?.ws?.close();
-        instance.client?.end(new Error('restart'));
-        return await this.connectToWhatsapp({ instanceName });
-      } else if (state == 'connecting') {
         instance.client?.ws?.close();
         instance.client?.end(new Error('restart'));
         return await this.connectToWhatsapp({ instanceName });
       }
+
+      return {
+        instance: {
+          instanceName: instanceName,
+          status: state,
+        },
+      };
     } catch (error) {
       this.logger.error(error);
       return { error: true, message: error.toString() };
@@ -409,7 +441,7 @@ export class InstanceController {
     }
 
     try {
-      this.waMonitor.waInstances[instanceName]?.logoutInstance();
+      await this.waMonitor.waInstances[instanceName]?.logoutInstance();
 
       return { status: 'SUCCESS', error: false, response: { message: 'Instance logged out' } };
     } catch (error) {

src/api/controllers/template.controller.ts

@@ -12,4 +12,15 @@ export class TemplateController {
   public async findTemplate(instance: InstanceDto) {
     return this.templateService.find(instance);
   }
+
+  public async editTemplate(
+    instance: InstanceDto,
+    data: { templateId: string; category?: string; components?: any; allowCategoryChange?: boolean; ttl?: number },
+  ) {
+    return this.templateService.edit(instance, data);
+  }
+
+  public async deleteTemplate(instance: InstanceDto, data: { name: string; hsmId?: string }) {
+    return this.templateService.delete(instance, data);
+  }
 }

src/api/dto/instance.dto.ts

@@ -12,6 +12,7 @@ export class InstanceDto extends IntegrationDto {
   token?: string;
   status?: string;
   ownerJid?: string;
+  connectionStatus?: string;
   profileName?: string;
   profilePicUrl?: string;
   // settings

src/api/dto/template.dto.ts

@@ -6,3 +6,16 @@ export class TemplateDto {
   components: any;
   webhookUrl?: string;
 }
+
+export class TemplateEditDto {
+  templateId: string;
+  category?: 'AUTHENTICATION' | 'MARKETING' | 'UTILITY';
+  allowCategoryChange?: boolean;
+  ttl?: number;
+  components?: any;
+}
+
+export class TemplateDeleteDto {
+  name: string;
+  hsmId?: string;
+}

src/api/integrations/channel/evolution/evolution.channel.service.ts

@@ -13,9 +13,10 @@ import { chatbotController } from '@api/server.module';
 import { CacheService } from '@api/services/cache.service';
 import { ChannelStartupService } from '@api/services/channel.service';
 import { Events, wa } from '@api/types/wa.types';
-import { Chatwoot, ConfigService, Openai, S3 } from '@config/env.config';
+import { AudioConverter, Chatwoot, ConfigService, Openai, S3 } from '@config/env.config';
 import { BadRequestException, InternalServerErrorException } from '@exceptions';
 import { createJid } from '@utils/createJid';
+import { sendTelemetry } from '@utils/sendTelemetry';
 import axios from 'axios';
 import { isBase64, isURL } from 'class-validator';
 import EventEmitter2 from 'eventemitter2';
@@ -171,6 +172,8 @@ export class EvolutionStartupService extends ChannelStartupService {
 
         this.logger.log(messageRaw);
 
+        sendTelemetry(`received.message.${messageRaw.messageType ?? 'unknown'}`);
+
         this.sendDataWebhook(Events.MESSAGES_UPSERT, messageRaw);
 
         await chatbotController.emit({
@@ -323,8 +326,8 @@ export class EvolutionStartupService extends ChannelStartupService {
         messageRaw = {
           key: { fromMe: true, id: messageId, remoteJid: number },
           message: {
-            base64: isBase64(message.media) ? message.media : undefined,
-            mediaUrl: isURL(message.media) ? message.media : undefined,
+            base64: isBase64(message.media) ? message.media : null,
+            mediaUrl: isURL(message.media) ? message.media : null,
             quoted,
           },
           messageType: 'imageMessage',
@@ -337,8 +340,8 @@ export class EvolutionStartupService extends ChannelStartupService {
         messageRaw = {
           key: { fromMe: true, id: messageId, remoteJid: number },
           message: {
-            base64: isBase64(message.media) ? message.media : undefined,
-            mediaUrl: isURL(message.media) ? message.media : undefined,
+            base64: isBase64(message.media) ? message.media : null,
+            mediaUrl: isURL(message.media) ? message.media : null,
             quoted,
           },
           messageType: 'videoMessage',
@@ -351,8 +354,8 @@ export class EvolutionStartupService extends ChannelStartupService {
         messageRaw = {
           key: { fromMe: true, id: messageId, remoteJid: number },
           message: {
-            base64: isBase64(message.media) ? message.media : undefined,
-            mediaUrl: isURL(message.media) ? message.media : undefined,
+            base64: isBase64(message.media) ? message.media : null,
+            mediaUrl: isURL(message.media) ? message.media : null,
             quoted,
           },
           messageType: 'audioMessage',
@@ -372,8 +375,8 @@ export class EvolutionStartupService extends ChannelStartupService {
         messageRaw = {
           key: { fromMe: true, id: messageId, remoteJid: number },
           message: {
-            base64: isBase64(message.media) ? message.media : undefined,
-            mediaUrl: isURL(message.media) ? message.media : undefined,
+            base64: isBase64(message.media) ? message.media : null,
+            mediaUrl: isURL(message.media) ? message.media : null,
             quoted,
           },
           messageType: 'documentMessage',
@@ -449,7 +452,7 @@ export class EvolutionStartupService extends ChannelStartupService {
         }
       }
 
-      const base64 = messageRaw.message.base64;
+      const { base64 } = messageRaw.message;
       delete messageRaw.message.base64;
 
       if (base64 || file || audioFile) {
@@ -622,7 +625,8 @@ export class EvolutionStartupService extends ChannelStartupService {
     number = number.replace(/\D/g, '');
     const hash = `${number}-${new Date().getTime()}`;
 
-    if (process.env.API_AUDIO_CONVERTER) {
+    const audioConverterConfig = this.configService.get<AudioConverter>('AUDIO_CONVERTER');
+    if (audioConverterConfig.API_URL) {
       try {
         this.logger.verbose('Using audio converter API');
         const formData = new FormData();
@@ -640,10 +644,10 @@ export class EvolutionStartupService extends ChannelStartupService {
 
         formData.append('format', 'mp4');
 
-        const response = await axios.post(process.env.API_AUDIO_CONVERTER, formData, {
+        const response = await axios.post(audioConverterConfig.API_URL, formData, {
           headers: {
             ...formData.getHeaders(),
-            apikey: process.env.API_AUDIO_CONVERTER_KEY,
+            apikey: audioConverterConfig.API_KEY,
           },
         });
 

src/api/integrations/channel/meta/whatsapp.business.service.ts

@@ -20,10 +20,11 @@ import { chatbotController } from '@api/server.module';
 import { CacheService } from '@api/services/cache.service';
 import { ChannelStartupService } from '@api/services/channel.service';
 import { Events, wa } from '@api/types/wa.types';
-import { Chatwoot, ConfigService, Database, Openai, S3, WaBusiness } from '@config/env.config';
+import { AudioConverter, Chatwoot, ConfigService, Database, Openai, S3, WaBusiness } from '@config/env.config';
 import { BadRequestException, InternalServerErrorException } from '@exceptions';
 import { createJid } from '@utils/createJid';
 import { status } from '@utils/renderStatus';
+import { sendTelemetry } from '@utils/sendTelemetry';
 import axios from 'axios';
 import { arrayUnique, isURL } from 'class-validator';
 import EventEmitter2 from 'eventemitter2';
@@ -459,6 +460,15 @@ export class BusinessStartupService extends ChannelStartupService {
                   mediaType = 'video';
                 }
 
+                if (mediaType == 'video' && !this.configService.get<S3>('S3').SAVE_VIDEO) {
+                  this.logger?.info?.('Video upload attempted but is disabled by configuration.');
+                  return {
+                    success: false,
+                    message:
+                      'Video upload is currently disabled. Please contact support if you need this feature enabled.',
+                  };
+                }
+
                 const mimetype = result.data?.mime_type || result.headers['content-type'];
 
                 const contentDisposition = result.headers['content-disposition'];
@@ -506,7 +516,9 @@ export class BusinessStartupService extends ChannelStartupService {
                 const mediaUrl = await s3Service.getObjectUrl(fullName);
 
                 messageRaw.message.mediaUrl = mediaUrl;
-                messageRaw.message.base64 = buffer.data.toString('base64');
+                if (this.localWebhook.enabled && this.localWebhook.webhookBase64) {
+                  messageRaw.message.base64 = buffer.data.toString('base64');
+                }
 
                 // Processar OpenAI speech-to-text para áudio após o mediaUrl estar disponível
                 if (this.configService.get<Openai>('OPENAI').ENABLED && mediaType === 'audio') {
@@ -544,11 +556,19 @@ export class BusinessStartupService extends ChannelStartupService {
               this.logger.error(['Error on upload file to minio', error?.message, error?.stack]);
             }
           } else {
-            const buffer = await this.downloadMediaMessage(received?.messages[0]);
-            messageRaw.message.base64 = buffer.toString('base64');
+            if (this.localWebhook.enabled && this.localWebhook.webhookBase64) {
+              const buffer = await this.downloadMediaMessage(received?.messages[0]);
+              messageRaw.message.base64 = buffer.toString('base64');
+            }
 
             // Processar OpenAI speech-to-text para áudio mesmo sem S3
             if (this.configService.get<Openai>('OPENAI').ENABLED && message.type === 'audio') {
+              let openAiBase64 = messageRaw.message.base64;
+              if (!openAiBase64) {
+                const buffer = await this.downloadMediaMessage(received?.messages[0]);
+                openAiBase64 = buffer.toString('base64');
+              }
+
               const openAiDefaultSettings = await this.prismaRepository.openaiSetting.findFirst({
                 where: {
                   instanceId: this.instanceId,
@@ -564,7 +584,7 @@ export class BusinessStartupService extends ChannelStartupService {
                     openAiDefaultSettings.OpenaiCreds,
                     {
                       message: {
-                        base64: messageRaw.message.base64,
+                        base64: openAiBase64,
                         ...messageRaw,
                       },
                     },
@@ -646,6 +666,8 @@ export class BusinessStartupService extends ChannelStartupService {
 
         this.logger.log(messageRaw);
 
+        sendTelemetry(`received.message.${messageRaw.messageType ?? 'unknown'}`);
+
         this.sendDataWebhook(Events.MESSAGES_UPSERT, messageRaw);
 
         await chatbotController.emit({
@@ -1004,6 +1026,7 @@ export class BusinessStartupService extends ChannelStartupService {
             [message['mediaType']]: {
               [message['type']]: message['id'],
               ...(message['mediaType'] !== 'audio' &&
+                message['mediaType'] !== 'video' &&
                 message['fileName'] &&
                 !isImage && { filename: message['fileName'] }),
               ...(message['mediaType'] !== 'audio' && message['caption'] && { caption: message['caption'] }),
@@ -1291,7 +1314,8 @@ export class BusinessStartupService extends ChannelStartupService {
     number = number.replace(/\D/g, '');
     const hash = `${number}-${new Date().getTime()}`;
 
-    if (process.env.API_AUDIO_CONVERTER) {
+    const audioConverterConfig = this.configService.get<AudioConverter>('AUDIO_CONVERTER');
+    if (audioConverterConfig.API_URL) {
       this.logger.verbose('Using audio converter API');
       const formData = new FormData();
 
@@ -1308,10 +1332,10 @@ export class BusinessStartupService extends ChannelStartupService {
 
       formData.append('format', 'mp3');
 
-      const response = await axios.post(process.env.API_AUDIO_CONVERTER, formData, {
+      const response = await axios.post(audioConverterConfig.API_URL, formData, {
         headers: {
           ...formData.getHeaders(),
-          apikey: process.env.API_AUDIO_CONVERTER_KEY,
+          apikey: audioConverterConfig.API_KEY,
         },
       });
 
@@ -1593,9 +1617,14 @@ export class BusinessStartupService extends ChannelStartupService {
       const messageType = msg.messageType.includes('Message') ? msg.messageType : msg.messageType + 'Message';
       const mediaMessage = msg.message[messageType];
 
+      if (!msg.message?.base64) {
+        const buffer = await this.downloadMediaMessage({ type: messageType, ...msg.message });
+        msg.message.base64 = buffer.toString('base64');
+      }
+
       return {
         mediaType: msg.messageType,
-        fileName: mediaMessage?.fileName,
+        fileName: mediaMessage?.fileName || mediaMessage?.filename,
         caption: mediaMessage?.caption,
         size: {
           fileLength: mediaMessage?.fileLength,

src/api/integrations/channel/whatsapp/baileysMessage.processor.ts

@@ -1,5 +1,5 @@
 import { Logger } from '@config/logger.config';
-import { BaileysEventMap, MessageUpsertType, proto } from 'baileys';
+import { BaileysEventMap, MessageUpsertType, WAMessage } from 'baileys';
 import { catchError, concatMap, delay, EMPTY, from, retryWhen, Subject, Subscription, take, tap } from 'rxjs';
 
 type MessageUpsertPayload = BaileysEventMap['messages.upsert'];
@@ -12,13 +12,29 @@ export class BaileysMessageProcessor {
   private subscription?: Subscription;
 
   protected messageSubject = new Subject<{
-    messages: proto.IWebMessageInfo[];
+    messages: WAMessage[];
     type: MessageUpsertType;
     requestId?: string;
     settings: any;
   }>();
 
   mount({ onMessageReceive }: MountProps) {
+    // Se já existe subscription, fazer cleanup primeiro
+    if (this.subscription && !this.subscription.closed) {
+      this.subscription.unsubscribe();
+    }
+
+    // Se o Subject foi completado, recriar
+    if (this.messageSubject.closed) {
+      this.processorLogs.warn('MessageSubject was closed, recreating...');
+      this.messageSubject = new Subject<{
+        messages: WAMessage[];
+        type: MessageUpsertType;
+        requestId?: string;
+        settings: any;
+      }>();
+    }
+
     this.subscription = this.messageSubject
       .pipe(
         tap(({ messages }) => {

src/api/integrations/channel/whatsapp/voiceCalls/useVoiceCallsBaileys.ts

@@ -71,7 +71,7 @@ export const useVoiceCallsBaileys = async (
 
   socket.on('assertSessions', async (jids, force, callback) => {
     try {
-      const response = await baileys_sock.assertSessions(jids, force);
+      const response = await baileys_sock.assertSessions(jids);
 
       callback(response);
 

src/api/integrations/chatbot/base-chatbot.controller.ts

@@ -2,6 +2,7 @@ import { IgnoreJidDto } from '@api/dto/chatbot.dto';
 import { InstanceDto } from '@api/dto/instance.dto';
 import { PrismaRepository } from '@api/repository/repository.service';
 import { WAMonitoringService } from '@api/services/monitor.service';
+import { Events } from '@api/types/wa.types';
 import { Logger } from '@config/logger.config';
 import { BadRequestException } from '@exceptions';
 import { TriggerOperator, TriggerType } from '@prisma/client';
@@ -446,6 +447,16 @@ export abstract class BaseChatbotController<BotType = any, BotData extends BaseC
 
       const remoteJid = data.remoteJid;
       const status = data.status;
+      const session = await this.getSession(remoteJid, instance);
+
+      if (this.integrationName === 'Typebot') {
+        const typebotData = {
+          remoteJid: remoteJid,
+          status: status,
+          session,
+        };
+        this.waMonitor.waInstances[instance.instanceName].sendDataWebhook(Events.TYPEBOT_CHANGE_STATUS, typebotData);
+      }
 
       if (status === 'delete') {
         await this.sessionRepository.deleteMany({
@@ -867,6 +878,16 @@ export abstract class BaseChatbotController<BotType = any, BotData extends BaseC
             status: 'paused',
           },
         });
+
+        if (this.integrationName === 'Typebot') {
+          const typebotData = {
+            remoteJid: remoteJid,
+            status: 'paused',
+            session,
+          };
+          this.waMonitor.waInstances[instance.instanceName].sendDataWebhook(Events.TYPEBOT_CHANGE_STATUS, typebotData);
+        }
+
         return;
       }
 
@@ -880,12 +901,6 @@ export abstract class BaseChatbotController<BotType = any, BotData extends BaseC
         return;
       }
 
-      // Skip if session exists and status is paused
-      if (session && session.status === 'paused') {
-        this.logger.warn(`Session for ${remoteJid} is paused, skipping message processing`);
-        return;
-      }
-
       // Merged settings
       const mergedSettings = {
         ...settings,

src/api/integrations/chatbot/base-chatbot.service.ts

@@ -49,7 +49,7 @@ export abstract class BaseChatbotService<BotType = any, SettingsType = any> {
     try {
       JSON.parse(str);
       return true;
-    } catch (e) {
+    } catch {
       return false;
     }
   }
@@ -180,6 +180,7 @@ export abstract class BaseChatbotService<BotType = any, SettingsType = any> {
     remoteJid: string,
     message: string,
     settings: SettingsType,
+    linkPreview: boolean = true,
   ): Promise<void> {
     if (!message) return;
 
@@ -202,7 +203,7 @@ export abstract class BaseChatbotService<BotType = any, SettingsType = any> {
       if (mediaType) {
         // Send accumulated text before sending media
         if (textBuffer.trim()) {
-          await this.sendFormattedText(instance, remoteJid, textBuffer.trim(), settings, splitMessages);
+          await this.sendFormattedText(instance, remoteJid, textBuffer.trim(), settings, splitMessages, linkPreview);
           textBuffer = '';
         }
 
@@ -210,7 +211,7 @@ export abstract class BaseChatbotService<BotType = any, SettingsType = any> {
         try {
           if (mediaType === 'audio') {
             await instance.audioWhatsapp({
-              number: remoteJid.split('@')[0],
+              number: remoteJid.includes('@lid') ? remoteJid : remoteJid.split('@')[0],
               delay: (settings as any)?.delayMessage || 1000,
               audio: url,
               caption: altText,
@@ -218,7 +219,7 @@ export abstract class BaseChatbotService<BotType = any, SettingsType = any> {
           } else {
             await instance.mediaMessage(
               {
-                number: remoteJid.split('@')[0],
+                number: remoteJid.includes('@lid') ? remoteJid : remoteJid.split('@')[0],
                 delay: (settings as any)?.delayMessage || 1000,
                 mediatype: mediaType,
                 media: url,
@@ -252,7 +253,56 @@ export abstract class BaseChatbotService<BotType = any, SettingsType = any> {
 
     // Send any remaining text
     if (textBuffer.trim()) {
-      await this.sendFormattedText(instance, remoteJid, textBuffer.trim(), settings, splitMessages);
+      await this.sendFormattedText(instance, remoteJid, textBuffer.trim(), settings, splitMessages, linkPreview);
+    }
+  }
+
+  /**
+   * Split message by double line breaks and return array of message parts
+   */
+  private splitMessageByDoubleLineBreaks(message: string): string[] {
+    return message.split('\n\n').filter((part) => part.trim().length > 0);
+  }
+
+  /**
+   * Send a single message with proper typing indicators and delays
+   */
+  private async sendSingleMessage(
+    instance: any,
+    remoteJid: string,
+    message: string,
+    settings: any,
+    linkPreview: boolean = true,
+  ): Promise<void> {
+    const timePerChar = settings?.timePerChar ?? 0;
+    const minDelay = 1000;
+    const maxDelay = 20000;
+    const delay = Math.min(Math.max(message.length * timePerChar, minDelay), maxDelay);
+
+    this.logger.debug(`[BaseChatbot] Sending single message with linkPreview: ${linkPreview}`);
+
+    if (instance.integration === Integration.WHATSAPP_BAILEYS) {
+      await instance.client.presenceSubscribe(remoteJid);
+      await instance.client.sendPresenceUpdate('composing', remoteJid);
+    }
+
+    await new Promise<void>((resolve) => {
+      setTimeout(async () => {
+        await instance.textMessage(
+          {
+            number: remoteJid.includes('@lid') ? remoteJid : remoteJid.split('@')[0],
+            delay: settings?.delayMessage || 1000,
+            text: message,
+            linkPreview,
+          },
+          false,
+        );
+        resolve();
+      }, delay);
+    });
+
+    if (instance.integration === Integration.WHATSAPP_BAILEYS) {
+      await instance.client.sendPresenceUpdate('paused', remoteJid);
     }
   }
 
@@ -265,67 +315,24 @@ export abstract class BaseChatbotService<BotType = any, SettingsType = any> {
     text: string,
     settings: any,
     splitMessages: boolean,
+    linkPreview: boolean = true,
   ): Promise<void> {
-    const timePerChar = settings?.timePerChar ?? 0;
-    const minDelay = 1000;
-    const maxDelay = 20000;
-
     if (splitMessages) {
-      const multipleMessages = text.split('\n\n');
-      for (let index = 0; index < multipleMessages.length; index++) {
-        const message = multipleMessages[index];
-        if (!message.trim()) continue;
+      const messageParts = this.splitMessageByDoubleLineBreaks(text);
 
-        const delay = Math.min(Math.max(message.length * timePerChar, minDelay), maxDelay);
+      this.logger.debug(`[BaseChatbot] Splitting message into ${messageParts.length} parts`);
 
-        if (instance.integration === Integration.WHATSAPP_BAILEYS) {
-          await instance.client.presenceSubscribe(remoteJid);
-          await instance.client.sendPresenceUpdate('composing', remoteJid);
-        }
+      for (let index = 0; index < messageParts.length; index++) {
+        const message = messageParts[index];
 
-        await new Promise<void>((resolve) => {
-          setTimeout(async () => {
-            await instance.textMessage(
-              {
-                number: remoteJid.split('@')[0],
-                delay: settings?.delayMessage || 1000,
-                text: message,
-              },
-              false,
-            );
-            resolve();
-          }, delay);
-        });
-
-        if (instance.integration === Integration.WHATSAPP_BAILEYS) {
-          await instance.client.sendPresenceUpdate('paused', remoteJid);
-        }
+        this.logger.debug(`[BaseChatbot] Sending message part ${index + 1}/${messageParts.length}`);
+        await this.sendSingleMessage(instance, remoteJid, message, settings, linkPreview);
       }
+
+      this.logger.debug(`[BaseChatbot] All message parts sent successfully`);
     } else {
-      const delay = Math.min(Math.max(text.length * timePerChar, minDelay), maxDelay);
-
-      if (instance.integration === Integration.WHATSAPP_BAILEYS) {
-        await instance.client.presenceSubscribe(remoteJid);
-        await instance.client.sendPresenceUpdate('composing', remoteJid);
-      }
-
-      await new Promise<void>((resolve) => {
-        setTimeout(async () => {
-          await instance.textMessage(
-            {
-              number: remoteJid.split('@')[0],
-              delay: settings?.delayMessage || 1000,
-              text: text,
-            },
-            false,
-          );
-          resolve();
-        }, delay);
-      });
-
-      if (instance.integration === Integration.WHATSAPP_BAILEYS) {
-        await instance.client.sendPresenceUpdate('paused', remoteJid);
-      }
+      this.logger.debug(`[BaseChatbot] Sending single message`);
+      await this.sendSingleMessage(instance, remoteJid, text, settings, linkPreview);
     }
   }
 

src/api/integrations/chatbot/chatbot.controller.ts

@@ -91,19 +91,19 @@ export class ChatbotController {
       pushName,
       isIntegration,
     };
-    await evolutionBotController.emit(emitData);
+    evolutionBotController.emit(emitData);
 
-    await typebotController.emit(emitData);
+    typebotController.emit(emitData);
 
-    await openaiController.emit(emitData);
+    openaiController.emit(emitData);
 
-    await difyController.emit(emitData);
+    difyController.emit(emitData);
 
-    await n8nController.emit(emitData);
+    n8nController.emit(emitData);
 
-    await evoaiController.emit(emitData);
+    evoaiController.emit(emitData);
 
-    await flowiseController.emit(emitData);
+    flowiseController.emit(emitData);
   }
 
   public processDebounce(

src/api/integrations/chatbot/chatwoot/controllers/chatwoot.controller.ts

@@ -1,10 +1,6 @@
 import { InstanceDto } from '@api/dto/instance.dto';
 import { ChatwootDto } from '@api/integrations/chatbot/chatwoot/dto/chatwoot.dto';
 import { ChatwootService } from '@api/integrations/chatbot/chatwoot/services/chatwoot.service';
-import { PrismaRepository } from '@api/repository/repository.service';
-import { waMonitor } from '@api/server.module';
-import { CacheService } from '@api/services/cache.service';
-import { CacheEngine } from '@cache/cacheengine';
 import { Chatwoot, ConfigService, HttpServer } from '@config/env.config';
 import { BadRequestException } from '@exceptions';
 import { isURL } from 'class-validator';
@@ -13,7 +9,6 @@ export class ChatwootController {
   constructor(
     private readonly chatwootService: ChatwootService,
     private readonly configService: ConfigService,
-    private readonly prismaRepository: PrismaRepository,
   ) {}
 
   public async createChatwoot(instance: InstanceDto, data: ChatwootDto) {
@@ -84,9 +79,6 @@ export class ChatwootController {
   public async receiveWebhook(instance: InstanceDto, data: any) {
     if (!this.configService.get<Chatwoot>('CHATWOOT').ENABLED) throw new BadRequestException('Chatwoot is disabled');
 
-    const chatwootCache = new CacheService(new CacheEngine(this.configService, ChatwootService.name).getEngine());
-    const chatwootService = new ChatwootService(waMonitor, this.configService, this.prismaRepository, chatwootCache);
-
-    return chatwootService.receiveWebhook(instance, data);
+    return this.chatwootService.receiveWebhook(instance, data);
   }
 }

src/api/integrations/chatbot/chatwoot/services/chatwoot.service.ts

@@ -23,10 +23,11 @@ import { Chatwoot as ChatwootModel, Contact as ContactModel, Message as MessageM
 import i18next from '@utils/i18n';
 import { sendTelemetry } from '@utils/sendTelemetry';
 import axios from 'axios';
-import { proto } from 'baileys';
+import { WAMessageContent, WAMessageKey } from 'baileys';
 import dayjs from 'dayjs';
 import FormData from 'form-data';
 import { Jimp, JimpMime } from 'jimp';
+import { parsePhoneNumberFromString } from 'libphonenumber-js';
 import Long from 'long';
 import mimeTypes from 'mime-types';
 import path from 'path';
@@ -43,6 +44,9 @@ interface ChatwootMessage {
 export class ChatwootService {
   private readonly logger = new Logger('ChatwootService');
 
+  // Lock polling delay
+  private readonly LOCK_POLLING_DELAY_MS = 300; // Delay between lock status checks
+
   private provider: any;
 
   constructor(
@@ -129,7 +133,7 @@ export class ChatwootService {
   public async find(instance: InstanceDto): Promise<ChatwootDto> {
     try {
       return await this.waMonitor.waInstances[instance.instanceName].findChatwoot();
-    } catch (error) {
+    } catch {
       this.logger.error('chatwoot not found');
       return { enabled: null, url: '' };
     }
@@ -342,6 +346,16 @@ export class ChatwootService {
 
       return contact;
     } catch (error) {
+      if ((error.status === 422 || error.response?.status === 422) && jid) {
+        this.logger.warn(`Contact with identifier ${jid} creation failed (422). Checking if it already exists...`);
+        const existingContact = await this.findContactByIdentifier(instance, jid);
+        if (existingContact) {
+          const contactId = existingContact.id;
+          await this.addLabelToContact(this.provider.nameInbox, contactId);
+          return existingContact;
+        }
+      }
+
       this.logger.error('Error creating contact');
       console.log(error);
       return null;
@@ -369,7 +383,7 @@ export class ChatwootService {
       });
 
       return contact;
-    } catch (error) {
+    } catch {
       return null;
     }
   }
@@ -406,11 +420,60 @@ export class ChatwootService {
       }
 
       return true;
-    } catch (error) {
+    } catch {
       return false;
     }
   }
 
+  public async findContactByIdentifier(instance: InstanceDto, identifier: string) {
+    const client = await this.clientCw(instance);
+
+    if (!client) {
+      this.logger.warn('client not found');
+      return null;
+    }
+
+    // Direct search by query (q) - most common way to search by identifier/email/phone
+    const contact = (await (client as any).get('contacts/search', {
+      params: {
+        q: identifier,
+        sort: 'name',
+      },
+    })) as any;
+
+    if (contact && contact.data && contact.data.payload && contact.data.payload.length > 0) {
+      return contact.data.payload[0];
+    }
+
+    // Fallback for older API versions or different response structures
+    if (contact && contact.payload && contact.payload.length > 0) {
+      return contact.payload[0];
+    }
+
+    // Try search by attribute
+    const contactByAttr = (await (client as any).post('contacts/filter', {
+      payload: [
+        {
+          attribute_key: 'identifier',
+          filter_operator: 'equal_to',
+          values: [identifier],
+          query_operator: null,
+        },
+      ],
+    })) as any;
+
+    if (contactByAttr && contactByAttr.payload && contactByAttr.payload.length > 0) {
+      return contactByAttr.payload[0];
+    }
+
+    // Check inside data property if using axios interceptors wrapper
+    if (contactByAttr && contactByAttr.data && contactByAttr.data.payload && contactByAttr.data.payload.length > 0) {
+      return contactByAttr.data.payload[0];
+    }
+
+    return null;
+  }
+
   public async findContact(instance: InstanceDto, phoneNumber: string) {
     const client = await this.clientCw(instance);
 
@@ -567,34 +630,31 @@ export class ChatwootService {
   }
 
   public async createConversation(instance: InstanceDto, body: any) {
-    if (!body?.key) {
-      this.logger.warn(
-        `body.key is null or undefined in createConversation. Full body object: ${JSON.stringify(body)}`,
-      );
-      return null;
-    }
-
-    const isLid = body.key.previousRemoteJid?.includes('@lid') && body.key.senderPn;
-    const remoteJid = body.key.remoteJid;
+    const isLid = body.key.addressingMode === 'lid';
+    const isGroup = body.key.remoteJid.endsWith('@g.us');
+    const phoneNumber = isLid && !isGroup ? body.key.remoteJidAlt : body.key.remoteJid;
+    const { remoteJid } = body.key;
     const cacheKey = `${instance.instanceName}:createConversation-${remoteJid}`;
     const lockKey = `${instance.instanceName}:lock:createConversation-${remoteJid}`;
-    const maxWaitTime = 5000; // 5 secounds
+    const maxWaitTime = 5000; // 5 seconds
+    const client = await this.clientCw(instance);
+    if (!client) return null;
 
     try {
       // Processa atualização de contatos já criados @lid
-      if (isLid && body.key.senderPn !== body.key.previousRemoteJid) {
-        const contact = await this.findContact(instance, body.key.remoteJid.split('@')[0]);
-        if (contact && contact.identifier !== body.key.senderPn) {
+      if (phoneNumber && remoteJid && !isGroup) {
+        const contact = await this.findContact(instance, phoneNumber.split('@')[0]);
+        if (contact && contact.identifier !== remoteJid) {
           this.logger.verbose(
-            `Identifier needs update: (contact.identifier: ${contact.identifier}, body.key.remoteJid: ${body.key.remoteJid}, body.key.senderPn: ${body.key.senderPn}`,
+            `Identifier needs update: (contact.identifier: ${contact.identifier}, phoneNumber: ${phoneNumber}, body.key.remoteJidAlt: ${remoteJid}`,
           );
           const updateContact = await this.updateContact(instance, contact.id, {
-            identifier: body.key.senderPn,
-            phone_number: `+${body.key.senderPn.split('@')[0]}`,
+            identifier: phoneNumber,
+            phone_number: `+${phoneNumber.split('@')[0]}`,
           });
 
           if (updateContact === null) {
-            const baseContact = await this.findContact(instance, body.key.senderPn.split('@')[0]);
+            const baseContact = await this.findContact(instance, phoneNumber.split('@')[0]);
             if (baseContact) {
               await this.mergeContacts(baseContact.id, contact.id);
               this.logger.verbose(
@@ -610,7 +670,25 @@ export class ChatwootService {
       // If it already exists in the cache, return conversationId
       if (await this.cache.has(cacheKey)) {
         const conversationId = (await this.cache.get(cacheKey)) as number;
-        this.logger.verbose(`Found conversation to: ${remoteJid}, conversation ID: ${conversationId}`);
+        this.logger.verbose(`Found conversation to: ${phoneNumber}, conversation ID: ${conversationId}`);
+        let conversationExists: any;
+        try {
+          conversationExists = await client.conversations.get({
+            accountId: this.provider.accountId,
+            conversationId: conversationId,
+          });
+          this.logger.verbose(
+            `Conversation exists: ID: ${conversationExists.id} - Name: ${conversationExists.meta.sender.name} - Identifier: ${conversationExists.meta.sender.identifier}`,
+          );
+        } catch (error) {
+          this.logger.error(`Error getting conversation: ${error}`);
+          conversationExists = false;
+        }
+        if (!conversationExists) {
+          this.logger.verbose('Conversation does not exist, re-calling createConversation');
+          this.cache.delete(cacheKey);
+          return await this.createConversation(instance, body);
+        }
         return conversationId;
       }
 
@@ -623,7 +701,7 @@ export class ChatwootService {
             this.logger.warn(`Timeout aguardando lock para ${remoteJid}`);
             break;
           }
-          await new Promise((res) => setTimeout(res, 300));
+          await new Promise((res) => setTimeout(res, this.LOCK_POLLING_DELAY_MS));
           if (await this.cache.has(cacheKey)) {
             const conversationId = (await this.cache.get(cacheKey)) as number;
             this.logger.verbose(`Resolves creation of: ${remoteJid}, conversation ID: ${conversationId}`);
@@ -645,11 +723,7 @@ export class ChatwootService {
           return (await this.cache.get(cacheKey)) as number;
         }
 
-        const client = await this.clientCw(instance);
-        if (!client) return null;
-
-        const isGroup = remoteJid.includes('@g.us');
-        const chatId = isGroup ? remoteJid : remoteJid.split('@')[0];
+        const chatId = isGroup ? remoteJid : phoneNumber.split('@')[0].split(':')[0];
         let nameContact = !body.key.fromMe ? body.pushName : chatId;
         const filterInbox = await this.getInbox(instance);
         if (!filterInbox) return null;
@@ -657,19 +731,22 @@ export class ChatwootService {
         if (isGroup) {
           this.logger.verbose(`Processing group conversation`);
           const group = await this.waMonitor.waInstances[instance.instanceName].client.groupMetadata(chatId);
-          this.logger.verbose(`Group metadata: ${JSON.stringify(group)}`);
+          this.logger.verbose(`Group metadata: JID:${group.JID} - Subject:${group?.subject || group?.Name}`);
 
+          const participantJid = isLid && !body.key.fromMe ? body.key.participantAlt : body.key.participant;
           nameContact = `${group.subject} (GROUP)`;
 
           const picture_url = await this.waMonitor.waInstances[instance.instanceName].profilePicture(
-            body.key.participant.split('@')[0],
+            participantJid.split('@')[0],
           );
           this.logger.verbose(`Participant profile picture URL: ${JSON.stringify(picture_url)}`);
 
-          const findParticipant = await this.findContact(instance, body.key.participant.split('@')[0]);
-          this.logger.verbose(`Found participant: ${JSON.stringify(findParticipant)}`);
+          const findParticipant = await this.findContact(instance, participantJid.split('@')[0]);
 
           if (findParticipant) {
+            this.logger.verbose(
+              `Found participant: ID:${findParticipant.id} - Name: ${findParticipant.name} - identifier: ${findParticipant.identifier}`,
+            );
             if (!findParticipant.name || findParticipant.name === chatId) {
               await this.updateContact(instance, findParticipant.id, {
                 name: body.pushName,
@@ -679,12 +756,12 @@ export class ChatwootService {
           } else {
             await this.createContact(
               instance,
-              body.key.participant.split('@')[0],
+              participantJid.split('@')[0].split(':')[0],
               filterInbox.id,
               false,
               body.pushName,
               picture_url.profilePictureUrl || null,
-              body.key.participant,
+              participantJid,
             );
           }
         }
@@ -692,23 +769,17 @@ export class ChatwootService {
         const picture_url = await this.waMonitor.waInstances[instance.instanceName].profilePicture(chatId);
         this.logger.verbose(`Contact profile picture URL: ${JSON.stringify(picture_url)}`);
 
+        this.logger.verbose(`Searching contact for: ${chatId}`);
         let contact = await this.findContact(instance, chatId);
 
         if (contact) {
-          this.logger.verbose(`Found contact: ${JSON.stringify(contact)}`);
+          this.logger.verbose(`Found contact: ID:${contact.id} - Name:${contact.name}`);
           if (!body.key.fromMe) {
             const waProfilePictureFile =
               picture_url?.profilePictureUrl?.split('#')[0].split('?')[0].split('/').pop() || '';
             const chatwootProfilePictureFile = contact?.thumbnail?.split('#')[0].split('?')[0].split('/').pop() || '';
             const pictureNeedsUpdate = waProfilePictureFile !== chatwootProfilePictureFile;
-            const nameNeedsUpdate =
-              !contact.name ||
-              contact.name === chatId ||
-              (`+${chatId}`.startsWith('+55')
-                ? this.getNumbers(`+${chatId}`).some(
-                    (v) => contact.name === v || contact.name === v.substring(3) || contact.name === v.substring(1),
-                  )
-                : false);
+            const nameNeedsUpdate = !contact.name || contact.name === chatId;
             this.logger.verbose(`Picture needs update: ${pictureNeedsUpdate}`);
             this.logger.verbose(`Name needs update: ${nameNeedsUpdate}`);
             if (pictureNeedsUpdate || nameNeedsUpdate) {
@@ -727,7 +798,7 @@ export class ChatwootService {
             isGroup,
             nameContact,
             picture_url.profilePictureUrl || null,
-            remoteJid,
+            phoneNumber,
           );
         }
 
@@ -743,7 +814,6 @@ export class ChatwootService {
           accountId: this.provider.accountId,
           id: contactId,
         })) as any;
-        this.logger.verbose(`Contact conversations: ${JSON.stringify(contactConversations)}`);
 
         if (!contactConversations || !contactConversations.payload) {
           this.logger.error(`No conversations found or payload is undefined`);
@@ -755,7 +825,9 @@ export class ChatwootService {
         );
         if (inboxConversation) {
           if (this.provider.reopenConversation) {
-            this.logger.verbose(`Found conversation in reopenConversation mode: ${JSON.stringify(inboxConversation)}`);
+            this.logger.verbose(
+              `Found conversation in reopenConversation mode: ID: ${inboxConversation.id} - Name: ${inboxConversation.meta.sender.name} - Identifier: ${inboxConversation.meta.sender.identifier}`,
+            );
             if (inboxConversation && this.provider.conversationPending && inboxConversation.status !== 'open') {
               await client.conversations.toggleStatus({
                 accountId: this.provider.accountId,
@@ -775,7 +847,7 @@ export class ChatwootService {
 
           if (inboxConversation) {
             this.logger.verbose(`Returning existing conversation ID: ${inboxConversation.id}`);
-            this.cache.set(cacheKey, inboxConversation.id);
+            this.cache.set(cacheKey, inboxConversation.id, 1800);
             return inboxConversation.id;
           }
         }
@@ -789,14 +861,6 @@ export class ChatwootService {
           data['status'] = 'pending';
         }
 
-        /*
-        Triple check after lock
-        Utilizei uma nova verificação para evitar que outra thread execute entre o terminio do while e o set lock
-        */
-        if (await this.cache.has(cacheKey)) {
-          return (await this.cache.get(cacheKey)) as number;
-        }
-
         const conversation = await client.conversations.create({
           accountId: this.provider.accountId,
           data,
@@ -808,7 +872,7 @@ export class ChatwootService {
         }
 
         this.logger.verbose(`New conversation created of ${remoteJid} with ID: ${conversation.id}`);
-        this.cache.set(cacheKey, conversation.id);
+        this.cache.set(cacheKey, conversation.id, 1800);
         return conversation.id;
       } finally {
         await this.cache.delete(lockKey);
@@ -1164,7 +1228,7 @@ export class ChatwootService {
         const data: SendAudioDto = {
           number: number,
           audio: media,
-          delay: 1200,
+          delay: Math.floor(Math.random() * (2000 - 500 + 1)) + 500,
           quoted: options?.quoted,
         };
 
@@ -1175,7 +1239,7 @@ export class ChatwootService {
         return messageSent;
       }
 
-      const documentExtensions = ['.gif', '.svg', '.tiff', '.tif'];
+      const documentExtensions = ['.gif', '.svg', '.tiff', '.tif', '.dxf', '.dwg'];
       if (type === 'image' && parsedMedia && documentExtensions.includes(parsedMedia?.ext)) {
         type = 'document';
       }
@@ -1200,6 +1264,7 @@ export class ChatwootService {
       return messageSent;
     } catch (error) {
       this.logger.error(error);
+      throw error; // Re-throw para que o erro seja tratado pelo caller
     }
   }
 
@@ -1281,6 +1346,7 @@ export class ChatwootService {
 
       const senderName = body?.conversation?.messages[0]?.sender?.available_name || body?.sender?.name;
       const waInstance = this.waMonitor.waInstances[instance.instanceName];
+      instance.instanceId = waInstance.instanceId;
 
       if (body.event === 'message_updated' && body.content_attributes?.deleted) {
         const message = await this.prismaRepository.message.findFirst({
@@ -1291,12 +1357,7 @@ export class ChatwootService {
         });
 
         if (message) {
-          const key = message.key as {
-            id: string;
-            remoteJid: string;
-            fromMe: boolean;
-            participant: string;
-          };
+          const key = message.key as WAMessageKey;
 
           await waInstance?.client.sendMessage(key.remoteJid, { delete: key });
 
@@ -1428,7 +1489,6 @@ export class ChatwootService {
               await this.updateChatwootMessageId(
                 {
                   ...messageSent,
-                  owner: instance.instanceName,
                 },
                 {
                   messageId: body.id,
@@ -1443,7 +1503,7 @@ export class ChatwootService {
             const data: SendTextDto = {
               number: chatId,
               text: formatText,
-              delay: 1200,
+              delay: Math.floor(Math.random() * (2000 - 500 + 1)) + 500,
               quoted: await this.getQuotedMessage(body, instance),
             };
 
@@ -1463,7 +1523,6 @@ export class ChatwootService {
               await this.updateChatwootMessageId(
                 {
                   ...messageSent,
-                  instanceId: instance.instanceId,
                 },
                 {
                   messageId: body.id,
@@ -1494,12 +1553,7 @@ export class ChatwootService {
             },
           });
           if (lastMessage && !lastMessage.chatwootIsRead) {
-            const key = lastMessage.key as {
-              id: string;
-              fromMe: boolean;
-              remoteJid: string;
-              participant?: string;
-            };
+            const key = lastMessage.key as WAMessageKey;
 
             waInstance?.markMessageAsRead({
               readMessages: [
@@ -1536,7 +1590,7 @@ export class ChatwootService {
         const data: SendTextDto = {
           number: chatId,
           text: body.content.replace(/\\\r\n|\\\n|\n/g, '\n'),
-          delay: 1200,
+          delay: Math.floor(Math.random() * (2000 - 500 + 1)) + 500,
         };
 
         sendTelemetry('/message/sendText');
@@ -1557,51 +1611,46 @@ export class ChatwootService {
     chatwootMessageIds: ChatwootMessage,
     instance: InstanceDto,
   ) {
-    const key = message.key as {
-      id: string;
-      fromMe: boolean;
-      remoteJid: string;
-      participant?: string;
-    };
+    const key = message.key as WAMessageKey;
 
     if (!chatwootMessageIds.messageId || !key?.id) {
       return;
     }
 
-    await this.prismaRepository.message.updateMany({
-      where: {
-        key: {
-          path: ['id'],
-          equals: key.id,
-        },
-        instanceId: instance.instanceId,
-      },
-      data: {
-        chatwootMessageId: chatwootMessageIds.messageId,
-        chatwootConversationId: chatwootMessageIds.conversationId,
-        chatwootInboxId: chatwootMessageIds.inboxId,
-        chatwootContactInboxSourceId: chatwootMessageIds.contactInboxSourceId,
-        chatwootIsRead: chatwootMessageIds.isRead,
-      },
-    });
+    // Use raw SQL to avoid JSON path issues
+    const result = await this.prismaRepository.$executeRaw`
+      UPDATE "Message" 
+      SET 
+        "chatwootMessageId" = ${chatwootMessageIds.messageId},
+        "chatwootConversationId" = ${chatwootMessageIds.conversationId},
+        "chatwootInboxId" = ${chatwootMessageIds.inboxId},
+        "chatwootContactInboxSourceId" = ${chatwootMessageIds.contactInboxSourceId},
+        "chatwootIsRead" = ${chatwootMessageIds.isRead || false}
+      WHERE "instanceId" = ${instance.instanceId} 
+      AND "key"->>'id' = ${key.id}
+    `;
+
+    this.logger.verbose(`Update result: ${result} rows affected`);
 
     if (this.isImportHistoryAvailable()) {
-      chatwootImport.updateMessageSourceID(chatwootMessageIds.messageId, key.id);
+      try {
+        await chatwootImport.updateMessageSourceID(chatwootMessageIds.messageId, key.id);
+      } catch (error) {
+        this.logger.error(`Error updating Chatwoot message source ID: ${error}`);
+      }
     }
   }
 
   private async getMessageByKeyId(instance: InstanceDto, keyId: string): Promise<MessageModel> {
-    const messages = await this.prismaRepository.message.findFirst({
-      where: {
-        key: {
-          path: ['id'],
-          equals: keyId,
-        },
-        instanceId: instance.instanceId,
-      },
-    });
+    // Use raw SQL query to avoid JSON path issues with Prisma
+    const messages = await this.prismaRepository.$queryRaw`
+      SELECT * FROM "Message" 
+      WHERE "instanceId" = ${instance.instanceId} 
+      AND "key"->>'id' = ${keyId}
+      LIMIT 1
+    `;
 
-    return messages || null;
+    return (messages as MessageModel[])[0] || null;
   }
 
   private async getReplyToIds(
@@ -1636,17 +1685,13 @@ export class ChatwootService {
         },
       });
 
-      const key = message?.key as {
-        id: string;
-        fromMe: boolean;
-        remoteJid: string;
-        participant?: string;
-      };
+      const key = message?.key as WAMessageKey;
+      const messageContent = message?.message as WAMessageContent;
 
-      if (message && key?.id) {
+      if (messageContent && key?.id) {
         return {
-          key: message.key as proto.IMessageKey,
-          message: message.message as proto.IMessage,
+          key: key,
+          message: messageContent,
         };
       }
     }
@@ -1672,6 +1717,10 @@ export class ChatwootService {
     return result;
   }
 
+  private isInteractiveButtonMessage(messageType: string, message: any) {
+    return messageType === 'interactiveMessage' && message.interactiveMessage?.nativeFlowMessage?.buttons?.length > 0;
+  }
+
   private getAdsMessage(msg: any) {
     interface AdsMessage {
       title: string;
@@ -1900,12 +1949,6 @@ export class ChatwootService {
 
   public async eventWhatsapp(event: string, instance: InstanceDto, body: any) {
     try {
-      // Ignore events that are not messages (like EPHEMERAL_SYNC_RESPONSE)
-      if (body?.type && body.type !== 'message' && body.type !== 'conversation') {
-        this.logger.verbose(`Ignoring non-message event type: ${body.type}`);
-        return;
-      }
-
       const waInstance = this.waMonitor.waInstances[instance.instanceName];
 
       if (!waInstance) {
@@ -1951,11 +1994,7 @@ export class ChatwootService {
       }
 
       if (event === 'messages.upsert' || event === 'send.message') {
-        if (!body?.key) {
-          this.logger.warn(`body.key is null or undefined. Full body object: ${JSON.stringify(body)}`);
-          return;
-        }
-
+        this.logger.info(`[${event}] New message received - Instance: ${JSON.stringify(body, null, 2)}`);
         if (body.key.remoteJid === 'status@broadcast') {
           return;
         }
@@ -2000,8 +2039,9 @@ export class ChatwootService {
         const adsMessage = this.getAdsMessage(body);
 
         const reactionMessage = this.getReactionMessage(body.message);
+        const isInteractiveButtonMessage = this.isInteractiveButtonMessage(body.messageType, body.message);
 
-        if (!bodyMessage && !isMedia && !reactionMessage) {
+        if (!bodyMessage && !isMedia && !reactionMessage && !isInteractiveButtonMessage) {
           this.logger.warn('no body message found');
           return;
         }
@@ -2046,23 +2086,20 @@ export class ChatwootService {
 
           if (body.key.remoteJid.includes('@g.us')) {
             const participantName = body.pushName;
-            const rawPhoneNumber = body.key.participant.split('@')[0];
-            const phoneMatch = rawPhoneNumber.match(/^(\d{2})(\d{2})(\d{4})(\d{4})$/);
-
-            let formattedPhoneNumber: string;
-
-            if (phoneMatch) {
-              formattedPhoneNumber = `+${phoneMatch[1]} (${phoneMatch[2]}) ${phoneMatch[3]}-${phoneMatch[4]}`;
-            } else {
-              formattedPhoneNumber = `+${rawPhoneNumber}`;
-            }
+            const rawPhoneNumber =
+              body.key.addressingMode === 'lid' && !body.key.fromMe && body.key.participantAlt
+                ? body.key.participantAlt.split('@')[0].split(':')[0]
+                : body.key.participant.split('@')[0].split(':')[0];
+            const formattedPhoneNumber = parsePhoneNumberFromString(`+${rawPhoneNumber}`).formatInternational();
 
             let content: string;
 
             if (!body.key.fromMe) {
-              content = `**${formattedPhoneNumber} - ${participantName}:**\n\n${bodyMessage}`;
+              content = bodyMessage
+                ? `**${formattedPhoneNumber} - ${participantName}:**\n\n${bodyMessage}`
+                : `**${formattedPhoneNumber} - ${participantName}:**`;
             } else {
-              content = `${bodyMessage}`;
+              content = bodyMessage || '';
             }
 
             const send = await this.sendData(
@@ -2129,6 +2166,50 @@ export class ChatwootService {
           return;
         }
 
+        if (isInteractiveButtonMessage) {
+          const buttons = body.message.interactiveMessage.nativeFlowMessage.buttons;
+          this.logger.info('is Interactive Button Message: ' + JSON.stringify(buttons));
+
+          for (const button of buttons) {
+            const buttonParams = JSON.parse(button.buttonParamsJson);
+            const paymentSettings = buttonParams.payment_settings;
+
+            if (button.name === 'payment_info' && paymentSettings[0].type === 'pix_static_code') {
+              const pixSettings = paymentSettings[0].pix_static_code;
+              const pixKeyType = (() => {
+                switch (pixSettings.key_type) {
+                  case 'EVP':
+                    return 'Chave Aleatória';
+                  case 'EMAIL':
+                    return 'E-mail';
+                  case 'PHONE':
+                    return 'Telefone';
+                  default:
+                    return pixSettings.key_type;
+                }
+              })();
+              const pixKey = pixSettings.key_type === 'PHONE' ? pixSettings.key.replace('+55', '') : pixSettings.key;
+              const content = `*${pixSettings.merchant_name}*\nChave PIX: ${pixKey} (${pixKeyType})`;
+
+              const send = await this.createMessage(
+                instance,
+                getConversation,
+                content,
+                messageType,
+                false,
+                [],
+                body,
+                'WAID:' + body.key.id,
+                quotedMsg,
+              );
+              if (!send) this.logger.warn('message not sent');
+            } else {
+              this.logger.warn('Interactive Button Message not mapped');
+            }
+          }
+          return;
+        }
+
         const isAdsMessage = (adsMessage && adsMessage.title) || adsMessage.body || adsMessage.thumbnailUrl;
         if (isAdsMessage) {
           const imgBuffer = await axios.get(adsMessage.thumbnailUrl, { responseType: 'arraybuffer' });
@@ -2187,16 +2268,11 @@ export class ChatwootService {
 
         if (body.key.remoteJid.includes('@g.us')) {
           const participantName = body.pushName;
-          const rawPhoneNumber = body.key.participant.split('@')[0];
-          const phoneMatch = rawPhoneNumber.match(/^(\d{2})(\d{2})(\d{4})(\d{4})$/);
-
-          let formattedPhoneNumber: string;
-
-          if (phoneMatch) {
-            formattedPhoneNumber = `+${phoneMatch[1]} (${phoneMatch[2]}) ${phoneMatch[3]}-${phoneMatch[4]}`;
-          } else {
-            formattedPhoneNumber = `+${rawPhoneNumber}`;
-          }
+          const rawPhoneNumber =
+            body.key.addressingMode === 'lid' && !body.key.fromMe && body.key.participantAlt
+              ? body.key.participantAlt.split('@')[0].split(':')[0]
+              : body.key.participant.split('@')[0].split(':')[0];
+          const formattedPhoneNumber = parsePhoneNumberFromString(`+${rawPhoneNumber}`).formatInternational();
 
           let content: string;
 
@@ -2278,33 +2354,36 @@ export class ChatwootService {
       }
 
       if (event === 'messages.edit' || event === 'send.message.update') {
-        // Ignore events that are not messages (like EPHEMERAL_SYNC_RESPONSE)
-        if (body?.type && body.type !== 'message') {
-          this.logger.verbose(`Ignoring non-message event type: ${body.type}`);
+        const editedMessageContentRaw =
+          body?.editedMessage?.conversation ??
+          body?.editedMessage?.extendedTextMessage?.text ??
+          body?.editedMessage?.imageMessage?.caption ??
+          body?.editedMessage?.videoMessage?.caption ??
+          body?.editedMessage?.documentMessage?.caption ??
+          (typeof body?.text === 'string' ? body.text : undefined);
+
+        const editedMessageContent = (editedMessageContentRaw ?? '').trim();
+
+        if (!editedMessageContent) {
+          this.logger.info('[CW.EDIT] Conteúdo vazio — ignorando (DELETE tratará se for revoke).');
           return;
         }
 
-        if (!body?.key?.id) {
-          this.logger.warn(
-            `body.key.id is null or undefined in messages.edit. Full body object: ${JSON.stringify(body)}`,
-          );
+        const message = await this.getMessageByKeyId(instance, body?.key?.id);
+
+        if (!message) {
+          this.logger.warn('Message not found for edit event');
           return;
         }
 
-        const editedText = `${
-          body?.editedMessage?.conversation || body?.editedMessage?.extendedTextMessage?.text
-        }\n\n_\`${i18next.t('cw.message.edited')}.\`_`;
-        const message = await this.getMessageByKeyId(instance, body.key.id);
-        const key = message.key as {
-          id: string;
-          fromMe: boolean;
-          remoteJid: string;
-          participant?: string;
-        };
+        const key = message.key as WAMessageKey;
 
         const messageType = key?.fromMe ? 'outgoing' : 'incoming';
 
-        if (message && message.chatwootConversationId) {
+        if (message && message.chatwootConversationId && message.chatwootMessageId) {
+          // Criar nova mensagem com formato: "Mensagem editada:\n\nteste1"
+          const editedText = `\n\n\`${i18next.t('cw.message.edited')}:\`\n\n${editedMessageContent}`;
+
           const send = await this.createMessage(
             instance,
             message.chatwootConversationId,
@@ -2356,7 +2435,7 @@ export class ChatwootService {
             const url =
               `/public/api/v1/inboxes/${inbox.inbox_identifier}/contacts/${sourceId}` +
               `/conversations/${conversationId}/update_last_seen`;
-            chatwootRequest(this.getClientCwConfig(), {
+            await chatwootRequest(this.getClientCwConfig(), {
               method: 'POST',
               url: url,
             });
@@ -2382,15 +2461,30 @@ export class ChatwootService {
         await this.createBotMessage(instance, msgStatus, 'incoming');
       }
 
-      if (event === 'connection.update') {
-        if (body.status === 'open') {
-          // if we have qrcode count then we understand that a new connection was established
-          if (this.waMonitor.waInstances[instance.instanceName].qrCode.count > 0) {
-            const msgConnection = i18next.t('cw.inbox.connected');
-            await this.createBotMessage(instance, msgConnection, 'incoming');
-            this.waMonitor.waInstances[instance.instanceName].qrCode.count = 0;
-            chatwootImport.clearAll(instance);
-          }
+      if (event === 'connection.update' && body.status === 'open') {
+        const waInstance = this.waMonitor.waInstances[instance.instanceName];
+        if (!waInstance) return;
+
+        const now = Date.now();
+        const timeSinceLastNotification = now - (waInstance.lastConnectionNotification || 0);
+
+        // Se a conexão foi estabelecida via QR code, notifica imediatamente.
+        if (waInstance.qrCode && waInstance.qrCode.count > 0) {
+          const msgConnection = i18next.t('cw.inbox.connected');
+          await this.createBotMessage(instance, msgConnection, 'incoming');
+          waInstance.qrCode.count = 0;
+          waInstance.lastConnectionNotification = now;
+          chatwootImport.clearAll(instance);
+        }
+        // Se não foi via QR code, verifica o throttling.
+        else if (timeSinceLastNotification >= 30000) {
+          const msgConnection = i18next.t('cw.inbox.connected');
+          await this.createBotMessage(instance, msgConnection, 'incoming');
+          waInstance.lastConnectionNotification = now;
+        } else {
+          this.logger.warn(
+            `Connection notification skipped for ${instance.instanceName} - too frequent (${timeSinceLastNotification}ms since last)`,
+          );
         }
       }
 
@@ -2433,7 +2527,13 @@ export class ChatwootService {
     }
   }
 
-  public getNumberFromRemoteJid(remoteJid: string) {
+  public normalizeJidIdentifier(remoteJid: string) {
+    if (!remoteJid) {
+      return '';
+    }
+    if (remoteJid.includes('@lid')) {
+      return remoteJid;
+    }
     return remoteJid.replace(/:\d+/, '').split('@')[0];
   }
 
@@ -2578,7 +2678,7 @@ export class ChatwootService {
       const savedMessages = await this.prismaRepository.message.findMany({
         where: {
           Instance: { name: instance.instanceName },
-          messageTimestamp: { gte: dayjs().subtract(6, 'hours').unix() },
+          messageTimestamp: { gte: Number(dayjs().subtract(6, 'hours').unix()) },
           AND: ids.map((id) => ({ key: { path: ['id'], not: id } })),
         },
       });
@@ -2607,7 +2707,7 @@ export class ChatwootService {
       await chatwootImport.importHistoryMessages(instance, this, inbox, this.provider);
       const waInstance = this.waMonitor.waInstances[instance.instanceName];
       waInstance.clearCacheChatwoot();
-    } catch (error) {
+    } catch {
       return;
     }
   }

src/api/integrations/chatbot/chatwoot/utils/chatwoot-import-helper.ts

@@ -112,12 +112,19 @@ class ChatwootImport {
         const bindInsert = [provider.accountId];
 
         for (const contact of contactsChunk) {
-          bindInsert.push(contact.pushName);
+          const isGroup = this.isIgnorePhoneNumber(contact.remoteJid);
+
+          const contactName = isGroup ? `${contact.pushName} (GROUP)` : contact.pushName;
+          bindInsert.push(contactName);
           const bindName = `$${bindInsert.length}`;
 
-          bindInsert.push(`+${contact.remoteJid.split('@')[0]}`);
-          const bindPhoneNumber = `$${bindInsert.length}`;
-
+          let bindPhoneNumber: string;
+          if (!isGroup) {
+            bindInsert.push(`+${contact.remoteJid.split('@')[0]}`);
+            bindPhoneNumber = `$${bindInsert.length}`;
+          } else {
+            bindPhoneNumber = 'NULL';
+          }
           bindInsert.push(contact.remoteJid);
           const bindIdentifier = `$${bindInsert.length}`;
 
@@ -130,7 +137,7 @@ class ChatwootImport {
                        DO UPDATE SET
                         name = EXCLUDED.name,
                         phone_number = EXCLUDED.phone_number,
-                        identifier = EXCLUDED.identifier`;
+                        updated_at = NOW()`;
 
         totalContactsImported += (await pgClient.query(sqlInsert, bindInsert))?.rowCount ?? 0;
 

src/api/integrations/chatbot/dify/services/dify.service.ts

@@ -4,6 +4,7 @@ import { Integration } from '@api/types/wa.types';
 import { ConfigService, HttpServer } from '@config/env.config';
 import { Dify, DifySetting, IntegrationSession } from '@prisma/client';
 import axios from 'axios';
+import { isURL } from 'class-validator';
 
 import { BaseChatbotService } from '../../base-chatbot.service';
 import { OpenaiService } from '../../openai/services/openai.service';
@@ -78,15 +79,35 @@ export class DifyService extends BaseChatbotService<Dify, DifySetting> {
 
         // Handle image messages
         if (this.isImageMessage(content)) {
-          const contentSplit = content.split('|');
-          payload.files = [
-            {
-              type: 'image',
-              transfer_method: 'remote_url',
-              url: contentSplit[1].split('?')[0],
-            },
-          ];
-          payload.query = contentSplit[2] || content;
+          const media = content.split('|');
+
+          if (msg.message.mediaUrl || msg.message.base64) {
+            let mediaBase64 = msg.message.base64 || null;
+
+            if (msg.message.mediaUrl && isURL(msg.message.mediaUrl)) {
+              const result = await axios.get(msg.message.mediaUrl, { responseType: 'arraybuffer' });
+              mediaBase64 = Buffer.from(result.data).toString('base64');
+            }
+
+            if (mediaBase64) {
+              payload.files = [
+                {
+                  type: 'image',
+                  transfer_method: 'remote_url',
+                  url: mediaBase64,
+                },
+              ];
+            }
+          } else {
+            payload.files = [
+              {
+                type: 'image',
+                transfer_method: 'remote_url',
+                url: media[1].split('?')[0],
+              },
+            ];
+          }
+          payload.query = media[2] || content;
         }
 
         if (instance.integration === Integration.WHATSAPP_BAILEYS) {
@@ -107,7 +128,7 @@ export class DifyService extends BaseChatbotService<Dify, DifySetting> {
         const conversationId = response?.data?.conversation_id;
 
         if (message) {
-          await this.sendMessageWhatsApp(instance, remoteJid, message, settings);
+          await this.sendMessageWhatsApp(instance, remoteJid, message, settings, true);
         }
 
         await this.prismaRepository.integrationSession.update({
@@ -140,15 +161,35 @@ export class DifyService extends BaseChatbotService<Dify, DifySetting> {
 
         // Handle image messages
         if (this.isImageMessage(content)) {
-          const contentSplit = content.split('|');
-          payload.files = [
-            {
-              type: 'image',
-              transfer_method: 'remote_url',
-              url: contentSplit[1].split('?')[0],
-            },
-          ];
-          payload.inputs.query = contentSplit[2] || content;
+          const media = content.split('|');
+
+          if (msg.message.mediaUrl || msg.message.base64) {
+            let mediaBase64 = msg.message.base64 || null;
+
+            if (msg.message.mediaUrl && isURL(msg.message.mediaUrl)) {
+              const result = await axios.get(msg.message.mediaUrl, { responseType: 'arraybuffer' });
+              mediaBase64 = Buffer.from(result.data).toString('base64');
+            }
+
+            if (mediaBase64) {
+              payload.files = [
+                {
+                  type: 'image',
+                  transfer_method: 'remote_url',
+                  url: mediaBase64,
+                },
+              ];
+            }
+          } else {
+            payload.files = [
+              {
+                type: 'image',
+                transfer_method: 'remote_url',
+                url: media[1].split('?')[0],
+              },
+            ];
+            payload.inputs.query = media[2] || content;
+          }
         }
 
         if (instance.integration === Integration.WHATSAPP_BAILEYS) {
@@ -169,7 +210,7 @@ export class DifyService extends BaseChatbotService<Dify, DifySetting> {
         const conversationId = response?.data?.conversation_id;
 
         if (message) {
-          await this.sendMessageWhatsApp(instance, remoteJid, message, settings);
+          await this.sendMessageWhatsApp(instance, remoteJid, message, settings, true);
         }
 
         await this.prismaRepository.integrationSession.update({
@@ -202,15 +243,26 @@ export class DifyService extends BaseChatbotService<Dify, DifySetting> {
 
         // Handle image messages
         if (this.isImageMessage(content)) {
-          const contentSplit = content.split('|');
-          payload.files = [
-            {
-              type: 'image',
-              transfer_method: 'remote_url',
-              url: contentSplit[1].split('?')[0],
-            },
-          ];
-          payload.query = contentSplit[2] || content;
+          const media = content.split('|');
+
+          if (msg.message.mediaUrl || msg.message.base64) {
+            payload.files = [
+              {
+                type: 'image',
+                transfer_method: 'remote_url',
+                url: msg.message.mediaUrl || msg.message.base64,
+              },
+            ];
+          } else {
+            payload.files = [
+              {
+                type: 'image',
+                transfer_method: 'remote_url',
+                url: media[1].split('?')[0],
+              },
+            ];
+            payload.query = media[2] || content;
+          }
         }
 
         if (instance.integration === Integration.WHATSAPP_BAILEYS) {
@@ -246,7 +298,7 @@ export class DifyService extends BaseChatbotService<Dify, DifySetting> {
           await instance.client.sendPresenceUpdate('paused', remoteJid);
 
         if (answer) {
-          await this.sendMessageWhatsApp(instance, remoteJid, answer, settings);
+          await this.sendMessageWhatsApp(instance, remoteJid, answer, settings, true);
         }
 
         await this.prismaRepository.integrationSession.update({

src/api/integrations/chatbot/evoai/services/evoai.service.ts

@@ -5,6 +5,7 @@ import { ConfigService, HttpServer } from '@config/env.config';
 import { Evoai, EvoaiSetting, IntegrationSession } from '@prisma/client';
 import axios from 'axios';
 import { downloadMediaMessage } from 'baileys';
+import { isURL } from 'class-validator';
 import { v4 as uuidv4 } from 'uuid';
 
 import { BaseChatbotService } from '../../base-chatbot.service';
@@ -82,23 +83,43 @@ export class EvoaiService extends BaseChatbotService<Evoai, EvoaiSetting> {
 
       // Handle image message if present
       if (this.isImageMessage(content) && msg) {
-        const contentSplit = content.split('|');
-        parts[0].text = contentSplit[2] || content;
+        const media = content.split('|');
+        parts[0].text = media[2] || content;
 
         try {
-          // Download the image
-          const mediaBuffer = await downloadMediaMessage(msg, 'buffer', {});
-          const fileContent = Buffer.from(mediaBuffer).toString('base64');
-          const fileName = contentSplit[2] || `${msg.key?.id || 'image'}.jpg`;
+          if (msg.message.mediaUrl || msg.message.base64) {
+            let mediaBase64 = msg.message.base64 || null;
 
-          parts.push({
-            type: 'file',
-            file: {
-              name: fileName,
-              mimeType: 'image/jpeg',
-              bytes: fileContent,
-            },
-          } as any);
+            if (msg.message.mediaUrl && isURL(msg.message.mediaUrl)) {
+              const result = await axios.get(msg.message.mediaUrl, { responseType: 'arraybuffer' });
+              mediaBase64 = Buffer.from(result.data).toString('base64');
+            }
+
+            if (mediaBase64) {
+              parts.push({
+                type: 'file',
+                file: {
+                  name: msg.key.id + '.jpeg',
+                  mimeType: 'image/jpeg',
+                  bytes: mediaBase64,
+                },
+              } as any);
+            }
+          } else {
+            // Download the image
+            const mediaBuffer = await downloadMediaMessage(msg, 'buffer', {});
+            const fileContent = Buffer.from(mediaBuffer).toString('base64');
+            const fileName = media[2] || `${msg.key?.id || 'image'}.jpg`;
+
+            parts.push({
+              type: 'file',
+              file: {
+                name: fileName,
+                mimeType: 'image/jpeg',
+                bytes: fileContent,
+              },
+            } as any);
+          }
         } catch (fileErr) {
           this.logger.error(`[EvoAI] Failed to process image: ${fileErr}`);
         }
@@ -174,7 +195,7 @@ export class EvoaiService extends BaseChatbotService<Evoai, EvoaiSetting> {
       this.logger.debug(`[EvoAI] Extracted message to send: ${message}`);
 
       if (message) {
-        await this.sendMessageWhatsApp(instance, remoteJid, message, settings);
+        await this.sendMessageWhatsApp(instance, remoteJid, message, settings, true);
       }
     } catch (error) {
       this.logger.error(

src/api/integrations/chatbot/evolutionBot/services/evolutionBot.service.ts

@@ -6,6 +6,7 @@ import { ConfigService, HttpServer } from '@config/env.config';
 import { EvolutionBot, EvolutionBotSetting, IntegrationSession } from '@prisma/client';
 import { sendTelemetry } from '@utils/sendTelemetry';
 import axios from 'axios';
+import { isURL } from 'class-validator';
 
 import { BaseChatbotService } from '../../base-chatbot.service';
 import { OpenaiService } from '../../openai/services/openai.service';
@@ -71,16 +72,26 @@ export class EvolutionBotService extends BaseChatbotService<EvolutionBot, Evolut
         }
       }
 
-      if (this.isImageMessage(content)) {
-        const contentSplit = content.split('|');
+      if (this.isImageMessage(content) && msg) {
+        const media = content.split('|');
 
-        payload.files = [
-          {
-            type: 'image',
-            url: contentSplit[1].split('?')[0],
-          },
-        ];
-        payload.query = contentSplit[2] || content;
+        if (msg.message.mediaUrl || msg.message.base64) {
+          payload.files = [
+            {
+              type: 'image',
+              url: msg.message.base64 || msg.message.mediaUrl,
+            },
+          ];
+        } else {
+          payload.files = [
+            {
+              type: 'image',
+              url: media[1].split('?')[0],
+            },
+          ];
+        }
+
+        payload.query = media[2] || content;
       }
 
       if (instance.integration === Integration.WHATSAPP_BAILEYS) {
@@ -106,6 +117,15 @@ export class EvolutionBotService extends BaseChatbotService<EvolutionBot, Evolut
         };
       }
 
+      // Sanitize payload for logging (remove sensitive data)
+      const sanitizedPayload = {
+        ...payload,
+        inputs: {
+          ...payload.inputs,
+          apiKey: payload.inputs.apiKey ? '[REDACTED]' : undefined,
+        },
+      };
+
       const response = await axios.post(endpoint, payload, {
         headers,
       });
@@ -115,6 +135,10 @@ export class EvolutionBotService extends BaseChatbotService<EvolutionBot, Evolut
       }
 
       let message = response?.data?.message;
+      const rawLinkPreview = response?.data?.linkPreview;
+
+      // Validate linkPreview is boolean and default to true for backward compatibility
+      const linkPreview = typeof rawLinkPreview === 'boolean' ? rawLinkPreview : true;
 
       if (message && typeof message === 'string' && message.startsWith("'") && message.endsWith("'")) {
         const innerContent = message.slice(1, -1);
@@ -124,8 +148,10 @@ export class EvolutionBotService extends BaseChatbotService<EvolutionBot, Evolut
       }
 
       if (message) {
-        // Use the base class method to send the message to WhatsApp
-        await this.sendMessageWhatsApp(instance, remoteJid, message, settings);
+        // Use the base class method that handles splitMessages functionality
+        await this.sendMessageWhatsApp(instance, remoteJid, message, settings, linkPreview);
+      } else {
+        this.logger.warn(`[EvolutionBot] No message content received from bot response`);
       }
 
       // Send telemetry

src/api/integrations/chatbot/flowise/services/flowise.service.ts

@@ -5,6 +5,7 @@ import { Integration } from '@api/types/wa.types';
 import { ConfigService, HttpServer } from '@config/env.config';
 import { Flowise as FlowiseModel, IntegrationSession } from '@prisma/client';
 import axios from 'axios';
+import { isURL } from 'class-validator';
 
 import { BaseChatbotService } from '../../base-chatbot.service';
 import { OpenaiService } from '../../openai/services/openai.service';
@@ -57,6 +58,8 @@ export class FlowiseService extends BaseChatbotService<FlowiseModel> {
       overrideConfig: {
         sessionId: remoteJid,
         vars: {
+          messageId: msg?.key?.id,
+          fromMe: msg?.key?.fromMe,
           remoteJid: remoteJid,
           pushName: pushName,
           instanceName: instance.instanceName,
@@ -80,17 +83,28 @@ export class FlowiseService extends BaseChatbotService<FlowiseModel> {
     }
 
     if (this.isImageMessage(content)) {
-      const contentSplit = content.split('|');
+      const media = content.split('|');
 
-      payload.uploads = [
-        {
-          data: contentSplit[1].split('?')[0],
-          type: 'url',
-          name: 'Flowise.png',
-          mime: 'image/png',
-        },
-      ];
-      payload.question = contentSplit[2] || content;
+      if (msg.message.mediaUrl || msg.message.base64) {
+        payload.uploads = [
+          {
+            data: msg.message.base64 || msg.message.mediaUrl,
+            type: 'url',
+            name: 'Flowise.png',
+            mime: 'image/png',
+          },
+        ];
+      } else {
+        payload.uploads = [
+          {
+            data: media[1].split('?')[0],
+            type: 'url',
+            name: 'Flowise.png',
+            mime: 'image/png',
+          },
+        ];
+        payload.question = media[2] || content;
+      }
     }
 
     if (instance.integration === Integration.WHATSAPP_BAILEYS) {
@@ -128,7 +142,7 @@ export class FlowiseService extends BaseChatbotService<FlowiseModel> {
 
     if (message) {
       // Use the base class method to send the message to WhatsApp
-      await this.sendMessageWhatsApp(instance, remoteJid, message, settings);
+      await this.sendMessageWhatsApp(instance, remoteJid, message, settings, true);
     }
   }
 

src/api/integrations/chatbot/n8n/services/n8n.service.ts

@@ -51,6 +51,7 @@ export class N8nService extends BaseChatbotService<N8n, N8nSetting> {
         pushName: pushName,
         keyId: msg?.key?.id,
         fromMe: msg?.key?.fromMe,
+        quotedMessage: msg?.contextInfo?.quotedMessage,
         instanceName: instance.instanceName,
         serverUrl: this.configService.get<HttpServer>('SERVER').URL,
         apiKey: instance.token,
@@ -78,7 +79,7 @@ export class N8nService extends BaseChatbotService<N8n, N8nSetting> {
       const message = response?.data?.output || response?.data?.answer;
 
       // Use base class method instead of custom implementation
-      await this.sendMessageWhatsApp(instance, remoteJid, message, settings);
+      await this.sendMessageWhatsApp(instance, remoteJid, message, settings, true);
 
       await this.prismaRepository.integrationSession.update({
         where: {

src/api/integrations/chatbot/openai/services/openai.service.ts

@@ -6,6 +6,7 @@ import { IntegrationSession, OpenaiBot, OpenaiSetting } from '@prisma/client';
 import { sendTelemetry } from '@utils/sendTelemetry';
 import axios from 'axios';
 import { downloadMediaMessage } from 'baileys';
+import { isURL } from 'class-validator';
 import FormData from 'form-data';
 import OpenAI from 'openai';
 import P from 'pino';
@@ -85,6 +86,7 @@ export class OpenaiService extends BaseChatbotService<OpenaiBot, OpenaiSetting>
             remoteJid,
             "Sorry, I couldn't transcribe your audio message. Could you please type your message instead?",
             settings,
+            true,
           );
           return;
         }
@@ -173,7 +175,7 @@ export class OpenaiService extends BaseChatbotService<OpenaiBot, OpenaiSetting>
       }
 
       // Process with the appropriate API based on bot type
-      await this.sendMessageToBot(instance, session, settings, openaiBot, remoteJid, pushName || '', content);
+      await this.sendMessageToBot(instance, session, settings, openaiBot, remoteJid, pushName || '', content, msg);
     } catch (error) {
       this.logger.error(`Error in process: ${error.message || JSON.stringify(error)}`);
       return;
@@ -191,6 +193,7 @@ export class OpenaiService extends BaseChatbotService<OpenaiBot, OpenaiSetting>
     remoteJid: string,
     pushName: string,
     content: string,
+    msg?: any,
   ): Promise<void> {
     this.logger.log(`Sending message to bot for remoteJid: ${remoteJid}, bot type: ${openaiBot.botType}`);
 
@@ -222,10 +225,11 @@ export class OpenaiService extends BaseChatbotService<OpenaiBot, OpenaiSetting>
           pushName,
           false, // Not fromMe
           content,
+          msg,
         );
       } else {
         this.logger.log('Processing with ChatCompletion API');
-        message = await this.processChatCompletionMessage(instance, openaiBot, remoteJid, content);
+        message = await this.processChatCompletionMessage(instance, openaiBot, remoteJid, content, msg);
       }
 
       this.logger.log(`Got response from OpenAI: ${message?.substring(0, 50)}${message?.length > 50 ? '...' : ''}`);
@@ -233,7 +237,7 @@ export class OpenaiService extends BaseChatbotService<OpenaiBot, OpenaiSetting>
       // Send the response
       if (message) {
         this.logger.log('Sending message to WhatsApp');
-        await this.sendMessageWhatsApp(instance, remoteJid, message, settings);
+        await this.sendMessageWhatsApp(instance, remoteJid, message, settings, true);
       } else {
         this.logger.error('No message to send to WhatsApp');
       }
@@ -268,6 +272,7 @@ export class OpenaiService extends BaseChatbotService<OpenaiBot, OpenaiSetting>
     pushName: string,
     fromMe: boolean,
     content: string,
+    msg?: any,
   ): Promise<string> {
     const messageData: any = {
       role: fromMe ? 'assistant' : 'user',
@@ -276,18 +281,35 @@ export class OpenaiService extends BaseChatbotService<OpenaiBot, OpenaiSetting>
 
     // Handle image messages
     if (this.isImageMessage(content)) {
-      const contentSplit = content.split('|');
-      const url = contentSplit[1].split('?')[0];
+      const media = content.split('|');
 
-      messageData.content = [
-        { type: 'text', text: contentSplit[2] || content },
-        {
-          type: 'image_url',
-          image_url: {
-            url: url,
+      if (msg.message.mediaUrl || msg.message.base64) {
+        let mediaBase64 = msg.message.base64 || null;
+
+        if (msg.message.mediaUrl && isURL(msg.message.mediaUrl)) {
+          const result = await axios.get(msg.message.mediaUrl, { responseType: 'arraybuffer' });
+          mediaBase64 = Buffer.from(result.data).toString('base64');
+        }
+
+        if (mediaBase64) {
+          messageData.content = [
+            { type: 'text', text: media[2] || content },
+            { type: 'image_url', image_url: { url: mediaBase64 } },
+          ];
+        }
+      } else {
+        const url = media[1].split('?')[0];
+
+        messageData.content = [
+          { type: 'text', text: media[2] || content },
+          {
+            type: 'image_url',
+            image_url: {
+              url: url,
+            },
           },
-        },
-      ];
+        ];
+      }
     }
 
     // Get thread ID from session or create new thread
@@ -376,6 +398,7 @@ export class OpenaiService extends BaseChatbotService<OpenaiBot, OpenaiSetting>
     openaiBot: OpenaiBot,
     remoteJid: string,
     content: string,
+    msg?: any,
   ): Promise<string> {
     this.logger.log('Starting processChatCompletionMessage');
 
@@ -468,18 +491,26 @@ export class OpenaiService extends BaseChatbotService<OpenaiBot, OpenaiSetting>
     // Handle image messages
     if (this.isImageMessage(content)) {
       this.logger.log('Found image message');
-      const contentSplit = content.split('|');
-      const url = contentSplit[1].split('?')[0];
+      const media = content.split('|');
 
-      messageData.content = [
-        { type: 'text', text: contentSplit[2] || content },
-        {
-          type: 'image_url',
-          image_url: {
-            url: url,
+      if (msg.message.mediaUrl || msg.message.base64) {
+        messageData.content = [
+          { type: 'text', text: media[2] || content },
+          { type: 'image_url', image_url: { url: msg.message.base64 || msg.message.mediaUrl } },
+        ];
+      } else {
+        const url = media[1].split('?')[0];
+
+        messageData.content = [
+          { type: 'text', text: media[2] || content },
+          {
+            type: 'image_url',
+            image_url: {
+              url: url,
+            },
           },
-        },
-      ];
+        ];
+      }
     }
 
     // Combine all messages: system messages, pre-defined messages, conversation history, and current message

src/api/integrations/chatbot/typebot/services/typebot.service.ts

@@ -1,5 +1,6 @@
 import { PrismaRepository } from '@api/repository/repository.service';
 import { WAMonitoringService } from '@api/services/monitor.service';
+import { Events } from '@api/types/wa.types';
 import { Auth, ConfigService, HttpServer, Typebot } from '@config/env.config';
 import { Instance, IntegrationSession, Message, Typebot as TypebotModel } from '@prisma/client';
 import { getConversationMessage } from '@utils/getConversationMessage';
@@ -151,6 +152,14 @@ export class TypebotService extends BaseChatbotService<TypebotModel, any> {
           },
         });
       }
+
+      const typebotData = {
+        remoteJid: data.remoteJid,
+        status: 'opened',
+        session,
+      };
+      this.waMonitor.waInstances[instance.name].sendDataWebhook(Events.TYPEBOT_CHANGE_STATUS, typebotData);
+
       return { ...request.data, session };
     } catch (error) {
       this.logger.error(error);
@@ -309,7 +318,7 @@ export class TypebotService extends BaseChatbotService<TypebotModel, any> {
         } else if (formattedText.includes('[buttons]')) {
           await this.processButtonMessage(instance, formattedText, session.remoteJid);
         } else {
-          await this.sendMessageWhatsApp(instance, session.remoteJid, formattedText, settings);
+          await this.sendMessageWhatsApp(instance, session.remoteJid, formattedText, settings, true);
         }
 
         sendTelemetry('/message/sendText');
@@ -318,7 +327,7 @@ export class TypebotService extends BaseChatbotService<TypebotModel, any> {
       if (message.type === 'image') {
         await instance.mediaMessage(
           {
-            number: session.remoteJid.split('@')[0],
+            number: session.remoteJid,
             delay: settings?.delayMessage || 1000,
             mediatype: 'image',
             media: message.content.url,
@@ -333,7 +342,7 @@ export class TypebotService extends BaseChatbotService<TypebotModel, any> {
       if (message.type === 'video') {
         await instance.mediaMessage(
           {
-            number: session.remoteJid.split('@')[0],
+            number: session.remoteJid,
             delay: settings?.delayMessage || 1000,
             mediatype: 'video',
             media: message.content.url,
@@ -348,7 +357,7 @@ export class TypebotService extends BaseChatbotService<TypebotModel, any> {
       if (message.type === 'audio') {
         await instance.audioWhatsapp(
           {
-            number: session.remoteJid.split('@')[0],
+            number: session.remoteJid,
             delay: settings?.delayMessage || 1000,
             encoding: true,
             audio: message.content.url,
@@ -384,7 +393,7 @@ export class TypebotService extends BaseChatbotService<TypebotModel, any> {
         } else if (formattedText.includes('[buttons]')) {
           await this.processButtonMessage(instance, formattedText, session.remoteJid);
         } else {
-          await this.sendMessageWhatsApp(instance, session.remoteJid, formattedText, settings);
+          await this.sendMessageWhatsApp(instance, session.remoteJid, formattedText, settings, true);
         }
 
         sendTelemetry('/message/sendText');
@@ -399,12 +408,14 @@ export class TypebotService extends BaseChatbotService<TypebotModel, any> {
         },
       });
     } else {
+      let statusChange = 'closed';
       if (!settings?.keepOpen) {
         await prismaRepository.integrationSession.deleteMany({
           where: {
             id: session.id,
           },
         });
+        statusChange = 'delete';
       } else {
         await prismaRepository.integrationSession.update({
           where: {
@@ -415,6 +426,13 @@ export class TypebotService extends BaseChatbotService<TypebotModel, any> {
           },
         });
       }
+
+      const typebotData = {
+        remoteJid: session.remoteJid,
+        status: statusChange,
+        session,
+      };
+      instance.sendDataWebhook(Events.TYPEBOT_CHANGE_STATUS, typebotData);
     }
   }
 
@@ -423,7 +441,7 @@ export class TypebotService extends BaseChatbotService<TypebotModel, any> {
    */
   private async processListMessage(instance: any, formattedText: string, remoteJid: string) {
     const listJson = {
-      number: remoteJid.split('@')[0],
+      number: remoteJid,
       title: '',
       description: '',
       buttonText: '',
@@ -472,7 +490,7 @@ export class TypebotService extends BaseChatbotService<TypebotModel, any> {
    */
   private async processButtonMessage(instance: any, formattedText: string, remoteJid: string) {
     const buttonJson = {
-      number: remoteJid.split('@')[0],
+      number: remoteJid,
       thumbnailUrl: undefined,
       title: '',
       description: '',
@@ -624,21 +642,28 @@ export class TypebotService extends BaseChatbotService<TypebotModel, any> {
 
           if (!content) {
             if (unknownMessage) {
-              await this.sendMessageWhatsApp(waInstance, remoteJid, unknownMessage, {
-                delayMessage,
-                expire,
-                keywordFinish,
-                listeningFromMe,
-                stopBotFromMe,
-                keepOpen,
+              await this.sendMessageWhatsApp(
+                waInstance,
+                remoteJid,
                 unknownMessage,
-              });
+                {
+                  delayMessage,
+                  expire,
+                  keywordFinish,
+                  listeningFromMe,
+                  stopBotFromMe,
+                  keepOpen,
+                  unknownMessage,
+                },
+                true,
+              );
               sendTelemetry('/message/sendText');
             }
             return;
           }
 
           if (keywordFinish && content.toLowerCase() === keywordFinish.toLowerCase()) {
+            let statusChange = 'closed';
             if (keepOpen) {
               await this.prismaRepository.integrationSession.update({
                 where: {
@@ -649,6 +674,7 @@ export class TypebotService extends BaseChatbotService<TypebotModel, any> {
                 },
               });
             } else {
+              statusChange = 'delete';
               await this.prismaRepository.integrationSession.deleteMany({
                 where: {
                   botId: findTypebot.id,
@@ -656,6 +682,14 @@ export class TypebotService extends BaseChatbotService<TypebotModel, any> {
                 },
               });
             }
+
+            const typebotData = {
+              remoteJid: remoteJid,
+              status: statusChange,
+              session,
+            };
+            waInstance.sendDataWebhook(Events.TYPEBOT_CHANGE_STATUS, typebotData);
+
             return;
           }
 
@@ -773,21 +807,28 @@ export class TypebotService extends BaseChatbotService<TypebotModel, any> {
       if (!data?.messages || data.messages.length === 0) {
         if (!content) {
           if (unknownMessage) {
-            await this.sendMessageWhatsApp(waInstance, remoteJid, unknownMessage, {
-              delayMessage,
-              expire,
-              keywordFinish,
-              listeningFromMe,
-              stopBotFromMe,
-              keepOpen,
+            await this.sendMessageWhatsApp(
+              waInstance,
+              remoteJid,
               unknownMessage,
-            });
+              {
+                delayMessage,
+                expire,
+                keywordFinish,
+                listeningFromMe,
+                stopBotFromMe,
+                keepOpen,
+                unknownMessage,
+              },
+              true,
+            );
             sendTelemetry('/message/sendText');
           }
           return;
         }
 
         if (keywordFinish && content.toLowerCase() === keywordFinish.toLowerCase()) {
+          let statusChange = 'closed';
           if (keepOpen) {
             await this.prismaRepository.integrationSession.update({
               where: {
@@ -798,6 +839,7 @@ export class TypebotService extends BaseChatbotService<TypebotModel, any> {
               },
             });
           } else {
+            statusChange = 'delete';
             await this.prismaRepository.integrationSession.deleteMany({
               where: {
                 botId: findTypebot.id,
@@ -806,6 +848,13 @@ export class TypebotService extends BaseChatbotService<TypebotModel, any> {
             });
           }
 
+          const typebotData = {
+            remoteJid: remoteJid,
+            status: statusChange,
+            session,
+          };
+          waInstance.sendDataWebhook(Events.TYPEBOT_CHANGE_STATUS, typebotData);
+
           return;
         }
 
@@ -866,21 +915,28 @@ export class TypebotService extends BaseChatbotService<TypebotModel, any> {
 
     if (!content) {
       if (unknownMessage) {
-        await this.sendMessageWhatsApp(waInstance, remoteJid, unknownMessage, {
-          delayMessage,
-          expire,
-          keywordFinish,
-          listeningFromMe,
-          stopBotFromMe,
-          keepOpen,
+        await this.sendMessageWhatsApp(
+          waInstance,
+          remoteJid,
           unknownMessage,
-        });
+          {
+            delayMessage,
+            expire,
+            keywordFinish,
+            listeningFromMe,
+            stopBotFromMe,
+            keepOpen,
+            unknownMessage,
+          },
+          true,
+        );
         sendTelemetry('/message/sendText');
       }
       return;
     }
 
     if (keywordFinish && content.toLowerCase() === keywordFinish.toLowerCase()) {
+      let statusChange = 'closed';
       if (keepOpen) {
         await this.prismaRepository.integrationSession.update({
           where: {
@@ -891,6 +947,7 @@ export class TypebotService extends BaseChatbotService<TypebotModel, any> {
           },
         });
       } else {
+        statusChange = 'delete';
         await this.prismaRepository.integrationSession.deleteMany({
           where: {
             botId: findTypebot.id,
@@ -898,6 +955,15 @@ export class TypebotService extends BaseChatbotService<TypebotModel, any> {
           },
         });
       }
+
+      const typebotData = {
+        remoteJid: remoteJid,
+        status: statusChange,
+        session,
+      };
+
+      waInstance.sendDataWebhook(Events.TYPEBOT_CHANGE_STATUS, typebotData);
+
       return;
     }
 

src/api/integrations/event/event.controller.ts

@@ -14,12 +14,24 @@ export type EmitData = {
   apiKey?: string;
   local?: boolean;
   integration?: string[];
+  extra?: Record<string, any>;
 };
 
 export interface EventControllerInterface {
   set(instanceName: string, data: any): Promise<any>;
   get(instanceName: string): Promise<any>;
-  emit({ instanceName, origin, event, data, serverUrl, dateTime, sender, apiKey, local }: EmitData): Promise<void>;
+  emit({
+    instanceName,
+    origin,
+    event,
+    data,
+    serverUrl,
+    dateTime,
+    sender,
+    apiKey,
+    local,
+    extra,
+  }: EmitData): Promise<void>;
 }
 
 export class EventController {

src/api/integrations/event/event.dto.ts

@@ -40,6 +40,11 @@ export class EventDto {
     useTLS?: boolean;
     events?: string[];
   };
+
+  kafka?: {
+    enabled?: boolean;
+    events?: string[];
+  };
 }
 
 export function EventInstanceMixin<TBase extends Constructor>(Base: TBase) {
@@ -82,5 +87,10 @@ export function EventInstanceMixin<TBase extends Constructor>(Base: TBase) {
       useTLS?: boolean;
       events?: string[];
     };
+
+    kafka?: {
+      enabled?: boolean;
+      events?: string[];
+    };
   };
 }

src/api/integrations/event/event.manager.ts

@@ -1,3 +1,4 @@
+import { KafkaController } from '@api/integrations/event/kafka/kafka.controller';
 import { NatsController } from '@api/integrations/event/nats/nats.controller';
 import { PusherController } from '@api/integrations/event/pusher/pusher.controller';
 import { RabbitmqController } from '@api/integrations/event/rabbitmq/rabbitmq.controller';
@@ -17,6 +18,7 @@ export class EventManager {
   private natsController: NatsController;
   private sqsController: SqsController;
   private pusherController: PusherController;
+  private kafkaController: KafkaController;
 
   constructor(prismaRepository: PrismaRepository, waMonitor: WAMonitoringService) {
     this.prisma = prismaRepository;
@@ -28,6 +30,7 @@ export class EventManager {
     this.nats = new NatsController(prismaRepository, waMonitor);
     this.sqs = new SqsController(prismaRepository, waMonitor);
     this.pusher = new PusherController(prismaRepository, waMonitor);
+    this.kafka = new KafkaController(prismaRepository, waMonitor);
   }
 
   public set prisma(prisma: PrismaRepository) {
@@ -93,25 +96,34 @@ export class EventManager {
     return this.pusherController;
   }
 
+  public set kafka(kafka: KafkaController) {
+    this.kafkaController = kafka;
+  }
+  public get kafka() {
+    return this.kafkaController;
+  }
+
   public init(httpServer: Server): void {
     this.websocket.init(httpServer);
     this.rabbitmq.init();
     this.nats.init();
     this.sqs.init();
     this.pusher.init();
+    this.kafka.init();
   }
 
   public async emit(eventData: {
     instanceName: string;
     origin: string;
     event: string;
-    data: Object;
+    data: object;
     serverUrl: string;
     dateTime: string;
     sender: string;
     apiKey?: string;
     local?: boolean;
     integration?: string[];
+    extra?: Record<string, any>;
   }): Promise<void> {
     await this.websocket.emit(eventData);
     await this.rabbitmq.emit(eventData);
@@ -119,42 +131,47 @@ export class EventManager {
     await this.sqs.emit(eventData);
     await this.webhook.emit(eventData);
     await this.pusher.emit(eventData);
+    await this.kafka.emit(eventData);
   }
 
   public async setInstance(instanceName: string, data: any): Promise<any> {
-    if (data.websocket)
+    if (data.websocket) {
       await this.websocket.set(instanceName, {
         websocket: {
           enabled: true,
           events: data.websocket?.events,
         },
       });
+    }
 
-    if (data.rabbitmq)
+    if (data.rabbitmq) {
       await this.rabbitmq.set(instanceName, {
         rabbitmq: {
           enabled: true,
           events: data.rabbitmq?.events,
         },
       });
+    }
 
-    if (data.nats)
+    if (data.nats) {
       await this.nats.set(instanceName, {
         nats: {
           enabled: true,
           events: data.nats?.events,
         },
       });
+    }
 
-    if (data.sqs)
+    if (data.sqs) {
       await this.sqs.set(instanceName, {
         sqs: {
           enabled: true,
           events: data.sqs?.events,
         },
       });
+    }
 
-    if (data.webhook)
+    if (data.webhook) {
       await this.webhook.set(instanceName, {
         webhook: {
           enabled: true,
@@ -165,8 +182,9 @@ export class EventManager {
           byEvents: data.webhook?.byEvents,
         },
       });
+    }
 
-    if (data.pusher)
+    if (data.pusher) {
       await this.pusher.set(instanceName, {
         pusher: {
           enabled: true,
@@ -178,5 +196,15 @@ export class EventManager {
           useTLS: data.pusher?.useTLS,
         },
       });
+    }
+
+    if (data.kafka) {
+      await this.kafka.set(instanceName, {
+        kafka: {
+          enabled: true,
+          events: data.kafka?.events,
+        },
+      });
+    }
   }
 }

src/api/integrations/event/event.router.ts

@@ -1,3 +1,4 @@
+import { KafkaRouter } from '@api/integrations/event/kafka/kafka.router';
 import { NatsRouter } from '@api/integrations/event/nats/nats.router';
 import { PusherRouter } from '@api/integrations/event/pusher/pusher.router';
 import { RabbitmqRouter } from '@api/integrations/event/rabbitmq/rabbitmq.router';
@@ -18,5 +19,6 @@ export class EventRouter {
     this.router.use('/nats', new NatsRouter(...guards).router);
     this.router.use('/pusher', new PusherRouter(...guards).router);
     this.router.use('/sqs', new SqsRouter(...guards).router);
+    this.router.use('/kafka', new KafkaRouter(...guards).router);
   }
 }

src/api/integrations/event/event.schema.ts

@@ -22,6 +22,9 @@ export const eventSchema: JSONSchema7 = {
     sqs: {
       $ref: '#/$defs/event',
     },
+    kafka: {
+      $ref: '#/$defs/event',
+    },
   },
   $defs: {
     event: {

src/api/integrations/event/kafka/kafka.controller.ts

@@ -0,0 +1,416 @@
+import { PrismaRepository } from '@api/repository/repository.service';
+import { WAMonitoringService } from '@api/services/monitor.service';
+import { configService, Kafka, Log } from '@config/env.config';
+import { Logger } from '@config/logger.config';
+import { Consumer, ConsumerConfig, Kafka as KafkaJS, KafkaConfig, Producer, ProducerConfig } from 'kafkajs';
+
+import { EmitData, EventController, EventControllerInterface } from '../event.controller';
+
+export class KafkaController extends EventController implements EventControllerInterface {
+  private kafkaClient: KafkaJS | null = null;
+  private producer: Producer | null = null;
+  private consumer: Consumer | null = null;
+  private readonly logger = new Logger('KafkaController');
+  private reconnectAttempts = 0;
+  private maxReconnectAttempts = 10;
+  private reconnectDelay = 5000; // 5 seconds
+  private isReconnecting = false;
+
+  constructor(prismaRepository: PrismaRepository, waMonitor: WAMonitoringService) {
+    super(prismaRepository, waMonitor, configService.get<Kafka>('KAFKA')?.ENABLED, 'kafka');
+  }
+
+  public async init(): Promise<void> {
+    if (!this.status) {
+      return;
+    }
+
+    await this.connect();
+  }
+
+  private async connect(): Promise<void> {
+    try {
+      const kafkaConfig = configService.get<Kafka>('KAFKA');
+
+      const clientConfig: KafkaConfig = {
+        clientId: kafkaConfig.CLIENT_ID || 'evolution-api',
+        brokers: kafkaConfig.BROKERS || ['localhost:9092'],
+        connectionTimeout: kafkaConfig.CONNECTION_TIMEOUT || 3000,
+        requestTimeout: kafkaConfig.REQUEST_TIMEOUT || 30000,
+        retry: {
+          initialRetryTime: 100,
+          retries: 8,
+        },
+      };
+
+      // Add SASL authentication if configured
+      if (kafkaConfig.SASL?.ENABLED) {
+        clientConfig.sasl = {
+          mechanism: (kafkaConfig.SASL.MECHANISM as any) || 'plain',
+          username: kafkaConfig.SASL.USERNAME,
+          password: kafkaConfig.SASL.PASSWORD,
+        };
+      }
+
+      // Add SSL configuration if enabled
+      if (kafkaConfig.SSL?.ENABLED) {
+        clientConfig.ssl = {
+          rejectUnauthorized: kafkaConfig.SSL.REJECT_UNAUTHORIZED !== false,
+          ca: kafkaConfig.SSL.CA ? [kafkaConfig.SSL.CA] : undefined,
+          key: kafkaConfig.SSL.KEY,
+          cert: kafkaConfig.SSL.CERT,
+        };
+      }
+
+      this.kafkaClient = new KafkaJS(clientConfig);
+
+      // Initialize producer
+      const producerConfig: ProducerConfig = {
+        maxInFlightRequests: 1,
+        idempotent: true,
+        transactionTimeout: 30000,
+      };
+
+      this.producer = this.kafkaClient.producer(producerConfig);
+      await this.producer.connect();
+
+      // Initialize consumer for global events if enabled
+      if (kafkaConfig.GLOBAL_ENABLED) {
+        await this.initGlobalConsumer();
+      }
+
+      this.reconnectAttempts = 0;
+      this.isReconnecting = false;
+
+      this.logger.info('Kafka initialized successfully');
+
+      // Create topics if they don't exist
+      if (kafkaConfig.AUTO_CREATE_TOPICS) {
+        await this.createTopics();
+      }
+    } catch (error) {
+      this.logger.error({
+        local: 'KafkaController.connect',
+        message: 'Failed to connect to Kafka',
+        error: error.message || error,
+      });
+      this.scheduleReconnect();
+      throw error;
+    }
+  }
+
+  private async initGlobalConsumer(): Promise<void> {
+    try {
+      const kafkaConfig = configService.get<Kafka>('KAFKA');
+
+      const consumerConfig: ConsumerConfig = {
+        groupId: kafkaConfig.CONSUMER_GROUP_ID || 'evolution-api-consumers',
+        sessionTimeout: 30000,
+        heartbeatInterval: 3000,
+      };
+
+      this.consumer = this.kafkaClient.consumer(consumerConfig);
+      await this.consumer.connect();
+
+      // Subscribe to global topics
+      const events = kafkaConfig.EVENTS;
+      if (events) {
+        const eventKeys = Object.keys(events).filter((event) => events[event]);
+
+        for (const event of eventKeys) {
+          const topicName = this.getTopicName(event, true);
+          await this.consumer.subscribe({ topic: topicName });
+        }
+
+        // Start consuming messages
+        await this.consumer.run({
+          eachMessage: async ({ topic, message }) => {
+            try {
+              const data = JSON.parse(message.value?.toString() || '{}');
+              this.logger.debug(`Received message from topic ${topic}: ${JSON.stringify(data)}`);
+
+              // Process the message here if needed
+              // This is where you can add custom message processing logic
+            } catch (error) {
+              this.logger.error(`Error processing message from topic ${topic}: ${error}`);
+            }
+          },
+        });
+
+        this.logger.info('Global Kafka consumer initialized');
+      }
+    } catch (error) {
+      this.logger.error(`Failed to initialize global Kafka consumer: ${error}`);
+    }
+  }
+
+  private async createTopics(): Promise<void> {
+    try {
+      const kafkaConfig = configService.get<Kafka>('KAFKA');
+      const admin = this.kafkaClient.admin();
+      await admin.connect();
+
+      const topics = [];
+
+      // Create global topics if enabled
+      if (kafkaConfig.GLOBAL_ENABLED && kafkaConfig.EVENTS) {
+        const eventKeys = Object.keys(kafkaConfig.EVENTS).filter((event) => kafkaConfig.EVENTS[event]);
+
+        for (const event of eventKeys) {
+          const topicName = this.getTopicName(event, true);
+          topics.push({
+            topic: topicName,
+            numPartitions: kafkaConfig.NUM_PARTITIONS || 1,
+            replicationFactor: kafkaConfig.REPLICATION_FACTOR || 1,
+          });
+        }
+      }
+
+      if (topics.length > 0) {
+        await admin.createTopics({
+          topics,
+          waitForLeaders: true,
+        });
+
+        this.logger.info(`Created ${topics.length} Kafka topics`);
+      }
+
+      await admin.disconnect();
+    } catch (error) {
+      this.logger.error(`Failed to create Kafka topics: ${error}`);
+    }
+  }
+
+  private getTopicName(event: string, isGlobal: boolean = false, instanceName?: string): string {
+    const kafkaConfig = configService.get<Kafka>('KAFKA');
+    const prefix = kafkaConfig.TOPIC_PREFIX || 'evolution';
+
+    if (isGlobal) {
+      return `${prefix}.global.${event.toLowerCase().replace(/_/g, '.')}`;
+    } else {
+      return `${prefix}.${instanceName}.${event.toLowerCase().replace(/_/g, '.')}`;
+    }
+  }
+
+  private handleConnectionLoss(): void {
+    if (this.isReconnecting) {
+      return;
+    }
+
+    this.cleanup();
+    this.scheduleReconnect();
+  }
+
+  private scheduleReconnect(): void {
+    if (this.reconnectAttempts >= this.maxReconnectAttempts) {
+      this.logger.error(
+        `Maximum reconnect attempts (${this.maxReconnectAttempts}) reached. Stopping reconnection attempts.`,
+      );
+      return;
+    }
+
+    if (this.isReconnecting) {
+      return;
+    }
+
+    this.isReconnecting = true;
+    this.reconnectAttempts++;
+
+    const delay = this.reconnectDelay * Math.pow(2, Math.min(this.reconnectAttempts - 1, 5));
+
+    this.logger.info(
+      `Scheduling Kafka reconnection attempt ${this.reconnectAttempts}/${this.maxReconnectAttempts} in ${delay}ms`,
+    );
+
+    setTimeout(async () => {
+      try {
+        this.logger.info(
+          `Attempting to reconnect to Kafka (attempt ${this.reconnectAttempts}/${this.maxReconnectAttempts})`,
+        );
+        await this.connect();
+        this.logger.info('Successfully reconnected to Kafka');
+      } catch (error) {
+        this.logger.error({
+          local: 'KafkaController.scheduleReconnect',
+          message: `Reconnection attempt ${this.reconnectAttempts} failed`,
+          error: error.message || error,
+        });
+        this.isReconnecting = false;
+        this.scheduleReconnect();
+      }
+    }, delay);
+  }
+
+  private async ensureConnection(): Promise<boolean> {
+    if (!this.producer) {
+      this.logger.warn('Kafka producer is not available, attempting to reconnect...');
+      if (!this.isReconnecting) {
+        this.scheduleReconnect();
+      }
+      return false;
+    }
+    return true;
+  }
+
+  public async emit({
+    instanceName,
+    origin,
+    event,
+    data,
+    serverUrl,
+    dateTime,
+    sender,
+    apiKey,
+    integration,
+    extra,
+  }: EmitData): Promise<void> {
+    if (integration && !integration.includes('kafka')) {
+      return;
+    }
+
+    if (!this.status) {
+      return;
+    }
+
+    if (!(await this.ensureConnection())) {
+      this.logger.warn(`Failed to emit event ${event} for instance ${instanceName}: No Kafka connection`);
+      return;
+    }
+
+    const instanceKafka = await this.get(instanceName);
+    const kafkaLocal = instanceKafka?.events;
+    const kafkaGlobal = configService.get<Kafka>('KAFKA').GLOBAL_ENABLED;
+    const kafkaEvents = configService.get<Kafka>('KAFKA').EVENTS;
+    const we = event.replace(/[.-]/gm, '_').toUpperCase();
+    const logEnabled = configService.get<Log>('LOG').LEVEL.includes('WEBHOOKS');
+
+    const message = {
+      ...(extra ?? {}),
+      event,
+      instance: instanceName,
+      data,
+      server_url: serverUrl,
+      date_time: dateTime,
+      sender,
+      apikey: apiKey,
+      timestamp: Date.now(),
+    };
+
+    const messageValue = JSON.stringify(message);
+
+    // Instance-specific events
+    if (instanceKafka?.enabled && this.producer && Array.isArray(kafkaLocal) && kafkaLocal.includes(we)) {
+      const topicName = this.getTopicName(event, false, instanceName);
+
+      let retry = 0;
+      while (retry < 3) {
+        try {
+          await this.producer.send({
+            topic: topicName,
+            messages: [
+              {
+                key: instanceName,
+                value: messageValue,
+                headers: {
+                  event,
+                  instance: instanceName,
+                  origin,
+                  timestamp: dateTime,
+                },
+              },
+            ],
+          });
+
+          if (logEnabled) {
+            const logData = {
+              local: `${origin}.sendData-Kafka`,
+              ...message,
+            };
+            this.logger.log(logData);
+          }
+
+          break;
+        } catch (error) {
+          this.logger.error({
+            local: 'KafkaController.emit',
+            message: `Error publishing local Kafka message (attempt ${retry + 1}/3)`,
+            error: error.message || error,
+          });
+          retry++;
+          if (retry >= 3) {
+            this.handleConnectionLoss();
+          }
+        }
+      }
+    }
+
+    // Global events
+    if (kafkaGlobal && kafkaEvents[we] && this.producer) {
+      const topicName = this.getTopicName(event, true);
+
+      let retry = 0;
+      while (retry < 3) {
+        try {
+          await this.producer.send({
+            topic: topicName,
+            messages: [
+              {
+                key: `${instanceName}-${event}`,
+                value: messageValue,
+                headers: {
+                  event,
+                  instance: instanceName,
+                  origin,
+                  timestamp: dateTime,
+                },
+              },
+            ],
+          });
+
+          if (logEnabled) {
+            const logData = {
+              local: `${origin}.sendData-Kafka-Global`,
+              ...message,
+            };
+            this.logger.log(logData);
+          }
+
+          break;
+        } catch (error) {
+          this.logger.error({
+            local: 'KafkaController.emit',
+            message: `Error publishing global Kafka message (attempt ${retry + 1}/3)`,
+            error: error.message || error,
+          });
+          retry++;
+          if (retry >= 3) {
+            this.handleConnectionLoss();
+          }
+        }
+      }
+    }
+  }
+
+  public async cleanup(): Promise<void> {
+    try {
+      if (this.consumer) {
+        await this.consumer.disconnect();
+        this.consumer = null;
+      }
+      if (this.producer) {
+        await this.producer.disconnect();
+        this.producer = null;
+      }
+      this.kafkaClient = null;
+    } catch (error) {
+      this.logger.warn({
+        local: 'KafkaController.cleanup',
+        message: 'Error during cleanup',
+        error: error.message || error,
+      });
+      this.producer = null;
+      this.consumer = null;
+      this.kafkaClient = null;
+    }
+  }
+}

src/api/integrations/event/kafka/kafka.router.ts

@@ -0,0 +1,36 @@
+import { RouterBroker } from '@api/abstract/abstract.router';
+import { InstanceDto } from '@api/dto/instance.dto';
+import { EventDto } from '@api/integrations/event/event.dto';
+import { HttpStatus } from '@api/routes/index.router';
+import { eventManager } from '@api/server.module';
+import { eventSchema, instanceSchema } from '@validate/validate.schema';
+import { RequestHandler, Router } from 'express';
+
+export class KafkaRouter extends RouterBroker {
+  constructor(...guards: RequestHandler[]) {
+    super();
+    this.router
+      .post(this.routerPath('set'), ...guards, async (req, res) => {
+        const response = await this.dataValidate<EventDto>({
+          request: req,
+          schema: eventSchema,
+          ClassRef: EventDto,
+          execute: (instance, data) => eventManager.kafka.set(instance.instanceName, data),
+        });
+
+        res.status(HttpStatus.CREATED).json(response);
+      })
+      .get(this.routerPath('find'), ...guards, async (req, res) => {
+        const response = await this.dataValidate<InstanceDto>({
+          request: req,
+          schema: instanceSchema,
+          ClassRef: InstanceDto,
+          execute: (instance) => eventManager.kafka.get(instance.instanceName),
+        });
+
+        res.status(HttpStatus.OK).json(response);
+      });
+  }
+
+  public readonly router: Router = Router();
+}

src/api/integrations/event/kafka/kafka.schema.ts

@@ -0,0 +1,21 @@
+import { JSONSchema7 } from 'json-schema';
+import { v4 } from 'uuid';
+
+import { EventController } from '../event.controller';
+
+export const kafkaSchema: JSONSchema7 = {
+  $id: v4(),
+  type: 'object',
+  properties: {
+    enabled: { type: 'boolean', enum: [true, false] },
+    events: {
+      type: 'array',
+      minItems: 0,
+      items: {
+        type: 'string',
+        enum: EventController.events,
+      },
+    },
+  },
+  required: ['enabled'],
+};

src/api/integrations/event/nats/nats.controller.ts

@@ -47,6 +47,7 @@ export class NatsController extends EventController implements EventControllerIn
     sender,
     apiKey,
     integration,
+    extra,
   }: EmitData): Promise<void> {
     if (integration && !integration.includes('nats')) {
       return;
@@ -65,6 +66,7 @@ export class NatsController extends EventController implements EventControllerIn
     const logEnabled = configService.get<Log>('LOG').LEVEL.includes('WEBHOOKS');
 
     const message = {
+      ...(extra ?? {}),
       event,
       instance: instanceName,
       data,

src/api/integrations/event/pusher/pusher.controller.ts

@@ -121,6 +121,7 @@ export class PusherController extends EventController implements EventController
     apiKey,
     local,
     integration,
+    extra,
   }: EmitData): Promise<void> {
     if (integration && !integration.includes('pusher')) {
       return;
@@ -133,6 +134,7 @@ export class PusherController extends EventController implements EventController
     const enabledLog = configService.get<Log>('LOG').LEVEL.includes('WEBHOOKS');
     const eventName = event.replace(/_/g, '.').toLowerCase();
     const pusherData = {
+      ...(extra ?? {}),
       event,
       instance: instanceName,
       data,

src/api/integrations/event/rabbitmq/rabbitmq.controller.ts

@@ -209,6 +209,7 @@ export class RabbitmqController extends EventController implements EventControll
     sender,
     apiKey,
     integration,
+    extra,
   }: EmitData): Promise<void> {
     if (integration && !integration.includes('rabbitmq')) {
       return;
@@ -233,6 +234,7 @@ export class RabbitmqController extends EventController implements EventControll
     const logEnabled = configService.get<Log>('LOG').LEVEL.includes('WEBHOOKS');
 
     const message = {
+      ...(extra ?? {}),
       event,
       instance: instanceName,
       data,

src/api/integrations/event/sqs/sqs.controller.ts

@@ -1,7 +1,8 @@
+import * as s3Service from '@api/integrations/storage/s3/libs/minio.server';
 import { PrismaRepository } from '@api/repository/repository.service';
 import { WAMonitoringService } from '@api/services/monitor.service';
 import { CreateQueueCommand, DeleteQueueCommand, ListQueuesCommand, SQS } from '@aws-sdk/client-sqs';
-import { configService, Log, Sqs } from '@config/env.config';
+import { configService, HttpServer, Log, S3, Sqs } from '@config/env.config';
 import { Logger } from '@config/logger.config';
 
 import { EmitData, EventController, EventControllerInterface } from '../event.controller';
@@ -15,27 +16,29 @@ export class SqsController extends EventController implements EventControllerInt
     super(prismaRepository, waMonitor, configService.get<Sqs>('SQS')?.ENABLED, 'sqs');
   }
 
-  public init(): void {
+  public async init(): Promise<void> {
     if (!this.status) {
       return;
     }
 
-    new Promise<void>((resolve) => {
-      const awsConfig = configService.get<Sqs>('SQS');
+    const awsConfig = configService.get<Sqs>('SQS');
 
-      this.sqs = new SQS({
-        credentials: {
-          accessKeyId: awsConfig.ACCESS_KEY_ID,
-          secretAccessKey: awsConfig.SECRET_ACCESS_KEY,
-        },
+    this.sqs = new SQS({
+      credentials: {
+        accessKeyId: awsConfig.ACCESS_KEY_ID,
+        secretAccessKey: awsConfig.SECRET_ACCESS_KEY,
+      },
 
-        region: awsConfig.REGION,
-      });
-
-      this.logger.info('SQS initialized');
-
-      resolve();
+      region: awsConfig.REGION,
     });
+
+    this.logger.info('SQS initialized');
+
+    const sqsConfig = configService.get<Sqs>('SQS');
+    if (this.sqs && sqsConfig.GLOBAL_ENABLED) {
+      const sqsEvents = Object.keys(sqsConfig.EVENTS).filter((e) => sqsConfig.EVENTS[e]);
+      await this.saveQueues(sqsConfig.GLOBAL_PREFIX_NAME, sqsEvents, true);
+    }
   }
 
   private set channel(sqs: SQS) {
@@ -47,7 +50,7 @@ export class SqsController extends EventController implements EventControllerInt
   }
 
   override async set(instanceName: string, data: EventDto): Promise<any> {
-    if (!this.status) {
+    if (!this.status || configService.get<Sqs>('SQS').GLOBAL_ENABLED) {
       return;
     }
 
@@ -75,6 +78,7 @@ export class SqsController extends EventController implements EventControllerInt
         instanceId: this.monitor.waInstances[instanceName].instanceId,
       },
     };
+
     console.log('*** payload: ', payload);
     return this.prisma[this.name].upsert(payload);
   }
@@ -89,6 +93,7 @@ export class SqsController extends EventController implements EventControllerInt
     sender,
     apiKey,
     integration,
+    extra,
   }: EmitData): Promise<void> {
     if (integration && !integration.includes('sqs')) {
       return;
@@ -98,100 +103,154 @@ export class SqsController extends EventController implements EventControllerInt
       return;
     }
 
-    const instanceSqs = await this.get(instanceName);
-    const sqsLocal = instanceSqs?.events;
-    const we = event.replace(/[.-]/gm, '_').toUpperCase();
+    if (this.sqs) {
+      const serverConfig = configService.get<HttpServer>('SERVER');
+      const sqsConfig = configService.get<Sqs>('SQS');
 
-    if (instanceSqs?.enabled) {
-      if (this.sqs) {
-        if (Array.isArray(sqsLocal) && sqsLocal.includes(we)) {
-          const eventFormatted = `${event.replace('.', '_').toLowerCase()}`;
-          const queueName = `${instanceName}_${eventFormatted}.fifo`;
-          const sqsConfig = configService.get<Sqs>('SQS');
-          const sqsUrl = `https://sqs.${sqsConfig.REGION}.amazonaws.com/${sqsConfig.ACCOUNT_ID}/${queueName}`;
+      const we = event.replace(/[.-]/gm, '_').toUpperCase();
 
-          const message = {
-            event,
-            instance: instanceName,
-            data,
-            server_url: serverUrl,
-            date_time: dateTime,
-            sender,
-            apikey: apiKey,
-          };
-
-          const params = {
-            MessageBody: JSON.stringify(message),
-            MessageGroupId: 'evolution',
-            MessageDeduplicationId: `${instanceName}_${eventFormatted}_${Date.now()}`,
-            QueueUrl: sqsUrl,
-          };
-
-          this.sqs.sendMessage(params, (err) => {
-            if (err) {
-              this.logger.error({
-                local: `${origin}.sendData-SQS`,
-                message: err?.message,
-                hostName: err?.hostname,
-                code: err?.code,
-                stack: err?.stack,
-                name: err?.name,
-                url: queueName,
-                server_url: serverUrl,
-              });
-            } else {
-              if (configService.get<Log>('LOG').LEVEL.includes('WEBHOOKS')) {
-                const logData = {
-                  local: `${origin}.sendData-SQS`,
-                  ...message,
-                };
-
-                this.logger.log(logData);
-              }
-            }
-          });
+      let sqsEvents = [];
+      if (sqsConfig.GLOBAL_ENABLED) {
+        sqsEvents = Object.keys(sqsConfig.EVENTS).filter((e) => sqsConfig.EVENTS[e]);
+      } else {
+        const instanceSqs = await this.get(instanceName);
+        if (instanceSqs?.enabled && Array.isArray(instanceSqs?.events)) {
+          sqsEvents = instanceSqs?.events;
         }
       }
+
+      if (Array.isArray(sqsEvents) && sqsEvents.includes(we)) {
+        const prefixName = sqsConfig.GLOBAL_ENABLED ? sqsConfig.GLOBAL_PREFIX_NAME : instanceName;
+        const eventFormatted =
+          sqsConfig.GLOBAL_ENABLED && sqsConfig.GLOBAL_FORCE_SINGLE_QUEUE
+            ? 'singlequeue'
+            : `${event.replace('.', '_').toLowerCase()}`;
+        const queueName = `${prefixName}_${eventFormatted}.fifo`;
+        const sqsUrl = `https://sqs.${sqsConfig.REGION}.amazonaws.com/${sqsConfig.ACCOUNT_ID}/${queueName}`;
+
+        const message = {
+          ...(extra ?? {}),
+          event,
+          instance: instanceName,
+          dataType: 'json',
+          data,
+          server: serverConfig.NAME,
+          server_url: serverUrl,
+          date_time: dateTime,
+          sender,
+          apikey: apiKey,
+        };
+
+        const jsonStr = JSON.stringify(message);
+        const size = Buffer.byteLength(jsonStr, 'utf8');
+        if (size > sqsConfig.MAX_PAYLOAD_SIZE) {
+          if (!configService.get<S3>('S3').ENABLE) {
+            this.logger.error(
+              `${instanceName} - ${eventFormatted} - SQS ignored: payload (${size} bytes) exceeds SQS size limit (${sqsConfig.MAX_PAYLOAD_SIZE} bytes) and S3 storage is not enabled.`,
+            );
+            return;
+          }
+
+          const buffer = Buffer.from(jsonStr, 'utf8');
+          const fullName = `messages/${instanceName}_${eventFormatted}_${Date.now()}.json`;
+
+          await s3Service.uploadFile(fullName, buffer, size, {
+            'Content-Type': 'application/json',
+            'Cache-Control': 'no-store',
+          });
+
+          const fileUrl = await s3Service.getObjectUrl(fullName);
+
+          message.data = { fileUrl };
+          message.dataType = 's3';
+        }
+
+        const messageGroupId = sqsConfig.GLOBAL_ENABLED
+          ? `${serverConfig.NAME}-${eventFormatted}-${instanceName}`
+          : 'evolution';
+        const isGlobalEnabled = sqsConfig.GLOBAL_ENABLED;
+        const params = {
+          MessageBody: JSON.stringify(message),
+          MessageGroupId: messageGroupId,
+          QueueUrl: sqsUrl,
+          ...(!isGlobalEnabled && {
+            MessageDeduplicationId: `${instanceName}_${eventFormatted}_${Date.now()}`,
+          }),
+        };
+
+        this.sqs.sendMessage(params, (err) => {
+          if (err) {
+            this.logger.error({
+              local: `${origin}.sendData-SQS`,
+              params: JSON.stringify(message),
+              sqsUrl: sqsUrl,
+              message: err?.message,
+              hostName: err?.hostname,
+              code: err?.code,
+              stack: err?.stack,
+              name: err?.name,
+              url: queueName,
+              server_url: serverUrl,
+            });
+          } else if (configService.get<Log>('LOG').LEVEL.includes('WEBHOOKS')) {
+            const logData = {
+              local: `${origin}.sendData-SQS`,
+              ...message,
+            };
+
+            this.logger.log(logData);
+          }
+        });
+      }
     }
   }
 
-  private async saveQueues(instanceName: string, events: string[], enable: boolean) {
+  private async saveQueues(prefixName: string, events: string[], enable: boolean) {
     if (enable) {
-      const eventsFinded = await this.listQueuesByInstance(instanceName);
+      const sqsConfig = configService.get<Sqs>('SQS');
+      const eventsFinded = await this.listQueues(prefixName);
       console.log('eventsFinded', eventsFinded);
 
       for (const event of events) {
-        const normalizedEvent = event.toLowerCase();
-
+        const normalizedEvent =
+          sqsConfig.GLOBAL_ENABLED && sqsConfig.GLOBAL_FORCE_SINGLE_QUEUE ? 'singlequeue' : event.toLowerCase();
         if (eventsFinded.includes(normalizedEvent)) {
           this.logger.info(`A queue para o evento "${normalizedEvent}" já existe. Ignorando criação.`);
           continue;
         }
 
-        const queueName = `${instanceName}_${normalizedEvent}.fifo`;
-
+        const queueName = `${prefixName}_${normalizedEvent}.fifo`;
         try {
+          const isGlobalEnabled = sqsConfig.GLOBAL_ENABLED;
           const createCommand = new CreateQueueCommand({
             QueueName: queueName,
             Attributes: {
               FifoQueue: 'true',
+              ...(isGlobalEnabled && { ContentBasedDeduplication: 'true' }),
             },
           });
+
           const data = await this.sqs.send(createCommand);
           this.logger.info(`Queue ${queueName} criada: ${data.QueueUrl}`);
         } catch (err: any) {
           this.logger.error(`Erro ao criar queue ${queueName}: ${err.message}`);
         }
+
+        if (sqsConfig.GLOBAL_ENABLED && sqsConfig.GLOBAL_FORCE_SINGLE_QUEUE) {
+          break;
+        }
       }
     }
   }
 
-  private async listQueuesByInstance(instanceName: string) {
+  private async listQueues(prefixName: string) {
     let existingQueues: string[] = [];
+
     try {
       const listCommand = new ListQueuesCommand({
-        QueueNamePrefix: `${instanceName}_`,
+        QueueNamePrefix: `${prefixName}_`,
       });
+
       const listData = await this.sqs.send(listCommand);
       if (listData.QueueUrls && listData.QueueUrls.length > 0) {
         // Extrai o nome da fila a partir da URL
@@ -201,7 +260,7 @@ export class SqsController extends EventController implements EventControllerInt
         });
       }
     } catch (error: any) {
-      this.logger.error(`Erro ao listar filas para a instância ${instanceName}: ${error.message}`);
+      this.logger.error(`Erro ao listar filas para ${prefixName}: ${error.message}`);
       return;
     }
 
@@ -209,8 +268,8 @@ export class SqsController extends EventController implements EventControllerInt
     return existingQueues
       .map((queueName) => {
         // Espera-se que o nome seja `${instanceName}_${event}.fifo`
-        if (queueName.startsWith(`${instanceName}_`) && queueName.endsWith('.fifo')) {
-          return queueName.substring(instanceName.length + 1, queueName.length - 5).toLowerCase();
+        if (queueName.startsWith(`${prefixName}_`) && queueName.endsWith('.fifo')) {
+          return queueName.substring(prefixName.length + 1, queueName.length - 5).toLowerCase();
         }
         return '';
       })
@@ -218,15 +277,15 @@ export class SqsController extends EventController implements EventControllerInt
   }
 
   // Para uma futura feature de exclusão forçada das queues
-  private async removeQueuesByInstance(instanceName: string) {
+  private async removeQueuesByInstance(prefixName: string) {
     try {
       const listCommand = new ListQueuesCommand({
-        QueueNamePrefix: `${instanceName}_`,
+        QueueNamePrefix: `${prefixName}_`,
       });
       const listData = await this.sqs.send(listCommand);
 
       if (!listData.QueueUrls || listData.QueueUrls.length === 0) {
-        this.logger.info(`No queues found for instance ${instanceName}`);
+        this.logger.info(`No queues found for ${prefixName}`);
         return;
       }
 
@@ -240,7 +299,7 @@ export class SqsController extends EventController implements EventControllerInt
         }
       }
     } catch (err: any) {
-      this.logger.error(`Error listing queues for instance ${instanceName}: ${err.message}`);
+      this.logger.error(`Error listing queues for ${prefixName}: ${err.message}`);
     }
   }
 }

src/api/integrations/event/webhook/webhook.controller.ts

@@ -65,6 +65,7 @@ export class WebhookController extends EventController implements EventControlle
     apiKey,
     local,
     integration,
+    extra,
   }: EmitData): Promise<void> {
     if (integration && !integration.includes('webhook')) {
       return;
@@ -90,6 +91,7 @@ export class WebhookController extends EventController implements EventControlle
     const regex = /^(https?:\/\/)/;
 
     const webhookData = {
+      ...(extra ?? {}),
       event,
       instance: instanceName,
       data,