Skip to main content

リクエストパラメータ

本体構造

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

message_info フィールド

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

files_info 構造

string
必須
ファイルアドレスまたはbase64データ
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