当前位置：首页 > news >正文

每日钉钉API探索：createDing一键发起DING消息

news 2025/7/18 14:30:18

在企业协作中，及时提醒和任务分发至关重要。今天我们要介绍的是钉钉提供的 createDing 接口，它允许你一键唤起DING消息、任务、日程等创建界面，帮助用户快速发起重要通知或任务提醒。

📌 功能概述

createDing 是一个非常实用的接口，用于调起钉钉客户端的 DING 发送界面，用户可以在该界面中填写内容、选择附件、设置提醒方式等。它不直接发送DING，而是唤起客户端界面，让用户进行最终确认和操作。

适用于：

发起紧急通知（DING消息）
创建日程提醒
分配任务给指定人员
附带图片或链接内容

💻 支持平台

平台	版本要求
Android	✅ 6.0.0+
iOS	✅ 6.0.0+
Harmony	✅ 7.0.0+
Mac	❌ 不支持
Windows	❌ 不支持

说明：目前该接口仅支持移动端（包括H5微应用和小程序），不支持桌面端。

📲 应用类型支持

应用类型	是否支持调用
企业内部应用	✅
第三方企业应用	✅
第三方个人应用	✅

🔐 鉴权规则

H5 应用：需通过 dd.config 完成鉴权后使用。
小程序应用：无需鉴权，可直接调用。

⚙️ 参数说明

继承通用输入对象，并扩展以下关键参数：

参数名	类型	必填	示例值	描述
`users`	Array	✅	`["03333", "04333"]`	接收DING的用户ID列表。
`text`	String	否	`"钉消息内容"`	DING消息正文内容。
`type`	Number	否	`1`	附件类型： 1：图片 2：链接
`alertType`	Number	否	`1`	提醒方式： 0：电话 1：短信 2：应用内
`alertDate`	Object	否	`{ value: '2015-05-09 08:00', format: 'yyyy-MM-dd HH:mm' }`	提醒时间。
`attachment`	Object	否	`{ images: ['https://xxx.com/example1.png'] }`	附件信息，如图片链接。
`confInfo`	Object	否	日程信息对象	用于创建日程时的配置。
`taskInfo`	Object	否	任务信息对象	用于创建任务时的配置。
`corpId`	String	H5微应用必填	`"ding12345"`	企业CorpID。

📤 返回结果

继承通用输出对象，无扩展字段，调用成功时返回空对象，失败时返回错误信息。

🛠 使用示例代码

dd.createDing({text: '这是一条DING消息内容',type: 1, // 图片附件类型users: ['03333', '04333'],corpId: 'ding12345', // H5应用必填alertType: 1, // 短信提醒alertDate: {value: '2025-07-18 10:00',format: 'yyyy-MM-dd HH:mm'},attachment: {images: ['https://example.com/image1.jpg']},confInfo: {startTime: {value: '2025-07-18 10:30',format: 'yyyy-MM-dd HH:mm'},endTime: {value: '2025-07-18 11:30',format: 'yyyy-MM-dd HH:mm'},location: '线上会议',remindType: 2,remindMinutes: 10},taskInfo: {deadlineTime: {value: '2025-07-20 18:00',format: 'yyyy-MM-dd HH:mm'},ccUsers: ['100', '101'],taskRemind: 60},success: function () {console.log('DING界面已打开');},fail: function (err) {console.error('调用失败:', err);},complete: function () {console.log('操作完成');}
});

🎯 典型使用场景

场景	说明
紧急通知	向指定用户发送DING消息并设置短信或电话提醒。
任务分发	调起任务创建界面，指定接收人、截止时间、抄送人等。
日程安排	快速唤起日程界面，预填时间、地点等信息。
带附件通知	附加图片或链接，增强信息表达。