钉钉设置：
开发文档：https://developers.dingtalk.com/document/app#/serverapi2/qf2nxq
1、创建钉钉机器人
钉钉群--群设置--智能群助手--添加机器人--自定义
钉钉的机器人基于webhook协议，webhook呢是一个api概念，是微服务api的使用范式之一，也被称为反向api，即前端不主动发送请求，完全由后端推送。
2、填写机器人信息
image.png
需要注意的是，在安全设置一栏里，我们选择加签的方式来验证。钉钉机器人的安全策略有三种：第一种是使用关键字，就是说推送的消息里必须包含创建机器人时定义的关键字，如果不包含就推送不了消息；第二种就是使用加密签名，第三种是定义几个ip源，非这些源的请求会被拒绝。综合来看，还是第二种又安全又灵活。
创建成功后，系统会分配一个webhook地址，这个地址需要保存一下，地址中有唯一的accesstoken，还有一个秘钥。
3、Python代码实现钉钉消息推送
Python第三方包之DingDingBot钉钉机器人实现消息推送，支持发文本格式、链接格式、markdown格式。
安装命令：pip install DingtalkChatbot
3.1、发送txt消息
from dingtalkchatbot.chatbot import DingtalkChatbot
webhook = 'https://oapi.dingtalk.com/robot/send?access_token=xxx'
secret = 'SEC4965fe94534b8933c57123167a546adxxxx'
#新版安全设置为‘加签’时，需要传入请求秘钥
#同时支持设置消息链接跳转方式，默认pc_slide_False为跳转到浏览器，pc_slide为在pc段侧边栏打开
#同时支持设置消息发送失败时提醒，默认fail_notice为False不提醒
xiaoding = DingtalkChatbot(webhook,secret=secret,pc_slide=True,fail_notice=True)
#text
xiaoding.send_text(msg='哈哈哈',is_at_all=False)
3.2、发送发送txt消息 @指定人
# 用户手机号列表
at_mobiles = ['15623728888'] #这里填@的人的手机号，可自定义@的位置，默认添加在消息末尾
xiaoding.send_text(msg='你好啊！', at_mobiles=at_mobiles)
3.3、发送Link消息
# link
xiaoding.send_link(title='ITester软件测试小栈所有历史文章',
text='点击查收！',
message_url='https://mp.weixin.qq.com/mp/profile_ext?action=home&__biz=MzI5MTg1NjA4Nw==#wechat_redirect',
pic_url='http://wx.qlogo.cn/mmhead/Q3auHgzwzM6h0QgTMSjYavc1h3yODa0xnS5iaI09GXpM49gpncZcYhw/132')
3.4、发送图片消息
# image
xiaoding.send_image(pic_url='https://baike.baidu.com/pic/%E4%B8%8A%E7%8F%AD/79978/1/5243fbf2b2119313043a69bb6b380cd791238d44?fr=lemma&ct=single#aid=1&pic=5243fbf2b2119313043a69bb6b380cd791238d44')
3.5、发送Markdown消息给所有人
# markdown 提醒所有人
xiaoding.send_markdown(title='邹工的机器人提醒', text='9月16日早上好，摸鱼人，今天比昨天又少了一天，工作再累，一定不要忘记摸鱼哦\n'
'> 距离中秋假期还有 2 天\n\n'
'> 距离国庆假期还有 15 天\n\n'
'> 距离元旦还有 106 天\n\n'
'> 距离春节假期还有 138天\n\n',
is_at_all=True)
3.6、 ActionCard整体跳转消息类型
# 整体跳转ActionCard
btns1 = [CardItem(title="查看详情", url="https://mp.weixin.qq.com/mp/profile_ext?action=home&__biz=MzI5MTg1NjA4Nw==#wechat_redirect")]
actioncard1 = ActionCard(title='ITester软件测试小栈',
text=' \n### 扫码可查看ITester软件测试小栈历史文章',
btns=btns1,
btn_orientation=1,
hide_avatar=1)
xiaoding.send_action_card(actioncard1)
3.7、ActionCard单独跳转消息（两个按钮选择）
# 单独跳转ActionCard
# 1、两个按钮选择
btns2 = [CardItem(title="点赞👍", url="https://mp.weixin.qq.com/mp/profile_ext?action=home&__biz=MzI5MTg1NjA4Nw==#wechat_redirect"),
CardItem(title="比心❤️", url="https://mp.weixin.qq.com/mp/profile_ext?action=home&__biz=MzI5MTg1NjA4Nw==#wechat_redirect")]
actioncard2 = ActionCard(title='查看详情',
text=' \n### 扫码可查看ITester软件测试小栈历史文章',
btns=btns2,
btn_orientation=1,
hide_avatar=1)
xiaoding.send_action_card(actioncard2)
3.8、ActionCard单独跳转消息（三个按钮选择）
# 2、三个按钮选择
btns3 = [CardItem(title="点赞👍", url="https://mp.weixin.qq.com/mp/profile_ext?action=home&__biz=MzI5MTg1NjA4Nw==#wechat_redirect"),
CardItem(title="星标✨", url="https://mp.weixin.qq.com/mp/profile_ext?action=home&__biz=MzI5MTg1NjA4Nw==#wechat_redirect"),
CardItem(title="比心❤️", url="https://mp.weixin.qq.com/mp/profile_ext?action=home&__biz=MzI5MTg1NjA4Nw==#wechat_redirect")]
actioncard3 = ActionCard(title='查看详情',
text=' \n### 扫码可查看ITester软件测试小栈历史文章',
btns=btns3,
btn_orientation=1,
hide_avatar=1)
xiaoding.send_action_card(actioncard3)
3.9、FeedCard消息类型
# FeedCard消息类型（注意：当发送FeedCard时，pic_url需要传入参数值，必选）
card1 = CardItem(title="ITester软件测试小栈历史文章", url="https://mp.weixin.qq.com/mp/profile_ext?action=home&__biz=MzI5MTg1NjA4Nw==#wechat_redirect", pic_url="https://mmbiz.qpic.cn/mmbiz_gif/9RdLdzUL98hSxnicLQUHJlRh6jE5bJOOOK5gpQSEsjgibnDKGrDic6AL1yUmyAmkn638fQvDGDroQkEHnib6iaOSAEg/640?wx_fmt=gif&tp=webp&wxfrom=5&wx_lazy=1")
card2 = CardItem(title="精选文章", url="https://mp.weixin.qq.com/mp/profile_ext?action=home&__biz=MzI5MTg1NjA4Nw==#wechat_redirect", pic_url="http://wx.qlogo.cn/mmhead/Q3auHgzwzM6h0QgTMSjYavc1h3yODa0xnS5iaI09GXpM49gpncZcYhw/132")
card3 = CardItem(title="热门文章", url="https://mp.weixin.qq.com/mp/profile_ext?action=home&__biz=MzI5MTg1NjA4Nw==#wechat_redirect", pic_url="http://wx.qlogo.cn/mmhead/Q3auHgzwzM6h0QgTMSjYavc1h3yODa0xnS5iaI09GXpM49gpncZcYhw/132")
cards = [card1, card2, card3]
xiaoding.send_feed_card(cards)
