📋 飞书多维表格自动化：多选字段作为 HTTP 请求数组参数

完整指南：如何在飞书多维表格自动化中，将多选字段值转换为 JSON 数组格式，用于 HTTP 请求体。

📑 目录

问题描述
解决方案
完整配置流程
实际应用案例
注意事项
常见问题

📋 问题描述

在飞书多维表格自动化流程中使用「发送 HTTP 请求」节点时，多选字段直接引用会输出逗号分隔的字符串：

❌ 直接引用输出："选项 1,选项 2,选项 3"

但大多数 API 需要JSON 数组格式：

✅ 期望格式：["选项 1", "选项 2", "选项 3"]

✅ 解决方案

方法一：使用公式字段转换（推荐）

1 添加公式字段

在多维表格中新增一个公式字段，使用以下公式：

ARRAYJOIN(多选字段， "\",\"")

多选字段原始值	公式字段输出
选项 1,选项 2,选项 3	`选项 1","选项 2","选项 3`

2 配置 HTTP 请求体

在自动化流程的「发送 HTTP 请求」节点中：

{
  "tags": ["${公式字段}"],
  "other_field": "${其他字段}"
}

最终生成：

{
  "tags": ["选项 1", "选项 2", "选项 3"],
  "other_field": "其他值"
}

方法二：直接引用（仅限接受字符串的 API）

如果目标 API 接受逗号分隔的字符串：

{
  "tags": "${多选字段}"
}

🔧 完整配置流程

1. 创建自动化流程

打开飞书多维表格
点击右上角 「自动化」 → 「+ 创建自动化流程」
选择触发条件

2. 设置触发条件

常用触发条件：

✅ 当有新记录创建时
✅ 当记录被更新时
✅ 当特定字段被修改时
✅ 定时触发

3. 添加 HTTP 请求操作

参数	配置说明
请求方法	POST / PUT / GET / DELETE
请求 URL	目标 API 地址（不支持带查询参数的 URL）
查询参数	以 Key-Value 形式填写
请求头	Content-Type: application/json
请求体类型	Raw (JSON)
请求体内容	JSON 格式，可引用表格字段

4. 配置请求体示例

{
  "title": "${标题字段}",
  "status": "${单选项字段}",
  "tags": ["${公式字段}"],
  "description": "${文本字段}",
  "amount": "${数字字段}",
  "created_at": "${日期字段}"
}

📝 实际应用案例

案例 1：发送飞书群消息

{
  "msg_type": "interactive",
  "card": {
    "config": {
      "wide_screen_mode": true
    },
    "elements": [
      {
        "tag": "div",
        "text": {
          "tag": "lark_md",
          "content": "**项目名称：** ${项目名称}\n**标签：** ${公式字段}"
        }
      }
    ]
  }
}

案例 2：创建任务到第三方系统

{
  "task": {
    "name": "${任务名称}",
    "priority": "${优先级}",
    "labels": ["${公式字段}"],
    "assignee": "${负责人}",
    "due_date": "${截止日期}"
  }
}

案例 3：同步数据到数据库

{
  "record": {
    "id": "${记录 ID}",
    "categories": ["${公式字段}"],
    "metadata": {
      "created_by": "${创建人}",
      "updated_at": "${最后更新时间}"
    }
  }
}

⚠️ 注意事项

JSON 格式要求

要求	说明
双引号	字符串必须使用英文双引号 `""`
冒号分隔	键值对使用英文冒号 `:`
大括号包裹	对象使用 `{}`
中括号数组	数组使用 `[]`
最多键值对	100 个

HTTP 请求限制

限制项	数值
响应超时	60 秒
支持方法	GET / POST / PUT / PATCH / DELETE
状态码解析	仅 200-299 会被解析
内网 URL	❌ 不支持

飞书自动化固定 IP 地址

中国大陆机房：
123.58.10.238, 123.58.10.239, 220.243.131.172, 220.243.131.173, 101.126.59.7, 101.126.59.8, 101.126.59.9

非中国大陆机房：
3.225.193.57, 34.196.227.34

🔍 常见问题

Q1: 为什么 HTTP 请求超时？

答：响应时长上限为 60 秒。若超时，请求可能成功也可能失败，需向被调用方确认。

Q2: 可以直接在 URL 里添加查询参数吗？

答：❌ 不可以。需在 「入参」→「查询参数」 处填写。

Q3: 为什么响应值无法引用？

答：确保：

响应体设置为 JSON 格式
粘贴了正确的响应示例
HTTP 状态码在 200-299 之间

Q4: 多选字段转换为数组后还是字符串？

答：检查公式字段是否正确：

✅ 正确：ARRAYJOIN(多选字段， "\",\"")
❌ 错误：ARRAYJOIN(多选字段， ",")

Q5: 如何调试 HTTP 请求？

答：

使用 Postman 测试 API
在飞书自动化中查看执行日志
检查响应体配置是否正确