最近疫情,各种视频和通信工具火了,微信不能9个人以上进行视频会议(好像改进了)。刚开年用的是钉钉来开会,刚好年前又用了下钉钉的Py接口,昨天搞硬件没写,所以今天把前面用钉钉剩下的一些问题翻出来,重新用下,后面AI优化好了可以作为及时通信接口。

钉钉的py封装推荐https://pypi.org/project/DingtalkChatbot/

不知道是大神开发,还是和阿里有渊源,看源码是作者devin,大神照片

python 抓取钉钉 python调用钉钉接口_git

好,言归正传,有兴趣自行研究。

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,打字目前最多的一次,终有一日我要搞出需要的富文本。