python dingding --- 钉钉机器人API
2024-06-04 17:05:10
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')
方式二：
from dingding import Robot # Robot 是一个机器人实例对象Robot.set_token('xxx')
方式三：
from dingding import R # R 是一个机器人类对象r = R()
r.set_token('xxx')
查看token
方式一：
from dingding import Robotprint(Robot.token)
方式二：
from dingding import Rr = R()
print(r.token)
设置关键词
方式一：
from dingding import set_key_word# 机器人的关键词是创建群聊机器人时自己添加的，不包含其中一个关键词消息无法发出
# set_key_word('xxx')
set_key_word(['xxx1', 'xxx2'])
方式二：
from dingding import Robot # Robot 是一个机器人实例对象# Robot.set_key_word('xxx')
Robot.set_key_word(['xxx1', 'xxx2'])
方式三：
from dingding import R # R 是一个机器人类对象r = R()
# r.set_key_word('xxx')
r.set_key_word(['xxx1', 'xxx2'])
查看关键词
方式一：
from dingding import Robotprint(Robot.key_word)
方式二：
from dingding import Rr = R()
print(r.key_word)
设置开头模板
方式一：
from dingding import set_token# 设置消息的开头模板，例如：提示时间
set_tpl('xxx')
方式二：
from dingding import Robot # Robot 是一个机器人实例对象Robot.set_tpl('xxx')
方式三：
from dingding import R # R 是一个机器人类对象r = R()
r.set_tpl('xxx')
发送文本消息
from dingding import RobotRobot.send_text('hello word')
# @张三
Robot.send_text('hello word', at_user_ids=['zhangsan'])
# @所有人
Robot.send_text('hello word', at_all=True)
发送Markdown消息
from dingding import RobotRobot.send_markdown(title='this is a markdown message', text='**加粗hello world**')
发送整体跳转 ActionCard 消息
from dingding import RobotRobot.send_overall_card(title='this is a markdown message', text='**加粗hello world**', link='https://www.baidu.com')
发送独立跳转 ActionCard 消息
from dingding import RobotRobot.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/"}]
)
发送 FeedCard 消息
from dingding import RobotRobot.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'],
)
三、API
dingding 模块 API
| API | 说明 |
|---|---|
| R | 机器人类对象 |
| Robot | 机器人实例对象 |
| set_token | 给机器人实例设置token |
| set_key_word | 给机器人实例设置关键词 |
| set_tpl | 给机器人实例设置开头模板 |
Robot API
| API | 说明 |
|---|---|
| set_token | 给机器人实例设置token |
| set_key_word | 给机器人实例设置关键词 |
| set_tpl | 给机器人实例设置开头模板 |
| send_text | 发送文本消息 |
| send_markdown | 发送markdown文本消息 |
| send_overall_card | 发送图片消息 |
| send_dependent_card | 发送图片文本 |
| send_feed_card | 发送文件 |
Robot API 参数
set_token 参数：
| 参数 | 类型 | 说明 |
|---|---|---|
| token | 列表 | token，webhook中的key参数 |
set_key_word 参数：
| 参数 | 类型 | 说明 |
|---|---|---|
| key_word | 列表 | 关键词，机器人的关键词是创建群聊机器人时自己添加的，不包含其中一个关键词消息无法发出 |
set_tpl 参数：
| 参数 | 类型 | 说明 |
|---|---|---|
| tpl | 列表 | 开头模板 |
send_text 参数：
| 参数 | 类型 | 说明 |
|---|---|---|
| text | 字符串 | 消息内容 |
| at_all | bool | @all |
| at_user_ids | 列表 | userid的列表，提醒群中的指定成员(@某个成员)。如：[‘zhangsan’, ‘lisi’] |
| at_mobiles | 列表 | 手机号列表，提醒手机号对应的群成员(@某个成员) 如：[‘19912345678’] |
| index | int | 关键词索引，如果设置了多个关键词，index 表示用第几个官籍此发消息 |
send_markdown 参数：
| 参数 | 类型 | 说明 |
|---|---|---|
| title | 字符串 | 消息标题 |
| text | 字符串 | 消息内容 |
| at_all | bool | @all |
| at_user_ids | 列表 | userid的列表，提醒群中的指定成员(@某个成员)。如：[‘zhangsan’, ‘lisi’] |
| at_mobiles | 列表 | 手机号列表，提醒手机号对应的群成员(@某个成员) 如：[‘19912345678’] |
| index | int | 关键词索引，如果设置了多个关键词，index 表示用第几个官籍此发消息 |
send_link 参数：
| 参数 | 类型 | 说明 |
|---|---|---|
| title | 字符串 | 图片路径 |
| at_all | bool | 图片路径 |
| at_user_ids | 列表 | 图片路径 |
| at_mobiles | 列表 | 图片路径 |
| index | int | 关键词索引，如果设置了多个关键词，index 表示用第几个官籍此发消息 |
send_overall_card 参数：
| 参数 | 类型 | 说明 |
|---|---|---|
| title | 字符串 | 消息标题 |
| text | 字符串 | 消息内容 |
| link | 字符串 | 消息链接 |
| single_title | 字符串 | 消息结尾提示标题，如：全文阅读 |
| index | int | 关键词索引，如果设置了多个关键词，index 表示用第几个官籍此发消息 |
send_dependent_card 参数：
| 参数 | 类型 | 说明 |
|---|---|---|
| title | 字符串 | 消息标题 |
| text | 字符串 | 消息内容 |
| buttons | 列表 | 消息跳转按钮列表 |
| index | int | 关键词索引，如果设置了多个关键词，index 表示用第几个官籍此发消息 |
buttons 参数字段说明：
| 参数 | 类型 | 说明 |
|---|---|---|
| title | 字符串 | 消息标题 |
| actionURL | 字符串 | 跳转url |
- botton 构造参数示例：
[{"title": "内容不错","actionURL": "https://www.dingtalk.com/"},{"title": "不感兴趣","actionURL": "https://www.dingtalk.com/"}
]
send_feed_card 参数：
| 参数 | 类型 | 说明 |
|---|---|---|
| title_list | 列表 | 消息标题列表 |
| title_list | 列表 | 消息标题列表 |
| message_url_list | 列表 | 消息跳转url列表 |
| pic_url_list | 列表 | 消息封面url列表 |
| index | int | 关键词索引，如果设置了多个关键词，index 表示用第几个官籍此发消息 |
下一篇 python wechat — 企业微信机器人API
python dingding --- 钉钉机器人API相关推荐
- 钉钉机器人关键词应答_Gmail 邮件推送到钉钉群机器人（详细）教程|国内接收 Gmail 邮件...
做这个功能费了我老大劲了,首先想到的还是利用现成的软件,尝试了一圈发现都不满意.然后不想重复造轮子,就搜索如何把 Gmail 推送到钉钉,结果只搜到了诸如 Python 如何调用 Gmail API. ...
- Python--发送邮件和钉钉消息
一. 邮件发送 1. 开通邮箱SMTP服务,并获取 授权码 这个账户是你要使用此邮箱发送邮件的账户,密码不是平时登录邮箱的密码,而是开通 POP3/SMTP 功能后设置的客户端授权密码. 这里以 12 ...
- python 使用钉钉机器人发送消息至钉钉
如果你在使用钉钉,并且经常需要发送某些消息到钉钉群中,例如在监控某些数据,当出现异常的时候,及时发送消息通知钉钉群:或者在完成某些操作,发送消息到钉钉群中,那么我们可以使用钉钉机器人,实现自动化信息同 ...
- Python用钉钉机器人发送消息并艾特多人
继续水文章.今天主要是吐槽一下钉钉的接口文档 前几天碰见个需求: 从jira接口查出每日未完成的任务 用钉钉机器人把任务发送到钉钉工作群里,并标注是谁的任务.任务标题 发送时,艾特对应的人员 给每个人 ...
- 钉钉自定义机器人python_使用钉钉自定义机器人发送舔狗日记[70行][python]
[Python] 纯文本查看 复制代码# -*- coding: utf-8 -*- import requests import json import time #下面是解密用到的模块 impor ...
- python之钉钉机器人编程
通过钉钉机器人可以通过程序向手机端的钉钉发送信息. 相关模块 import requests # 发送HTTP 请求模块 import json # json 解析模块 开启步骤 在钉钉聊天工具当 ...
- python调用钉钉API发送消息
#!/usr/bin/env python # -*- coding: utf-8 -*- # 2017-8-20 钉钉API发送消息import urllib, urllib2 import req ...
- Python 3 开发钉钉群机器人
转载自「刘悦的技术博客」 链接: v3u.cn/a_id_132 最近疫情比较严重,很多公司依靠阿里旗下的办公软件钉钉来进行远程办公,当然了,钉钉这个产品真的是让人一言难尽,要多难用有多难用,真的让人 ...
- python自动化办公 51cto_用Python开发钉钉群机器人,自动办公神器
最近疫情比较严重,很多公司依靠阿里旗下的办公软件钉钉来进行远程办公,虽然钉钉别的功能很鸡肋,但是机器人这个功能还是让人眼前一亮,属于比较极客的功能,它可以将第三方服务的信息聚合到钉钉群中,实现信息的自 ...
最新文章
- 阿里云飞天技术出海 eWTP落地马来西亚
- 利用python实现简易版的贪吃蛇游戏（面向python小白）
- c++ map 析构函数_C++学习刷题6--C++类的使用：构造函数、析构函数和类的使用
- linux下设置代理
- 文计笔记 3： 软件系统
- linux网络编程之地址结构sockaddr和sockaddr_in的区别
- mysql边备份边导入么_MySQL 怎么导入导出操作
- 问题：android学习内容破碎，我个人关于如何学习android的一些个人经历
- 【书摘】一种基于Git的版本管理方案
- 少年不懂鲁迅，如今才知道，我们都是闰土
- 一分钟搞懂的算法之BPE算法
- office2007安装时，提示找不到Office.zh-cn下的OfficeMUI.msi解决方法
- STM32应用开发实践教程：初识STM32
- win7 计算器 android,win7计算器
- 如何在html中调用Js函数
- 2016.11.16回顾
- Office2016下Excel饼图和Visio饼图绘制的几个小技巧（饼图分离、颜色逐块编辑、扇形区起始角度指定等）
- input框不允许输入负数
- web页面中如何唤起打开APP实践
- 半导体生产行业检测仪器远程在线式尘埃粒子计数器