使用钉钉、专属钉和飞书通知渠道 - 数据管理 DMS

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

前提条件

已在钉钉或飞书中建立组织。

说明

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

注意事项

仅支持在移动端进行工单审批。
如果您为阿里集团内部用户，请联系DMS技术支持（钉钉群号：67215001618）。

准备工作

配置接收消息的应用。
普通钉钉/专属钉钉
1. 创建应用。
  1. 登录并加入钉钉组织。
    登录钉钉开放平台。
    选择企业所在的组织。例如“XXX测试组织”。
  2. 访问钉钉后台，创建钉钉应用。
    单击页面右上角的我的后台。
    单击应用开发页签，在左侧导航栏选择企业内部应用 > 钉钉应用。
    单击创建应用。
    输入应用名称和应用描述，单击保存。
  3. 配置接收消息的钉钉机器人。
    单击已创建应用的名称，进入应用编辑页面。
    在左侧导航栏中，选择应用能力 > 添加应用能力，并在该页面添加一个机器人。
    配置机器人相关信息，包含机器人简介、机器人描述和消息接收模式等，并单击发布。
    说明
    消息接收模式选择HTTP模式。
  4. 配置网页应用信息。
    在应用能力菜单下，单击网页应用。
    配置应用首页地址，并单击保存。
    填写应用地址需要参考当前DMS数据处理地区。例如数据处理地区为新加坡，则应用首页地址为https://dms-ap-southeast-1.alibabacloud.com。
    说明
    查看数据处理地区的具体操作，请参见切换DMS部署地域。
    华东1（杭州）：https://dms-cn-hangzhou.alibabacloud.com。
    日本（东京）：https://dms-ap-northeast-1.alibabacloud.com。
    新加坡：https://dms-ap-southeast-1.alibabacloud.com。
    马来西亚（吉隆坡）：https://dms-ap-southeast-3.alibabacloud.com。
    印度尼西亚（雅加达）：https://dms-ap-southeast-5.alibabacloud.com。
    沙特（利雅得）：https://dms-me-central-1.alibabacloud.com。
  5. 配置权限。
    在左侧导航栏中选择开发配置 > 权限管理，申请如下权限：
    调用SNS API时需要具备的基本权限
    成员信息读权限
    根据手机号获取成员基本信息权限
    调用企业API基础权限
    获取钉钉开放接口用户访问凭证的基础权限
    钉钉群基础信息管理权限
    企业内机器人发送消息权限
    互动卡片实例写权限
  6. 创建新版本并发布。
    企业自建应用需要供企业内其他用户使用，则必须发布一个版本。
    在左侧导航栏中选择版本管理与发布，单击创建新版本，填写相关配置信息，并单击保存。
2. 创建卡片。
  1. 新建模板。
    进入卡片平台，单击新建模板。
    填入模板名称、选择卡片类型、卡片模板场景等信息，并单击创建。
    卡片模板场景选择普通卡片，关联应用选择创建的应用。
  2. 导入卡片模板。
    选择更多 > 导入模板，导入消息通知卡片模板并保存。示例模板文件DingTalkTemplate.json。
  3. 发布消息通知卡片模板。
飞书/飞书国际版（Lark）
1. 登录飞书或Lark开放平台并进入开发者后台。
  1. 访问飞书开放平台或Lark开放平台。
  2. 单击登录。
    登录的账号需要在目标企业组织下，例如组织名为“XXX测试组织”。
  3. 登录后进入开发者后台。
2. 单击创建企业自建应用，配置名称、应用描述等相关信息，再单击创建。更多信息，企业自建应用开发流程。
3. 添加飞书机器人。
  1. （可选）单击应用名称，进入应用编辑页面。
    说明
    如果新创建的应用，则可忽略该步骤。
  2. 在左侧导航栏中，选择应用能力 > 添加应用能力。
  3. 在按能力添加页签下，单击机器人卡片上的添加。
  4. 在机器人页面，输入机器人名称，单击保存。
4. 添加网页应用。
  1. 在左侧导航栏中，选择应用能力 > 添加应用能力。
  2. 在按能力添加页签下，单击网页应用卡片上的添加。
  3. 在网页应用页面，填写移动端主页地址，并单击保存。
    填写主页地址需要参考当前DMS数据处理地区。例如数据处理地区为新加坡，则应用首页地址为https://dms-ap-southeast-1.alibabacloud.com。
    说明
    查看数据处理地区的具体操作，请参见切换DMS部署地域。
    华东1（杭州）：https://dms-cn-hangzhou.alibabacloud.com。
    日本（东京）：https://dms-ap-northeast-1.alibabacloud.com。
    新加坡：https://dms-ap-southeast-1.alibabacloud.com。
    马来西亚（吉隆坡）：https://dms-ap-southeast-3.alibabacloud.com。
    印度尼西亚（雅加达）：https://dms-ap-southeast-5.alibabacloud.com。
    沙特（利雅得）：https://dms-me-central-1.alibabacloud.com。
5. 添加重定向URL以及H5可信域名。
  1. 在左侧导航栏中，选择开发配置 > 安全设置。
  2. 在重定向URL页签下，配置重定向URL和H5可信域名。
    配置重定向URL和H5可信域名都需要参考DMS数据处理地区，例如DMS数据处理地区在新加坡，那么重定向URL为https://dms-ap-southeast-1.alibabacloud.com/console/mobile/index/，H5可信域名为https://dms-ap-southeast-1.alibabacloud.com。
  3. 分别单击添加。
6. 配置应用权限。
  1. 在左侧导航栏中，选择开发配置 > 权限设置。
  2. 在API权限页签下，申请如下权限。权限配置操作及权限说明，请参见申请权限和权限说明。
    获取用户USER ID
    通过手机号或邮箱获取用户ID
    上传图片和附件到云文档中
    说明
    Lark不支持此权限。
    获取与发送单聊、群组消息
    以应用的身份发消息
    给多个用户批量发消息
    获取与上传图片或文件资源
7. 发布应用版本。
  如果企业自建应用需要给企业内其他用户使用，则必须要发布一个版本。
  1. 在左侧导航栏中选择应用发布 > 版本管理与发布。
  2. 单击创建版本。
  3. 填写应用版本号、选择移动端的默认能力等信息，单击保存。
    可用范围选择全部成员。
获取钉钉、专属钉或飞书的关键信息。该信息将用于DMS配置通知渠道。
普通钉钉
- 应用AppId、AgentId、AppKey、AppSecret
  在钉钉开放平台的凭证与基础信息页面获取应用AppId、AgentId、AppKey、AppSecret。
- RobotCode
  在应用能力 > 机器人页面获取RobotCode。
- 卡片模板ID
  在卡片平台的模板管理 > 模板列表页面获取。
专属钉钉
- 应用AppKey、AppSecret
  在钉钉开放平台的基础信息页面获取应用AppKey、AppSecret。
- RobotCode
  在钉钉开放平台的机器人页面，查看凭证信息来获取RobotCode。
- 卡片模板ID
  在卡片平台的开发工具 > 卡片搭建页面获取。
飞书/Lark
在飞书开放平台或Lark开放平台的基础信息 > 凭证与基础信息页面获取AppId、AppSecret。

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

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

说明

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

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

登录数据管理DMS 5.0。
单击控制台左上角的图标，选择全部功能 > 运维管理 > 通知管理。
说明
若您使用的是非极简模式的控制台，请在顶部菜单栏中，选择运维管理 > 通知管理。
单击页面左上角的渠道管理。
选中目标通知渠道。
配置飞书、Lark、钉钉或专属钉钉所需的信息。
如下以配置飞书渠道信息举例，其他渠道配置操作与此示例类似。
1. 单击飞书渠道区域的编辑。
2. 输入AppId、AppSecret，单击保存。