sequenceDiagram
    actor User
    participant ChatPlatform
    participant DifyService
    participant OpenaiService
    participant DifyAPI

    User->>ChatPlatform: Sends audio message
    ChatPlatform->>DifyService: Forwards audio message (msg, instance)
    DifyService->>OpenaiService: speechToText(msg, instance)
    OpenaiService->>OpenaiService: Download/process audio buffer
    OpenaiService->>DifyAPI: Request transcription (OpenAI Whisper)
    DifyAPI-->>OpenaiService: Return transcription
    OpenaiService-->>DifyService: Return transcription text
    DifyService->>DifyService: processedContent = "[audio] " + transcription
    DifyService->>DifyAPI: POST /chat-messages (query: processedContent)
    DifyAPI-->>DifyService: Bot response
    DifyService->>ChatPlatform: Send reply message
    ChatPlatform-->>User: Delivers reply

sequenceDiagram
    actor User
    participant ChatPlatform
    participant ChatbotController
    participant BaseChatbotService
    participant SpecificBotService
    participant PrismaRepository
    participant ExternalBotAPI

    User->>ChatPlatform: Sends message
    ChatPlatform->>ChatbotController: routeMessage(instance, ...)
    ChatbotController->>BaseChatbotService: process(instance, remoteJid, bot, session, settings, content, ...)
    BaseChatbotService->>BaseChatbotService: Check/Get session
    alt No existing session
        BaseChatbotService->>BaseChatbotService: createNewSession(instanceInfo, sessionData, botType)
        BaseChatbotService->>PrismaRepository: Save new session
        PrismaRepository-->>BaseChatbotService: New session created
    end
    BaseChatbotService->>SpecificBotService: sendMessageToBot(instance, session, settings, bot, ...)
    SpecificBotService->>SpecificBotService: Prepare payload (e.g., transcribe audio if needed)
    SpecificBotService->>ExternalBotAPI: Send processed message
    ExternalBotAPI-->>SpecificBotService: Receive bot response
    SpecificBotService->>BaseChatbotService: sendMessageWhatsApp(instance, remoteJid, responseText, settings)
    BaseChatbotService->>ChatPlatform: Send reply to user
    ChatPlatform-->>User: Deliver reply

erDiagram
    n8nSchema {
        boolean enabled "Required"
        string description
        string webhookUrl "Required"
        string basicAuthUser
        string basicAuthPassword "Renamed from basicAuthPass"
        string triggerType "New, Required, Enum: all, keyword, none, advanced"
        string triggerOperator "New, Enum: equals, contains, ..."
        string triggerValue "New"
        integer expire "New"
        string keywordFinish "New"
        integer delayMessage "New"
        string unknownMessage "New"
        boolean listeningFromMe "New"
        boolean stopBotFromMe "New"
        boolean keepOpen "New"
        integer debounceTime "New"
        array ignoreJids "New"
        boolean splitMessages "New"
        integer timePerChar "New"
    }

    n8nSettingSchema {
        integer expire "Required"
        string keywordFinish "Required"
        integer delayMessage "Required"
        string unknownMessage "Required"
        boolean listeningFromMe "Required"
        boolean stopBotFromMe "Required"
        boolean keepOpen "Required"
        integer debounceTime "Required"
        array ignoreJids "Required"
        string botIdFallback "Renamed from n8nIdFallback"
        boolean splitMessages "Required"
        integer timePerChar "Required"
    }

    n8nStatusSchema {
        string remoteJid "Required"
        string status "Required, Enum: opened, closed, paused, delete (order changed)"
    }

    n8nIgnoreJidSchema {
        string remoteJid "Required"
        string action "Required, Enum: add, remove"
    }
    note "Shows key field changes and additions to N8N JSON schemas based on the diff."

classDiagram
    class BaseChatbotService {
        +String serviceName
        +ConfigService configService
        +PrismaRepository prismaRepository
        +WAMonitoringService waMonitor
        +process(instance, remoteJid, bot, session, settings, content, pushName, msg)
        +createNewSession(instanceInfo, sessionData, botType): IntegrationSession
        +sendMessageWhatsApp(instance, remoteJid, message, settings)
        +isAudioMessage(content): boolean
        +isImageMessage(content): boolean
        #abstract getBotType(): string
        #abstract sendMessageToBot(instance, session, settings, bot, remoteJid, pushName, content, msg): Promise~void~
    }
    class DifyService {
        +OpenaiService openaiService
        +constructor(waMonitor, prisma, config, openai)
        +getBotType(): string
        +sendMessageToBot(instance, session, settings, dify, remoteJid, pushName, content, msg): Promise~void~
        -createNewSession(instance, data) "Removed"
    }
    class N8nService {
        +OpenaiService openaiService
        +constructor(waMonitor, prisma, config, openai)
        +getBotType(): string
        +sendMessageToBot(instance, session, settings, n8n, remoteJid, pushName, content, msg): Promise~void~
        -createBot() "Removed"
        -findBots() "Removed"
        -fetchBot() "Removed"
        -updateBot() "Removed"
        -deleteBot() "Removed"
        -createNewSession() "Removed"
        -sendMessageWhatsApp() "Removed"
    }
    class OpenaiService {
        +constructor(waMonitor, prisma, config)
        +getBotType(): string
        +speechToText(msg, instance): Promise~string~ "Refactored"
        +sendMessageToBot(instance, session, settings, bot, remoteJid, pushName, content, msg): Promise~void~
        -createNewSession() "Removed"
    }
    class FlowiseService {
        +OpenaiService openaiService
        +constructor(waMonitor, prisma, config, openai) "Updated signature"
        +getBotType(): string
        +processBot(instance, remoteJid, bot, session, settings, content, pushName, msg) "Added"
        +sendMessageToBot(instance, session, settings, bot, remoteJid, pushName, content, msg): Promise~void~
    }
    class EvoaiService {
        +OpenaiService openaiService
        +constructor(waMonitor, prisma, config, openai) "Updated signature"
        +getBotType(): string
        +sendMessageToBot(instance, session, settings, evoai, remoteJid, pushName, content, msg): Promise~void~
        -process() "Removed"
        -createNewSession() "Removed"
    }
    BaseChatbotService <|-- DifyService
    BaseChatbotService <|-- N8nService
    BaseChatbotService <|-- OpenaiService
    BaseChatbotService <|-- FlowiseService
    BaseChatbotService <|-- EvoaiService