ダイレクトメッセージ内の新しいコマンド（トリガー）
このピースでできること
- ダイレクトメッセージで、指定したユーザーへのメンションに続く特定のコマンドを検知してトリガーします。
- 英語名：。
Slackの接続方法
1. 接続を作成
- 接続から「接続を作成」をクリックします。
2. 接続設定
- 接続名を設定して、「接続する」をクリックします。
3. Slackとの接続設定
- workrunがSlackワークスペースにアクセスすることを許可します。
4. 「保存」を押して接続名が設定されていることを確認する。
- 「保存」を押して接続名が設定されていることを確認します。
Slack接続時の注意点
- Slack接続時に読み取るチャンネル数が多いと内部エラーが発生することがございます。
- 内部エラーが発生してチャンネルを入力できなくなった際には以下の対応をお試しください。
- 動的値をクリック
- チャンネルIDを直接入力
- workrunが提供する標準のSlack接続を利用する場合は、追加の設定は不要です。カスタムSlackアプリを利用する場合は、上記の設定を行ってください。
ピースの設定項目
1. ユーザー（必須）
- メンションの対象にするユーザーを選択またはIDで指定します。
2. コマンド（必須）
- 監視するコマンド文字列のリストを小文字で指定します（例：help、support）。
3. ボットのメッセージを無視（任意）
- Botからの投稿を除外するか選択します。
4. 自分のメッセージを無視（任意）
- 自分自身が送ったDMを除外するか選択します。
取得できる情報
条件に一致したダイレクトメッセージの情報と、解析したコマンド・引数を1件ずつ取得できます。
- / ：会話ID・種類。対象はDM（）です。
- / ：投稿者のユーザーID・元のメッセージ本文。本文にはメンションやコマンド・引数が含まれます。
- / ：投稿・イベントのタイムスタンプ。含まれる場合に利用できます。数値に変換せず文字列として扱ってください。
- ：認識したコマンド。メンション後の先頭語を小文字にした値です。
- ：コマンドに続く引数の文字列配列。空白で区切られ、引用符によるグループ化は行いません。
- / / など：Slackから届いたイベントに含まれる場合のみ利用できる追加情報です。
取得条件と注意点
- 指定したユーザーへの メンションに、空白とコマンドが続くメッセージが対象です。認識したコマンドを小文字にして設定リストと照合するため、リストにも小文字で入力してください。
- 「ボットのメッセージを無視」「自分のメッセージを無視」が有効な場合、該当する投稿は除外します。自分の投稿を除外する場合はユーザートークンを含む接続を利用してください。Botトークンだけのカスタム接続では、Botを自分として判定します。
- 出力は通知内のメッセージ情報に を追加したものです。 の中を参照する形式ではなく、本文のメンションも自動削除しません。
- 項目の有無はSlackから届くイベントによります。メッセージの詳細な種類を一律に除外する処理ではないため、必要な項目は実際の受信結果で確認してください。ファイル本体などを別APIで自動取得する処理はありません。
- Slack側のイベント購読・接続のアクセス範囲により、届く通知の範囲が変わります。
利用例
で処理を分け、 を検索語や通知文に利用できます。会話IDと投稿時刻を、後続の返信先の指定にも利用できます。
出力例（抜粋）
キーと構造を示す架空例です。実際の値や全項目を示すものではありません。