在飞书多维表格中使用自动化 HTTP 拓展前，必须先完成企业自建应用的开通与发布，并配置完整的云文档权限；随后再在多维表格自动化里正确设置 HTTP 扩展：填写不带查询参数的请求 URL、补充 timestamp 等查询参数与请求头，并使用 JSON 格式编写包含字段变量的请求体。

如果你想在飞书多维表格中让某一行数据自动触发外部 API 接口调用，例如向飞书机器人推送通知、同步数据到企业自建系统，首先必须添加并启用「HTTP拓展」。需要注意的是，这并不是点击“+”后就能直接使用的普通功能，它依赖企业自建应用的合法身份认证以及完整的权限配置。只要任何一个环节缺失，就很容易出现请求被拦截，或返回 403 权限错误的问题。

开通企业自建应用并配置云文档权限

进入飞书开发者后台（open.feishu.cn/app）→ 使用管理员账号登录 → 点击「创建应用」→ 选择「企业自建应用」→ 填写应用名称（例如“多维表格HTTP对接”）→ 提交审核。

审核通过后，进入该应用的「凭证与基础信息」页面，【必须复制并妥善保存 App ID 和 App Secret】——这两个参数后续需要填写到自动化凭据中，一旦遗失通常需要重新生成，而旧凭据会立即失效。

在「权限管理」中，勾选完整的「云文档」相关权限（包括读取、编辑文档内容等）。如果未勾选完整就直接配置自动化，流程运行时通常会报错“无权限访问表格”。

最后点击「发布应用」：只有正式发布后的应用才具备真实的接口调用能力；未发布的应用即使已经填写了 App ID 和 App Secret，请求仍然会被平台拦截。

在多维表格中配置HTTP拓展动作

方法一：基础 POST 推送（适用于飞书机器人、Webhook 通知等常见场景）
打开目标多维表格 → 点击右上角「自动化」→ 「创建自动化」→ 触发条件选择「当新增记录时」→ 执行动作选择「发送 HTTP 请求」。

① 请求地址：将目标接口的 URL 直接粘贴到这里，例如飞书机器人的 webhook 地址。这里有一个非常常见的配置误区：【URL 不能直接携带查询参数】。像 https://open.feishu.cn/open-apis/bot/v2/hook/xxx?timestamp=123 这种带有 ? 参数的链接，通常会导致请求失败。正确做法是把 timestamp 这类参数拆分出来，放到下一步的「查询参数」中分别填写。

② 查询参数与请求头：点击「+ 添加参数」，Key 填写 timestamp，Value 使用表达式 {{now()}}；再新增一项 Key 为 sign，Value 填写你自行计算好的签名值（如果是飞书机器人且无需签名，此处可留空）；请求头至少需要填写 Content-Type: application/json。

③ 请求体与响应解析：这里选择「JSON」格式，然后在文本框中填写请求体，例如：{"msg_type":"text","content":{"text":"新提交了一条客户线索:{{客户姓名}}"}}。需要特别注意的是，其中的 {{客户姓名}} 只是示例占位符，实际使用时必须替换为真实的字段变量名称，并且变量名必须与多维表格中的字段名称完全一致，哪怕大小写不一致也可能导致取值失败。

方法二：GET 方式拉取外部数据（例如调用库存 API）
触发条件选择「当修改记录时」→ 执行动作仍选择「发送 HTTP 请求」→ 请求方法改为 GET → URL 填写包含查询参数的完整地址（如https://api.example.com/inventory?sku={{商品编码}}）→ 请求体留空 → 响应体选择 JSON → 在「返回值」中填写 data.stock_level，用于后续写回表格字段。

验证与调试关键点

点击「测试运行」按钮后，重点观察响应状态码。200 代表请求成功；401 通常表示 App 凭证无效；403 一般说明云文档权限没有开全；404 则表示 URL 路径填写错误，或者目标服务当前不可达。

如果接口响应体本身是 JSON，但自动化中返回的是空值，就要检查「返回值」里填写的字段路径是否与真实返回结构一致——例如 API 实际返回 {"result":{"stock":15}}，但你填写的是 stock，那么系统自然无法正确取值。

在正式启用自动化流程之前，务必先关闭其他可能发生冲突、且操作同一字段的自动化规则，避免因为重复触发而造成数据混乱、接口重复调用，甚至引发限流问题。