通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

快速入门：处理电子邮件事件

  • 项目

通过 Azure 事件网格处理通信服务电子邮件事件，开始使用 Azure 通信服务。 订阅传递报告和参与度报告等电子邮件事件后，将生成并接收这些事件。 完成本快速入门会从你的 Azure 帐户中扣取最多几美分的费用。

先决条件

关于事件网格

事件网格是一种基于云的事件处理服务。 在本文中，你将了解如何订阅通信服务事件，以及触发事件以查看结果。 通常，你会将事件发送到处理事件数据并执行操作的终结点。 在本文中，我们会将事件发送到收集并显示消息的 Web 应用。

设置环境

要设置我们将用于生成和接收事件的环境，请执行以下部分中的步骤。

注册事件网格资源提供程序

如果以前未在 Azure 订阅中使用过事件网格，则可能需要注册事件网格资源提供程序。 要注册提供程序，请按照下列步骤操作：

  1. 转到 Azure 门户。
  2. 在左侧菜单中选择“订阅”。
  3. 选择用于事件网格的订阅。
  4. 在左侧菜单中的“设置”下，选择“资源提供程序”。
  5. 找到 Microsoft.EventGrid。
  6. 如果未注册资源提供程序，请选择“注册”。

完成注册可能需要一些时间。 选择“刷新”可更新状态。 当“状态”下显示“已注册”时，即可继续。

部署事件网格查看器

对于本快速入门，我们将使用事件网格查看器近乎实时地查看事件。 查看器为用户提供实时源体验。 此外，每个事件的有效负载应可供检查。

要设置查看器，请按照 Azure 事件网格查看器中的步骤操作。

使用 Webhook 订阅电子邮件事件

可以订阅特定事件以向事件网格提供有关将要跟踪的事件发送到的位置的信息。

  1. 在门户中，转到创建的通信服务资源。

  2. 在通信服务资源中，在“通信服务”页面的左侧菜单中，选择“事件”。

  3. 选择“添加事件订阅”。

    显示 Azure 通信服务资源的“事件”页的屏幕截图。“事件订阅”按钮被调用。

  4. 在“创建事件订阅”页上，为事件订阅输入“名称”。

  5. 在“事件类型”下，选择要订阅的事件。 对于电子邮件，可以选择 Email Delivery Report Received 和 Email Engagement Tracking Report Received。

  6. 如果系统提示输入系统主题名称，请随意输入唯一的字符串。 此字段不会对体验造成影响，适用于内部遥测。

    显示“创建事件订阅”对话框的屏幕截图。在“事件类型”下，已选中“接收电子邮件传递报告”和“接收电子邮件参与度跟踪报告”。

  7. 对于“终结点类型”，选择 “Webhook”。

    显示“创建事件订阅”对话框详细信息的屏幕截图。在“终结点类型”列表中，已选择“Webhook”。

  8. 对于“终结点”，选择“选择终结点”，然后输入 Web 应用的 URL。

    在这种情况下，我们将使用我们之前在快速入门中设置的事件网格查看器中的 URL。 示例的 URL 采用以下格式：https://{{site-name}}.azurewebsites.net/api/updates

  9. 选择“确认所选内容” 。

    显示“选择 Webhook”对话框的屏幕截图。订阅服务器终结点框包含 URL，并且可以看到“确认选择”按钮。

查看电子邮件事件

要生成和接收电子邮件事件，请执行以下部分中的步骤。

触发电子邮件事件

要查看事件触发器，我们需要生成一些事件。 若要触发事件，请使用附加到通信服务资源的电子邮件域资源发送电子邮件。

  • 当电子邮件状态为终端状态（即“已送达”、“失败”、“筛选到垃圾邮件”、“已隔离”）时，将生成 Email Delivery Report Received 事件。
  • 打开发送的电子邮件或单击电子邮件中的链接时，将生成 Email Engagement Tracking Report Received 事件。 若要触发事件，需要启用电子邮件域资源上的 User Interaction Tracking 选项

查看通信服务支持的事件的完整列表。

接收电子邮件事件

生成事件后，你会注意到 Email Delivery Report Received 和 Email Engagement Tracking Report Received 事件已发送到终结点。 这些事件将显示在本快速入门开始时设置的事件网格查看器中。 选择事件旁边的眼睛图标以查看整个有效负载。 事件应类似于以下数据：

Azure 事件网格查看器的屏幕截图，显示接收电子邮件传递报告事件的事件网格架构。

Azure 事件网格查看器的屏幕截图，显示电子邮件参与度跟踪报告事件的事件网格架构。

  • EngagementContext 是指在 engagementType 为 Click 时单击的链接。
  • 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 通信服务 - 电子邮件事件。

另外建议查看以下文章：