python dingding --- 钉钉机器人API

dingding — 钉钉机器人

github 源码地址：https://github.com/zly717216/dingding

一、模块介绍

版本号

dingding: V1.0.0

功能

当前版本支持群机器人相关API调用，包括发送文本消息、文本链接、markdown、整体跳转 ActionCard、独立跳转 ActionCard、FeedCard。

文本消息类型

文本链接类型

markdown 类型

整体跳转 ActionCard类型

独立跳转 ActionCard 类型

FeedCard 类型

如何使用

• 1.创建钉钉群
• 2.创建机器人，复制 webhook，如：https://oapi.dingtalk.com/robot/send?access_token=xxxxx
• 3.调用机器人API，示例见下文

安装

将 dingding 包复制到 site-pakages 下

二、示例

设置token

方式一：

from dingding import set_token


# 机器人的token是webhook中的 access_token 参数
set_token('xxx')
1
2
3
4
5

方式二：

from dingding import Robot     # Robot 是一个机器人实例对象


Robot.set_token('xxx')
1
2
3
4

方式三：

from dingding import R        # R 是一个机器人类对象


r = R()
r.set_token('xxx')
1
2
3
4
5

查看token

方式一：

from dingding import Robot


print(Robot.token)
1
2
3
4

方式二：

from dingding import R


r = R()
print(r.token)
1
2
3
4
5

设置关键词

方式一：

from dingding import set_key_word


# 机器人的关键词是创建群聊机器人时自己添加的，不包含其中一个关键词消息无法发出
# set_key_word('xxx')
set_key_word(['xxx1', 'xxx2'])
1
2
3
4
5
6

方式二：

from dingding import Robot     # Robot 是一个机器人实例对象


# Robot.set_key_word('xxx')
Robot.set_key_word(['xxx1', 'xxx2'])
1
2
3
4
5

方式三：

from dingding import R        # R 是一个机器人类对象


r = R()
# r.set_key_word('xxx')
r.set_key_word(['xxx1', 'xxx2'])
1
2
3
4
5
6

查看关键词

方式一：

from dingding import Robot


print(Robot.key_word)
1
2
3
4

方式二：

from dingding import R


r = R()
print(r.key_word)
1
2
3
4
5

设置开头模板

方式一：

from dingding import set_token


# 设置消息的开头模板，例如：提示时间
set_tpl('xxx')
1
2
3
4
5

方式二：

from dingding import Robot     # Robot 是一个机器人实例对象


Robot.set_tpl('xxx')
1
2
3
4

方式三：

from dingding import R        # R 是一个机器人类对象


r = R()
r.set_tpl('xxx')
1
2
3
4
5

发送文本消息

from dingding import Robot


Robot.send_text('hello word')
# @张三
Robot.send_text('hello word', at_user_ids=['zhangsan'])
# @所有人
Robot.send_text('hello word', at_all=True)
1
2
3
4
5
6
7
8

发送Markdown消息

from dingding import Robot


Robot.send_markdown(title='this is a markdown message', text='**加粗hello world**')
1
2
3
4

发送整体跳转 ActionCard 消息

from dingding import Robot


Robot.send_overall_card(title='this is a markdown message', text='**加粗hello world**', link='https://www.baidu.com')
1
2
3
4

发送独立跳转 ActionCard 消息

from dingding import Robot


Robot.send_dependent_card(
   title='this is a markdown message', 
   text='**加粗hello world**',
   buttons=[
      {
         "title": "内容不错",
         "actionURL": "https://www.dingtalk.com/"
      },
      {
         "title": "不感兴趣",
         "actionURL": "https://www.dingtalk.com/"
      }
   ]
)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

发送 FeedCard 消息

from dingding import Robot


Robot.send_feed_card(
    title_list=['时代的火车向前开1', '时代的火车向前开2'],
    message_url_list=[
       'https://www.dingtalk.com/', 
       'https://www.dingtalk.com/'
    ],
    pic_url_list=[
       'https://img.alicdn.com/tfs/TB1NwmBEL9TBuNjy1zbXXXpepXa-2400-1218.png', 
       'https://img.alicdn.com/tfs/TB1NwmBEL9TBuNjy1zbXXXpepXa-2400-1218.png'
    ],
)
1
2
3
4
5
6
7
8
9
10
11
12
13
14

三、API

dingding 模块 API

Robot API

Robot API 参数

set_token 参数：

set_key_word 参数：

set_tpl 参数：

send_text 参数：

send_markdown 参数：

send_link 参数：

send_overall_card 参数：

send_dependent_card 参数：

buttons 参数字段说明：

• botton 构造参数示例：

[
   {
      "title": "内容不错",
      "actionURL": "https://www.dingtalk.com/"
   },
   {
      "title": "不感兴趣",
      "actionURL": "https://www.dingtalk.com/"
   }
]
1
2
3
4
5
6
7
8
9
10

send_feed_card 参数：

下一篇 python wechat — 企业微信机器人API