チャンネル内の新しいコマンド（トリガー）

このピースでできること

• チャンネルで、指定したユーザーへのメンションに続く特定のコマンド（例：@bot help）を検知してトリガーします。

• 英語名：。

ピースの設定項目

1. ユーザー（必須）

• メンションの対象にするユーザーを選択またはIDで指定します。

2. コマンド（必須）

• 監視するコマンド文字列のリストを小文字で指定します（例：help、support）。

3. ボットが参加しているチャンネルだけ（任意）

• チャンネルの選択候補を、Botが参加しているチャンネルに絞ります。初期値は有効です。受信できるイベントの範囲を増やすものではありません。

4. チャンネル（任意）

• 監視対象のチャンネルを複数指定できます。未指定時は、この接続に届くチャンネルのイベントを対象にします。DMは対象外です。

5. ボットのメッセージを無視（任意）

• Botからの投稿を除外するか選択します。

取得できる情報

• / ：会話ID・種類。対象はチャンネル（ / ）です。

• / ：投稿者のユーザーID・元のメッセージ本文。本文にはメンションやコマンド・引数が含まれます。

• / ：投稿・イベントのタイムスタンプ。含まれる場合に利用できます。数値に変換せず文字列として扱ってください。

• ：認識したコマンド。メンション後の先頭語を小文字にした値です。

• ：コマンドに続く引数の文字列配列。空白で区切られ、引用符によるグループ化は行いません。

• / / など：Slackから届いたイベントに含まれる場合のみ利用できる追加情報です。

取得条件と注意点

• 指定したユーザーへの メンションに、空白とコマンドが続くメッセージが対象です。認識したコマンドを小文字にして設定リストと照合するため、リストにも小文字で入力してください。

• チャンネルを指定した場合は、そのIDと一致する通知だけを対象にします。未指定の場合は、この接続へ届くチャンネルの通知を対象にします。「ボットのメッセージを無視」が有効な場合はBot投稿を除外します。

• 「ボットが参加しているチャンネルだけ」は、選択候補の一覧を絞る設定です。実行時に受信範囲を増やす設定ではありません。

• 出力は通知内のメッセージ情報に を追加したものです。 の中を参照する形式ではなく、本文のメンションも自動削除しません。

• 項目の有無はSlackから届くイベントによります。メッセージの詳細な種類を一律に除外する処理ではないため、必要な項目は実際の受信結果で確認してください。ファイル本体などを別APIで自動取得する処理はありません。

• Slack側のイベント購読・接続のアクセス範囲により、届く通知の範囲が変わります。

利用例

出力例（抜粋）