钉钉如何设置单聊机器人的快捷入口?
版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。
设置钉钉单聊机器人快捷入口的方法有两种:
通过接口设置
钉钉提供了设置单聊机器人快捷入口的接口:
接口地址: https://oapi.dingtalk.com/chat/set_robot_shortcut
请求方法:POST
具体参数:
robot_userid:机器人的userid
name:快捷入口的名称
id:唯一的id,不同的快捷入口id不能重复
department:配置快捷入口的部门ID列表
通过该接口,可以将单聊机器人设置为指定部门的快捷入口。
在钉钉内设置
企业管理员也可以登录钉钉后台,在 「机器人管理」→「快捷入口」页面设置单聊机器人的快捷入口:
1)选择单聊机器人
2)设置快捷入口名称和ID
3)选择快捷入口生效的部门
当设置成功后,在钉钉的「工作台」→「部门」中会显示出该单聊机器人的快捷入口。
设置成快捷入口后,用户在打开对应部门时,会立即看见机器人的头像,方便用户与机器人直接交互。
调用「设置单聊机器人快捷入口」接口设置添加单聊机器人快捷入口。需要添加快捷入口名称、标题、PC端跳转链接和移动端跳转链接。接口请求方法为: POST /v1.0/robot/plugins/set HTTP/1.1 Host:api.dingtalk.com x-acs-dingtalk-access-token:String Content-Type:application/json { "robotCode" : "String", "pluginInfoList" : [ { "pcUrl" : "String", "mobileUrl" : "String", "name" : "String", "icon" : "String" } ] }
调用该接口需要企业内部应用的单聊机器人使用管理权限。接口返回参数为是否成功设置单聊机器人快捷入口。如果设置失败,会返回相应的错误码。此回答整理自钉群“钉钉开发者社区(互助群)”