​

WebSocket Chat Communication

​

Chat Message Types

​

Sending Chat Messages

{
  "code": "chat",
  "user_id": "user_456",
  "room_id": "conversation_123",
  "data": {
    "message": "Hello, how's the design coming along?",
    "sender": "user_456",
    "message_id": "msg_abc123",
    "attached_files": ["file_789"]
  }
}

​

Required Fields

• code: Must be “chat”
• user_id: The user ID of the sender
• room_id: The conversation or room ID
• data.message: The text message content
• data.sender: The user ID of the sender (same as user_id)

​

Optional Fields

• data.message_id: Unique ID for the message (auto-generated if not provided)
• data.attached_files: Array of file IDs attached to the message
• data.reply_to: ID of the message being replied to
• timestamp: ISO format timestamp (auto-generated if not provided)

​

Receiving Chat Messages

{
  "status": "success",
  "code": "chat_response",
  "user_id": "user_456",
  "room_id": "conversation_123",
  "timestamp": "2023-05-01T12:34:56.789Z",
  "data": {
    "message": "Hello, how's the design coming along?",
    "sender": "user_456",
    "message_id": "msg_xyz",
    "attached_files": [],
    "metadata": {
      "sent_from_device": "web"
    }
  }
}

​

Typing Indicators

{
  "code": "typing",
  "user_id": "user_456",
  "room_id": "conversation_123",
  "data": {
    "status": "started", // or "stopped"
    "sender": "user_456"
  }
}

​

Read Receipts

{
  "code": "read_receipt",
  "user_id": "user_456",
  "room_id": "conversation_123",
  "data": {
    "message_id": "msg_xyz",
    "sender": "user_456"
  }
}

​

Presence Updates

{
  "code": "presence",
  "user_id": "user_456",
  "data": {
    "status": "online", // online, offline, away, busy
    "sender": "user_456"
  }
}

​

Conversation Rooms

1. Join the conversation room:
   {
     "code": "join",
     "user_id": "user_456",
     "room_id": "conversation_123",
     "data": {}
   }
   
2. Request history messages (optional):
   {
     "code": "historic",
     "user_id": "user_456",
     "room_id": "conversation_123",
     "data": {
       "message": "Load conversation history",
       "product_id": "product_789",
       "conversation_id": "conversation_123"
     }
   }
   
3. Update your presence:
   {
     "code": "presence",
     "user_id": "user_456",
     "room_id": "conversation_123",
     "data": {
       "sender": "user_456",
       "status": "online"
     }
   }
   

​

Message Metadata

{
  "code": "chat",
  "user_id": "user_456",
  "room_id": "conversation_123",
  "data": {
    "message": "Check out these design specs",
    "sender": "user_456",
    "metadata": {
      "importance": "high",
      "category": "design_review",
      "tags": ["urgent", "review"]
    }
  }
}

​

File Attachments

1. First upload the files using the /files API endpoint
2. Then include the file IDs in the chat message:
   {
     "code": "chat",
     "user_id": "user_456",
     "room_id": "conversation_123",
     "data": {
       "message": "Here are the updated CAD files",
       "sender": "user_456",
       "attached_files": ["file_123", "file_456"]
     }
   }
   

​

Broadcast Messages