メインコンテンツまでスキップ

起動とリセット

チャネルを初めて起動するとき、またはボットの対話履歴をリセットするときに、この API で対話を開始します。

URI​

{{base_url}}/generic/ns/{{namespace}}/bot-provider/{{bot_provider_name}}/message/sse

HTTP メソッド​

POST

ヘッダー​

API キーの機能を有効にしている場合、ヘッダーに X-API-KEY を含め、Asgard の管理画面で設定した API キーを指定してください。指定しないと接続できません。

名称型説明
X-API-KEYstringご利用の API キー

リクエストのパラメータ​

名称型説明
customChannelIdstringチャットチャネルの ID。必須で、任意に決められます。対話の記憶はチャネル ID ごとです。
customMessageIdstringメッセージ ID。任意に設定するか空でも構いません。追跡とデバッグに便利です。
textstring初期化時は空にします
actionstring初期化時は RESET_CHANNEL を指定します

ペイロードの例​

{
"customChannelId": "a-random-channel-id-1",
"customMessageId": "a-random-msg-id-1",
"text": "",
"action": "RESET_CHANNEL"
}

レスポンス​

成功すると JSON メッセージが連続して届きます。各イベントの詳細は次を参照してください。

各イベント​

Message Template​

message オブジェクトの template 項目には、フロントエンドの標準コンポーネント向けの描画データが入ります。