メインコンテンツへスキップ

​
リクエストパラメータ

​
本体構造

​
client
string
必須
ビジネス識別子、MarsMind Intelligenceに確認してください
​
signature
string
必須
署名、以下のアルゴリズムを参照
​
timestamp
integer
必須
タイムスタンプ（Unix秒単位）
​
message_info
object
必須
メッセージ詳細、以下のフィールド定義を参照

​
message_info フィールド

​
msg_id
string
一意のメッセージID、assist_dialogシナリオでは必須
​
group_id
string
グループチャットID、from_user_idとgroup_idが共に空の場合はエラー400
​
group_name
string
グループチャット名
​
from_user_id
string
必須
送信者ID
​
from_user_nickname
string
送信者ニックネーム
​
to_user_id
string
受信者ID
​
to_user_nickname
string
受信者ニックネーム
​
at_list
string[]
@ユーザーIDのリスト（auto_dialogのみサポート）
​
content
string
メッセージテキスト内容、contentとfiles_infoの少なくとも1つは必須
​
message_type
integer
必須
1 = 通常メッセージ、2 = 引用メッセージ
​
event_type
string
必須
auto_dialog | assist_dialog | website_dialog | cmd_dialog
​
from_user_type
integer
1=ロボットバインディングアカウント 2=顧客 3=カスタマーサービス 4=ロボットメッセージ。auto_dialogでは必須
​
create_timestamp
integer
必須
メッセージ作成時間（Unixタイムスタンプ）
​
files_info
File[]
添付ファイルリスト、下表参照。contentとfiles_infoの少なくとも1つは必須
​
quote
object
引用メッセージオブジェクト、msg_id、message_typeを含む必要があります。message_type=2の場合は必須

​
files_info 構造

​
content
string
必須
ファイルアドレスまたはbase64データ
​
file_type
string
必須
“image”/“document”/“voice”

​
対話シナリオの説明

​
auto_dialog（自動対話）

  • event_type = auto_dialog
  • send_url を提供し、MarsMind Intelligenceがメッセージロジックを自動制御します
  • テキスト、画像、ファイルをサポート（リクエストごとに一意のタイプ）
from_user_type 記入の提案：
  • バインディング対象：インテリジェントアシスタント自身のメッセージを除き、すべて1を記入
  • 非バインディング対象：外部顧客は2、同社の人員は3を記入

​
assist_dialog（補助対話）

  • event_type = assist_dialog
  • メッセージ処理結果をリアルタイムで返します
  • パラメータがauto_dialogメッセージと一致する場合、コンテキストが再利用されます

​
website_dialog（ウェブサイト対話）

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