最近疫情,各种视频和通信工具火了,微信不能9个人以上进行视频会议(好像改进了)。刚开年用的是钉钉来开会,刚好年前又用了下钉钉的Py接口,昨天搞硬件没写,所以今天把前面用钉钉剩下的一些问题翻出来,重新用下,后面AI优化好了可以作为及时通信接口。
钉钉的py封装推荐https://pypi.org/project/DingtalkChatbot/
不知道是大神开发,还是和阿里有渊源,看源码是作者devin,大神照片
好,言归正传,有兴趣自行研究。
1.首先注册一个钉钉号
登入后增加一个dingding机器人,选择设置。
在电脑端登录,设置dingding机器人(手机不行),基本设计没啥,主要安全设置,有3个选项,我选择关键字,其他几个可以自行尝试。安全功能主要是官方为了防止信息发送泛滥来约束机器人行为的,我设了关键字,那么在py端,通过py发送的text必须以关键字开头,才能被发送出去,否者提示关键字错误。
2.记录机器人的webhook号
作为机器人的身份证,带着hook号的信息才能被发出
3.创建PY程序
3.1导入模块
from dingtalkchatbot.chatbot import DingtalkChatbot, is_not_null_and_blank_str, ActionCard, FeedLink, CardItem
这里有个坑,git官方只导入了第一个DingtalkChatbot,但是例子中的CardItem需要在这里导入,否者报错。git中example官方例子就是上面全部导入的,这是git的readme遗漏地方
3.2 实例化chatbot
xiaoding = DingtalkChatbot(webhook)
这问题不大,webhook就是2中的机器人号
3.3发送text
因为我在1中设定的安全关键字是“py:”,所以我发送的text的msg中,必须以这个开头
# Text消息@所有人
xiaoding.send_text(msg='py:我就是py,py就是我!', is_at_all=True)
这个at一个人和at所有人都没问题,被at的话在手机上会多出一个回复选项
3.4发送img
因为加入关键字,所以发送img不行,只有用以下方法
3.5发送link
没问题,要注意text不能为空,关键字应该加入到title中,这个地方可以加入外网的图片地址,相当于发图片
3.6发送Markdown
这个功能最好,以官方例子
# Markdown消息@所有人
xiaoding.send_markdown(title='氧气文字', text='#### 广州天气\n'
'> 9度,西北风1级,空气良89,相对温度73%\n\n'
'> ![美景](http://www.sinaimg.cn/dy/slidenews/5_img/2013_28/453_28488_469248.jpg)\n'
'> ###### 10点20分发布 [天气](http://www.thinkpage.cn/) \n',
is_at_all=True)
- title
需要改为带关键字的,
- text
##加一个空格:是标识字体为几级标题,对应效果为加粗字体变大,后面空格不能省,这个应该是markdown富文本编辑器的语法(没空研究了,虽然一直对实现这个功能很眼馋),这个最好保留。
>加一个空格,是让显示左边有条淡色的竖线,这样看起来很工整(大神对API很熟啊)
![]():分开说,!是外部解释器,如果不加!,那么后面一堆出来的就是那个网址的文本,如果加了,钉钉里面显示的就是解析的图片,我试了下本地图片不行,所以是个外部图片解释器,可以用网上图片地址;[]这个里面填写的是超链接显示字符,如果前面带了!作为解释器,那么【】里面的内容就会省掉,dingding消息里面看不到字符显示;最后是(),里面就是超链接
- text续
如果每次改text很麻烦,在py头上申明变量,让text=变量同样好使
- is_at_all
跟text类似,等于true直接好使,
- at_mobiles
这个功能感觉还有待完善,源码注释首先有个小问题,和_ids写反了,应该是@的手机号,要带入到text中。所以尴尬了,要@的人不能跟发text一样,不仅需要在at_mobles=xx,还得在text中@xx,如果事先声明过一个mobiles变量,那么就得变量=手机号,text@手机号,at_mobils=变量名。如
Markdown消息@指定用户
at_mobiles_id=['199XXXX']
xiaoding.send_markdown(title='py:氧气文字', text='##### 广州天气 @199XXXX\n',
at_mobiles=at_mobiles_id)
这就很尴尬了,每次发消息还得把用户带进去。
边写边又尝试了下。
at_mobiles_id=['199xxxx']
xiaoding.send_markdown(title='py:氧气文字', text='##### 广州天气 \n'+'@'+at_mobiles_id[0],
at_mobiles=at_mobiles_id)
这样将text和电话切片开,实测OK,电话号需要用list类型,所以【0】不能省掉。
3.7发送feedcard信息
我的理解就是发送列表,发送没什么问题。官方里面的图片网址过期了,所以发送显示不出来,重新找一个就没问题了。另外官方
http://www.thinkpage.cn/
天气地址也过期了,需要换成
http://www.seniverse.com/
所以git官方还是用稳定图床当索引的好,不然像我这种新手第一次用,出错了之后一脸懵逼,最后好不容易才查出链接失效。
actioncard没去研究,目前im软件有这些基本功能就够了,太复杂反而脱离im的本质了。
OK,打字目前最多的一次,终有一日我要搞出需要的富文本。