API ドキュメント

​

リクエストパラメータ

​

メイン構造

​

message_info フィールド

​

files_info 構造

​

会話シナリオの種類

​

auto_dialog（自動対話）

• event_type = auto_dialog
• send_url を提供し、MarsMind が自動で送信ロジックを制御
• テキスト・画像・ファイルをサポート（リクエストごとに 1 種類のみ）

• 特定ユーザーに紐付く場合：AI 以外のメッセージはすべて 1
• 特定ユーザーに紐付かない場合：外部顧客は 2、自社スタッフは 3

​

assist_dialog（補助対話）

• event_type = assist_dialog
• リアルタイムで結果を返却
• auto_dialog と同一のパラメータであれば、既存のコンテキストを利用

​

website_dialog（Web 対話）

• event_type = website_dialog
• 即時に結果を返却し、会話履歴に追加
• send_url は利用不可

​

cmd_dialog（コマンド制御）

• event_type = cmd_dialog
• content にコマンドを指定。現在サポートしているのは：
  • stop_auto_reply：自動返信を停止（auto_dialog シナリオのみ有効）

​

利用例

​

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" }
    ]
  }
}'