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

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

重要

SMS 和 PSTN 功能取決於您使用的電話號碼,以及您根據 Azure 帳單位址所決定在內運作的國家/地區。 如需詳細資訊,請參閱訂用帳戶資格文件。

必要條件

關於 Event Grid

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

設定環境

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

註冊事件方格資源提供者

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

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

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

部署事件方格檢視器

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

若要設定檢視器,請遵循Azure 事件方格 Viewer中的步驟。

使用 Web 勾點訂閱 SMS 事件

您可以訂閱特定事件,以提供事件方格的相關資訊,以傳送您想要追蹤的事件。

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

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

  3. 選取 [新增事件訂閱]。

    顯示Azure 通訊服務資源 [事件] 頁面的螢幕擷取畫面。已呼叫 [事件訂用帳戶] 按鈕。

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

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

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

    顯示 [建立事件訂閱] 對話方塊的螢幕擷取畫面。在 [事件種類] 底下,已選取 [收到 SMS] 和 [SMS 傳遞報告]。

  7. 針對 [端點類型],選取 [Web 攔截]。

    顯示 [建立事件訂用帳戶] 對話方塊詳細資料的螢幕擷取畫面。在 [端點類型] 清單中,已選取 [Web 勾點]。

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

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

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

    顯示 [選取 Web 攔截] 對話方塊的螢幕擷取畫面。[訂閱者端點] 方塊包含 U R L,而且會顯示 [確認選取專案] 按鈕。

檢視 SMS 事件

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

觸發 SMS 事件

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

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

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

接收 SMS 事件

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

顯示 SMS 接收事件之事件方格架構之Azure 事件方格檢視器的螢幕擷取畫面。

顯示 SMS 傳遞報表事件之事件方格架構之Azure 事件方格檢視器的螢幕擷取畫面。

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

清除資源

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

下一步

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

您可能也想要: