​
Chat System Overview

The chat system provides a RESTful API for managing conversations and messages. It’s designed to handle normal conversations and workflow-based conversations through a simple API interface.

​
Core Components

​
1. Conversations

  • Create and manage chat sessions
  • Associate conversations with specific workflows
  • Support different usecases
    • DEFAULT: Simple chat conversation
    • WORKFLOW_EXECUTION: To trigger a workflow
  • Track conversation metadata and state

​
2. Messages

  • Send and receive messages within conversations
  • Support text content, media content
  • Track message status and metadata
  • Associate messages with conversations

​
Typical Flow Diagram

​
Key Features

  1. Workflow Integration

    • Each conversation can be linked to a specific workflow
    • Supports workflow execution
    • Automatic workflow state management

  2. Message Handling

    • Synchronous message processing
    • Message status tracking
    • Support for metadata

  3. Error Handling

    • Consistent error responses
    • Clear status codes
    • Detailed error messages

  4. Webhook Integration

    • Real-time callback for message events
    • Detailed message information in webhook payload
    • Supports different webhook handlers