Slackアクション

このページでは、ワークフロー自動化アクションカタログで利用可能なすべてのSlackチャットアクションのリファレンスを提供します。これらのアクションにより、ワークフローからSlackメッセージング操作が可能になります。

前提条件

ワークフロー自動化でSlackアクションを使用する前に、以下を確認してください：

• 適切な権限を持つ Slack ワークスペース。
• ワークフロー自動化でシークレットとして設定された Slack ボット トークン。
• メッセージを送信する Slack チャネルへのアクセス。

Slack 統合の構成

このセクションでは、ワークフロー自動化の Slack アクションを許可するために最小限のスコープ権限で Slack アプリケーションを設定する手順について詳しく説明します。

Slackアプリを作成する

1. Slack API >Create New App > From Scratch

2. アプリに名前を付けてワークスペースを選択し、 Create App [アプリの作成]をクリックします。

3. 作成したら、左側のナビゲーションのApp Home [アプリ ホーム]に移動し、ボットがオンラインになっていることを確認します。

   

OAuth権限を設定する

1. 左側のナビゲーションで、 OAuth & Permissions [OAuth と権限]を選択します。

2. Bot Token Scopes [ボット トークン スコープ]セクションまで下にスクロールし、次のスコープを追加して、ワークフロー自動化アクションの使用を許可します。

   • chat:write - メッセージを投稿するために必要です
   • reactions:read - スレッドからの反応を得るために必要
   • files:write - スレッドに添付ファイルをアップロードするために必要です
   

3. 上にスクロールして、 Install to [workspace] [ワークスペースにインストール]ボタンをクリックして、Slack ワークスペースで OAuth セットアップを開始します。

4. 確認プロンプトが表示されます。Allow [許可]をクリックして確認します。

5. 成功したら、Bot token [ボット トークン]をコピーし、次のステップのために保存します。トークンはxoxb-...で始まる必要があります。

チャンネルにアプリを追加する

Slack アプリの作成と設定が完了したら、使用する Slack チャンネルのインテグレーションを編集し、Slackアプリを追加して、そのチャンネルにアプリを追加します。

New Relicの設定

Slack アプリケーションをセットアップしてボット トークンを取得したら、以下の GraphQL ミューテーションを使用してこの資格情報を New Relic シークレット管理に保存します。

mutation {
  secretsManagementCreateSecret(
    scope: { type: ACCOUNT, id: "12345678" }
    namespace: "slack"
    key: "my-app-bot-token"
    description: "A slack token to send messages with newrelic workflow automation"
    value: "xoxb-..."
  ) {
    key
  }
}

次の値を設定します。

• id - New RelicアカウントID
• namespace - オプション：任意の英数字文字列を使用して秘密を分類します
• key - この秘密を参照するには英数字の文字列を使用します
• description - 秘密の説明（オプション）
• value - 前の手順でコピーしたSlackボットトークン

New RelicユーザーAPIキーを備えたNerdGraph GraphiQLエクスプローラーを使用して、このミューテーションを実行できます。 正常に送信すると、次のような結果が表示されます。

{
  "data": {
    "secretsManagementCreateSecret": {
      "key": "my-app-bot-token"
    }
  }
}

ワークフローで Slack を使用する

ネームスペースとキー名とともに保存されている Slack ボットの秘密を利用して、ワークフロー オートメーション機能を使用します。

例：

name: to-slack

steps:
  - name: postCsv
    type: action
    action: slack.chat.postMessage
    version: 1
    inputs:
      channel: test-channel-workflow
      text: "Hello World!"
      token: ${{ :secrets:slack:my-app-bot-token }}

Slackアクション