影刀RPA新手教程：飞书机器人消息发送完全指南——最简单的消息推送方法

一、为什么你要学飞书消息推送

我第一次用影刀跑完一个采集流程后，傻傻地坐在电脑前等它跑完。

跑完之后我还得自己去文件夹里翻结果。后来同事跟我说：你用飞书机器人啊，跑完了直接给你发消息。

当时我就震惊了——原来机器人可以主动发消息告诉你"活干完了"。

这种感觉太爽了，就像请了个助理，干完活还会主动跟你汇报。

今天带你从零开始，把飞书消息推送完全搞明白。

二、安装与环境准备

首先确认你有一个飞书群。如果没有，打开飞书，点右上角的"+"号，创建一个群聊。

群名随便取，比如"影刀通知群"，可以只加你自己一个人。

然后最关键的一步：给这个群添加一个机器人。

在群聊窗口，点右上角的"设置"按钮（齿轮图标）。

左侧菜单找到"群机器人"，点击。页面中间有个"添加机器人"的按钮，点它。

选择"自定义机器人"，给机器人起个名字，比如"流程通知助手"。

飞书会给你一个Webhook地址，长这样：https://open.feishu.cn/open-apis/bot/v2/hook/xxxxxxxxx。

这串地址非常关键，复制下来保存好。这相当于机器人的"手机号"，有了它你就能给这个群发消息了。

影刀本身的安装很简单，官网下载Windows版本，一路默认安装就行。

安装时别忘了勾选浏览器扩展，这是网页自动化的基础。

三、元素定位入门

虽然发消息不需要元素定位，但作为零基础读者，你必须了解这个影刀核心概念。

元素定位就是告诉影刀"网页上的哪个东西我要操作"。影刀提供了好几种定位方式。

XPath定位：//div[@class='result-list']/div[1]，意思是在页面上找class为result-list的div下面第一个子div。

CSS选择器定位：.result-list > div:first-child，跟XPath一样的作用，语法更简洁。

正则表达式不是用来定位元素的，是用来匹配文本内容的。比如从一大段文字里提取电话号码：\d{11}匹配11位数字。

捕获元素的操作：打开目标网页，回到影刀，点顶部工具栏的"捕获元素"按钮，把鼠标移到网页元素上，红色框选中后点击即可。

元素捕获后会自动保存到影刀的"元素库"里，后面直接用就行。

四、变量与数据基础

在正式开始发消息之前，需要了解影刀怎么处理数据。

变量就是给一个值起名字，方便后面反复使用。

创建变量：在影刀左侧工具栏点"变量管理"（花括号图标）。

常用变量类型：字符串（一段文字，用双引号包起来）、整数（1、2、3这样的数字）、列表（[1, 2, 3]）、字典（{"name":"张三","score":90}）。

本篇文章用到的变量主要有两个：webhook_url（字符串，存那个Webhook地址）、message（字符串，存要发送的消息内容）。

赋值的方法：从指令列表拖"设置变量"指令到画布上，在"变量名"输入框填webhook_url，"值"输入框粘贴你的Webhook地址。

注意数字和字符串的区别。123是数字可以加减，"123"是字符串只能拼接。

影刀里拼接字符串用&符号，不是用+号。

五、流程控制

影刀里的流程控制让程序有了判断能力。

最核心的三个指令：If条件判断、For循环、While循环。

If条件的用法：拖一个"If条件"指令到画布，在条件框里写判断逻辑。比如status == "success"。

对，在影刀里判断相等用两个等号==，一个等号是赋值，别搞混。

For循环用来遍历列表。比如你抓了10条数据放在列表里，用For循环一条一条处理。

While循环是"当条件满足就一直执行"，比如"当网页还没加载完就继续等"。

本篇文章的流程很简单，不需要复杂的判断逻辑，所以流程控制主要用在消息格式化那部分。

六、核心实战：发送第一条飞书消息

现在正式开始用影刀发送飞书消息。整个流程只需要一个核心指令：HTTP请求。

在影刀指令列表里搜索"HTTP"，找到"发起HTTP请求"指令，拖到画布上。

双击这个指令进入配置界面，需要填写几个参数：

请求URL：粘贴你的Webhook地址，长这样：https://open.feishu.cn/open-apis/bot/v2/hook/你的token。

请求方式：选择POST（从下拉框里选，有GET、POST、PUT等选项）。

请求头：点"添加"按钮，新增两行。第一行的key填Content-Type，value填application/json。

请求体：选择"json"类型，在文本框中输入：

{
  "msg_type": "text",
  "content": {
    "text": "影刀流程已运行完毕，数据采集成功。"
  }
}

填完所有参数后，点"确定"关闭配置窗口。

这时候点左上角的"运行"按钮（绿色三角形），流程就会执行。

执行完成后去飞书群里看一眼，应该能收到一条消息。看到消息的瞬间真的有种莫名的成就感。

七、数据处理：消息内容动态化

上面的例子发的是固定文字，实际使用中消息内容往往需要动态生成。

比如你采集了今天的销售数据，想把汇总内容放进消息里。

假设你的变量sales_today存了今天的销售额，order_count存了订单数。

先创建这两个变量，分别赋值为采集到的数值。

然后用"设置变量"指令拼接消息内容：

msg_content = "今日销售数据汇总\n销售额：" & sales_today & "元\n订单数：" & order_count & "单"

这里\n是换行符，在消息里会显示为换行。

然后把HTTP请求的请求体改成这样：

{
  "msg_type": "text",
  "content": {
    "text": "msg_content"
  }
}

注意：在请求体的JSON里引用变量，直接用变量名就行，影刀会自动替换。

八、进阶：飞书富文本消息

飞书支持发送富文本消息，也就是可以带颜色、加粗、链接的复杂消息。

富文本消息的请求体格式：

{
  "msg_type": "post",
  "content": {
    "post": {
      "zh_cn": {
        "title": "影刀流程运行报告",
        "content": [
          [
            {
              "tag": "text",
              "text": "运行状态："
            },
            {
              "tag": "text",
              "text": "成功",
              "style": ["bold"]
            }
          ],
          [
            {
              "tag": "text",
              "text": "采集数据：128条\n"
            }
          ]
        ]
      }
    }
  }
}

这种消息在飞书群里显示的效果更好看，但构造起来稍微复杂一些。

初学者先用简单的text类型就好，等熟悉了再尝试富文本。

我日常使用的流程配置模板可以在home.linyan.cloud找到参考。

九、平台实战：完整流程

现在串一个完整案例：从网页采集数据，然后通过飞书发送通知。

流程步骤：

1. 用"启动新浏览器"指令打开Chrome
2. 用"跳转到网页"指令打开目标网站
3. 用"获取元素文本"指令抓取页面上的数据
4. 把数据赋值给变量

6. 拼接消息内容
7. 用HTTP请求指令发送到飞书

完整变量列表：

• webhook_url：字串，Webhook地址
• target_data：字串，采集到的数据
• message：字串，最终消息内容

错误处理：在流程外层加Try-Catch指令。Catch里也发一条消息，告诉你说"流程出错了"。

这样不管成功还是失败，你都能收到通知，不用守在电脑前。

十、系统联动与更多玩法

飞书机器人不只是发消息，还能发图片、发文件、发卡片。

发图片需要先把图片上传到飞书获取image_key，然后用图片类型的消息体发送。

这个操作稍微复杂一点，用到了飞书的"上传图片"API

卡片消息更强大，可以放按钮、下拉框、日期选择器，用户还能直接点击交互。

不过卡片消息的配置比较复杂，建议先把文本消息玩熟了再进阶。

还有一个实用技巧：在飞书群里对机器人发指令，用关键词触发影刀流程。

比如在群里发"执行日报"，机器人收到后，影刀就去跑日报流程。

这需要配合飞书的"事件订阅"功能，属于进阶内容。

十一、工程化规范

发送消息的工程化建议：

1. Webhook地址单独存一个变量，不要硬写在多个地方。改地址时只改一处。

2. 消息模板抽离出来，方便统一修改格式。

3. 每发一条消息前后都输出日志，方便排查。

4. 敏感信息（Webhook地址、token）不要在流程里明文暴露。

5. 给不同的场景建不同的群和机器人，日报用一个群，告警用另一个群。

6. 流程名称清晰明了，比如"飞书通知_数据采集完成_v1"。

7. 修改流程后先手动跑一遍测试，确认消息能收到。

十二、速查表与常见报错

飞书消息类型速查：

• text：纯文本消息，最简单
• post：富文本消息，支持颜色和格式
• image：图片消息
• share_chat：分享群聊
• interactive：交互式卡片

HTTP请求常见报错：

• JSON格式错误：检查请求体里的逗号、引号是否配对了
• 请求超时：检查Webhook地址是否正确，网络是否正常
• 返回"invalid webhook url"：Webhook地址错误或者机器人被删除了
• 返回"tenant access token invalid"：权限问题

变量命名规范速查：

• 蛇形命名法：daily_sales、error_message
• 驼峰命名法：dailySales、errorMessage

常用状态码速查：

• 0：运行成功
• 非0：运行失败，具体看msg字段提示

作者：林焱

#影刀RPA #RPA教程 #飞书 #消息推送 #影刀新手 #自动化办公 #Webhook