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

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

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

先决条件

关于事件网格

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

设置事件网格查看器

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

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

    Screenshot that shows the Event Grid Viewer Sample Page with Deploy To Azure option.

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

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

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

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

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

  • “托管计划名称”- 创建任何名称以标识托管计划。

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

    Screenshot that shows Custom deployment of Events Viewer web app and properties you need to provide to successfully deploy.

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

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

    Screenshot that shows Events Viewer web app.

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

    Screenshot that shows URL of Events Viewer web app.

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

订阅高级消息传送事件

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

    Screenshot that shows Azure Communication Services Events subscription option and allows you to subscribe to Advanced Messaging events.

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

    • 订阅名称。

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

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

      Screenshot that shows create event subscription properties.

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

      Screenshot that shows how to update webhook url of event subscription to receive events.

    • 选择创建

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

    Screenshot that shows two Advanced messaging events subscribed.

清理资源

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

后续步骤

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