你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
快速入门:处理高级消息传送事件
Azure 通信服务现在允许你使用高级消息传送 SDK 发送和接收 WhatsApp 消息。 设置事件网格事件以接收 WhatsApp 消息发送/接收状态报告入门。 完成本快速入门会从你的 Azure 帐户中扣取最多几美分的费用。
先决条件
关于事件网格
事件网格是一种基于云的事件处理服务。 在本文中,你将了解如何订阅通信服务事件,以及触发事件以查看结果。 通常,你会将事件发送到处理事件数据并执行操作的终结点。 在本文中,我们会将事件发送到收集并显示消息的 Web 应用。
设置事件网格查看器
事件网格查看器是一个示例网站,可用于查看事件网格中的传入事件。
转到此链接 Azure 事件网格查看器 - 代码示例 | Microsoft Learn。 单击“部署到 Azure”部署事件网格查看器示例。
单击“部署到 Azure”后,填写必填字段。 由于网站名称会创建 DNS 条目,因此它需要是全局唯一的。 建议为此步骤在名称中加入别名。 尽管本快速入门不要求进行任何特殊设置以执行此步骤,但下面提供了有关填写部署详细信息的一些建议:
Subscription
- 选择包含 Azure 通信服务资源的订阅。 此特定订阅不是必需的,但它可以让你在完成快速入门后,更轻松地进行清理。Resource Group
- 选择包含 Azure 通信服务资源的资源组。 此特定资源组不是必需的,但它可以让你在完成快速入门后,更轻松地进行清理。Region
- 选择包含 Azure 通信服务资源的资源组。 此特定区域不是必需的,但建议使用。Site Name
- 创建全局唯一的名称。 此站点名称用于创建要连接到事件网格查看器的域。Hosting Plan Name
- 创建任意名称来标识托管计划。Sku
- SKU F1 可用于开发和测试。 如果在创建事件网格查看器时遇到验证错误,指出 F1 计划没有更多容量,请尝试选择其他区域。 有关 SKU 的详细信息,请参阅应用服务定价
然后选择“查看 + 创建”。
部署完成后,选择应用服务资源将其打开。
在资源概述页中,选择“默认域”属性旁边的复制按钮。
事件网格查看器的 URL 是你用于创建部署的网站名称,追加路径
/api/update
。 例如:“https://{{site-name}}.azurewebsites.net/api/updates”。 在下一步和创建演示应用期间,你将需要用到它。
订阅高级消息传送事件
在 Azure 门户中打开通信服务资源,导航到左侧面板中的“事件”选项,然后选择“+事件订阅”。
填写新事件订阅的详细信息。
订阅名称。
系统主题名称 - 输入唯一名称,除非此名称已预先填充订阅主题。
事件类型 - 从列表中选择两个高级消息传送事件。
可选:选择 AdvancedMessageAnalysisCompleted 事件(当前为公共预览版)来接收消息分析事件。 有关如何启用消息分析的说明,请参阅使用 Azure OpenAI 启用消息分析
重要
Azure 通信服务的这一功能目前以预览版提供。
预览版 API 和 SDK 在没有服务级别协议的情况下提供。 建议不要将它们用于生产工作负荷。 某些功能可能不受支持或者已受限。
有关详细信息,请参阅 Microsoft Azure 预览版补充使用条款。
对于终结点类型,选择“Webhook”,然后输入我们在“设置事件网格查看器”步骤中创建的事件网格查看器的 URL,追加路径
/api/updates
。 例如:https://{{site-name}}.azurewebsites.net/api/updates
。选择创建。
导航回到你的 Azure 通信服务资源的左侧面板中的“事件”选项。 请注意具有高级消息传送事件的新事件订阅。
清理资源
如果想要清理并删除通信服务订阅,可以删除资源或资源组。 删除资源组同时也会删除与之相关联的任何其他资源。 了解有关清理资源的详细信息。
后续步骤
请继续学习下一篇文章,了解如何使用高级消息 SDK 进行 WhatsApp 消息传送。