连接多维表格与飞书审批的桥梁,让审批流程更智能
现在支持请求头传递字段数据,用户无需编写任何JSON请求体!
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}};也支持URL,如:https://example.com/image1.jpg,https://example.com/image2.png{{附件字段.附件ID}};也支持URL,如:https://example.com/file1.pdf,https://example.com/file2.docx🎯 智能上传:系统会自动下载多维表格中的图片和附件文件,上传到飞书服务器,并在审批中正确显示。
📋 支持格式:
依然支持传统的JSON请求体模式:
http://your-domain.com/webhook.php?approval_code=审批Code
JSON请求体示例:
{
"user_id": "{{发起人用户ID}}",
"widget16510509704570001": "{{申请内容}}",
"widget16510509704570002": {
"amount": "{{金额}}",
"currency": "CNY"
}
}
URL模式允许您通过纯URL访问的方式触发审批创建,无需发送JSON数据。所有字段数据通过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=申请内容 |
http://your-domain.com/webhook.php?approval_code=ABC123&user_id=ou_xxx&widget123=请假申请&widget456=因个人事务请假
http://your-domain.com/webhook.php?approval_code=ABC123&user_id=ou_xxx&widget123=报销申请&widget456_amount=500.00&widget456_currency=CNY
http://your-domain.com/webhook.php?approval_code=ABC123&user_id=ou_xxx&widget123=请假申请&widget456_start=2024-01-01&widget456_end=2024-01-03
选择审批定义,系统将自动为您生成URL模板:
字段ID_amount 和 字段ID_currency字段ID_start 和 字段ID_end字段ID_1=值1&字段ID_2=值2 格式输入完整的URL进行测试:
系统提供详细的日志记录功能,帮助您监控和调试审批中转器的运行状态。
记录所有通过webhook接收的数据处理过程,包括成功和失败的请求。
支持实时查看日志,自动刷新功能让您及时发现问题。
不同级别的日志信息用颜色区分,ERROR、WARN、INFO一目了然。
点击下面的按钮访问专用的日志查看器界面:
🔍 打开日志查看器日志查看器采用密码保护机制:
admin123发送给 Webhook 的数据必须是 JSON 格式,包含以下信息:
{
"user_id": "发起人的用户ID",
"字段ID1": "字段值1",
"字段ID2": "字段值2",
...
}
{
"widget123": "这是文本内容"
}
{
"widget456": "123"
}
{
"widget789": {
"amount": "100.50",
"currency": "CNY"
}
}
{
"widget101": "2024-01-01"
}
{
"widget202": {
"start": "2024-01-01T09:00:00+08:00",
"end": "2024-01-02T18:00:00+08:00"
}
}
{
"widget303": "选项key值"
}
{
"widget404": ["选项1", "选项2"]
}
{
"widget505": ["user_id1", "user_id2"]
}
{
"widget606": "https://example.com/image1.jpg,https://example.com/image2.png"
}
💡 系统会自动下载并上传图片到飞书服务器
{
"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!
http://your-domain.com/webhook.php?approval_code=审批Code在粘贴的配置代码中,将形如 {{字段名字段}} 的部分替换为多维表格的实际字段:
{
"user_id": "{{发起人字段}}", ← 改为 "{{发起人}}"
"申请内容": "{{申请内容字段}}", ← 改为 "{{申请内容}}"
"申请金额": "{{申请金额字段}}", ← 改为 "{{金额}}"
"申请日期": "{{申请日期字段}}" ← 改为 "{{日期}}"
}
如果您已经熟悉审批字段ID,依然可以使用传统方式。
http://your-domain.com/webhook.php?approval_code=审批Code在请求体中使用 JSON 格式,通过动态字段插入表格数据:
{
"user_id": "{{发起人字段}}",
"widget16510509704570001": "{{申请内容字段}}",
"widget16510509704570002": "{{金额字段}}",
"widget16510509704570003": "{{日期字段}}"
}
最简单的配置方式,适合字段较少的情况。
在多维表格自动化中,URL配置为:
http://your-domain.com/webhook.php?approval_code=审批Code&field_mapping=申请内容:widget123,申请金额:widget456
请求体配置为:
{
"user_id": "{{发起人字段}}",
"申请内容": "{{申请内容字段}}",
"申请金额": "{{金额字段}}"
}
配置完成后,可以通过以下方式验证:
可能原因:
解决方法:
常见错误:
解决方法:
可能原因:
解决方法:
如果您在使用过程中遇到问题,可以: