钉钉互动卡片对接-普通互动卡片接入流程

news2024/11/15 11:16:52

这里写目录标题

- - 一、创建内部应用
  - 二、搭建普通卡片模板
  - 三、调用互动卡片服务端接口
  - 接口报文
  - - 一、发送卡片
    - 二、更新卡片
    - 三、获取token

一、创建内部应用

登录开发者后台，创建内部应用。例如百度-内部测试
获取AppKey和AppSecret，获取应用访问凭证获取企业内部应用的access_token。调试
申请机器人接口权限，搜索“机器人”，选择机器人相关接口权限并申请。

二、搭建普通卡片模板

登录互动卡片普通版搭建平台，搭建卡片模板。

在这里插入图片描述

 {
    "singleChatReceiver":"{\"userId\":\"ceshi.xut\"}",
    "cardData":"{   \"config\": {     \"autoLayout\": true,     \"enableForward\": true   },   \"header\": {     \"title\": {       \"type\": \"text\",       \"text\": \"钉钉卡片\"     },     \"logo\": \"@lALPDfJ6V_FPDmvNAfTNAfQ\"   },   \"contents\": [     {       \"type\": \"text\",       \"text\": \"测试钉钉卡片\",       \"id\": \"text_1705996981881\"     }   ] }",
    "cardBizId":"123914144413",
    "cardTemplateId":"StandardCard",
    "callbackUrl":" ",
    "robotCode":"dingchqvg2j6rbwx8msb"
}

三、调用互动卡片服务端接口

1.调用新版服务端API-机器人发送互动卡片接口，实现发送卡片信息。API Explorer

注意：下面箭头是 json 格式

在这里插入图片描述

2.根据cardBizId卡片标识ID，调用新版服务端API-更新机器人发送互动卡片接口，实现更新卡片内容。

把钉钉测试卡片修改为钉钉测试卡片 1
在这里插入图片描述

发送卡片时，附带回调 url ，可以接收钉钉的回调，然后调用更新卡片接口，更新卡片消息

接口报文

一、发送卡片

url:  https://api.dingtalk.com/v1.0/im/v1.0/robot/interactiveCards/send
method: post
header:
 {
    "x-acs-dingtalk-access-token":"165c38d896533629815fca2e2aa38d02"
}
body:
 {
    "singleChatReceiver":"{\"userId\":\"ceshi.x\"}",
    "cardData":"{   \"config\": {     \"autoLayout\": true,     \"enableForward\": true   },   \"header\": {     \"title\": {       \"type\": \"text\",       \"text\": \"钉钉卡片\"     },     \"logo\": \"@lALPDfJ6V_FPDmvNAfTNAfQ\"   },   \"contents\": [     {       \"type\": \"text\",       \"text\": \"测试钉钉卡片\",       \"id\": \"text_1705996981881\"     }   ] }",
    "cardBizId":"123914144413",
    "cardTemplateId":"StandardCard",
    "callbackUrl":" ",
    "robotCode":"dingchqvg2j6rbwx8msb"
}

二、更新卡片

url:  https://api.dingtalk.com/v1.0/im/robots/interactiveCards
method: put
header:
 {
    "x-acs-dingtalk-access-token":"165c38d896533629815fca2e2aa38d02"
}
body:
 {
    "cardData":"{   \"config\": {     \"autoLayout\": true,     \"enableForward\": true   },   \"header\": {     \"title\": {       \"type\": \"text\",       \"text\": \"钉钉卡片\"     },     \"logo\": \"@lALPDfJ6V_FPDmvNAfTNAfQ\"   },   \"contents\": [     {       \"type\": \"text\",       \"text\": \"测试钉钉卡片\",       \"id\": \"text_1705996981881\"     }   ] }",
    "cardBizId":"123914144413",
    "updateOptions":{
        "updateCardDataByKey":true
    }
}
response: