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