**支援終止通知**：在 2026 年 2 月 20 日， AWS 將終止對 Amazon Chime 服務的支援。2026 年 2 月 20 日之後，您將無法再存取 Amazon Chime 主控台或 Amazon Chime 應用程式資源。如需詳細資訊，請造訪[部落格文章](https://aws.amazon.com/blogs/messaging-and-targeting/update-on-support-for-amazon-chime/)。**注意：**這不會影響 [Amazon Chime SDK 服務的](https://aws.amazon.com/chime/chime-sdk/)可用性。

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

# 為 Amazon Chime 建立 Webhook
<a name="webhooks"></a>

Webhooks 可讓 Web 應用程式即時彼此通訊。一般而言，Webhook 會在動作發生時傳送通知。例如，假設您執行線上購物網站。當客戶將項目新增至購物車、支付訂單費用或傳送評論時，Webhooks 可以通知您。Webhooks 不需要像傳統應用程式一樣多的程式設計，也不會使用那麼多的處理能力。如果沒有 Webhook，程式必須經常輪詢資料，才能即時取得資料。使用 Webhook，傳送應用程式會立即發佈資料。

您建立的傳入 Webhook 可以透過程式設計方式傳送訊息到 Amazon Chime 聊天室。例如，Webhook 可以通知客戶服務團隊建立新的高優先順序票證，並在聊天室中新增票證的連結。

您可以使用 Markdown 來設定 Webhooks 訊息格式，而且可包括表情符號。HTTP 連結和電子郵件地址轉譯為作用中連結。訊息也可以包含 @All 和 @Present 註釋，以分別提醒所有成員，以及呈現聊天室的成員。若要用 @ 提及聊天室參與者，可以使用他們的別名或整的電子郵件地址。例如，@`alias` 或 @`alias@domain.com`。

Webhooks 只能是聊天室的一部分，無法共用。Amazon Chime 聊天室管理員最多可為每個聊天室新增 10 個 Webhook。

建立 Webhook 之後，您可以將其與 Amazon Chime 聊天室整合，如下列程序所示。

**將 Webhook 與聊天室整合**

1. 從聊天室管理員取得 Webhook URL。如需詳細資訊，請參閱《*Amazon Chime 使用者指南*》中的將 [Webhook 新增至聊天室](https://docs.aws.amazon.com/chime/latest/ug/chat-webhooks.html)。

1. 使用您建立的指令碼或應用程式中的 Webhook URL，將訊息傳送到聊天室：

   1. URL 接受 HTTP POST 要求。

   1. Amazon Chime Webhooks 接受具有單一金鑰**內容**的 JSON 承載。以下是使用範例承載的 curl 命令範例：

      ```
      curl -X POST "<Insert your webhook URL here>" -H "Content-Type:application/json" --data '{"Content":"Message Body emoji test: :) :+1: link test: http://sample.com email test: marymajor@example.com All member callout: @All All Present member callout: @Present"}'
      ```

      以下是給 Windows 使用者的 PowerShell 命令範例：

      ```
      Invoke-WebRequest -Uri '<Insert your webhook URL here>' -Method 'Post' -ContentType 'application/JSON' -Body '{"Content":"Message Body emoji test: :) :+1: link test: http://sample.com email test: marymajor@example.com All member callout: @All All Present member callout: @Present"}'
      ```

外部程式將 HTTP POST 傳送到 Webhook URL 之後，伺服器會驗證 Webhook 有效且具有指派的聊天室。這個 Webhook 會出現在聊天室名單中，且名稱旁會出現 Webhook 圖示。經 Webhook 傳送的聊天室訊息，將會列在名稱後面接著 **(Webhook)** 之 Webhook 其下的聊天室中。

**注意**  
Webhook 目前並未啟用 CORS。

## 故障診斷 Webhook 錯誤
<a name="webhook-errors"></a>

以下是 Webhook 的相關錯誤清單：
+ 每個 Webhook 的傳入 Webhook 速率限制為每個聊天室各 1 TPS。調節會導致 HTTP 429 錯誤。
+ Webhook 張貼的訊息不得超過 4 KB。過大的訊息承載會導致 HTTP 413 錯誤。
+ Webhook 張貼的訊息若具有 @ 和 @ Present 註釋，只適用於 50 名成員以下的聊天室。50 名成員以上會導致 HTTP 400 錯誤。
+ 如果已重新產生 Webhook URL，使用舊的 URL 就會導致 HTTP 404 錯誤。
+ 如果聊天室中的 Webhook 已刪除，使用舊的 URL 就會導致 HTTP 404 錯誤。
+ 無效的 Webhook URL 會導致 HTTP 403 錯誤。
+ 如果服務無法使用，使用者會在回應中收到 HTTP 503 錯誤。