影刀RPA新手教程：飞书机器人Webhook完全指南——消息推送格式、卡片消息与群通知自动化

影刀RPA新手教程：飞书机器人Webhook完全指南——消息推送格式、卡片消息与群通知自动化

作者：林焱 | 真实案例驱动，每篇覆盖12大核心模块，禁止空话。

案例背景：我把运营群的消息推送搞成了全自动

去年双11，运营团队每天要在3个飞书群里手动推送数据日报，早上9点一次、下午6点一次。

那个人休了三天假，群里连续三天没数据，老板直接在群里问"人呢"。

我接手后用影刀RPA + 飞书机器人Webhook，把这套推送做到了完全无人值守。

今天这篇文章，就是把整套方案拆透，从零到上线，每一步都有代码。

一、安装与准备工作

打开影刀客户端，新建一个应用，取名"飞书消息推送机器人"。

我当时犯的第一个错：直接在本地跑，没考虑服务器环境。

正确做法：先在影刀控制台创建一个应用，发布到云端，再用云调度触发。

安装影刀就不赘述了，官网下载一路下一步。重点说环境配置：

• 影刀版本：建议 2.6 以上，低版本HTTP指令有bug
• Python环境：勾选"嵌入Python"，后面要用到 requests 库
• 编码设置：应用设置里把编码改成 UTF-8，否则中文会乱码

我当时踩过这个坑：本地跑得好好的，发到云端就乱码。

原因是本地Windows默认GBK，云端是UTF-8，HTTP请求没指定编码就翻车了。

二、元素定位：获取飞书Webhook地址

飞书机器人的Webhook地址是固定的，不需要元素定位去抓取。

但很多新手不知道Webhook入口在哪，这里说清楚：

打开飞书群 → 设置 → 群机器人 → 添加机器人 → 自定义机器人。

勾选"自定义消息类型"，复制 Webhook URL。

URL格式是这样的：

https://open.feishu.cn/open-apis/bot/v2/hook/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

重要：不要把完整的URL当秘密，飞书机器人的安全机制是靠URL本身，泄露就等于把群权限交出去了。

我当时把URL写进了代码注释里，提交到Git仓库，后来不得不把机器人删了重建。

正确做法：把Webhook URL存到影刀的"应用参数"里，运行时动态读取，代码里永远不硬编码。

三、变量与数据类型：消息体的正确组装方式

飞书消息推送的核心，是往Webhook地址发一个HTTP POST请求，Body是JSON格式。

在影刀里，先创建一个字符串变量webhook_url，值是你的Webhook地址。

再创建一个字典变量msg_body，用来组装消息体。

最简单的文本消息格式：

{"msg_type":"text","content":{"text":"测试消息"}}

在影刀里用"配置参数"指令来组装这个JSON：

• 变量名：msg_body
• 变量类型：字典
• 键值对：msg_type→text，content→ 另一个字典

这里有个细节：影刀的字典类型，嵌套字典要用"配置参数"里的"添加子项"来操作。

直接写JSON字符串再转字典也行，但我更推荐用影刀原生的字典操作，调试时能在变量面板直接看到结构。

我当时踩过这个坑：用Python的json.dumps()转出来的字符串，再传给HTTP指令，Content-Type没设为application/json，飞书一直返回"invalid body"。

四、流程控制：按条件发送不同消息

真实场景里，消息内容是根据数据动态变化的。

比如销售额达标就发绿色卡片，不达标就发红色告警。

用影刀的"如果…否则"指令来实现：

如果 销售额 >= 目标值 消息类型 = 成功卡片 否则 消息类型 = 告警文本 结束如果

更复杂一点，可以嵌套判断：

如果 销售额 >= 目标值 * 1.2 发送"超额完成"卡片 否则如果 销售额 >= 目标值 发送"达标"卡片 否则 发送"未达标"告警 + @所有人 结束如果

循环指令用在批量推送场景。

比如要给5个群各发一条消息，把Webhook地址存到列表里，用"遍历循环"逐个发送。

当时我第一次写循环，把HTTP请求放在循环里没加等待，飞书限频，第3条开始全部失败。

正确做法：每次发送后加睡眠指令，等待1-2秒，避开限频。

五、网页自动化：从后台抓取推送数据

消息内容不能写死，要从实际业务系统里抓。

以电商后台为例，用影刀的"启动新浏览器"指令打开后台页面。

元素定位四合一策略：

先试XPath，最稳：

//div[@class='sales-number']/span

XPath找不到再试CSS选择器：

div.sales-number > span

动态ID的情况用正则表达式匹配：

id="sales_\d+"

实在定位不到的，用"获取元素XPath"指令先录一遍，再手工优化。

我当时踩过这个坑：页面用了Shadow DOM，影刀直接定位不到。

解决方法是先用"执行JavaScript"指令，在页面里用ShadowRoot.querySelector()拿到元素，再把内容通过return传出来。

六、数据处理：把原始数据变成消息内容

从页面抓到的数据，通常是字符串，需要处理成合适的格式。

用影刀的"文本处理"指令做字符串拼接：

"今日销售额：" + 销售额 + "\n目标完成率：" + 完成率 + "%"

多行文本用\n换行，飞书的文本消息支持换行显示。

如果是数字，要做格式化：

完成率 = round(销售额 / 目标值 * 100, 2)

数据里有空值的情况，用"如果…否则"做默认值处理：

如果 销售额 == "" 或 销售额 == null 销售额 = "0" 结束如果

我当时遇到过一个坑：页面加载不完全，抓到的是空字符串，直接做除法算完成率，流程直接报错停了。

后来在所有数据抓取后面都加了"尝试捕获"指令，抓不到就用上一次缓存的值。

七、鼠标键盘图像：截图插入消息

飞书机器人支持发送图片，先把图表截图，转成Base64，再塞进消息体。

用影刀的"截取网页元素截图"指令，把销售趋势图截下来，保存到本地路径。

然后用Python把图片转成Base64：

importbase64withopen("C:/temp/sales_chart.png","rb")asf:img_base64=base64.b64encode(f.read()).decode('utf-8')![在这里插入图片描述](https://i-blog.csdnimg.cn/direct/2cb317897e884b308cf15b1c5f89a387.png#pic_center)print(img_base64)

把Python的输出存到影刀变量img_base64里。

飞书图片消息的格式：

{"msg_type":"image","content":{"image_key":"img_xxxxxxxx"}}

注意：飞书发送图片不能直接贴Base64，要先用"上传图片"接口拿到image_key，再用image_key发消息。

我当时在这里卡了半天，一直往Webhook直接POST图片数据，返回的都是"unsupported msg type"。

八、进阶技能：卡片消息的高级玩法

文本消息能干的事太有限，真实生产环境都用卡片消息。

飞书卡片消息的JSON结构比较复杂，用影刀的"配置参数"指令一层层组装：

{"msg_type":"interactive","card":{"config":{"wide_screen_mode":true},"header":{"title":{"tag":"plain_text","content":"今日数据日报"},"template":"green"},"elements":[{"tag":"div","text":{"tag":"lark_md","content":"**销售额**：¥120,000\n**完成率**：120%"}}]}}

卡片颜色template可选值：blue、green、orange、red、purple、grey。

用变量动态控制颜色，让卡片状态一眼可见：

如果 完成率 >= 100 template = "green" 否则如果 完成率 >= 80 template = "orange" 否则 template = "red" 结束如果

卡片里还能加按钮，点击后触发另一个Webhook，实现简单的交互。

我当时做的方案：卡片底部加一个"查看详情"按钮，点击后跳转到数据看板页面。

九、平台实战：在影刀控制台配置定时触发

写完流程，要在影刀控制台配置定时调度，才能做到每天自动推送。

打开影刀控制台 → 任务中心 → 新建任务。

任务类型选"定时触发"，时间设成每天上午9点和下午6点。

Cron表达式写法：

0 9,18 * * *

意思是每天9:00和18:00各触发一次。

触发器配置里，把"飞书Webhook地址"作为参数传入，这样换群只需要改参数，不用改流程。

我当时踩过这个坑：流程里硬编码了Webhook地址，后来运营新建了一个群，要改地址，只能改流程重新发版。

正确做法：所有外部配置（Webhook地址、阈值、收件人列表）全部通过应用参数传入。

十、系统联动：和邮件、短信形成多重告警

飞书消息有可能漏看，关键告警要多重通知。

在影刀流程里，飞书消息发送成功后，再调一个邮件发送指令。

邮件收件人列表存到影刀的列表变量里，遍历发送。

如果飞书消息发送失败（HTTP返回码不是200），立即发邮件告警，内容是错误详情。

用"尝试捕获"指令包住HTTP请求：

尝试 HTTP请求 POST webhook_url 如果 返回码 != 200 发送邮件 "飞书推送失败：" + 返回消息 结束如果 捕获异常 发送邮件 "流程异常：" + 异常信息 结束尝试

我当时有一次飞书Webhook被人改了权限，所有推送全部失败，又因为没加异常捕获，失败了也没人知道。

从那以后，所有对外的HTTP请求，我都会包一层状态检查和异常告警。

十一、工程化规范：让机器人不负责任

上线的机器人，要遵守几个规范，否则跑着跑着就没人维护了。

命名规范：

机器人名字要能看出用途，比如"数据日报推送机器人"，不要叫"test"、“机器人1”。

日志规范：

每次推送，在影刀流程里写一条日志，记录推送时间、目标群、消息摘要。

日志格式统一：

[飞书推送] 2024-11-11 09:00:02 | 运营群 | 销售额120000 | 成功

异常处理规范：

所有HTTP调用都必须有超时设置和重试机制。

飞书Webhook推荐重试3次，每次间隔2秒：

循环 3次 尝试 HTTP请求 如果 返回码 == 200 跳出循环 结束如果 捕获异常 睡眠 2秒 继续 结束尝试 结束循环

我当时没加热重试，网络抖动导致每天总有那么一两条丢消息，运营来问的时候才发现问题。

十二、速查表与常见报错

报错1：HTTP 400 invalid body

原因：Content-Type没设为application/json，或者JSON格式有语法错误。

解决：在HTTP请求指令里，Header手动加一条Content-Type: application/json。

报错2：HTTP 9499 msg timeout

原因：Webhook地址失效，或者机器人被删除了。

解决：去飞书群里重新添加一个机器人，更新Webhook地址。

报错3：卡片消息显示"不支持的消息类型"

原因：卡片JSON结构写错了，或者msg_type写成了text而不是interactive。

解决：对照飞书开放平台的卡片消息文档，检查JSON结构。

报错4：发送成功但群里看不到消息

原因：机器人被移出了群，或者群设置了"仅群主可@所有人"。

解决：检查机器人在群里的状态，调整群权限设置。

飞书卡片颜色速查：

完整案例代码参考

以下是主流程的核心代码片段，可直接参考使用。

HTTP请求配置（Python实现，在影刀"执行Python代码"指令里调用）：

importrequestsimportjsondefsend_feishu_message(webhook_url,msg_body):headers={"Content-Type":"application/json","charset":"utf-8"}resp=requests.post(webhook_url,data=json.dumps(msg_body,ensure_ascii=False).encode('utf-8'),headers=headers,timeout=10)returnresp.status_code,resp.text# 卡片消息组装示例card_msg={"msg_type":"interactive","card":{"config":{"wide_screen_mode":True},"header":{"title":{"tag":"plain_text","content":"销售日报"},"template":"green"},"elements":[{"tag":"div","text":{"tag":"lark_md","content":"**今日销售额**：¥{}\n**完成率**：{}%".format(sales,rate)}}]}}status,result=send_feishu_message(webhook_url,card_msg)print(status,result)

XPath元素定位参考（以电商后台为例）：

# 销售额元素 //div[contains(@class,'sales')]//span[@class='value'] # 完成率元素 //div[@id='dashboard']//div[@class='rate']/text() # 动态ID处理 //div[contains(@id,'sales_')]/span

CSS选择器备选方案：

/* 销售额 */div.sales span.value/* 完成率 */#dashboard div.rate/* 包含特定文本的元素 */div:contains("销售额")

我当时踩过这个坑：三个最深刻的教训

教训一：Webhook地址硬编码在代码里。

有次我把包含Webhook地址的代码截图发到技术群里问问题，虽然马赛克了大部分，但有人还是通过上下文猜到了完整地址。

半小时后那个群开始收到垃圾消息。

从那以后，所有密钥、Webhook地址，一律不进代码，全部走参数。

教训二：没做发送频率限制。

早期版本里，数据异常触发告警，1分钟内发了60多条消息到群里。

群成员直接把机器人移出了群。

现在所有推送都加频率限制：同一个内容5分钟内只推一次，告警类消息加@提醒，普通消息不加。

教训三：卡片消息的JSON手写，没有校验。

有一次手抖少写了一个引号，JSON格式错误，卡片消息一直发不出去。

现在卡片JSON先用在线JSON校验工具检查，再贴到影刀里，或者用Python的json.dumps()来生成，避免手写错误。

延伸：home.linyan.cloud 上的更多资源

这篇文章的完整示例代码和飞书卡片消息模板，我都整理到了 home.linyan.cloud，包含10种不同场景的卡片JSON模板，直接复制就能用。

如果你在配置Webhook时遇到这篇文章没覆盖到的问题，也可以去那里留言，我看到会回复。

#影刀RPA #RPA教程 #飞书机器人 #Webhook #消息推送 #自动化 #林焱

作者：林焱