发送轻量级互动卡片

接口调用量说明钉钉标准版接口累计可调用次数为1万次/月，当前接口会消耗调用次数。若该调用量无法满足需求，你可升级钉钉专业版(Open API调用量50万次/月)或钉钉专属版(Open API调用量500万次/月)扩容调用次数。

调用本接口发动轻量级互动卡片消息。

说明

轻量级互动卡片是钉钉开放平台提供的一个新的接入方式，通过此模板你将不再需要调试模板，不用关心卡片点击事件处理。在用户点击互动卡片之后，开放平台会以事件订阅的形式将互动内容发送给你。此事件拥有重试的机制，直至得到有效响应。

调用本接口，实现发送轻量级互动卡片，具体示例，如下图。

权限

要调用此API，需要以下权限之一。

应用类型	是否支持	权限	API Explorer调试
企业内部应用	支持	chat相关接口的管理权限	API Explorer
第三方企业应用	支持	chat相关接口的管理权限	API Explorer
第三方个人应用	暂不支持	chat相关接口的管理权限	暂不支持

错误码

HttpCode	错误码	错误信息	说明
400	queryEmployInfoFailed	查询企业员工信息失败	查询企业员工信息失败
400	invalidParameter	无效的参数	无效的参数
400	notEmptyParameter	缺失必填的参数	缺失必填的参数
400	emptyUserId	用户ID为空	用户ID为空
400	decryptOpenconversationIdFailed	群ID解码失败	群ID解码失败
400	contentSecurityChckFailed	卡片内容不符合安全规范	卡片内容不符合安全规范
400	cardTemplateInvalid	卡片模板无效	卡片模板无效
400	chatbotNotInstall	机器人未安装	机器人未安装
400	userNotExist	用户不存在	用户不存在
400	invalidParameter.param.empty	入参为空	入参为空
400	invalidParameter.cid.empty	群id为空	群id为空
400	invalidParameter.cardTemplate.notFound	不存在的卡片模板	不存在的卡片模板
400	paramBlank	请求参数为空	请求参数为空
400	sendCardMessageFailed	发送卡片失败	发送卡片失败
400	cidDecryptError	群ID解析失败	群ID解析失败
400	sceneGroupNotFound	非场景群	非场景群
400	chatbotNotFound	不存在的机器人	不存在的机器人
400	uidDecryptError	消息接收者UID解码错误	消息接收者UID解码错误
400	duplicateKey	卡片模板占位符有重复Key	卡片模板占位符有重复Key
400	getPictureFailed	获取图片url失败	获取图片url失败
400	contentCheckError	卡片内容校验失败	卡片内容校验失败
400	outTrackIdLengthLimited	超过卡片业务标识信息长度	超过卡片业务标识信息长度
500	systemBusy	系统繁忙	系统异常错误

curl --location --request POST 'https://api.dingtalk.com/v1.0/im/interactiveCards/templates/send' \ --header 'x-acs-dingtalk-access-token;' \ --header 'Content-Type: application/json' \ --data-raw '{ "cardTemplateId" : "String", "openConversationId" : "String", "singleChatReceiver" : "String", "outTrackId" : "String", "robotCode" : "String", "callbackUrl" : "String", "cardData" : "String", "sendOptions" : { "atUserListJson" : "String", "atAll" : Boolean, "receiverListJson" : "String", "cardPropertyJson" : "String" } }'

发送轻量级互动卡片

权限#

错误码#

请求参数

返回响应

权限

错误码