Slack - jinba

概要

Slack ツールを使用すると、Slack メッセージングプラットフォームと連携できます。メッセージの送信、スレッド内の返信取得、一斉送信など、さまざまな機能を提供します。

主な機能

SLACK_POST_MESSAGE
- ユーザーまたはチャンネルへのメッセージ送信
SLACK_POST_BLOCKS_MESSAGE
- Block Kit 形式（セクション、ヘッダー、画像、区切り線、アクションなど）でチャンネルにリッチメッセージを投稿
SLACK_GET_CONVERSATION_REPLIES
- チャンネル内の特定のスレッドに対する返信を取得

認証

Slack ツールを使用するには、Slack アプリを作成し、Bot User OAuth アクセストークンを取得する必要があります。Slack API サイトでアプリを作成し、トークンを取得してください。セットアップ手順は開発者ドキュメントに従ってください。

Slack認証情報の詳細な設定方法については、Slack認証情報ページをご覧ください。

API キーは機密情報として扱い、公開リポジトリにコミットしないでください。

例：メッセージの送信と返信の取得

- id: get_conversation_replies
  tool: SLACK_GET_CONVERSATION_REPLIES
  config:
    - name: token
      value: "{{secrets.SLACK_BOT_TOKEN}}"
  input:
    - name: channel
      value: "#jinba-dev-tmp"
    - name: thread_ts
      value: "1738331888.564969"
- id: send_message
  tool: SLACK_POST_MESSAGE
  config:
    - name: token
      value: "{{secrets.SLACK_BOT_TOKEN}}"
  input:
    - name: text
      value: Hello, world!
    - name: channel
      value: "#900_tl_yuta"

例：Block Kit メッセージの投稿

SLACK_POST_BLOCKS_MESSAGE は、blocks 配列（各ブロックオブジェクトに type プロパティが必要、最大50ブロック）、Block Kit 非対応クライアントや通知に表示されるフォールバック用の text、channel、およびスレッドに返信する場合の任意項目 thread_ts を受け取ります。

- id: post_blocks_message
  tool: SLACK_POST_BLOCKS_MESSAGE
  config:
    - name: token
      value: "{{secrets.SLACK_BOT_TOKEN}}"
  input:
    - name: channel
      value: "#general"
    - name: text
      value: "週次レポートが完成しました"
    - name: blocks
      value: |
        [
          {
            "type": "header",
            "text": { "type": "plain_text", "text": "週次レポート" }
          },
          {
            "type": "section",
            "text": { "type": "mrkdwn", "text": "*ステータス:* すべてのチェックに合格 :white_check_mark:" }
          }
        ]