一、创建钉钉群聊
钉钉自定义机器人只能在桌面版添加和设置参数,博主使用的是Windows 10系统,如果你使用的是其他系统可以去钉钉官网下载对应的桌面版本。创建群聊需要3人或以上,拉上你要好的朋友就可以开始添加机器人测试了(要做好被打的准备,因为测试的时候会一直“Ding、Ding、Ding”通知)也可以创建完成群后把朋友踢出群,这样就可以没有顾虑的开始测试了。
二、添加自定义机器人
第一步、打开群设置,点击智能群助手
第二步、点击添加机器人
第三步、选择自定义机器人(通过Webhook接入自定义服务)
到了这步就要开始填写机器人参数了
三、获取自定义机器人webhook
步骤一,在机器人管理页面选择“自定义”机器人,输入机器人名字并选择要发送消息的群,同时可以为机器人设置机器人头像。
步骤二,完成必要的安全设置(至少选择一种),勾选 我已阅读并同意《自定义机器人服务及免责条款》,点击“完成”。安全设置目前有3种方式,设置说明见下文介绍。
萌新我推荐只使用自定义关键词
这里我设置了两个关键词,分别是V和S,只有发送的消息内容包含V或着S的关键词才会被正常发送
你可以自定义关键词内容,参数填写完成后勾选我已阅读并同意然后点击完成
**这时你会听见“Ding”的一声,那么恭喜你,已经完成了机器人的创建
步骤三,完成安全设置后,复制出机器人的Webhook地址,可用于向这个群发送消息,格式如下:
至此,你就完成了机器人创建的所有部分,一定要记得复制Webhook,它是控制机器人的“钥匙”,后面的HTTP POST 请求需要使用
四、使用自定义机器人
注意事项
(1)获取到Webhook地址后,用户可以向这个地址发起HTTP POST 请求,即可实现给该钉钉群发送消息。注意,发起POST请求时,必须将字符集编码设置成UTF-8。
(2)当前自定义机器人支持文本 (text)、链接 (link)、markdown(markdown)、ActionCard、FeedCard消息类型,大家可以根据自己的使用场景选择合适的消息类型,达到最好的展示样式。
(3)自定义机器人发送消息时,可以通过手机号码指定“被@人列表”。在“被@人列表”里面的人员收到该消息时,会有@消息提醒(免打扰会话仍然通知提醒,首屏出现“有人@你”)。
(4)当前机器人尚不支持应答机制 (该机制指的是群里成员在聊天@机器人的时候,钉钉回调指定的服务地址,即Outgoing机器人)。
操作步骤
官方推荐使用命令行工具curl,Windows10是内置了curl命令行工具,无需自己配置环境就可以使用
为避免出错,请将以下命令直接复制到命令行,再将xxxxxxxx替换为真实access_token;若测试出错,请检查复制的命令是否和测试命令一致,多特殊字符会报错
curl ‘https://oapi.dingtalk.com/robot/send?access_token=xxxxxxxx’
-H ‘Content-Type: application/json’
-d ‘{“msgtype”: “text”,
“text”: {
“content”: “我就是我, 是不一样的烟火”
}
}’
五、配置通知
获取到的 https://oapi.dingtalk.com/robot/send?access_token=xxxxxxxx 如下图填写,并开启钉钉通知,当拦截到非法访问,钉钉消息会发送通知提醒