Slash Command(スラッシュコマンド)
誰かがSlackチャンネルに定義済みのスラッシュコマンドを入力したときトリガーされます。
このイベントは、コマンドへの応答 - リアルタイム、またはコマンドへの応答 - 遅延のアクションカードとペアで使用します。
Slackアプリでスラッシュコマンドを設定すると、Slackチャンネルにスラッシュコマンドを入力するとき、データのペイロードがSlackアプリから、ターゲットURLに送信されます。これは、スラッシュコマンドのカードを含むフローの起動URLの必要があります。カードの下端にある[Webhook settings(Webhookの設定)]アイコンをクリックし、URL文字列を取得します。詳細については、Slack APIドキュメントを参照してください。
SlackワークスペースへのSlackアプリの追加
スラッシュコマンドのイベントカードを使用するには、以下の手順を実行する必要があります。
-
独自のSlackアプリを作成します。「基本的なアプリの設定」を参照してください。
-
アプリ用のスラッシュコマンドを設定します。
-
Slackアプリの[Basic Information(基本情報)]ページで、[Add features and functionality(機能の追加)]セクションを展開して[Slash Commands(スラッシュコマンド)]を選択します。
-
[Create New Command(新しいコマンドを作成)]ボタンをクリックします。
-
[Command(コマンド)]フィールドに新しいアプリのスラッシュコマンドを追加します。Slackワークスペースのすべてのユーザーが、このスラッシュコマンドを使用してアプリを起動できるようになります。
-
[Request URL(リクエストURL)]フィールドに、スラッシュコマンドカードでトリガーするフローのURLを追加します。フローを起動するAPIアクセスURLを見つける方法については、「APIエンドポイントを使ったフローの呼び出し」を参照してください。
-
Slackワークスペースのアプリ ユーザーに役立つ情報を[Short Description(簡単な説明)]と[Usage Hint(使用上のヒント)]に追加して、[Save(保存)]をクリックします。
-
-
Slackの[Install App(アプリのインストール)]ページに移動し、Slackワークスペース用のアプリをインストールします。
-
アプリを適切にインストールしたかどうかを確認するには、Slackクライアントのメッセージバーに「/」を入力します。インストールしたアプリが一覧表示されます。
オプション
フィールド | 定義 | タイプ | Required (必須) |
---|---|---|---|
Use Signing Key?(署名鍵を使用?) | Slackからの要求を検証するかどうか。Yesが選択された場合、Slackは顧客アプリに対して一意であるシークレットを使用して要求に署名します。コネクターは署名を使用して、要求がSlackからターゲットURLへのものであることを検証します。 |
True/False |
TRUE |
Signing Key(署名鍵) |
使用するアプリに対して一意であるシークレット値。この値はSlackアプリ管理コンソールから取得します。
[Use Signing Key?(署名鍵を使用?)]がYesに設定されている場合、Slackからの要求の検証にこのキーが使用されます。それ以外の場合はNoです。 |
テキスト |
TRUE |
出力
フィールド | 定義 | Type (タイプ) |
---|---|---|
コマンド |
||
Slash Command(スラッシュコマンド) | Slackボットに送信されたスラッシュコマンド。 |
テキスト |
Text(テキスト) | スラッシュコマンドの後にユーザーが入力した内容。 |
テキスト |
Response URL(応答URL) | スラッシュコマンド応答のURL。 |
テキスト |
Team ID(チームID) | スラッシュコマンドを送信したユーザーのチームID。 |
テキスト |
Team Domain(チームドメイン) | ユーザーのチームドメイン名。 |
テキスト |
Channel ID(チャンネルID) | スラッシュコマンドが送信されたチャンネルのID。 |
テキスト |
Channel Name(チャンネル名) | スラッシュコマンドが送信されたチャンネルの名前。 |
テキスト |
User ID(ユーザーID) |
ユーザーの一意識別子。 |
テキスト |
User Name(ユーザー名) | ユーザーのSlackユーザー名。 |
テキスト |