创建收集表

最后更新:2026/10/13

创建新的收集表,支持自动生成识客码。

请求方式: POST(HTTPS)

请求地址: https://open.wshoto.com/openapi/collect/form/save?access_token=access_token

Query参数:

参数 类型 必填 说明
access_token string 是 调用接口凭证

Body参数:

{
  "title": "092901",
  "category_id": "0",
  "cover_pic": null,
  "cover_pic_id": null,
  "summary": "092901",
  "commit_button_name": "提交",
  "template_id": "1688384007978396162",
  "sync_mode": 1,
  "field_mapping_id": "1688384008016144898",
  "clue_pool_id": "1694952500660047234",
  "clue_pool_name": "默认线索池",
  "qrcode_type": 1,
  "qrcode_id": "1234567890",
  "qrcode_name": "活码名称",
  "qrcode_url": "",
  "multi_commit": 0,
  "clue_auto_allot": 0,
  "customer_sync_mode": 1,
  "access_customer_channel_list": ["1518834955667346433"],
  "ad_code": "140406",
  "show_type": null,
  "show_content": "{}",
  "guide": "填写指引",
  "jump_type": 1,
  "pic_url": "",
  "user_id": "user123",
  "target_type": 0,
  "visible_dept_ids": [],
  "visible_user_ids": [],
  "allow_edit_submitted": 1,
  "allow_relate_user": 1
}
参数 类型 必填 说明
title string 是 收集表标题
category_id long 否 分类ID
cover_pic string 否 封面图片URL
cover_pic_id long 否 封面图片ID
summary string 否 收集表摘要说明
commit_button_name string 否 提交按钮名称,默认"提交"
template_id long 是 自定义字段模板ID
sync_mode int 否 客户填写时必填:0-不同步,1-同步至线索池,2-同步至客户信息;员工填写时可不传,不执行客户同步
field_mapping_id long 否 字段映射ID
clue_pool_id long 否 线索池ID
clue_pool_name string 否 线索池名称
qrcode_type int 否 二维码类型:1-员工活码,3-识客码
qrcode_id long 否 二维码ID
qrcode_name string 否 二维码名称
qrcode_url string 否 二维码URL
multi_commit int 否 同一客户是否可提交多次:1-是,0-否,默认0
clue_auto_allot int 否 线索自动分配:1-是,0-否,默认0
customer_sync_mode int 否 客户同步模式,默认1
access_customer_channel_list array 否 获客渠道列表
ad_code string 否 指定使用区域代码
show_type int 否 显示类型
show_content string 否 显示内容JSON
guide string 否 填写指引
jump_type int 否 跳转类型
pic_url string 否 图片URL
user_id string 否 用户ID
target_type int 否 填写对象:仅支持0-客户填写、1-员工填写;不传或为 null 时默认 0,兼容原客户表请求
visible_dept_ids string[] 否 员工填写时的可见部门ID列表;与 visible_user_ids 均为空时不限制可见范围
visible_user_ids string[] 否 员工填写时的可见员工ID列表;与 visible_dept_ids 均为空时不限制可见范围
allow_edit_submitted int 否 允许编辑已提交内容:0-否,1-是;不传或为 null 时默认 1
allow_relate_user int 否 员工填写时允许关联人员:0-否,1-是;不传或为 null 时默认 1

返回值:

{
    "code": "00000",
    "msg": "请求成功",
    "data": "1703702408451883585"
}

返回说明:

参数 类型 说明
code string 出错返回码,为"00000"表示成功,其他表示调用失败
msg string 返回码描述
data string 新创建的收集表ID

results matching ""

    No results matching ""