TerraformでAWS ChatbotとSlackを連携してみた

2025.12.01
TerraformでAWS ChatbotとSlackを連携してみた
この記事をシェアする

本記事は、クラウドビルダーズ株式会社のアドベントカレンダー2025の1日目の記事となります!

はじめに

こんにちは、CloudBuildersのsugawaraです。

SlackなどのチャットツールにAWSからの通知を送っているケースは多いかと思います。最近、初めてAWS Chatbotを使ってその設定をしてみたのですが、とっても簡単にSlack連携することができました。

本記事ではTerraformを利用して、AWS ChatbotとSlackを連携し、テストメッセージを送信するところまで実施します。さらに、チャットツール上でAWSリソースについて簡単な対話ができる機能についても試していきます。

なお、昨年の同じ時期にはGitHubとSlackの連携をしていたようです。ご興味のある方はこちら↓↓

GitHubとSlackを連携してみた

AWS Chatbotとは

AWS Chatbotは、Microsoft Teams や Slack 上で AWSリソースを手軽にモニタリングしたり、操作したりできるインタラクティブエージェントです。CloudWatch アラームの通知を受け取ったり、チャット上から AWS リソースの状態確認や簡単な操作ができます。

具体的には、下記のような操作を行うことができます。

  • アラートの受信(CloudWatch、Security Hub、AWS Health など)
  • 診断情報の取得(EC2 や Lambda の状態確認など)
  • AWS サポートケースの作成 など

なお、AWS Chatbotは旧名称であり、現在はAmazon Q Developerに統合されています。コンソール画面上では、”Amazon Q Developer in chat applications”と表示されています。

ただし、Amazon Q Developerには様々な機能があり、この名称だとどの機能かわかりにくいため、本記事では従来のAWS Chatbotという名称を使っていきます。

準備作業

Slackチャンネル作成

まず、Chatbotと連携したいSlackチャンネルを作成します。今回は検証用に、弊社Slack内にてtmp-sugawara-chatbot-testというチャンネルを作成しました。

連携の設定に必要なのは、SlackのチームIDとチャンネルIDです。連携したいSlackチャンネルをブラウザ版で開くと、下記のようにURL上に記載されています。TからはじまるものがチームID(ワークスペースID)で、CからはじまるものがチャンネルIDです。ブラウザ上でサインインして確認してみてください。

https://app.slack.com/client/TXXXXXXXXXX/CXXXXXXXXXX

チームIDとチャンネルIDは後ほどTerraform上で利用します。

チャットクライアントの設定

Terraformでは設定ができないものは実際にAWSアカウントにログインして設定していきます。ログイン後、検索窓にChatbotと入力します。Amazon Q Developer in chat applications(旧名称:AWS Chatbot)が表示されるので、クリックして遷移します。

チャットクライアントの設定にて、チャットクライアントのドロップダウンリストでSlackを選択し、【クライアントを設定】のボタンをクリックします。

Slackの承認画面に遷移するので、ワークスペース名を確認し、問題なければ【許可】ボタンをクリックします。

AWSコンソールに遷移して、Slackワークスペースが表示されていれば設定完了です。これであとは連携したいチャンネルを追加するだけとなります。チャンネルの追加は手動でもできますが、今回はTerraformで設定します。

Terraformによる構築

リソース作成

次に、必要なAWSリソースをTerraformで作成して、Slackと連携をさせていきます。ここで作成するものは下記になります。

  • IAMロール(Chatbot用)
  • SNSトピックとサブスクリプション
  • Chatbot

簡単にそれぞれについて説明します。

Chatbot用のIAMロールを作成し、Amazon Q Developerへのアクセス権限をアタッチします。また、あとでSlack上からBilling情報を確認するため、BillingReadOnlyの権限も追加しています。

# Chatbot用のIAMロール
resource "aws_iam_role" "chatbot" {
  name = "iam-role-for-chatbot"
  assume_role_policy = jsonencode(
    {
      "Version" = "2012-10-17"
      "Statement" = [
        {
          "Effect" = "Allow"
          "Principal" = {
            "Service" = [
              "chatbot.amazonaws.com"
            ]
          }
          "Action" = [
            "sts:AssumeRole"
          ]
        }
      ]
    }
  )
}

# Amazon Q Developerの権限をアタッチ
resource "aws_iam_role_policy_attachment" "chatbot_q_developer_access" {
  role       = aws_iam_role.chatbot.name
  policy_arn = "arn:aws:iam::aws:policy/AmazonQDeveloperAccess"
}

# AWS Billingの読み取り専用権限をアタッチ
resource "aws_iam_role_policy_attachment" "chatbot_billing_access" {
  role       = aws_iam_role.chatbot.name
  policy_arn = "arn:aws:iam::aws:policy/AWSBillingReadOnlyAccess"
}

SNSはトピックのみ作成します。サブスクリプションの記載は不要です。

# Slack通知(Chatbot経由)
resource "aws_sns_topic" "chatbot_slack" {
  name = "sns-topic-for-slack-chatbot-integration"
}

Chatbotの定義には、これまで準備していたSlackのチームIDやチャンネルID、IAMロールのARNやSNSのARNを設定します。guardrail_policy_arnsは、チャンネル内のユーザーが実行できるアクションを制御するものです。その名の通りガードレールの役割となるので、必要最低限の権限に絞ることで、誤操作を防止します。

また、ログ設定はすべて出力としています。AWS Chatbotはグローバルサービスのため、ログはus-east-1のCloudWatch Logsに出力されます。

resource "aws_chatbot_slack_channel_configuration" "chatbot_slack_alert" {
  configuration_name    = "chatbot-slack-integration-test"
  iam_role_arn          = aws_iam_role.chatbot.arn
  slack_team_id         = "TXXXXXXXXXX" # チームIDをコピペ
  slack_channel_id      = "CXXXXXXXXXX" # チャンネルIDをコピペ
  guardrail_policy_arns = [
    "arn:aws:iam::aws:policy/ReadOnlyAccess",
    "arn:aws:iam::aws:policy/AmazonQDeveloperAccess",
    "arn:aws:iam::aws:policy/AWSBillingReadOnlyAccess"
  ]
  sns_topic_arns        = [aws_sns_topic.chatbot_slack.arn]
  logging_level         = "INFO"
}

上記のTerraformコードでplanをして確認をします。

plan結果
...
Terraform used the selected providers to generate the following
execution plan. Resource actions are indicated with the following
symbols:
  + create

Terraform will perform the following actions:

  # aws_chatbot_slack_channel_configuration.chatbot_slack_alert will be created
  + resource "aws_chatbot_slack_channel_configuration" "chatbot_slack_alert" {
      + chat_configuration_arn      = (known after apply)
      + configuration_name          = "chatbot-slack-integration-test"
      + guardrail_policy_arns       = [
          + "arn:aws:iam::aws:policy/ReadOnlyAccess",
          + "arn:aws:iam::aws:policy/AmazonQDeveloperAccess",
          + "arn:aws:iam::aws:policy/AWSBillingReadOnlyAccess",
        ]
      + iam_role_arn                = (known after apply)
      + logging_level               = "INFO"
      + region                      = "ap-northeast-1"
      + slack_channel_id            = "CXXXXXXXXXX"
      + slack_channel_name          = (known after apply)
      + slack_team_id               = "TXXXXXXXXXX"
      + slack_team_name             = (known after apply)
      + sns_topic_arns              = [
          + (known after apply),
        ]
      + tags_all                    = {}
      + user_authorization_required = false
    }

  # aws_iam_role.chatbot will be created
  + resource "aws_iam_role" "chatbot" {
      + arn                   = (known after apply)
      + assume_role_policy    = jsonencode(
            {
              + Statement = [
                  + {
                      + Action    = [
                          + "sts:AssumeRole",
                        ]
                      + Effect    = "Allow"
                      + Principal = {
                          + Service = [
                              + "chatbot.amazonaws.com",
                            ]
                        }
                    },
                ]
              + Version   = "2012-10-17"
            }
        )
      + create_date           = (known after apply)
      + force_detach_policies = false
      + id                    = (known after apply)
      + managed_policy_arns   = (known after apply)
      + max_session_duration  = 3600
      + name                  = "iam-role-for-chatbot"
      + name_prefix           = (known after apply)
      + path                  = "/"
      + tags_all              = (known after apply)
      + unique_id             = (known after apply)

      + inline_policy (known after apply)
    }

  # aws_iam_role_policy_attachment.chatbot_billing_access will be created
  + resource "aws_iam_role_policy_attachment" "chatbot_billing_access" {
      + id         = (known after apply)
      + policy_arn = "arn:aws:iam::aws:policy/AWSBillingReadOnlyAccess"
      + role       = "iam-role-for-chatbot"
    }

  # aws_iam_role_policy_attachment.chatbot_q_developer_access will be created
  + resource "aws_iam_role_policy_attachment" "chatbot_q_developer_access" {
      + id         = (known after apply)
      + policy_arn = "arn:aws:iam::aws:policy/AmazonQDeveloperAccess"
      + role       = "iam-role-for-chatbot"
    }

  # aws_sns_topic.chatbot_slack will be created
  + resource "aws_sns_topic" "chatbot_slack" {
      + arn                         = (known after apply)
      + beginning_archive_time      = (known after apply)
      + content_based_deduplication = false
      + fifo_throughput_scope       = (known after apply)
      + fifo_topic                  = false
      + id                          = (known after apply)
      + name                        = "sns-topic-for-slack-chatbot-integration"
      + name_prefix                 = (known after apply)
      + owner                       = (known after apply)
      + policy                      = (known after apply)
      + region                      = "ap-northeast-1"
      + signature_version           = (known after apply)
      + tags_all                    = (known after apply)
      + tracing_config              = (known after apply)
    }

Plan: 5 to add, 0 to change, 0 to destroy.

────────────────────────────────────────────────────────────────────

Note: You didn't use the -out option to save this plan, so Terraform
can't guarantee to take exactly these actions if you run "terraform
apply" now.

plan結果に問題がなければ、そのままapplyします。

作成リソースの確認

applyしたら、実際に想定したリソースが作成されているか確認します。

IAMロールとポリシー

信頼ポリシー

SNSトピック

Chatbotのチャンネル追加

詳細

これでリソースの作成はすべて完了です!

実際に使ってみる

@Amazon Qの実施

Slack上で動作確認をしていきますが、その前に最後の設定です。連携するチャンネルにて、@Amazon Qを実行します。実行前はまだチャンネルにAmazon Qが未参加です。さっそく参加させましょう。

実行すると、Amazon Qをチャンネルに追加するかどうか聞かれるため、これを追加します。これで@Amazon Qとやり取りできるようになりました!

Amazon QからのHello Messageも来てますね。英語で来ていますが、こちらは日本語メッセージを書いて問題ありません。

テストメッセージの送信

これですべての設定が完了したので、実際に試していきます。

まずはAWSコンソールのChatbotの詳細ページにある、【テストメッセージを送信】のボタンをクリックします。

Slackに下記のようなテストメッセージが送信されました!これでSlackとChabotの連携が正しく設定されていることが確認できました。これを利用して、CloudWatchのアラームなども通知可能になります。

Amazon Qとのやりとり

次に、Slack上でAmazon Qとやり取りをしていきます。今回はBillingの権限を追加しているため、今月の料金を聞いてみます。AWSコンソールを開かなくても、料金の確認ができました!

他にも、一般的な質問にもChatGPTのように回答してくれます。

おわりに

今回はTerraformを利用してAWS ChatbotとSlackを連携してみました。ChatOps の第一歩として非常に簡単に導入できるため、ぜひ活用してみてください!

この記事をシェアする
著者:sugawara
元高校英語教員。2023-2025 Japan AWS All Certifications Engineers。 過去記事:https://www.cloudbuilders.jp/articles/author/sugawara/