文档

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

更新时间:

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

前提条件

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

说明

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

注意事项

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

  • 如果您为阿里集团内部用户,请联系DMS技术支持(钉钉群号:67215001618)。

准备工作

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

    普通钉钉/专属钉钉

    1. 创建应用

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

        1. 访问钉钉开放平台

        2. 单击页面右上角的登录,选择企业所在的组织。例如“DMS测试组织”。

          image

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

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

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

        3. 单击创建应用

          image

        4. 输入应用名称应用描述,单击保存

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

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

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

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

          说明

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

      4. 配置网页应用信息。

        1. 应用能力菜单下,单击网页应用

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

      5. 配置权限。

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

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

        • 成员信息读权限

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

        • 调用企业API基础权限

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

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

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

        • 互动卡片实例写权限

      6. 创建新版本并发布。

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

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

    2. 创建卡片

      1. 新建模板。

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

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

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

          image

      2. 导入卡片模板。

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

        image

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

    飞书

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

      1. 访问飞书开放平台

      2. 单击登录

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

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

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

      image

    3. 添加飞书机器人。

      1. (可选)单击应用名称,进入应用编辑页面。

        说明

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

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

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

        image

      4. 机器人页面,输入机器人名称,单击保存

        image

    4. 添加网页应用。

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

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

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

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

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

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

        image

      3. 分别单击添加

    6. 配置应用权限。

      1. 在左侧导航栏中,选择开发配置 > 权限设置

      2. API权限页签下,申请如下权限。权限配置操作及权限说明,请参见申请权限权限说明

        • 获取用户USER ID

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

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

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

        • 以应用的身份发消息

        • 给多个用户批量发消息

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

    7. 发布应用版本。

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

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

      2. 单击创建版本

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

        可用范围选择全部成员

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

    普通钉钉

    • 应用AppId、AgentId、AppKey、AppSecret

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

    • RobotCode

      应用能力 > 机器人页面获取RobotCode。

    • 卡片模板ID

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

    专属钉钉

    • 应用AppKey、AppSecret

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

    • RobotCode

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

    • 卡片模板ID

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

    飞书

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

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

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

说明

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

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

  1. 登录数据管理DMS 5.0
  2. 单击控制台左上角的2023-01-28_15-57-17.png图标,选择全部功能 > 运维管理 > 通知管理

    说明

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

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

  4. 选中目标通知渠道。

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

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

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

    2. 输入AppIdAppSecret,单击保存

      image

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

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

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

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

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

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

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

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

    image

  6. 开启消息通知。

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

移动端通知效果展示

钉钉/专属钉钉

飞书

image

image

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

image

相关文档

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

常见问题

Q:在个人信息的通知配置了飞书的通知渠道信息,为什么在飞书中未收到DMS的消息通知呢?

A:请检查您是否已开通飞书通知渠道。开通飞书渠道后,您配置的信息才可生效,DMS将通过该渠道向您发送消息通知。开通操作,请参见步骤一:在DMS开通并配置通知渠道