> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agencyhandy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Slackを連携してAgencyHandyのアラートをリアルタイムで受信する

> SlackワークスペースをAgencyHandyに接続して、注文の更新、タスクの変更、チケットのアラートが自動的にSlackチャンネルに投稿されるようにしましょう。

AgencyHandyのSlack連携により、誰もアプリを切り替えることなくチームが常に最新の情報を把握できます。一度接続すると、タスク、注文、またはその他のワークスペースアクティビティが変更されるたびに、AgencyHandyが選択したSlackチャンネルに自動通知を投稿します — チームはリアルタイムで何が起きているかを常に把握できます。

<Note>
  Slack連携の接続・管理ができるのは、（連携権限を持つ）**SuperAdmin**、**Admin**、および**Manager**ロールのみです。接続を認可するにはSlackワークスペースの管理者権限が必要です。
</Note>

## Slackを連携する

<Steps>
  <Step title="インテグレーションを開く">
    左サイドバーで**インテグレーション**をクリックします。
  </Step>

  <Step title="Slackカードを見つける">
    **Slack**カードまでスクロールし、**連携**をクリックします。
  </Step>

  <Step title="SlackでAgencyHandyを認可する">
    Slack認可ウィンドウが開きます。Slackワークスペースにまだサインインしていない場合は、ここでサインインします。AgencyHandyが要求する権限を確認し、**許可**をクリックしてアクセスを承認します。
  </Step>

  <Step title="通知チャンネルを選択する">
    認可後、AgencyHandyの通知を表示させたいSlackチャンネルを選択します。ドロップダウンからチャンネルを選び、**保存**をクリックして確定します。
  </Step>

  <Step title="設定を確認する">
    Slackカードが**連携済み**と表示されるように更新されます。AgencyHandyはすぐに選択したチャンネルへの通知投稿を開始します。
  </Step>
</Steps>

## Slackに送信される通知

AgencyHandyは以下のいずれかのイベントが発生すると、Slackメッセージを投稿します：

| カテゴリ       | 通知をトリガーするイベント           |
| ---------- | ----------------------- |
| **タスク**    | タスクの作成、更新、割り当て、または完了    |
| **注文**     | 注文の作成またはステータス変更         |
| **コメント**   | タスクまたは注文への新しいコメントの追加    |
| **ファイル添付** | タスクへのファイルまたは添付ファイルの追加   |
| **チケット**   | チケットの作成、割り当て、またはステータス変更 |

各Slackメッセージには以下が含まれます：

* タスク、注文、またはチケットの**名前**
* メッセージをトリガーした**ステータス変更**またはアクション
* AgencyHandy内の関連アイテムへの**リンク**

タスクにファイルまたは添付ファイルが追加された場合、Slackメッセージにはその添付ファイルのプレビューも含まれます。

<Tip>
  専用の\*\*#agency-handy-alerts\*\*チャンネル（または類似のもの）を選択して、通知を整理し、メインのチームチャンネルが散らかるのを防ぎましょう。
</Tip>

## Slackを切断する

通知を停止するには、**インテグレーション**に戻り、Slackカードの**切断**をクリックします。すべての通知は即座に停止します。

## 重要な注意事項

* **ワークスペースごとに1つの接続** — 各AgencyHandyワークスペースには1つのSlackワークスペースのみ接続できます。別のSlackワークスペースに切り替えるには、現在のものを切断してから再接続してください。
* **チャンネルの可視性** — 通知は選択したSlackチャンネルの全員に表示されます。共有する詳細レベルに適したチャンネルであることを確認してください（例：クライアントに関する機密の注文詳細をパブリックチャンネルに投稿しないようにしてください）。
* **再認可** — Slackトークンの有効期限が切れたり権限が変更されたりした場合は、インテグレーションに戻り、再接続して通知を復元してください。