Slash Command(スラッシュコマンド)

誰かがSlackチャンネルに定義済みのスラッシュコマンドを入力したときトリガーされます。

このイベントは、コマンドへの応答 - リアルタイム、またはコマンドへの応答 - 遅延のアクションカードとペアで使用します。

Slackアプリでスラッシュコマンドを設定すると、Slackチャンネルにスラッシュコマンドを入力するとき、データのペイロードがSlackアプリから、ターゲットURLに送信されます。これは、スラッシュコマンドのカードを含むフローの起動URLの必要があります。カードの下端にある[Webhook settings(Webhookの設定)]アイコンをクリックし、URL文字列を取得します。詳細については、Slack APIドキュメントを参照してください。

SlackワークスペースへのSlackアプリの追加

スラッシュコマンドのイベントカードを使用するには、以下の手順を実行する必要があります。

  1. 独自のSlackアプリを作成します。「基本的なアプリの設定」を参照してください。

  2. アプリ用のスラッシュコマンドを設定します。

    1. Slackアプリの[Basic Information(基本情報)]ページで、[Add features and functionality(機能の追加)]セクションを展開して[Slash Commands(スラッシュコマンド)]を選択します。

    2. [Create New Command(新しいコマンドを作成)]ボタンをクリックします。

    3. [Command(コマンド)]フィールドに新しいアプリのスラッシュコマンドを追加します。Slackワークスペースのすべてのユーザーが、このスラッシュコマンドを使用してアプリを起動できるようになります。

    4. [Request URL(リクエストURL)]フィールドに、スラッシュコマンドカードでトリガーするフローのURLを追加します。フローを起動するAPIアクセスURLを見つける方法については、「APIエンドポイントを使ったフローの呼び出し」を参照してください。

    5. Slackワークスペースのアプリ ユーザーに役立つ情報を[Short Description(簡単な説明)][Usage Hint(使用上のヒント)]に追加して、[Save(保存)]をクリックします。

  3. Slackの[Install App(アプリのインストール)]ページに移動し、Slackワークスペース用のアプリをインストールします。

  4. アプリを適切にインストールしたかどうかを確認するには、Slackクライアントのメッセージバーに「/」を入力します。インストールしたアプリが一覧表示されます。

オプション

フィールド 定義 タイプ 必須
Use Signing Key?(署名鍵を使用?) Slackからの要求を検証するかどうか。Yesが選択された場合、Slackは顧客アプリに対して一意であるシークレットを使用して要求に署名します。コネクターは署名を使用して、要求がSlackからターゲットURLへのものであることを検証します。 ブール値 TRUE
Signing Key(署名鍵) 使用するアプリに対して一意であるシークレット値。この値はSlackアプリ管理コンソールから取得します。

[Use Signing Key?(署名鍵を使用?)]Yesに設定されている場合、Slackからの要求の検証にこのキーが使用されます。それ以外の場合はNoです。

文字列 TRUE

出力

フィールド 定義 タイプ
コマンド
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ユーザー名。 文字列

関連項目

Slackコネクター

Workflows要素

Slack API