API Documentation

​

Request Parameters

​

Main Structure

​

message_info Fields

​

files_info Structure

​

Conversation Scenarios

​

auto_dialog (Automatic Dialog)

• event_type = auto_dialog
• Provide send_url. MarsMind will control sending logic automatically.
• Supports text, image, or file (only one type per request).

• If bound to a specific account: all non-AI messages should use 1.
• If not bound: external customer = 2, internal staff = 3.

​

assist_dialog (Assisted Dialog)

• event_type = assist_dialog
• Immediately returns the processed result.
• If parameters match a previous auto_dialog message, the same context will be reused.

​

website_dialog (Web Dialog)

• event_type = website_dialog
• Message is processed immediately and appended to context.
• send_url is not supported.

​

cmd_dialog (Command Control)

• event_type = cmd_dialog
• content should contain the command. Currently supported:
  • stop_auto_reply: stop auto-reply (only valid in auto_dialog).

​

Example Usage

​

auto_dialog

curl -X POST http://127.0.0.1:7002/custom-im/chat-messages \
-H "Content-Type: application/json" \
-d '{
  "client": "test",
  "signature": "d97b383a532466b6c6c451e76a2ab57b",
  "timestamp": 1748584621,
  "message_info": {
    "content": "",
    "message_type": 1,
    "group_id": "98765@chatroom",
    "event_type": "auto_dialog",
    "from_user_id": "aa123",
    "from_user_type": 2,
    "msg_id": "9005",
    "create_timestamp": 1748584621,
    "files_info": [
      { "content": "https://example.com/img.png", "file_type": "image" }
    ]
  }
}'