分享方式:


快速入門:處理進階傳訊事件

重要

本文所述的功能目前處於公開預覽狀態。 此預覽版本沒有服務等級協定,不建議用於處理生產工作負載。 可能不支援特定功能,或可能已經限制功能。 如需詳細資訊,請參閱 Microsoft Azure 預覽版增補使用條款

Azure 通訊服務現在可讓您使用進階傳訊 SDK 來傳送和接收 WhatsApp 訊息。 開始設定事件方格事件,以接收 WhatsApp 訊息傳送/接收狀態報告。 完成本快速入門後,您的 Azure 帳戶中會產生幾美分或更少的少許費用。

必要條件

關於 Event Grid

事件方格是一項雲端式事件服務。 在本文中,您將了解如何訂閱通訊服務事件,並觸發事件以檢視結果。 通常,您會將事件傳送至可處理事件資料及採取行動的端點。 在本文中,您會將事件傳送至可收集及顯示訊息的 Web 應用程式。

設定事件方格檢視器

事件方格檢視器是一個範例網站,可讓您從事件方格檢視傳入事件。

  1. 移至此連結 Azure 事件方格檢視器 - 程式碼範例 | Microsoft Learn。 按兩下 [部署至 Azure] 按鈕,以部署事件方格檢視器範例。

    Screenshot that shows the Event Grid Viewer Sample Page with Deploy To Azure option.

  2. 按兩下 [部署至 Azure] 按鈕之後,填入必要的欄位 (因為網站名稱在建立 DNS 項目時需要全域唯一,因此建議您在此步驟的名稱中包含您的別名)。 雖然本快速入門不需要此步驟的任何特殊設定,但以下是填寫部署詳細資料的建議:

  • Subscription - 選取包含 Azure 通訊服務資源的訂用帳戶。 此特定訂用帳戶並非必要,但在完成快速入門之後,就能更輕鬆地清除。

  • Resource Group - 選取包含 Azure 通訊服務資源的資源群組。 此特定資源群組並非必要,但在完成快速入門之後,就能更輕鬆地清除。

  • Region - 選取包含 Azure 通訊服務資源的資源群組。 此特定區域並非必要,但建議使用。

  • 'Site Name' - 建立全域唯一的名稱。 此網站名稱是用來建立網域以連線到事件方格檢視器。

  • 「主控方案名稱」- 建立任何名稱來識別您的主控方案。

  • 「Sku」- sku F1 很適合用於開發與測試用途。 如果您在建立事件方格檢視器時遇到驗證錯誤,指出 F1 方案沒有更多容量,請嘗試選取不同的區域。 如需關於 sku 的詳細資訊,請參閱 App Service 價格

    Screenshot that shows Custom deployment of Events Viewer web app and properties you need to provide to successfully deploy.

  1. 然後選取 [檢閱 + 建立]

  2. 部署完成之後,選取 App Service 資源以開啟。

    Screenshot that shows Events Viewer web app.

  3. 在 [資源概觀] 頁面上,選取 [預設網域] 屬性旁的 [複製] 按鈕。

    Screenshot that shows URL of Events Viewer web app.

  4. 事件方格檢視器的 URL 是您用來建立部署的網站名稱,並附加路徑「/api/update」。 例如,「https://{{site-name}}.azurewebsites.net/api/updates」。 在下一個步驟和建立示範應用程式期間,將需要用到。

訂閱進階傳訊事件

  1. 在 Azure 入口網站中開啟您的通訊服務資源,瀏覽至左面板中的 [事件] 選項,然後選取 [+事件訂用帳戶]

    Screenshot that shows Azure Communication Services Events subscription option and allows you to subscribe to Advanced Messaging events.

  2. 填入新事件訂閱的詳細資料:

    • 訂用帳戶名稱。

    • 系統主題名稱 - 輸入唯一的名稱,除非此名稱已預先填入訂用帳戶中的主題。

    • 事件類型 - 從清單中選取兩個進階傳訊事件。

      Screenshot that shows create event subscription properties.

    • 針對端點類型,選取 [Webhook],然後輸入我們在 [設定事件方格檢視器] 步驟中建立的事件方格檢視器 URL,並附加路徑「/api/updates」。 例如:https://{{site-name}}.azurewebsites.net/api/updates。

      Screenshot that shows how to update webhook url of event subscription to receive events.

    • 選取 建立

  3. 現在,如果您導流至 Azure 通訊服務資源左面板中的 [事件] 選項,您應該能夠看到具有進階傳訊事件的新事件訂用帳戶。

    Screenshot that shows two Advanced messaging events subscribed.

清除資源

如果您想要清除並移除通訊服務訂用帳戶,您可以刪除資源或資源群組。 刪除資源群組也會刪除與其相關聯的任何其他資源。 深入了解如何清除資源

下一步

請前往下一篇文章,了解如何使用適用於 WhatsApp 傳訊的進階傳訊 SDK。