通过

设置传入呼叫、通话记录和短信服务

  • 项目

Azure 通信服务与 Azure 事件网格集成，可针对聊天、电话、短信、视频和语音呼叫事件发送实时通知。 反过来，Azure 事件网格使用事件订阅将事件消息路由到订阅者。

要启用通话记录和短信服务，必须首先通过注册事件网格系统主题来配置应用程序以侦听 Azure 通信服务事件。 然后，通过在 Azure 门户上创建事件网格订阅来订阅特定的传入呼叫、通话记录或短信事件。

重要提示

  • 您必须是应用程序注册 的 所有者才能创建事件网格订阅。
  • 使用以下过程一次只能设置一个 Webhook 终结点。 要启用来电、短信和通话录音服务，您必须重复该过程以为每个服务设置 Webhook 终结点。
  • 您必须为每个事件类型创建一个新的事件订阅。 不要通过更改事件类型来更新现有事件订阅。
  • 连接事件订阅时，必须使用与首次连接到 Azure 资源时相同的应用程序（客户端）ID 和租户（目录）ID 进行应用注册。 若要获取事件网格应用程序和租户 ID，请转到 从 Power Apps 门户获取应用程序和租户 ID。

创建 Event 网格 系统主题

  1. 在 Azure 门户上打开事件网格系统主题服务。

  2. 创建新的 事件 网格 系统主题，然后在 基本 选项卡上，添加以下信息：

    • 主题类型：Azure 通信服务

    • 订阅：选择您的订阅。

    • 资源组：选择 Azure 通信服务资源所在的资源组。

    • 资源：选择要连接到Dynamics 365 客户服务的 Azure 通信服务资源。

    • 在 系统主题 Details 部分中指定 Name 。

      Create Event 网格 系统主题 对话框的 Name 字段

    有关详细信息，请参阅 创建和部署 Event 网格 系统主题。

  3. 在事件网格系统主题页上，选择订阅链接。

    用于创建 Event 网格 系统主题 的订阅链接

  4. 在资源订阅页面上，选择 Settings Resource providers（设置>资源提供程序），然后检查 Microsoft.EventGrid 提供程序是否 列为 Registered（已注册）。 如果事件网格未注册，选择记录，然后选择重新注册进行注册。

设置传入呼叫 Webhook

  1. 在 Azure 门户中打开资源。 选择事件，然后选择事件订阅。

  2. 在 Basics（基本信息 ） 选项卡上，输入以下详细信息：

    • 名称：输入录制事件订阅的名称。

    • 事件架构：选择 列表中的事件网格架构 。

    • 主题 类型：选择 列表中的 Azure 通信服务 。

    • 订阅：在列表中选择您的订阅。

    • 资源组：选择资源组。

    • 资源：选择资源。

    • 系统主题名称：此字段会自动填充您创建的系统主题名称。 但是，如果您看到多个值，请从列表中选择特定的系统主题名称。

    • 筛选到事件类型：您可以筛选通话录音、来电或 SMS 服务的事件。

      • 要筛选呼叫服务的事件类型，请在列表中选择 Incoming Call （来电）。

    • 终结点 类型：选择 Web Hook 。

    • 终结点：选择 选择终结点，然后输入来电、Customer Service 管理中心或联系中心 管理中心的 webhook 终结点。 转到渠道>电话号码>高级>管理 Azure 通信服务获取以下 webhook 终结点：

      • 传入呼叫 Web Hook 终结点（预览版） 以启用传入呼叫。

        来电 Webhook 终结点

  3. 选择“其他功能 ”选项卡。选择“使用 身份验证 Microsoft Entra ” 复选框，然后输入以下详细信息。 有关这些值的详细信息， 请参阅本文的从 Power Apps 门户 获取应用程序和租户 ID 部分。

    • Microsoft Entra 租户 ID：输入 Azure 资源的租户（目录）ID。
    • Microsoft Entra 应用程序 ID 或 URI：输入 Azure 资源的应用程序（客户端）ID。

    事件网格订阅附加功能

  4. 选择创建为记录创建事件订阅终结点。

    同步最多可能需要 15 分钟。如果出现类似“Webhook 验证握手失败”的错误，请在几分钟后重试此步骤。

设置通话录音 Webhook

  1. 跟随设置 Incoming Calls Webhook，但在筛选事件类型时，选择 选择列表中的 Recording File Status Updated 。

  2. 对于 终结点类型 ，选择 列表中的 Web Hook 。

  3. 对于 终结点，选择 选择终结点，然后输入Customer Service 管理中心或联系中心 管理中心的录制 webhook 终结点。 转到频道电话号码高级管理 Azure 通信服务 录制 Webhook 终结点>。>>>

    事件网格订阅录制 Webhook 终结点

  4. 选择“其他功能 ”选项卡。选择“使用 身份验证” Microsoft Entra 复选框，然后输入以下详细信息。 有关这些值的信息，请转到 从门户 Power Apps 获取事件网格应用程序和租户 ID 部分。

    • Microsoft Entra 租户 ID：输入 Azure 资源的租户（目录）ID。
    • Microsoft Entra 应用程序 ID 或 URL：输入 Azure 资源的应用程序（客户端）ID。

  5. 选择创建为记录创建事件订阅终结点。

    同步最多可能需要 15 分钟。如果您收到类似“Webhook 验证握手失败”的错误，请在几分钟后重试此步骤。

设置 SMS Webhook

  1. 跟随设置 Incoming Calls Webhook 部分，但在筛选事件类型时，列表中会显示 选择 SMS Received 和 SMS Delivery Report Received 。

  2. 对于 终结点类型 ，选择 列表中的 Web Hook 。

  3. 对于 终结点、选择 选择终结点，然后输入联系中心 管理中心或Customer Service 管理中心终结点录制 webhook。 转到频道电话号码高级 管理 Azure 通信服务>SMS Web Hook 终结点>。>>

  4. 选择“其他功能 ”选项卡。选择“使用 身份验证” Microsoft Entra 复选框，然后输入以下详细信息。 有关这些值的信息，请转到 门户部分的获取事件网格应用程序和租户 ID Power Apps 。

    • Microsoft Entra 租户 ID：输入 Azure 资源的租户（目录）ID。
    • Microsoft Entra 应用程序 ID 或 URL：输入 Azure 资源的应用程序（客户端）ID。

  5. 选择创建为记录创建事件订阅终结点。

    同步最多可能需要 15 分钟。如果您收到类似“Webhook 验证握手失败”的错误，请在几分钟后重试此步骤。

将 Azure 资源从现有语音堆栈重新连接到增强的语音堆栈

如果要从现有语音堆栈迁移到增强型语音堆栈，请使用以下视频来确保事件网格已针对传入呼叫和录制进行了正确配置。

从 Power Apps 门户获取事件网格应用程序和租户 ID

备注

仅当从门户获取 ID Power Apps 时遇到问题时，才使用此方法。 若要从 Azure 门户获取 ID，请搜索“应用注册”，然后找到连接的 Azure 通信服务资源的注册。 复制 应用程序（客户端） ID 以填写 事件网格应用程序 ID 框，复制 目录（租户） ID 以填充 事件网格租户 ID 框。

  1. 打开 Power Apps 门户，选择您的环境。

  2. 在站点地图中，选择 Dataverse>表>所有。

  3. 搜索通信提供程序设置条目表并将其打开。

  4. 在通信提供程序设置条目列和数据部分，查看键列中的 EventGridAppID 和 EventGripAppTenantID 字段，记下值列中相应的 ID 值。