🚀 飞书审批中转器

连接多维表格与飞书审批的桥梁,让审批流程更智能

飞书应用配置

审批定义管理

请先配置应用信息并测试连接

Webhook接收器

🚀 新功能:请求头模式(推荐)

现在支持请求头传递字段数据,用户无需编写任何JSON请求体!

📋 多维表格配置助手

我们为您准备了专门的配置助手,帮您快速生成多维表格自动化配置:

配置助手将引导您完成整个配置过程,并生成可直接复制的配置代码。

请求头模式配置方法

URL格式: http://your-domain.com/webhook.php?approval_code=审批Code&user_id={{发起人用户ID}}
请求头配置示例:
Content-Type: application/json
widget16510509704570001: {{申请内容}}
widget16510509704570002: {{金额}}|CNY
widget16510509704570003: {{开始日期}}|{{结束日期}}
widget16510509704570004: {{选项1}},{{选项2}}

字段格式说明:

  • 普通文本:直接填写内容
  • 金额字段:格式为 金额|币种,如:100.50|CNY
  • 日期区间:格式为 开始日期|结束日期,如:2024-01-01|2024-01-02
  • 多选字段:格式为 选项1,选项2,用逗号分隔
  • 联系人字段:格式为 用户ID1,用户ID2,用逗号分隔
  • 图片字段:推荐使用多维表格的附件ID,格式:{{图片字段.附件ID}};也支持URL,如:https://example.com/image1.jpg,https://example.com/image2.png
  • 附件字段:推荐使用多维表格的附件ID,格式:{{附件字段.附件ID}};也支持URL,如:https://example.com/file1.pdf,https://example.com/file2.docx
📸 图片和附件自动处理

🎯 智能上传:系统会自动下载多维表格中的图片和附件文件,上传到飞书服务器,并在审批中正确显示。

📋 支持格式:

  • 图片:JPG, PNG, GIF, WebP等常见格式
  • 附件:PDF, DOC, DOCX, XLS, XLSX, PPT等办公文档
  • 单个文件:直接填写文件URL
  • 多个文件:用逗号分隔多个URL

📍 传统JSON模式(兼容)

依然支持传统的JSON请求体模式:

URL格式: http://your-domain.com/webhook.php?approval_code=审批Code

JSON请求体示例:

{
  "user_id": "{{发起人用户ID}}",
  "widget16510509704570001": "{{申请内容}}",
  "widget16510509704570002": {
    "amount": "{{金额}}",
    "currency": "CNY"
  }
}

🧪 测试工具

格式:字段ID: 字段值

💡 使用建议

🎯 最佳实践

  • 推荐使用请求头模式:配置简单,支持所有字段类型
  • 使用配置助手:自动生成配置代码,避免手工错误
  • 测试配置:在实际使用前先通过测试工具验证
  • 查看日志:遇到问题时检查系统日志获取详细信息
  • 图片和附件:支持自动处理文件上传,无需手动转换格式

🚀 新功能亮点

  • 📸 图片自动上传:多维表格中的图片自动上传到飞书审批
  • 📎 附件智能处理:支持PDF、Word、Excel等各种文档格式
  • 🔄 批量文件支持:一次可处理多个图片或附件
  • ⚡ 零配置体验:文件处理完全自动化,无需额外设置

🔗 URL模式 - 纯URL参数触发

✨ 什么是URL模式?

URL模式允许您通过纯URL访问的方式触发审批创建,无需发送JSON数据。所有字段数据通过URL参数传递,配置更简单,调用更便捷。

🎯 适用场景

  • 📋 简单表单 - 字段数量较少的审批流程
  • 🔗 外部系统集成 - 需要通过HTTP GET请求触发
  • 快速集成 - 无需构建复杂的JSON请求体
  • 🧪 测试调试 - 可以直接在浏览器中测试

🛠️ URL模式配置

基础URL格式

http://your-domain.com/webhook.php?approval_code=审批Code&user_id=用户ID&字段ID=字段值

参数说明

参数名 必填 说明 示例
approval_code 必填 审批定义Code ABC123-DEF456
user_id 必填 发起人用户ID ou_xxx
open_id 可选 发起人OpenID(替代user_id) ou_abc123
字段ID 可选 审批表单字段值 widget123=申请内容

📝 配置示例

示例1:简单文本审批

http://your-domain.com/webhook.php?approval_code=ABC123&user_id=ou_xxx&widget123=请假申请&widget456=因个人事务请假
说明:
  • widget123: 申请类型字段,值为"请假申请"
  • widget456: 申请原因字段,值为"因个人事务请假"

示例2:包含金额的审批

http://your-domain.com/webhook.php?approval_code=ABC123&user_id=ou_xxx&widget123=报销申请&widget456_amount=500.00&widget456_currency=CNY
说明:
  • widget456_amount: 金额字段的数值部分
  • widget456_currency: 金额字段的货币类型

示例3:包含日期区间的审批

http://your-domain.com/webhook.php?approval_code=ABC123&user_id=ou_xxx&widget123=请假申请&widget456_start=2024-01-01&widget456_end=2024-01-03
说明:
  • widget456_start: 日期区间字段的开始日期
  • widget456_end: 日期区间字段的结束日期

🔧 URL生成器

选择审批定义,系统将自动为您生成URL模板:

💡 如果下拉框为空,请点击"🔄 刷新"按钮重新加载

⚠️ 注意事项

字段类型处理

  • 文本字段:直接使用参数值
  • 数字字段:确保参数值为有效数字
  • 金额字段:使用 字段ID_amount字段ID_currency
  • 日期字段:使用 YYYY-MM-DD 格式
  • 日期区间:使用 字段ID_start字段ID_end
  • 多选字段:使用 字段ID_1=值1&字段ID_2=值2 格式

URL编码

  • 中文字符需要进行URL编码
  • 特殊字符(如空格、&、=)需要编码
  • 建议使用工具或编程语言自动编码

长度限制

  • 浏览器URL长度通常限制在2048字符内
  • 字段内容较长时建议使用JSON模式
  • 附件和图片无法通过URL模式传递

🧪 URL模式测试器

输入完整的URL进行测试:

系统日志

日志功能

系统提供详细的日志记录功能,帮助您监控和调试审批中转器的运行状态。

📝 Webhook日志

记录所有通过webhook接收的数据处理过程,包括成功和失败的请求。

🔍 实时监控

支持实时查看日志,自动刷新功能让您及时发现问题。

🎯 分级显示

不同级别的日志信息用颜色区分,ERROR、WARN、INFO一目了然。

访问日志查看器

点击下面的按钮访问专用的日志查看器界面:

🔍 打开日志查看器

🔐 密码管理

日志查看器采用密码保护机制:

  • 默认密码:admin123
  • 可在日志登录页面直接修改密码
  • 修改后的密码将保存在配置文件中
  • 支持临时密码和永久密码设置

快速查看最近日志

使用教程

🚀 初始配置步骤

步骤 1: 配置飞书应用

  1. 登录飞书开放平台创建应用
  2. 获取 App ID 和 App Secret
  3. 在"应用配置"标签页填写应用信息
  4. 点击"测试连接"确认配置正确

步骤 2: 添加审批定义

  1. 在飞书审批中心创建审批定义
  2. 复制审批定义的 Code
  3. 在"审批定义"标签页添加 Code
  4. 系统会自动获取审批表单字段

步骤 3: 配置多维表格

  1. 复制 Webhook 地址
  2. 在多维表格中配置自动化规则
  3. 设置触发条件(如新增记录)
  4. 添加发送 HTTP 请求动作

📋 数据格式说明

基础数据结构

发送给 Webhook 的数据必须是 JSON 格式,包含以下信息:

{
  "user_id": "发起人的用户ID",
  "字段ID1": "字段值1",
  "字段ID2": "字段值2",
  ...
}
重要:字段名必须使用审批定义中的字段ID,而不是字段显示名称。

不同字段类型的值格式

文本类型 (input, textarea)
{
  "widget123": "这是文本内容"
}
数字类型 (number)
{
  "widget456": "123"
}
金额类型 (amount)
{
  "widget789": {
    "amount": "100.50",
    "currency": "CNY"
  }
}
日期类型 (date)
{
  "widget101": "2024-01-01"
}
日期区间类型 (dateInterval)
{
  "widget202": {
    "start": "2024-01-01T09:00:00+08:00",
    "end": "2024-01-02T18:00:00+08:00"
  }
}
单选类型 (radioV2)
{
  "widget303": "选项key值"
}
多选类型 (checkboxV2)
{
  "widget404": ["选项1", "选项2"]
}
联系人类型 (contact)
{
  "widget505": ["user_id1", "user_id2"]
}
图片类型 (image)
{
  "widget606": "https://example.com/image1.jpg,https://example.com/image2.png"
}

💡 系统会自动下载并上传图片到飞书服务器

附件类型 (attachment)
{
  "widget707": "https://example.com/document.pdf,https://example.com/report.docx"
}

💡 支持PDF、Word、Excel等各种文档格式

完整示例

{
  "user_id": "egd312Id",
  "widget16510509704570001": "申请购买办公用品",
  "widget16510509704570002": "500.00",
  "widget16510509704570003": {
    "amount": "500.00",
    "currency": "CNY"
  },
  "widget16510509704570004": "2024-01-15",
  "widget16510509704570005": "urgent",
  "widget16510509704570006": "https://example.com/receipt.jpg,https://example.com/photo.png",
  "widget16510509704570007": "https://example.com/contract.pdf,https://example.com/quote.xlsx"
}

💡 该示例包含了文本、金额、日期、单选、图片和附件等多种字段类型

📊 多维表格配置指南

🚀 推荐方式:简化字段映射配置

新的简化配置方式,用户无需记住复杂的审批字段ID!

步骤 1: 获取配置代码
  1. 在本系统的"Webhook配置"标签页,选择"映射模式"
  2. 选择对应的审批定义
  3. 系统会自动生成用户配置代码
  4. 复制生成的JSON配置代码
步骤 2: 配置多维表格自动化
  1. 在多维表格中创建自动化规则
  2. 选择触发条件(如"记录创建时")
  3. 添加"发送HTTP请求"动作
  4. URL填写:http://your-domain.com/webhook.php?approval_code=审批Code
  5. 请求方法:POST
  6. 请求头:Content-Type: application/json
  7. 请求体:粘贴生成的配置代码
步骤 3: 修改字段引用

在粘贴的配置代码中,将形如 {{字段名字段}} 的部分替换为多维表格的实际字段:

{
  "user_id": "{{发起人字段}}",      ← 改为 "{{发起人}}"
  "申请内容": "{{申请内容字段}}",    ← 改为 "{{申请内容}}"
  "申请金额": "{{申请金额字段}}",    ← 改为 "{{金额}}"
  "申请日期": "{{申请日期字段}}"     ← 改为 "{{日期}}"
}
💡 优势:
  • 配置过程极其简单,只需要复制粘贴
  • 不需要记住审批字段ID
  • 系统自动处理数据类型转换
  • 支持字段名智能匹配

📝 传统方式:直接字段ID配置

如果您已经熟悉审批字段ID,依然可以使用传统方式。

步骤 1: 创建自动化
  1. 在多维表格中点击"自动化"
  2. 创建新的自动化规则
  3. 设置触发条件(如"当记录被创建时")
提示:也可以选择"当记录被更新时"来处理记录修改的情况。
步骤 2: 添加HTTP请求动作
  1. 在动作中选择"发送HTTP请求"
  2. 请求方法选择 POST
  3. URL 填写:http://your-domain.com/webhook.php?approval_code=审批Code
  4. 请求头添加:Content-Type: application/json
步骤 3: 配置请求体

在请求体中使用 JSON 格式,通过动态字段插入表格数据:

{
  "user_id": "{{发起人字段}}",
  "widget16510509704570001": "{{申请内容字段}}",
  "widget16510509704570002": "{{金额字段}}",
  "widget16510509704570003": "{{日期字段}}"
}
注意:
  • 字段ID必须与审批定义中的字段ID完全一致
  • 使用双花括号 {{}} 来插入多维表格的字段值
  • 确保JSON格式正确,注意逗号和引号

🔧 高级配置:URL参数映射

最简单的配置方式,适合字段较少的情况。

在多维表格自动化中,URL配置为:

http://your-domain.com/webhook.php?approval_code=审批Code&field_mapping=申请内容:widget123,申请金额:widget456

请求体配置为:

{
  "user_id": "{{发起人字段}}",
  "申请内容": "{{申请内容字段}}",
  "申请金额": "{{金额字段}}"
}
说明:field_mapping参数格式为 "表格字段名:审批字段ID,表格字段名:审批字段ID"

✅ 配置验证

配置完成后,可以通过以下方式验证:

  1. 在本系统的"Webhook配置"页面使用测试工具
  2. 在多维表格中创建一条测试记录,观察是否触发审批
  3. 查看系统日志,确认数据处理是否正常
常见问题:
  • 确保多维表格的自动化规则已启用
  • 检查URL地址是否正确
  • 确认字段名在请求体中正确引用
  • 验证发起人字段是否有效

🔧 问题排查指南

常见问题及解决方案

❌ 审批创建失败

可能原因:

  • 字段ID不匹配
  • 必填字段缺失
  • 字段值格式错误
  • 发起人信息错误

解决方法:

  • 检查日志查看详细错误信息
  • 使用测试工具验证数据格式
  • 确认审批定义字段ID正确
❌ JSON格式错误

常见错误:

  • 缺少引号或逗号
  • 中文引号替代英文引号
  • 末尾多余的逗号

解决方法:

  • 使用JSON验证工具检查格式
  • 复制提供的模板进行修改
  • 注意使用英文标点符号
❌ 权限问题

可能原因:

  • 飞书应用权限不足
  • 发起人无权限使用审批定义
  • Access Token 过期

解决方法:

  • 检查应用是否有审批相关权限
  • 确认发起人在审批定义的可见范围内
  • 重新配置应用信息

调试工具

🔍 日志查看

查看详细的处理日志,包括请求数据、处理过程和错误信息。

打开日志查看器
🧪 测试工具

使用内置测试工具验证数据格式和审批创建流程。

📋 字段映射

查看审批定义的字段ID和类型信息。

需要帮助?

如果您在使用过程中遇到问题,可以:

  • 查看系统日志获取详细错误信息
  • 使用测试工具验证配置
  • 检查飞书开放平台的应用配置
  • 确认多维表格的自动化配置正确