做电商运营，每天要把采集到的数据同步到飞书表格，让团队实时查看。
或者流程跑完了，想自动在飞书群里发一条消息：“今日采集完成，共XXX条”。
影刀有专门的飞书指令：读取飞书表格、写入飞书表格、发送飞书消息。
不需要API开发，拖拽指令填几个参数就能用。
下面讲飞书表格的授权、读写操作，以及如何把采集结果自动发送到飞书群。
一、准备工作：飞书应用授权
影刀要操作你的飞书表格，需要先授权（获取token）。
操作步骤：
- 打开飞书开发者后台（open.feishu.cn）
- 创建企业自建应用，取名“影刀RPA”
- 获取App ID和App Secret
- 在权限管理中开通“云文档读写”权限
- 发布应用，等待审核通过（企业内部应用通常秒过）
6. 在影刀里拖入“飞书授权”指令，填入ID和Secret
# 影刀指令：飞书授权
# App ID: cli_xxxxx
# App Secret: xxxxx
# 授权后会得到一个【飞书凭证】，后续所有飞书指令都要用这个凭证
影道指令精确名称：“飞书授权”在“办公软件”分类下。只需要授权一次，凭证有效期通常2小时，影刀会自动刷新。
容易踩坑：
如果提示“权限不足”，去飞书后台检查是否开启了“云文档读写”权限，并且应用已发布。
二、读取飞书表格数据
场景：你的团队在飞书表格里维护了一批商品关键词，影刀需要读出来，逐个去采集。
操作步骤：
- 打开飞书表格，复制表格的URL
- 拖入“读取飞书表格”指令
- 填入飞书凭证、表格链接、工作表名称、读取范围
- 输出到一个二维列表变量
# 示例：读取表格A列到C列，从第2行开始（第1行是表头）
【飞书凭证】 = 飞书授权(AppID, AppSecret)
读取飞书表格(
凭证=【飞书凭证】,
表格链接="https://xxxxx.feishu.cn/sheets/xxxx",
工作表名称="Sheet1",
读取范围="A2:C100"
) → 【数据列表】
# 【数据列表】是二维列表，每个元素是一行数据
不指定范围时： 读取整个工作表的所有数据。
指定范围时： 只读取该区域，性能更好。
影道指令精确名称：“读取飞书表格”返回的是列表类型，可以直接用ForEach循环。
三、写入飞书表格
场景：采集到的数据要实时同步到飞书表格，团队不用打开Excel就能看。
操作步骤：
- 准备一个二维列表数据
- 拖入“写入飞书表格”指令
- 指定起始单元格（如A2）
- 数据会从起始单元格开始，按行列写入
# 示例：把采集结果写入飞书表格
【采集结果】 = 创建列表()
追加数据到列表(【采集结果】, ["标题", "价格", "销量"]) # 表头
追加数据到列表(【采集结果】, ["手机", "99", "1000"])
追加数据到列表(【采集结果】, ["耳机", "29", "500"])
写入飞书表格(
凭证=【飞书凭证】,
表格链接="https://xxxxx.feishu.cn/sheets/xxxx",
工作表名称="Sheet1",
起始单元格="A1",
数据=【采集结果】
)
注意：
写入会覆盖目标区域的原有内容。如果想追加到末尾，需要先读取现有行数，再计算起始行。
# 先读取已用行数
读取飞书表格(范围="A:A") → 【整列数据】
【最后行号】 = 获取列表长度(【整列数据】) + 1
起始单元格 = "A" + 【最后行号】
影道版本差异：社区版不支持飞书指令。需要创业版及以上。
四、发送飞书消息通知
场景：流程运行结束后，自动在飞书群里发一条汇总消息。
操作步骤：
- 在飞书群里添加一个自定义机器人
- 获取机器人的webhook地址
- 在影刀里拖入“发送飞书消息”指令
- 填入webhook和消息内容
飞书群机器人设置：
- 打开飞书群 → 设置 → 群机器人 → 添加机器人 → 自定义机器人
- 复制webhook URL（格式：https://open.feishu.cn/open-apis/bot/v2/hook/xxxx）
# 影刀指令：发送飞书消息
发送飞书消息(
webhook="https://open.feishu.cn/open-apis/bot/v2/hook/xxxx",
消息类型="文本",
内容="今日采集完成，共采集50条商品数据"
)
支持富文本： 可以用Markdown格式，发送更美观的报告。
【报告内容】 = """
**【采集报告】**
- 开始时间：2025-01-15 08:00:00
- 结束时间：2025-01-15 08:15:00
- 采集成功：48条
- 采集失败：2条
- 详情请查看飞书表格：[点击这里](https://xxxxx)
"""
发送飞书消息(webhook, 消息类型="富文本", 内容=【报告内容】)
影道指令精确名称：“发送飞书消息”支持文本、富文本、卡片消息。卡片消息可以带按钮，更交互。
五、完整实战：采集拼多多数据并同步到飞书
场景： 每天早上8点，自动采集拼多多“手机”关键词的商品，写入飞书表格，然后在群里发通知。
第一步：飞书授权（放在流程开头）
【飞书凭证】 = 飞书授权(AppID="cli_xxx", AppSecret="xxx")
第二步：采集拼多多数据（写入临时列表）
【采集结果】 = 创建列表()
# 表头
追加数据到列表(【采集结果】, ["标题", "价格", "销量", "店铺"])
# 模拟采集（实际用拼多多采集流程）
# 循环采集...
# 每条数据追加到【采集结果】
第三步：写入飞书表格（先清空旧数据）
# 覆盖写入整个表格（从A1开始）
写入飞书表格(
凭证=【飞书凭证】,
表格链接="https://xxxxx.feishu.cn/sheets/xxxx",
工作表名称="拼多多采集",
起始单元格="A1",
数据=【采集结果】
)
第四步：发送通知到飞书群
【总条数】 = 获取列表长度(【采集结果】) - 1 # 减掉表头
【当前时间】 = 获取当前时间()
【消息】 = f"""
✅ **拼多多采集任务完成**
⏰ 完成时间：{【当前时间】}
📊 采集数量：{【总条数】}条
📎 查看表格：https://xxxxx.feishu.cn/sheets/xxxx
"""
发送飞书消息(webhook, 消息类型="富文本", 内容=【消息】)
效果：
每天早上定时运行（用影刀的“定时触发”功能，需创业版），群里的所有人都能收到通知，并点击链接查看实时表格。
六、进阶：飞书表格做配置中心
你可以把流程的配置参数（如关键词、最大页数）放在飞书表格里，让运营人员直接修改表格，影刀读取后动态调整行为。
配置表示例：
| 参数名 | 参数值 |
|---|---|
| 关键词 | 手机 |
| 最大页数 | 10 |
| 是否采集店铺 | 是 |
影刀读取配置：
# 读取配置表
读取飞书表格(范围="A2:B10") → 【配置列表】
# 转换成字典
【配置字典】 = 创建字典()
ForEach列表循环(【配置列表】):
设置字典的值(【配置字典】, 获取列表元素(当前循环项,0), 获取列表元素(当前循环项,1))
# 使用配置
【关键词】 = 获取字典的值(【配置字典】, "关键词")
【最大页数】 = 转为数字(获取字典的值(【配置字典】, "最大页数"))
这样运营人员不用碰影道，修改表格就能调整流程行为。
影道指令精确名称：“设置字典的值”和“获取字典的值”在“变量与数据”分类下。
七、常见问题速查
| 问题 | 解决方法 |
|---|---|
| 飞书授权失败 | 检查App ID和Secret是否正确；应用是否已发布；权限是否开启“云文档读写” |
| 读取飞书表格返回空 | 检查表格链接是否可访问；工作表名称是否正确（区分大小写）；范围是否有效 |
| 写入飞书表格提示“无权限” | 应用需要在飞书后台“应用权限”中申请“云文档读写”，并且表格要分享给应用（或应用是文档所有者） |
| 飞书消息发送不出去 | 检查webhook是否正确；机器人是否被群主禁言；网络是否通（影刀需要联网） |
| 写入大量数据（几千行）很慢 | 分批次写入，每次写500行，循环写入 |
| 飞书表格被多人同时编辑，写入冲突 | 加“固定等待”随机延迟；或在流程里先锁定表格（不推荐） |
| 读取的表格数据包含空行 | 用“数据清洗”过滤掉全空的列表项 |
八、飞书指令 vs Excel指令：怎么选？
| 对比维度 | 飞书表格 | 本地Excel |
|---|---|---|
| 实时共享 | ✅ 团队实时查看 | ❌ 需要发文件 |
| 权限控制 | ✅ 飞书权限 | ❌ 文件共享 |
| 运行速度 | 较慢（网络延迟） | 快 |
| 离线可用 | ❌ 需联网 | ✅ 完全离线 |
| 数据量限制 | 大表格可能慢 | 百万行无压力 |
| 配置中心 | ✅ 适合做配置 | 也可以但共享麻烦 |
我的建议：
- 团队协作、实时监控 → 用飞书表格
- 大量数据、高性能 → 用本地Excel，处理完再上传飞书
- 配置参数 → 优先飞书表格，非技术人员也能改
推荐资源
- 飞书开放平台文档：搜索“云文档 API”
- 影刀官方帮助中心搜“飞书”，有视频教程和模板
- 推荐使用飞书“多维表格”代替普通表格，支持更多数据类型和视图
注意：飞书指令需要创业版及以上。社区版用户可以用“模拟输入”手动操作飞书网页版，但极其不稳定，不推荐。
作者：林焱
本文为《影刀RPA学习手册》系列文章之一，内容源于实操经验的整理与分享。