為 Amazon Chime 建立 Webhook

焦點模式

為 Amazon Chime 建立 Webhook - Amazon Chime

支援終止通知：在 2026 年 2 月 20 日， AWS 將終止對 Amazon Chime 服務的支援。2026 年 2 月 20 日之後，您將無法再存取 Amazon Chime 主控台或 Amazon Chime 應用程式資源。如需詳細資訊，請造訪部落格文章。注意：這不會影響 Amazon Chime SDK 服務的可用性。

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

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 與聊天室整合

從聊天室管理員取得 Webhook URL。如需詳細資訊，請參閱《Amazon Chime 使用者指南》中的將 Webhook 新增至聊天室。

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

URL 接受 HTTP POST 要求。

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 其下的聊天室中。