共用方式為


快速入門: 處理 SMS 和傳遞報告事件

使用 Azure 事件方格來處理通訊服務 SMS 事件,以開始使用 Azure 通訊服務。 訂閱 SMS 事件,例如輸入訊息和傳遞報告之後,您會產生並接收這些事件。 完成本快速入門後,您的 Azure 帳戶中會產生幾美分或更少的少許費用。

重要

SMS 和 PSTN 功能是取決於您使用的電話號碼,以及執行此功能的所在國家/地區,這些項目皆是根據您的 Azure 帳單地址所決定。 如需詳細資訊,請參閱訂用帳戶資格文件。

必要條件

關於 Event Grid

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

設定環境

若要設定我們用來產生和接收事件的環境,請執行下列各節中的步驟。

註冊事件方格資源提供者

如果您先前在 Azure 訂用帳戶中從未使用過事件方格,可能必須註冊事件方格資源提供者。 若要註冊提供者,請遵循下列步驟:

  1. 前往 Azure 入口網站。
  2. 選取左側功能表上的 [訂用帳戶]
  3. 選取您用於事件方格的訂用帳戶。
  4. 在左側功能表的 [設定] 下,選取 [資源提供者] 。
  5. 尋找 Microsoft.EventGrid
  6. 若未註冊資源提供者,請選取 [註冊]

可能需要一點時間才能完成註冊。 選取 [重新整理] 來更新狀態。 當 [已註冊] 出現在 [狀態] 底下時,您就可以繼續作業。

部署事件方格檢視器

在本快速入門中,我們將使用事件方格查看器,以近乎即時的方式檢視事件。 檢視器會為使用者提供即時摘要的體驗。 此外,每個事件的承載都應該可供檢查。

若要設定查看器,請遵循 Azure 事件方格查看器中的步驟

使用 Webhook 訂閱 SMS 事件

您可以訂閱特定事件,以提供 Event Grid 的相關信息,以傳送您想要追蹤的事件。

  1. 在入口網站中,移至您建立的通訊服務資源。

  2. 在通訊服務資源內,從 [通訊服務] 頁面的左側功能表中選取 [事件]

  3. 選擇 [新增事件訂閱]

    Screenshot that shows the Events page of an Azure Communication Services resource. The Event Subscription button is called out.

  4. 在 [建立事件訂用帳戶] 頁面上,輸入事件訂用帳戶的名稱

  5. 在 [事件類型] 下,選取您想要訂閱的事件。 針對 SMS,您可以選擇 SMS ReceivedSMS Delivery Report Received

  6. 如果系統提示您提供 [系統主題名稱],請隨意提供唯一的字串。 此欄位不會影響您的體驗,其用途為內部遙測。

    Screenshot that shows the Create Event Subscription dialog. Under Event Types, SMS Received and SMS Delivery Report Received are selected.

  7. 針對 [端點類型],選取 [Webhook]

    Screenshot that shows a detail of the Create Event Subscription dialog. In the Endpoint Type list, Web Hook is selected.

  8. 針對 [端點],選取 [選取端點],然後輸入 Web 應用程式的 URL。

    在此情況下,我們將使用我們稍早在快速入門中設定事件方格檢視器 URL。 範例的 URL 具有下列格式: https://{{site-name}}.azurewebsites.net/api/updates

  9. 選取 [確認選取項目]

    Screenshot that shows the Select Web Hook dialog. The Subscriber Endpoint box contains a U R L, and a Confirm Selection button is visible.

檢視簡訊事件

若要產生和接收SMS事件,請執行下列各節中的步驟。

觸發 SMS 事件

若要檢視事件觸發程式,我們需要產生一些事件。

  • 當通訊服務電話號碼收到文字訊息時,會產生 SMS Received 事件。 若要觸發事件,請從您的電話傳送訊息到附加至通訊服務資源的電話號碼。
  • 當您使用通訊服務電話號碼將 SMS 傳送給使用者時,將會產生 SMS Delivery Report Received 事件。 若要觸發事件,您必須開啟您傳送的 SMSDelivery Report 選項。 嘗試將訊息傳送至已開啟 Delivery Report 的電話。 完成此動作後,您的 Azure 帳戶中會產生幾美分的少許費用。

查看通訊服務支援的事件完整清單。

接收 SMS 事件

產生事件之後,您會發現 SMS ReceivedSMS Delivery Report Received 事件都會傳送至您的端點。 這些事件會顯示在此快速入門開頭所設定的事件方格檢視器。 選取事件旁的眼睛圖示,以查看整個承載。 事件看起來應該類似下列資料:

Screenshot of the Azure Event Grid viewer that shows the Event Grid schema for an SMS received event.

Screenshot of the Azure Event Grid viewer that shows the Event Grid schema for an SMS delivery report event.

深入了解事件結構描述和其他事件處理概念

清除資源

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

下一步

在本快速入門中,您已了解如何使用 SMS 事件。 您可以藉由建立事件方格訂用帳戶,來接收 SMS 訊息。

您可能也想要: