チャットメッセージ
チュートリアル |
サンプル |
アプリケーション (チャットボットなど) は、アプリケーションチャットチャネルを通じて Space ユーザーと対話できます。
アプリケーションチャットチャネルでは、Space ユーザーは次のことができます。
これらすべての場合において、Space は異なるタイプのペイロードをアプリケーションに送信します。
アプリケーションのチャットチャネルを追加する
アプリケーションのチャットチャネルの追加は、明示的なアクションです。複数組織のアプリケーションは、setUiExtensions
API 呼び出しを行うことで自分自身のチャットチャネルを追加できます。例: Kotlin Space SDK を使用してサーバー側でこれを行う方法は次のとおりです。
単一組織アプリケーションの場合、アプリケーション設定からチャットチャネルを有効にすることができます。
拡張 | アプリケーションで、必要なアプリケーションを開きます。
概要タブで、チャットボットを選択します。
対応するチャットチャネルを開きたい場合は、チャットボットに移動をクリックします。
使用可能なコマンドをリストする
ユーザーがアプリケーションチャットチャネルで入力を開始すると、Space は ListCommandsPayload
タイプのペイロードをアプリケーションに送信します。
ペイロードの例:
一般的なチャットボットは次のように動作します。
ユーザーがスラッシュ
/
文字を入力すると、Space には使用可能なコマンドの完全なリストが表示されます。ユーザーが他の文字を入力すると、Space はその文字を検索パターンとして処理し、パターンに一致するコマンドのリストを表示します。
Space は、すぐに使えるこの機能を提供します。アプリケーションの唯一のタスクは、ListCommandsPayload
の受信時に使用可能なコマンドの JSON リストで応答することです。コマンドごとに、name
および description
を指定する必要があります。例:
使用可能なコマンドのリストを準備しやすくするために、Space SDK には CommandDetail
クラスが用意されています。例: これを使用してコマンドのリストを準備し、Space に送り返す方法は次のとおりです。
プロセスメッセージコマンド
ユーザーがアプリケーションチャットにメッセージを入力して Enter を押すと、Space は MessagePayload
タイプのペイロードをアプリケーションに送信します。
ペイロードの例:
アプリケーションがチャットボットまたはスラッシュコマンドである場合、通常、ユーザーがアプリケーションチャットに何らかのコマンドを送信する必要があることを意味します。これは、単なるコマンド名 (例: help
)、または引数付きのコマンド (例: book room-621
) の場合があります。MessagePayload
クラスは、メッセージで送信されたコマンドを処理するための 2 つのヘルパー関数を提供します。
MessagePayload.command(): String?
はユーザーが指定したコマンドを返しますMessagePayload.commandArguments(): String?
はユーザーが指定したコマンド引数を返します
さまざまな種類のメッセージ添付ファイルを操作できるように、Space SDK には FileAttachment
、ImageAttachment
、VideoAttachment
などのいくつかのクラスが用意されています。ファイルをアップロードして添付する方法を学ぶ
例: Kotlin Space SDK でメッセージを処理する方法は次のとおりです。
メッセージ内のユーザーアクションを処理する
メッセージコンストラクター DSL を使用すると、対話型 UI コントロールを含むチャットメッセージを作成できます (現在はボタンのみがサポートされています)。コントロールには action: MessageAction
プロパティがあります。MessageAction
インターフェースには PostMessageAction(actionId: String, payload: String)
という 1 つの実装があります。ユーザーがチャット内のボタンをクリックすると、Space は MessageActionPayload
タイプのペイロードをアプリケーションに送信します。ペイロードには、ボタンの actionId
とアクションの payload
が含まれます。このアクションを実行した後、アプリケーションは 200 OK
HTTP ステータスで応答する必要があります。
ペイロードの例:
Space SDK の場合、MessageActionPayload
クラスを使用してメッセージアクションを処理します。このクラスは 2 つのプロパティを提供します。
actionId: String
はクリックされたボタンのactionId
を返します。actionValue: String
はアクションpayload
を返します。
Kotlin Space SDK を使用してメッセージアクションを処理する方法は次のとおりです。
関連ページ:

(Kotlin) チャットボットの作成方法
チャットボットとは何ですか ? これは、独自のチャットチャネルで Space ユーザーと通信する Space アプリケーションです。最低限実行可能なボットは次のことを行う必要があります。ユーザーがチャネルに (スラッシュ) を入力すると、使用可能なコマンドのリストが表示されます。少なくとも 1 つのコマンドを指定します。ユーザーがこのコマンドをチャネルに送信した後、ボットは何かを実行してからメッセージで応答する必要があります。何をしたらいいでしょう:もちろん、初めてのチャットボットでも ! 早速...

(.NET) チャットボットの作成方法
チャットボットとは何ですか ? これは、独自のチャットチャネルで Space ユーザーと通信する Space アプリケーションです。最低限実行可能なボットは次のことを行う必要があります。ユーザーがチャネルに (スラッシュ) を入力すると、使用可能なコマンドのリストが表示されます。少なくとも 1 つのコマンドを指定します。ユーザーがこのコマンドをチャネルに送信した後、ボットは何かを実行してからメッセージで応答する必要があります。何をしたらいいでしょう:まずはチャットボットを作ってみましょう ! よ...

(Kotlin) インタラクティブ UI をメッセージに追加する方法
前提条件:次のように仮定します。「リマインダー」ボットのソースコードがあります。チャットボットの作成方法チュートリアルを完了しました。具体的には、環境をセットアップする手順を完了しました。ステップ 3. トンネリングサービスを実行する、ステップ 4. Space にチャットボットを登録する、何をしたらいいでしょう:このチュートリアルでは、(Kotlin) チャットボットの作成方法チュートリアルで作成した「リマインダー」ボットの機能を拡張します。具体的には、ボットメッセージの 1 つに UI...

複数組織アプリケーションの配布
マルチ組織アプリケーションは、複数の Space 組織にインストールできるアプリケーションです。組織ユーザーは、直接リンクをクリックするか、JetBrains マーケットプレイスを使用してアプリケーションをインストールできます。アプリケーションを複数の組織で使用できるようにするには、Space API 呼び出しを介して特定の組織内でアプリケーション自体を構成できる必要があります。アプリケーション構成の詳細については、こちらを参照します。複数組織アプリケーションの詳細:クライアントクレデンシャル...

単一組織アプリケーションの登録
アプリケーションの登録は、単一組織アプリケーションを Space インスタンスにインストールする主な方法です。アプリケーションを登録するときは、認可フロー、必要な権限、アプリケーションのエンドポイントなどの設定を手動で指定します。アプリケーションを Space インスタンスに追加する:メインメニューで、「拡張」をクリックし、「インストール済み」を選択します。新しいアプリをクリックします。指定: ユニークなアプリケーション名前。アプリケーションメール。アプリケーションが Space リポジトリにコ...

カスタムメニュー項目
サンプルカスタムメニュー項目を課題コンテキストメニューに追加するサンプルアプリケーション、アプリケーションは、Space のコンテキストメニューにカスタムメニュー項目を追加できます。ユーザーがカスタム項目をクリックすると、Space はアプリケーションにメッセージを送信します。メッセージには、タイプのペイロードが含まれています。カスタムメニュー項目を追加できる場所:現在、次の Space エンティティのコンテキストメニューはカスタム項目で拡張できます。課題、チャットメッセージ、コードレビュー、...