项目简介
本项目是基于Python的飞书自定义机器人消息发送工具,能向飞书发送多种类型消息,如文本、富文本、群名片、图片和卡片消息。使用时只需导入模块并调用相关函数,即可轻松实现消息发送。
项目的主要特性和功能
- 支持多种消息类型,可满足不同需求。
- 采用模板驱动,提供模板文件,便于构建不同格式的消息内容。
- 易于集成,提供简单的API接口,方便融入现有项目。
- 具备验证和错误处理机制,对富文本和卡片消息格式进行校验,处理发送过程中的错误。
- 有上传图片功能,可将图片上传到飞书服务器并获取图片键值。
安装使用步骤
1. 安装库
通过pip安装最新版本的库:
bash
pip install fly-book-bot-sender==0.1.8
2. 下载模板文件
从以下链接下载模板文件并放在项目根目录:
https://download.fr71.com/open/template.zip
3. 导入模块
在Python脚本中导入相关模块:
python
import fly_book_bot_sender as sender
from fly_book_bot_sender import MSG_TYPE
4. 配置全局机器人HookApi地址
设置全局使用的机器人消息发送api:
python
sender.setHookUrl('机器人创建时生成的hookUrl')
5. 发送消息
根据需求调用相应的函数发送不同类型的消息,例如发送文本消息:
python
sender.sendChatMsg(msgType=MSG_TYPE.TEXT, content='你好,这是一条文本消息!')
注意事项
sendChatMsg
函数会返回一个长度为2的数组,第一个元素是bool值表示发送的状态,第二个元素是字符串,在发送失败时返回原因,成功时返回"success"。使用本工具需要先创建飞书机器人并获取HookUrl,以及配置访问令牌(tenant_access_token)以获取图片的键值。具体创建机器人和配置的过程可以参考飞书的官方文档。
下载地址
点击下载 【提取码: 4003】【解压密码: www.makuang.net】