人与人会话中机器人发送互动卡片

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

调用本接口实现人与人会话中机器人发送互动卡片。

说明

调用本接口前，确保已完成创建和安装企业内部机器人，请参考企业内部应用机器人的创建和安装--人与人单聊（中间存在机器人）。

接口功能介绍

调用本接口，开通实现发送互动卡片。具体示例如下图所示。

卡片特殊能力用法

循环组件用法：内容塞入

会话列表lastMessage显示：

什么是lastmessage 指的是在会话列表页面透出的消息

设置特殊key：sys_lastMessageI18n。

value值：

{\"zh_CN\":\"蚂蚁分工\",\"zh_TW\":\"螞蟻分工\",\"zh_HK\":\"螞蟻分工\",\"ja_JP\":\"アリの分業\",\"en_US\":\"Ant division of labor\"}"

举例说明：

"cardData": { "cardParamMap": { "sys_lastMessageI18n": "{\"zh_CN\":\"蚂蚁分工\",\"zh_TW\":\"螞蟻分工\",\"zh_HK\":\"螞蟻分工\",\"ja_JP\":\"アリの分業\",\"en_US\":\"Ant division of labor\"}"}}

权限

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

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

错误码

HttpCode	错误码	错误信息	说明
400	param.empty	入参为空	入参为空
400	callbackUrl.empty	回调地址为空	回调地址为空
400	param.invalid	无效参数	无效参数
400	permission.checkFailed	发送动态卡片权限校验失败	发送动态卡片权限校验失败
400	queryChatbot.wrong	查询机器人失败	查询机器人失败
400	cardInstance.wrong	创建卡片实例失败，先检查卡片模板是否已发布	创建卡片实例失败，先检查卡片模板是否已发布
400	cidParse.wrong	单聊会话ID解码失败	单聊会话ID解码失败
400	card.templateEmpty	卡片模板ID为空	卡片模板ID为空
400	userInfo.convertError	消息接收者UID解码错误	消息接收者UID解码错误
400	card.outTraceIdError	卡片业务标识信息格式非法	卡片业务标识信息格式非法
400	card.outTraceIdEmpty	业务标识outTrackId为空	业务标识outTrackId为空
400	chatbot.notFound	机器人不存在	机器人不存在
400	invalidParameter.cid.empty	单聊会话id为空	单聊会话id为空
400	sendCardMessageFailed	发送卡片失败	发送卡片失败
400	duplicateKey	卡片模板占位符有重复Key	卡片模板占位符有重复Key
400	getPictureFailed	获取图片url失败	获取图片url失败
400	org.notOwn.group	单聊会话不属于当前企业	单聊会话不属于当前企业
400	send.oa.timeout	发工作通知超时，请稍后重试	发工作通知超时，请稍后重试
400	outTrackId.exceed.limit	outTrackId长度超限	outTrackId长度超限
500	systemBusy	系统繁忙	系统异常错误
500	systemError	系统错误	系统错误

curl --location --request POST 'https://api.dingtalk.com/v1.0/im/privateChat/interactiveCards/send' \ --header 'x-acs-dingtalk-access-token;' \ --header 'Content-Type: application/json' \ --data-raw 'POST /v1.0/im/privateChat/interactiveCards/send HTTP/1.1 Host:api.dingtalk.com x-acs-dingtalk-access-token:String Content-Type:application/json { "cardTemplateId" : "String", "openConversationId" : "String", "receiverUserIdList" : [ "String" ], "outTrackId" : "String", "robotCode" : "String", "callbackRouteKey" : "String", "cardData" : { "cardParamMap" : { "key" : "String" } }, "privateData" : { "key" : { "cardParamMap" : { "key" : "String" } } }, "userIdType" : Integer, "atOpenIds" : { "key" : "String" }, "cardOptions" : { "supportForward" : Boolean }, "pullStrategy" : Boolean }'

人与人会话中机器人发送互动卡片

接口功能介绍

卡片特殊能力用法

权限

错误码

请求参数

返回响应

人与人会话中机器人发送互动卡片

接口功能介绍#

卡片特殊能力用法#

权限#

错误码#

请求参数

返回响应

接口功能介绍

卡片特殊能力用法

权限

错误码