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

快速入门:处理短信和发送报告事件

通过 Azure 事件网格处理通信服务短信事件,开始使用 Azure 通信服务。 订阅入站消息和发送报告等短信事件后,将生成并接收这些事件。 完成本快速入门会从你的 Azure 帐户中扣取最多几美分的费用。

重要

短信和 PSTN 功能取决于所使用的电话号码和所在的国家/地区,具体取决于 Azure 帐单邮寄地址。 有关详细信息,请访问订阅资格文档。

先决条件

关于事件网格

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

设置环境

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

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

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

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

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

部署事件网格查看器

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

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

使用 Webhook 订阅短信事件

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

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

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

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

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

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

  5. 在“事件类型”下,选择要订阅的事件。 对于短信,可以选择 SMS ReceivedSMS Delivery Report Received

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

    显示“创建事件订阅”对话框的屏幕截图。在“事件类型”下,已选择“接收短信”和“短信传递报告”。

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

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

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

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

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

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

查看短信事件

要生成和接收短信事件,请执行以下部分中的步骤。

触发短信事件

要查看事件触发器,我们需要生成一些事件。

  • 当通信服务电话号码收到短信时,会生成 SMS Received 事件。 若要触发事件,请将消息从手机发送到附加到通信服务资源的电话号码。
  • 当使用通信服务电话号码向用户发送短信时,会生成 SMS Delivery Report Received 事件。 要触发事件,需要打开发送的短信Delivery Report 选项。 尝试在 Delivery Report 开启的情况下向手机发送消息。 完成此操作会从你的 Azure 帐户中扣取最多几美分的费用。

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

接收短信事件

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

Azure 事件网格查看器的屏幕截图,显示 SMS 接收到事件的事件网格架构。

Azure 事件网格查看器的屏幕截图,显示 SMS 传递报告事件的事件网格架构。

详细了解事件架构和其他事件处理概念

清理资源

如果想要清理并删除通信服务订阅,可以删除资源或资源组。 删除资源组同时也会删除与之相关联的任何其他资源。 了解有关清理资源的详细信息。

后续步骤

在本快速入门中,你学习了如何使用短信事件。 可以通过创建事件网格订阅来接收短信。

你可能还需要: