5. Slash Command から IM-LogicDesigner を起動する方法¶
ここでは、Slack の Slash Command を受け付けて IM-LogicDesigner を起動する方法を説明します。
5.1. 実行されるフローを生成¶
Slash Command で実行される IM-LogicDesigner を作成します。
ロジックフローの作成方法は「IM-LogicDesigner ユーザ操作ガイド 4.1 ロジックフロー」を参照してください。
フローの入力値には以下のパラメータを受け取ることができます。
$input <object>
├─ args <string[]>
└─ payload <object>
├─ token <string>
├─ command <string>
├─ text <string>
├─ response_url <string>
├─ trigger_id <string>
├─ user_id <string>
├─ user_name <string>
├─ team_id <string>
├─ team_domain <string>
├─ enterprise_id <string>
├─ enterprise_name <string>
├─ channel_id <string>
└─ channel_name <string>
args には Slash Command の第２引数以降の引数が配列で受け渡されます。
payload に含まれる各パラメータについては、「Slack Web API Slash Commands」を参照してください。
フローの返却値には、Slack に返却する応答メッセージを設定してください。
処理結果は JSON 文字列に変換して Slack に返却されます。
例
$output <object>
├─ text <string>
└─ attachments <object>
└─ text <string>
5.2. Custom Slash Command の登録¶
- Slack app を作成し、Custom Slash Command を登録します。Slash Command の登録方法は「Slack Web API Slash Commands」を参照してください。
・ Command、Short Description、Usage Hint にはそれぞれ任意の値を登録してください。・ Request URL には、以下のように URL を指定してください。シングルテナントで運用している環境、またはURLによるテナントの自動解決が有効になっている環境の場合
https://<Accel platform Domain>/<CONTEXT_PATH>/slack/slash/command/<flowId>
マルチテナント で運用している環境の場合
https://<Accel platform Domain>/<CONTEXT_PATH>/slack/<Tenant ID>/slash/command/<flowId>
5.3. Signing Secret の登録¶
intra-mart Accel Platform に Slack の Signing Secret を登録します。
登録したトークンは、Slash からリクエストを受け付けた際の検証に利用されます。
テナント管理者でログインし、サイトマップより「テナント管理」 - 「テナント情報」 - 「Slack連携」をクリックします。
Slack の Signing Secret を「Signing Secret」に入力し「更新」ボタンをクリックします。
以上の設定を行うと Slash Command から IM-LogicDesigner を起動できます。
5.4. Verification Token の登録¶
intra-mart Accel Platform に Slack のVerification Token を登録します。
登録したトークンは、Slash Command を受け付けた際の検証に利用されます。
テナント管理者でログインし、サイトマップより「テナント管理」 - 「テナント情報」 - 「Slack連携」をクリックします。
Slack の Verification Token を「検証トークン」に入力し「更新」ボタンをクリックします。
以上の設定を行うと Slash Command から IM-LogicDesigner を起動できます。
注意
Verification Token を使用したリクエストの検証は Slack で非推奨になりました。「Signing Secret の登録 」を使用してください。Signing Secret を登録している場合は、Verification Token を登録する必要はありません。