AI 助理
文档备案控制台
官方文档
首页

使用普通钉钉、专属钉钉、飞书和Lark通知消息

更新时间：
复制 MD 格式
产品详情
我的收藏

DMS消息通知接入普通钉钉、专属钉钉和飞书通知渠道，支持在移动端和客户端查看通知，并支持审批人在移动端进行工单审批。

前提条件

已在钉钉或飞书中建立组织。具体操作，请参见创建钉钉组织和创建飞书组织。

说明

该组织为企业的内部组织，而非阿里云的公共组织，例如阿里云服务支持。

注意事项

  • 仅支持在移动端进行工单审批。

  • 如果您为阿里集团内部用户，请联系DMS技术支持（钉钉群号：87370028482）。

  • 美国站不支持消息通知。

准备工作

  1. 配置接收消息的应用。

    普通钉钉/专属钉钉

    1. 创建应用。

      1. 登录并加入钉钉组织。

        1. 登录钉钉开放平台。

        2. 选择企业所在的组织。例如“XXX测试组织”。

      2. 访问钉钉后台，创建钉钉应用。

        1. 单击页面右上角的我的后台。

        2. 单击应用开发页签，在左侧导航栏选择企业内部应用 > 钉钉应用。

        3. 单击创建应用。

        4. 输入应用名称和应用描述，单击保存。

      3. 配置接收消息的钉钉机器人。

        1. 单击已创建应用的名称，进入应用编辑页面。

        2. 在左侧导航栏中，选择应用能力 > 添加应用能力，并在该页面添加一个机器人。

        3. 配置机器人相关信息，包含机器人简介、机器人描述和消息接收模式等，并单击发布。

          说明

          消息接收模式选择HTTP模式。

      4. 配置网页应用信息。

        1. 添加网页应用后，在应用能力菜单下，单击网页应用。

        2. 配置应用首页地址https://dms.aliyun.com并单击保存。

          说明

          如果您访问的是虚商环境，包含聚石塔、中信、联通合营云、联通沃云、菜鸟物流云、七牛云，请填写地址https://dms-ent4service.aliyun.com。

      5. 配置权限。

        在左侧导航栏中选择开发配置 > 权限管理，申请如下权限：

        • 调用SNS API时需要具备的基本权限

        • 成员信息读权限

        • 根据手机号获取成员基本信息权限

        • 调用企业API基础权限

        • 获取钉钉开放接口用户访问凭证的基础权限

        • 钉钉群基础信息管理权限

        • 企业内机器人发送消息权限

        • 互动卡片实例写权限

      6. 创建新版本并发布。

        企业自建应用需要供企业内其他用户使用，则必须发布一个版本。

        在左侧导航栏中选择版本管理与发布，单击创建新版本，填写相关配置信息，并单击保存。

    2. 创建卡片。

      1. 新建模板。

        1. 进入卡片平台，单击新建模板。

        2. 填入模板名称、选择卡片类型、卡片模板场景等信息，并单击创建。

          卡片模板场景选择普通卡片，关联应用选择创建的应用。

      2. 导入卡片模板。

        选择更多 > 导入模板，导入消息通知卡片模板并保存。示例模板文件DingTalkTemplate.json。

      3. 发布消息通知卡片模板。

    飞书/飞书国际版（Lark）

    1. 登录飞书或Lark开放平台并进入开发者后台。

      1. 访问飞书开放平台或Lark开放平台。

      2. 单击登录。

        登录的账号需要在目标企业组织下，例如组织名为“XXX测试组织”。

      3. 登录后进入开发者后台。

    2. 单击创建企业自建应用，配置名称、应用描述等相关信息，再单击创建。更多信息，企业自建应用开发流程。

    3. 添加飞书机器人。

      1. （可选）单击应用名称，进入应用编辑页面。

        说明

        如果新创建的应用，则可忽略该步骤。

      2. 在左侧导航栏中，选择应用能力 > 添加应用能力。

      3. 在按能力添加页签下，单击机器人卡片上的添加。

      4. 在机器人页面，输入机器人名称，单击保存。

    4. 添加网页应用。

      1. 在左侧导航栏中，选择应用能力 > 添加应用能力。

      2. 在按能力添加页签下，单击网页应用卡片上的添加。

      3. 在网页应用页面，填写移动端主页地址为https://dms.aliyun.com，并单击保存。

        说明

        如果您访问的是虚商环境，包含聚石塔、中信、联通合营云、联通沃云、菜鸟物流云、七牛云，请填写地址https://dms-ent4service.aliyun.com。

    5. 添加重定向URL以及H5可信域名。

      1. 在左侧导航栏中，选择开发配置 > 安全设置。

      2. 在重定向URL页签下，配置重定向URL为https://dms.aliyun.com/console/mobile/index/，配置H5可信域名为https://dms.aliyun.com。

        说明

        如果您使用的是虚商环境，则请配置重定向URL为https://dms-ent4service.aliyun.com/console/mobile/index/，H5可信域名为https://dms-ent4service.aliyun.com。

      3. 分别单击添加。

    6. 配置应用权限。

      1. 在左侧导航栏中，选择开发配置 > 权限管理。

      2. 在权限管理页签下，单击开通权限。

      3. 在应用身份权限tenant_access_token页签，申请如下权限。更多权限配置操作及权限说明，请参见申请权限和权限说明。

        • 获取用户 user ID

        • 通过手机号或邮箱获取用户 ID

        • 上传图片和附件到云文档中

          说明

          Lark不支持此权限。

        • 获取与发送单聊、群组消息

        • 以应用的身份发消息

        • 给多个用户批量发消息

        • 获取与上传图片或文件资源

    7. 发布应用版本。

      如果企业自建应用需要给企业内其他用户使用，则必须要发布一个版本。

      1. 在左侧导航栏中选择应用发布 > 版本管理与发布。

      2. 单击创建版本。

      3. 填写应用版本号、选择移动端的默认能力等信息，单击保存。

        可用范围选择全部成员。

  2. 获取钉钉、专属钉或飞书的关键信息。该信息将用于DMS配置通知渠道。

    普通钉钉

    • 获取应用AppId、AgentId、AppKey、AppSecret

      在钉钉开放平台的凭证与基础信息页面获取应用AppId、AgentId、AppKey、AppSecret。

    • 获取RobotCode

      在钉钉开发平台的应用能力 > 机器人页面获取RobotCode。

    • 获取卡片模板ID

      在卡片平台的模板管理 > 模板列表页面获取。

    • 获取CorpId（可选）

      进入钉钉开发者后台，单击头像获取CorpId。

      说明

      在DMS通知渠道中配置CorpId参数后，后续您无需切换钉钉组织到企业自建应用所在的组织即可接收消息并进行审批工单操作。

    专属钉钉

    • 获取应用AppKey、AppSecret

      在钉钉开放平台的基础信息页面获取应用AppKey、AppSecret。

    • 获取RobotCode

      在钉钉开放平台的机器人页面，查看凭证信息来获取RobotCode。

    • 获取卡片模板ID

      在卡片平台的开发工具 > 卡片搭建页面获取。

    • 获取CorpId（可选）

      进入钉钉开发者后台，单击头像获取CorpId。

      说明

      在DMS通知渠道中配置CorpId参数后，后续审批消息时，无需切换钉钉组织到企业自建应用所在的组织即可接收消息并进行审批工单操作。

    飞书/Lark

    在飞书开放平台或Lark开放平台的基础信息 > 凭证与基础信息页面获取AppId、AppSecret。

步骤一：在DMS开通并配置通知渠道

DMS渠道管理功能用于启用或禁用租户级别的通知渠道，以及维护飞书、专属钉等应用的配置信息。

说明

开通目标渠道后，您在DMS中配置的通知信息才可生效，DMS将通过该渠道向您发送消息通知。

仅管理员或DBA支持配置通知渠道。

  1. 登录数据管理DMS 5.0。

  2. 单击控制台左上角的2023-01-28_15-57-17.png图标，选择全部功能 > 运维管理 > 通知管理。

    说明

    若您使用的是非极简模式的控制台，请在顶部菜单栏中，选择运维管理 > 通知管理。

  3. 单击页面左上角的渠道管理。

  4. 选中目标通知渠道。

  5. 配置飞书、Lark、钉钉或专属钉钉所需的信息。

    如下以配置飞书渠道信息举例，其他渠道配置操作与此示例类似。

    1. 单击飞书渠道区域的编辑。

    2. 输入AppId、AppSecret，单击保存。

步骤二：设置接收消息通知的用户

如下以配置待审批数据导出工单的通知为例：

  1. 管理员将待接收消息的用户录入DMS。具体操作，请参见用户管理。

  2. 管理员或DBA进入DMS通知管理功能页面。

    在通知管理功能页面，选择需要通知的DMS功能模块更新消息。

  3. 在模块/业务类型筛选框中，选择工单 > 数据导出。

  4. 找到待审批业务状态的工单，单击右侧的修改。

  5. 在附加通知用户参数区域，选择目标用户，并单击确认。

  6. 开启消息通知。

    后续待审批的数据导出工单通知将直接发送至目标用户的钉钉、专属钉或飞书。

移动端通知效果展示

钉钉/专属钉钉

飞书

钉钉中将展示DMS审批通知卡片，包含工单类型（如数据导出）、创建人、UID、租户ID、业务背景、数据库信息和影响行数等详细信息，底部提供拒绝和同意按钮供审批操作。

飞书中的通知格式与钉钉类似，同样展示工单详细信息和拒绝/同意审批按钮。

您可以单击审批卡片查看详情。

审批详情页展示工单的完整信息，包括标题、背景描述、数据库地址、导出脚本、影响行数和工单审批信息等，底部提供审批拒绝和审批通过按钮。

相关文档

DMS支持在移动端快速处理工单，极大地提高了研发效率。具体操作，请参见在移动端审批工单。

常见问题

  • Q：在个人信息通知中配置了飞书、钉钉、专属钉或Lark的渠道信息，为什么在飞书、钉钉或其他渠道中未收到DMS的消息通知呢？

    A：请检查您是否已开通飞书、钉钉、专属钉或Lark通知渠道。开通对应渠道后，您配置的信息才可生效，DMS将通过该渠道向您发送消息通知。开通操作，请参见步骤一：在DMS开通并配置通知渠道。

  • Q：为什么配置了通知渠道信息和接收消息的用户，还是没有接收到钉钉或飞书消息？

    A：请根据如下步骤解决问题：

    1. 检查管理员或DBA是否已在DMS通知管理 > 渠道管理中开启对应的渠道。更多信息，请参见步骤一：在DMS开通并配置通知渠道。

    2. 单击DMS用户头像，确保通知方式中对应的通知渠道为开启状态。

      在弹出的下拉菜单中单击账户信息，在用户信息面板中查看通知字段是否已配置目标通知渠道。

  • Q：未修改通知设置，突然无法接收钉钉或飞书消息，可能是什么原因？

    A：可能是因为企业自建应用的API调用量超出限制，导致无法接收到消息。您可以在钉钉或飞书的开发者后台查看API调用量。调整API调用次数的操作，请参见钉钉和飞书。

上一篇：配置个人信息及通知方式下一篇：使用自定义Webhook通知