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

# Slack 整合

> 將 Living Security 連接至 Slack，以便向您的工作區傳送訓練通知、安全警示及手冊更新。

Slack 整合可讓 Living Security 直接向您的 Slack 工作區傳送通知。您可以通知使用者有新的訓練指派、向安全團隊發出風險事件警示，並讓主管掌握團隊進度。

<Note>
  若要設定提醒與手冊的傳送，請從 **設定 → 通訊 → 頻道** 開始，然後按一下 **Slack** 卡片。本頁說明的是底層的 Slack 應用程式設定。
</Note>

## 先決條件

在設定 Slack 整合之前，請確認您具備以下條件：

* Slack 工作區管理員或應用程式安裝權限
* 可存取位於 [api.slack.com](https://api.slack.com) 的 Slack API 入口網站
* Living Security 管理員權限

## 建立 Slack 應用程式

<Steps>
  <Step title="建立新的 Slack 應用程式">
    1. 前往 [api.slack.com/apps](https://api.slack.com/apps)
    2. 按一下 **Create New App**
    3. 選取 **From scratch**
    4. 輸入應用程式名稱（例如「Living Security」）
    5. 選取您的工作區
    6. 按一下 **Create App**

    <Check>
      您的應用程式會顯示在 Slack API 儀表板中。
    </Check>
  </Step>

  <Step title="設定 OAuth 範圍">
    1. 在左側邊欄中，按一下 **OAuth & Permissions**
    2. 捲動至 **Bot Token Scopes**
    3. 新增下列範圍：

    | 範圍 | 用途 |
    | - | - |
    | `chat:write` | 向頻道傳送訊息 |
    | `chat:write.public` | 不需加入即可向頻道傳送訊息 |
    | `users:read` | 查詢使用者資訊 |
    | `users:read.email` | 依電子郵件地址比對使用者 |

    <Tip>
      請僅新增貴組織所需的範圍。範圍越少，安全性越高。
    </Tip>
  </Step>

  <Step title="將應用程式安裝至您的工作區">
    1. 捲動至 **OAuth & Permissions** 頂端
    2. 按一下 **Install to Workspace**
    3. 檢閱權限後，按一下 **Allow**

    <Check>
      系統會顯示以 `xoxb-` 開頭的 **Bot User OAuth Token**。
    </Check>
  </Step>

  <Step title="取得簽署密鑰">
    1. 在左側邊欄中，按一下 **基本信息**
    2. 捲動至 **App Credentials**
    3. 複製 **Signing Secret**

    <Warning>
      請妥善保管您的簽署密鑰，切勿在公開儲存庫或記錄檔中分享。
    </Warning>
  </Step>
</Steps>

## 將憑證新增至 Living Security

<Steps>
  <Step title="前往出站集成">
    前往 **設定 → 集成 → 出站**，然後按一下 **Slack** 卡片。
  </Step>

  <Step title="新增您的憑證">
    按一下 **新增憑證** 並輸入：

    <ParamField body="botToken" type="string" required>
      以 `xoxb-` 開頭的 Bot User OAuth Token。可在 **OAuth & Permissions** 中找到。
    </ParamField>

    <ParamField body="signingSecret" type="string" required>
      您應用程式的 Signing Secret。可在 **基本信息 → App Credentials** 中找到。
    </ParamField>

    <ParamField body="appToken" type="string">
      選填。僅在使用 Socket Mode 連線時需要。以 `xapp-` 開頭。
    </ParamField>

    <ParamField body="label" type="string">
      選填。此憑證的易記名稱（例如「Production Slack」）。
    </ParamField>
  </Step>

  <Step title="儲存並驗證">
    按一下 **儲存**。該憑證會出現在您的清單中，狀態為 **主動**。

    <Check>
      您的 Slack 整合現已連接，可以開始傳送通知。
    </Check>
  </Step>
</Steps>

## 通知類型

連接完成後，Living Security 可以向 Slack 傳送下列類型的通知：

| 通知 | 說明 |
| - | - |
| 訓練指派 | 有新訓練指派時提醒使用者 |
| 訓練提醒 | 提醒使用者即將到期的期限 |
| 完成確認 | 訓練完成時傳送確認 |
| 安全警示 | 將風險事件通知安全團隊 |
| 手冊摘要 | 定期傳送手冊成效更新 |

## 疑難排解

<AccordionGroup>
  <Accordion title="訊息未顯示在頻道中">
    * 確認機器人已被邀請至該頻道（`/invite @YourBotName`）
    * 確認已新增 `chat:write.public` 範圍，以便不需加入即可在公開頻道中發布訊息
    * 確認頻道 ID 正確（請使用頻道 ID，而非名稱）
  </Accordion>

  <Accordion title="權杖無效錯誤">
    * 確認您複製了以 `xoxb-` 開頭的完整權杖
    * 確認應用程式仍安裝於您的工作區
    * 檢查權杖是否已重新產生（需要在 Living Security 中更新）
  </Accordion>

  <Accordion title="速率限制">
    Slack 會限制 API 請求。若您看到速率限制錯誤：

    * 降低通知頻率
    * 將多則通知合併為摘要訊息
    * 若有大量傳送的使用情境，請聯絡支援團隊
  </Accordion>
</AccordionGroup>

## 最佳實務

<Tip>
  請為 Living Security 通知建立專用的 Slack 頻道（例如 `#security-training`），以便整理警示並減少一般頻道中的干擾。
</Tip>

* 管理多個工作區時，請使用有意義的憑證標籤
* 定期稽核哪些頻道會收到通知
* 對於大量的警示，請設定通知摘要，而非逐則傳送
* 每季檢閱 Slack 應用程式權限，並移除未使用的範圍

## 相關內容

<CardGroup cols={2}>
  <Card title="電子郵件整合" icon="envelope" href="/zh-Hant/integrations/outbound/email">
    將電子郵件設定為傳送頻道。
  </Card>

  <Card title="Teams 整合" icon="microsoft" href="/zh-Hant/integrations/outbound/teams">
    將 Microsoft Teams 設定為傳送頻道。
  </Card>

  <Card title="通訊記錄" icon="clock-rotate-left" href="/zh-Hant/features/communications/log">
    追蹤 Slack 的傳送狀態與歷程記錄。
  </Card>

  <Card title="如何設定新的整合" icon="plug" href="/zh-Hant/integrations/managing/setup">
    整合設定一般指南。
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.