快速入門：處理電子郵件事件

  • 發行項

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

必要條件

關於 Event Grid

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

設定環境

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

註冊事件方格資源提供者

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

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

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

部署事件方格檢視器

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

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

使用 Webhook 訂閱電子郵件事件

您可以訂閱特定事件，以提供事件方格的相關信息，以傳送想要追蹤的事件。

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

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

  3. 選取 [新增事件訂用帳戶]。

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

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

  5. 在 [事件類型] 下，選取要訂閱的事件。 針對 [電子郵件]，可以選擇 Email Delivery Report Received 和 Email Engagement Tracking Report Received。

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

    Screenshot that shows the Create Event Subscription dialog. Under Event Types, Email Delivery Report Received and Email Engagement Tracking 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 URL, and a Confirm Selection button is visible.

檢視電子郵件事件

若要產生和接收電子郵件事件，請執行下列各節中的步驟。

觸發電子郵件事件

若要檢視事件觸發程式，則需要產生一些事件。 若要觸發事件，使用連結至通訊服務資源的電子郵件網域資源傳送電子郵件。

  • 當電子郵件狀態處於終端機狀態 (亦即已傳遞、失敗、篩選過的垃圾郵件、已隔離) 時，會產生 Email Delivery Report Received 事件。
  • 開啟傳送的電子郵件或按一下電子郵件中的連結時，就會產生 Email Engagement Tracking Report Received 事件。 若要觸發事件，需要開啟電子郵件網域資源上的 User Interaction Tracking 選項

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

接收電子郵件訊息

產生事件之後，您會發現 Email Delivery Report Received 和 Email Engagement Tracking Report Received 事件都會傳送至端點。 這些事件會顯示在此快速入門開始時設定的事件方格檢視器中。 選取事件旁的眼睛圖示以查看整個承載。 事件應類似於下列資料：

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

Screenshot of the Azure Event Grid viewer that shows the Event Grid schema for an EMAIL engagement tracking report event.

  • 當 engagementType 為 Click 時，EngagementContext 指的是按下的連結。
  • UserAgent 是指發起此電子郵件參與事件的使用者代理程式。 例如： 如果使用者使用 Win10 電腦在 Edge 上互動：Mozilla/5.0 (Windows NT 10.0；Win64；x64) AppleWebKit/537.36 (KHTML，例如 Gecko) Chrome/42.0.2311.135 Safari/537.36 Edge/12.246
  • EngagementType 是指參與類型，可能的值為「檢視」或「按下」。

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

清除資源

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

下一步

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

傳送電子郵件

如需架構資訊和範例事件，請參閱 Azure 通訊服務 - 電子郵件事件。

另外建議查看下列文章：