十六说:“这是一篇关于‘钉钉开放平台——自定义机器人’的抄录笔记,并附上了个人项目”
1.获取自定义机器人
点击左上角自己的头像,点击机器人管理
,在机器人管理页面选择自定义机器人
,输入机器人名字并选择要发送消息的群。如果需要的话,可以为机器人设置一个头像,点击完成
。并复制机器人对应的Webhook地址。
2.使用自定义机器人
- 获取到Webhook地址后,用户可以使用任何方式访问这个地址发起HTTP POST请求,即可实现给群组发送消息。注意,发起POST请求时,必须要将字符集编码设置成UTF-8.
- 当前机器人支持文本(text)、连接(link)、markdown(markdown)三种消息类型,大家可以根据自己的使用场景选择合适的消息类型,达到最好的展示样式。
- 自定义机器人发送消息时,可以通过手机号指定“被@人列表”。在“被@人列表”里面的人员,在收到该消息时,会有@消息提醒。
3.消息类型及数据格式
3.1 文本类型(text)
文本类型
{
"msgtype": "text",
"text": {
"content": "我是陈十六,请多指教@156****16**"
},
"at": {
"atMobiles": [
"1825718XXXX"
],
"isAtAll": false
}
}
参数 | 必选 | 类型 | 说明 |
---|---|---|---|
msgtype | true | string | 此消息类型为固定text |
content | true | string | 内容消息 |
atMobiles | false | string | 被@人手机号 |
isAtall | false | bool | @所有人时为ture,否则为false |
3.2 link类型
{
"msgtype": "link",
"link": {
"text":"link是以连接的形式发送消息。",
"title": "连接的主题",
"picUrl": "",
"messageUrl": "复制的机器人的Webhoot"
}
}
参数 | 必选 | 类型 | 说明 |
---|---|---|---|
msgtype | true | string | 此消息类型为固定link |
title | true | string | 消息标题 |
text | true | string | 内容消息,如果太长只会显示一部分 |
messageUrl | true | string | 点击消息跳转的url |
picUrl | false |