SlackでWebhookを生成する

1. Slackアプリを作成する（まだない場合）

Slackアプリを作成

名前を決め、アプリを関連付けるワークスペースを選んでから、Create Appをクリックします（テストメッセージを何度も投稿することになるので、テスト用のチャンネルを作っておくとよいでしょう）。すでにアプリを作成している場合は、そのアプリを使ってもかまいません。

2. SlackアプリでIncoming Webhooksを有効にする

Slackアプリを作成すると、新しいアプリの設定ページに移動します（既存のアプリを使う場合は、アプリの管理ダッシュボードから設定を開いてください）。

ここでIncoming Webhooks機能を選び、Activate Incoming Webhooksトグルをオンにします。

3. SlackワークスペースへのIncoming Webhookを作成する

Incoming Webhooksが有効になると、設定ページが更新され、追加のオプションがいくつか表示されます。その中にAdd New Webhook to Workspaceという便利なボタンがあるので、クリックします。

このボタンを押すと、Slackアプリのインストールフローを簡略化したものが始まります。この流れは単独で完結しているので、Incoming Webhook URLを生成するためにコードを書く必要はありません。次のような画面が表示されます。

アプリが投稿するチャンネルを選び、Authorizeボタンをクリックします。プライベートチャンネルにIncoming Webhookを追加する場合は、先にそのチャンネルに参加しておく必要があります。

アプリの設定ページに戻ると、Webhook URLs for Your Workspaceセクションに新しい項目が追加され、次のようなWebhook URLが表示されます。

https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX

このURLが、新しく作成したIncoming Webhookです。特定の1人のユーザーと、特定の1つのチャンネルに紐づいています。

CommentfulプラグインからSlack Webhook URLを追加する

CommentfulのSlack通知を設定するには、上記の手順に従ってSlack Webhook URLを作成してから、Commentful FigmaプラグインでSettingsアイコンボタン（プラグインウィンドウの右上）を開きます。Enable webhook notifications for review linksをクリックし、Webhook PlatformドロップダウンでSlackが選択されていることを確認したら、Slack Webhook URLをコピーして貼り付け、Save Webhook URLをクリックします。

（例：https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX）

Send Test Messageボタンをクリックすると、CommentfulからSlackチャンネルにテスト通知が送信されるので、Slack連携が正しく動作しているかを確認できます。

Commentful WebアプリからSlack Webhook URLを追加する

CommentfulのSlack通知を設定するには、上記の手順に従ってSlack Webhook URLを作成してから、Commentful Webアプリ（共有されたレビューリンクをブラウザで開いた状態）でキーボードのCTRL + Kキーを押し、Slack Webhook URLをコピーして貼り付けます。

（例：https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX）

Send Test Message to Slackボタンをクリックすると、CommentfulからSlackチャンネルにテスト通知が送信されるので、Slack連携が正しく動作しているかを確認できます。

Slack Webhookの通知は、選択したSlackチャンネルにチャンネル宛てのお知らせとして送信されます。Commentfulのコメントに@nameのようなテキストを含めると、Slackのメッセージ本文にそのテキストが表示されることがありますが、CommentfulはCommentfulのレビュアーをSlackのユーザーに自動で対応付けないため、Slackのネイティブなメンションとして確実に機能するわけではありません。