Amazon CodeCatalyst 不再向新客戶開放。現有客戶可以繼續正常使用該服務。如需詳細資訊，請參閱[如何從 CodeCatalyst 遷移](migration.md)。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 從 CodeCatalyst 傳送通知
<a name="notifications"></a>

您可以設定通知來監控 CodeCatalyst 中的專案和資源。使用者可以選擇要在任何他們是成員的專案中接收電子郵件的專案事件。您也可以透過設定 CodeCatalyst 空間和 Slack 工作區之間的存取權，然後設定要傳送至該 Slack 工作區中一或多個頻道的專案通知，來選擇在 Slack 等團隊傳訊應用程式中設定傳送至整個團隊的通知。設定 CodeCatalyst 空間和 Slack 工作區之間的存取權後，專案成員也可以選擇新增自己的 Slack 成員 IDs，以便他們可以直接收到連線 Slack 工作區和頻道中 CodeCatalyst 事件的通知。

**注意**  
可傳送至 Slack 的一組專案事件與使用者可以選擇在電子郵件中收到通知的一組事件不同。

**Topics**
+ [通知如何運作？](notifications-concepts.md)
+ [Slack 通知入門](getting-started-notifications.md)
+ [從 CodeCatalyst 傳送 Slack 和電子郵件通知](notifications-manage.md)

# 通知如何運作？
<a name="notifications-concepts"></a>

您可以設定專案，向團隊傳訊應用程式提供通知，例如 Slack。



## 通知需要哪些許可？
<a name="notifications-concepts-permissions"></a>

任何專案成員都可以在 CodeCatalyst 中設定、檢視、更新或刪除頻道的通知設定。不過，只有具有 **Space 管理員**角色的使用者才能新增或刪除 Slack 工作區。所有使用者都可以為他們屬於 CodeCatalyst 的專案設定要接收電子郵件的專案事件。

## 我可以設定哪些 CodeCatalyst 事件的通知？
<a name="notifications-concepts-events"></a>

您可以設定 CodeCatalyst，將有關工作流程事件的通知傳遞至一或多個 Slack 頻道。在 CodeCatalyst 專案和 Slack 之間設定通知後，專案使用者可以選擇新增自己的 Slack 成員 ID，以便在 Slack 頻道中接收有關 CodeCatalyst 事件的直接訊息。新增其 Slack IDs 的使用者，將在為其專案設定的 Slack 頻道中收到對其 IDs 的直接提及，協助提高他們關注之事件的意識。

您也可以選擇要接收電子郵件的事件。這些電子郵件會傳送到為您的 AWS 建置器 ID 設定的電子郵件地址。

## 如何呈現通知？
<a name="notifications-concepts-delivery"></a>

您可以設定 CodeCatalyst 將通知傳送到一或多個 Slack 頻道。您需要授權 CodeCatalyst 授予存取 Slack 工作區的許可。一旦提供授權，CodeCatalyst 就可以將通知傳送到您設定的 Slack 頻道。如果專案成員選擇新增其 Slack 成員 ID，他們可以在為該專案設定的 Slack 頻道中收到有關 CodeCatalyst 事件的提及。

## 如何設定通知？
<a name="notifications-concepts-setup"></a>

電子郵件通知會設定為 CodeCatalyst 的一部分。專案使用者可以在**我的設定**頁面中選擇想要接收電子郵件的事件。

若要為您的專案資源設定 Slack 通知，您必須完成下列高階任務。

**設定通知 （高階任務）**

1. 在 CodeCatalyst 中，您可以**設定 CodeCatalyst 與簡訊用戶端之間的連線**，例如 Slack。 CodeCatalyst 連接 Slack 工作區後，它將可供空間中的所有專案使用。
**注意**  
只有具有 Space 管理員角色的使用者才能新增或刪除 Slack 工作區。

1. 在 CodeCatalyst 的專案**中，新增您希望團隊接收通知的管道**。

1. 在 CodeCatalyst 中，您可以**開啟各種事件的通知**，例如工作流程執行失敗，並指定要傳送它們的管道。

如需詳細步驟，請參閱[Slack 通知入門](getting-started-notifications.md)。

在 CodeCatalyst 空間和 Slack 之間設定通知後，使用者可以選擇新增自己的 Slack IDs，以在為其專案設定的 Slack 頻道中接收有關 CodeCatalyst 事件的直接訊息。

# Slack 通知入門
<a name="getting-started-notifications"></a>

建立專案後，您可以設定 Slack 通知，以協助您的團隊監控專案資源。

這些步驟會逐步引導您首次在 CodeCatalyst 中設定 Slack 通知。如果您已設定通知，請參閱 [從 CodeCatalyst 傳送 Slack 和電子郵件通知](notifications-manage.md)。

**注意**  
可傳送至通知管道的一組專案事件與使用者可以選擇在電子郵件中收到通知的事件組不同。如需詳細資訊，請參閱[從 CodeCatalyst 傳送 Slack 和電子郵件通知](notifications-manage.md)。

**Topics**
+ [先決條件](#getting-started-notifications-prerequisites)
+ [步驟 1：將 CodeCatalyst 連接至 Slack 工作區](#getting-started-notifications-connect-slack)
+ [步驟 2：將 Slack 頻道新增至 CodeCatalyst](#getting-started-notifications-add-slack-channel)
+ [步驟 3：測試從 CodeCatalyst 到 Slack 的通知](#getting-started-notifications-next-steps)
+ [步驟 4：後續步驟](#getting-started-notifications-test)

## 先決條件
<a name="getting-started-notifications-prerequisites"></a>

開始之前，您必須準備好以下事項：
+ CodeCatalyst 空間。如需有關建立 CodeCatalyst 空間和首次登入的資訊，請參閱 [設定並登入 CodeCatalyst設定並登入 CodeCatalyst](setting-up-topnode.md)。
+ CodeCatalyst 專案。如需詳細資訊，請參閱[建立專案](projects-create.md)。
+ 具有**專案管理員**或**空間管理員**角色的 CodeCatalyst 帳戶。如需詳細資訊，請參閱[使用使用者角色授予存取權](ipa-roles.md)。
+ CodeCatalyst 可存取的 Slack 帳戶和 Slack 工作區。
+ CodeCatalyst 將傳送通知的 Slack 頻道。頻道可以是公有或私有。

## 步驟 1：將 CodeCatalyst 連接至 Slack 工作區
<a name="getting-started-notifications-connect-slack"></a>

只有具有 **Space 管理員**角色的使用者才能新增或刪除 Slack 工作區。新增或刪除 Slack 工作區會影響空間中的所有專案。為了在 CodeCatalyst 和 Slack 之間建立連線，CodeCatalyst 會與您的 Slack 工作區執行安全的 OAuth 身分驗證交握。

使用下列指示將 CodeCatalyst 連接至 Slack 工作區。

**注意**  
這只需要為每個 Slack 工作區執行一次。然後，您可以依 Slack 頻道設定通知。

**將 CodeCatalyst 連接到 Slack 工作區**

1. 在 https：//[https://codecatalyst.aws/](https://codecatalyst.aws/) 開啟 CodeCatalyst 主控台。

1. 導覽至您的專案。

1. 在導覽窗格中，選擇**專案設定**。

1. 選擇**通知**索引標籤。

1. 選擇**設定通知**。

1. 選擇**連線至 Slack 工作區**。

1. 讀取對話方塊內容，然後選擇**連線至 Slack 工作區**。

1. 在**聊天應用程式訊息中的 Amazon Q Developer** 上：

   1. 在右上角，選擇包含頻道的 Slack 工作區。

   1. 選擇 **Allow** (允許)。

   您將返回 CodeCatalyst 主控台。

1. 繼續進行[步驟 2：將 Slack 頻道新增至 CodeCatalyst](#getting-started-notifications-add-slack-channel)。

## 步驟 2：將 Slack 頻道新增至 CodeCatalyst
<a name="getting-started-notifications-add-slack-channel"></a>

您需要 Slack 頻道 ID 才能將頻道新增至 CodeCatalyst。

**取得您的 Slack 頻道 ID**

1. 登入 Slack。如需詳細資訊，請參閱[登入 Slack](https://slack.com/help/articles/212681477-Sign-in-to-Slack)。

1. 前往包含您希望通知前往之頻道的 Slack 工作區。如需詳細資訊，請參閱在 [Slack 工作區之間切換](https://slack.com/help/articles/1500002200741-Switch-between-workspaces)或[登入其他 Slack 工作區](https://slack.com/help/articles/212681477-Sign-in-to-Slack)。

1. 在導覽窗格中，開啟您要通知前往的頻道內容 （按一下滑鼠右鍵） 選單，然後選擇**開啟頻道詳細資訊**。

   頻道 ID 會顯示在對話方塊底部。

1. 複製**頻道 ID** 值。下一個步驟將需要此值。

使用您剛複製的頻道 ID，您現在可以將 Slack 頻道連線至 CodeCatalyst。

**將 Slack 頻道新增至 CodeCatalyst**

1. 開始之前，如果您的 Slack 頻道是私有的，請在聊天應用程式中將 Amazon Q Developer 新增至頻道，如下所示：

   1. 在 Slack 頻道的訊息方塊中，輸入 **@aws**，然後從對話方塊中選擇 **aws 應用程式**。

   1. 按 Enter。

      隨即出現 Slackbot 訊息，指出聊天應用程式中的 Amazon Q Developer 不在私有頻道中。

   1. 選擇**邀請他們**，邀請聊天應用程式中的 Amazon Q Developer 加入頻道。

1. 在 CodeCatalyst 主控台中，選擇**下一步**。

1. 在**頻道 ID** 中，貼上您先前取得的 Slack 頻道 ID。

1. 在**頻道名稱**中，輸入名稱。建議使用 Slack 頻道名稱。

1. 選擇**下一步**。

1. 在**選取通知事件**中，選擇您要接收通知的事件類型。

1. 選擇**完成**。

## 步驟 3：測試從 CodeCatalyst 到 Slack 的通知
<a name="getting-started-notifications-next-steps"></a>



將專案設定為傳送工作流程狀態的通知後，您可以在 Slack 中檢視通知。

**在 Slack 中檢視您的通知**

1. 在您的 CodeCatalyst 專案中，[手動啟動工作流程](workflows-manually-start.md)，以完成工作流程執行，並在執行完成時收到狀態通知。

1. 在 Slack 中，檢視您為通知設定的頻道。您的通知會顯示每個工作流程執行的最新狀態，以及是否失敗或成功。

## 步驟 4：後續步驟
<a name="getting-started-notifications-test"></a>

為您的 CodeCatalyst 空間設定 Slack 工作區後，您可以新增額外的 Slack 通道現有 CodeCatalyst 專案，並在建立新專案之後新增這些專案。您也可以讓專案使用者知道他們可以為其 Slack 成員 IDs 設定個人 Slack 通知，並設定他們將收到電子郵件的事件。如需詳細資訊，請參閱[從 CodeCatalyst 傳送 Slack 和電子郵件通知](notifications-manage.md)。

# 從 CodeCatalyst 傳送 Slack 和電子郵件通知
<a name="notifications-manage"></a>

您可以設定 CodeCatalyst 來傳送專案中事件發生的通知。CodeCatalyst 可以傳送通知給簡訊用戶端，例如 Slack 頻道。讓 CodeCatalyst 傳送訊息到 Slack 頻道有助於確保您的整個團隊都知道重要事件，例如工作流程失敗。或者，您可以選擇讓 CodeCatalyst @mention 出現在其傳送的 Slack 訊息中，以便您接收對應的直接訊息 (DM)。

CodeCatalyst 也可以透過電子郵件直接傳送通知給您。電子郵件通知將針對您為成員的任何專案中的事件傳送。這些電子郵件會傳送到您 AWS 建置器 ID 中設定的電子郵件地址。

**注意**  
可傳送至 Slack 頻道的事件可能與透過電子郵件傳送的事件不同。

**Topics**
+ [設定電子郵件通知](notifications-personal.md)
+ [傳送通知至 Slack 頻道](notifications-projects.md)
+ [設定 Slack 直接訊息](notifications-personal-slack.md)
+ [編輯通知管道的通知](notifications-edit.md)
+ [移除頻道](notifications-remove-channel.md)

# 設定電子郵件通知
<a name="notifications-personal"></a>

您可以選擇在身為 成員的任何專案中，將有關事件的電子郵件通知傳送給您。這些電子郵件會傳送到您 AWS 建置器 ID 中設定的電子郵件地址。根據預設，您將收到有關可傳送電子郵件之所有專案事件的電子郵件。<a name="notifications-personal-email"></a>

**設定專案事件的電子郵件通知**

1. 在 https：//[https://codecatalyst.aws/](https://codecatalyst.aws/) 開啟 CodeCatalyst 主控台。

1. 在頂端選單列中，選擇您的設定檔徽章，然後選擇**我的設定**。CodeCatalyst **我的設定**頁面隨即開啟。
**提示**  
您也可以前往專案或空間的成員頁面，並從成員清單中選擇您的名稱，以尋找您的使用者設定檔。

1. 在**電子郵件通知**中，在您要設定電子郵件通知的清單中尋找專案，然後選擇**編輯**。

1. 選取您要接收電子郵件的事件，然後選擇**儲存**。

# 傳送通知至 Slack 頻道
<a name="notifications-projects"></a>

您可以設定 CodeCatalyst，將專案事件的通知傳送至團隊的 Slack 頻道。透過這樣做，您可以協助確保整個團隊了解重要事件，例如工作流程執行失敗時。

**注意**  
專案的任何成員都可以管理傳送至該專案頻道的通知。不過，只有具有 **Space 管理員**角色的使用者才能新增或刪除 Slack 工作區。

使用下列指示來新增通知將傳送至其中的 Slack 頻道。

**新增通知的 Slack 頻道**

1. 如果您要新增第一個 Slack 頻道，請改為參閱 [Slack 通知入門](getting-started-notifications.md)。

   設定第一個頻道後，請返回此程序以設定其他頻道。

1. 開啟 CodeCatalyst 主控台，網址為 https：//[https://codecatalyst.aws/](https://codecatalyst.aws/)。

1. 導覽至您的專案。

1. 在導覽窗格中，選擇**專案設定**。

1. 選擇**通知**索引標籤。

1. 選擇 **Add channel** (新增頻道)。

1. 選擇**選擇工作區**，然後選取包含您要傳送通知之頻道的 Slack 工作區。

   如果您的 Slack 工作區不在清單中，您可以依照 中的指示新增它[Slack 通知入門](getting-started-notifications.md)。

1. 在輸入**頻道 ID** 之前，如果您要新增的 Slack 頻道是私有的，請完成以下步驟：

   1. 在 Slack 頻道的訊息方塊中，輸入 **@aws**，然後從快顯視窗中選擇 **aws 應用程式**。

   1. 按 Enter。

      隨即出現 Slackbot 訊息，指出聊天應用程式中的 Amazon Q Developer 不在私有頻道中。

   1. 選擇**邀請他們**，邀請聊天應用程式中的 Amazon Q Developer 加入頻道。

1. 在 CodeCatalyst 的**頻道 ID** 欄位中，輸入 Slack 頻道 ID。若要尋找 ID，請前往 Slack，然後在導覽窗格中，在頻道上按一下滑鼠右鍵，然後選擇**開啟頻道詳細資訊**。

   頻道 ID 會顯示在對話方塊底部。

1. 在**頻道名稱**中，輸入名稱。建議使用 Slack 頻道名稱。

1. 在**選取通知事件**中，選擇要接收通知的事件類型。

1. 選擇**新增**。

# 設定 Slack 直接訊息
<a name="notifications-personal-slack"></a>

如果 CodeCatalyst 專案已設定為[傳送通知至 Slack 頻道](notifications-projects.md)，這些通知也可以做為直接訊息 (DMs傳送。以 DMs 身分直接傳送通知給您，有助於提高您擁有角色之專案中發生的事件意識。若要啟用 DMs，您必須將 Slack 成員 ID 新增至 CodeCatalyst。

**設定 Slack 直接訊息**

1. 開啟 CodeCatalyst 主控台，網址為 https：//[https://codecatalyst.aws/](https://codecatalyst.aws/)。

1. 在頂端選單列中，選擇您的設定檔徽章，然後選擇**我的設定**。CodeCatalyst **我的設定**頁面隨即開啟。
**提示**  
您也可以前往專案或空間的成員頁面，並從成員清單中選擇您的姓名，以尋找您的使用者設定檔。

1. 在**個人 Slack 通知**中，選擇**連線 Slack ID**，然後選擇**連線至 Slack 工作區**。將開啟單獨的視窗。
**提示**  
除非具有 **Space 管理員**角色的使用者已為您的 CodeCatalyst 空間新增 Slack 工作區，否則此選項無法設定。如需詳細資訊，請參閱 [Slack 通知入門](getting-started-notifications.md) 和 [傳送通知至 Slack 頻道](notifications-projects.md)。

1. 在許可請求視窗中，請確定工作區的名稱符合針對 CodeCatalyst 空間設定的 Slack 工作區。選擇**允許**以允許聊天應用程式中的 Amazon Q Developer 存取工作區。視窗會關閉，Slack 工作區會顯示 **Connnection 狀態**為**已連線**。
**提示**  
如果連線狀態未變更，請檢查連線 Slack 工作區時發生錯誤。您可能需要向上捲動才能看到錯誤。

1. 若要停止接收個人 Slack 通知，請選擇連接的 Slack 工作區，然後選擇**中斷連線 Slack ID**。

# 編輯通知管道的通知
<a name="notifications-edit"></a>

您可以變更通知前往哪些頻道，也可以完全關閉特定通知。

**編輯通知**

1. 開啟 CodeCatalyst 主控台，網址為 https：//[https://codecatalyst.aws/](https://codecatalyst.aws/)。

1. 導覽至您的專案。

1. 在導覽窗格中，選擇**專案設定**。

1. 選擇**通知**索引標籤。

1. 選擇**編輯通知**。

1. 執行以下任意一項：
   + 若要將通知傳送至特定頻道，請從下拉式清單中選擇頻道。
   + 若要全域關閉通知，請選擇通知旁的切換開關。
   + 若要停止傳送通知至特定頻道，請選擇頻道上的 **X**。

1. 選擇 **Save** (儲存)。

# 移除頻道
<a name="notifications-remove-channel"></a>

您可以從 Amazon CodeCatalyst 移除 Slack 頻道。透過移除 Slack 頻道，所選 CodeCatalyst 專案的通知將不再傳送至頻道。

**移除頻道**

1. 開啟 CodeCatalyst 主控台，網址為 https：//[https://codecatalyst.aws/](https://codecatalyst.aws/)。

1. 導覽至您的專案。在導覽窗格中，選擇**專案設定**。

1. 在**專案設定**頁面上，選擇**通知**索引標籤。

1. 選擇您要移除的頻道旁的指標，然後選擇**移除頻道**。在確認視窗中選擇**確定**。