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

快速入门:处理高级消息传送事件

Azure 通信服务现在允许你使用高级消息传送 SDK 发送和接收 WhatsApp 消息。 设置事件网格事件以接收 WhatsApp 消息发送/接收状态报告入门。 完成本快速入门会从你的 Azure 帐户中扣取最多几美分的费用。

先决条件

关于事件网格

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

设置事件网格查看器

事件网格查看器是一个示例网站,可用于查看事件网格中的传入事件。

  1. 转到此链接 Azure 事件网格查看器 - 代码示例 | Microsoft Learn。 单击“部署到 Azure”部署事件网格查看器示例。

    显示带有“部署到 Azure”选项的事件网格查看器示例页面的屏幕截图。

  2. 单击“部署到 Azure”后,填写必填字段。 由于网站名称会创建 DNS 条目,因此它需要是全局唯一的。 建议为此步骤在名称中加入别名。 尽管本快速入门不要求进行任何特殊设置以执行此步骤,但下面提供了有关填写部署详细信息的一些建议:

  • Subscription - 选择包含 Azure 通信服务资源的订阅。 此特定订阅不是必需的,但它可以让你在完成快速入门后,更轻松地进行清理。

  • Resource Group - 选择包含 Azure 通信服务资源的资源组。 此特定资源组不是必需的,但它可以让你在完成快速入门后,更轻松地进行清理。

  • Region - 选择包含 Azure 通信服务资源的资源组。 此特定区域不是必需的,但建议使用。

  • Site Name - 创建全局唯一的名称。 此站点名称用于创建要连接到事件网格查看器的域。

  • Hosting Plan Name - 创建任意名称来标识托管计划。

  • Sku - SKU F1 可用于开发和测试。 如果在创建事件网格查看器时遇到验证错误,指出 F1 计划没有更多容量,请尝试选择其他区域。 有关 SKU 的详细信息,请参阅应用服务定价

    显示事件查看器 Web 应用的自定义部署以及成功部署所需提供的属性的屏幕截图。

  1. 然后选择“查看 + 创建”。

  2. 部署完成后,选择应用服务资源将其打开。

    显示事件查看器 Web 应用的屏幕截图。

  3. 在资源概述页中,选择“默认域”属性旁边的复制按钮。

    显示事件查看器 Web 应用的 URL 的屏幕截图。

  4. 事件网格查看器的 URL 是你用于创建部署的网站名称,追加路径 /api/update。 例如:“https://{{site-name}}.azurewebsites.net/api/updates”。 在下一步和创建演示应用期间,你将需要用到它。

订阅高级消息传送事件

  1. 在 Azure 门户中打开通信服务资源,导航到左侧面板中的“事件”选项,然后选择“+事件订阅”。

    显示 Azure 通信服务事件订阅选项并允许订阅高级消息传递事件的屏幕截图。

  2. 填写新事件订阅的详细信息。

    • 订阅名称。

    • 系统主题名称 - 输入唯一名称,除非此名称已预先填充订阅主题。

    • 事件类型 - 从列表中选择两个高级消息传送事件。

      显示创建事件订阅属性的屏幕截图。

    • 可选:选择 AdvancedMessageAnalysisCompleted 事件(当前为公共预览版)来接收消息分析事件。 有关如何启用消息分析的说明,请参阅使用 Azure OpenAI 启用消息分析

      重要

      Azure 通信服务的这一功能目前以预览版提供。

      预览版 API 和 SDK 在没有服务级别协议的情况下提供。 建议不要将它们用于生产工作负荷。 某些功能可能不受支持或者已受限。

      有关详细信息,请参阅 Microsoft Azure 预览版补充使用条款

      显示如何创建消息分析事件订阅属性的屏幕截图。

    • 对于终结点类型,选择“Webhook”,然后输入我们在“设置事件网格查看器”步骤中创建的事件网格查看器的 URL,追加路径 /api/updates 例如:https://{{site-name}}.azurewebsites.net/api/updates

      显示如何更新事件订阅的 Webhook URL 以接收事件的屏幕截图。

    • 选择创建

  3. 导航回到你的 Azure 通信服务资源的左侧面板中的“事件”选项。 请注意具有高级消息传送事件的新事件订阅。

    显示订阅了两个高级消息传递事件的屏幕截图。

清理资源

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

后续步骤

请继续学习下一篇文章,了解如何使用高级消息 SDK 进行 WhatsApp 消息传送。