在美洽里，软表单是把可填写的小表单直接放进对话、工单或外部渠道里，用来稳妥收集用户信息与业务数据。要用它，先在“表单管理”里新建模板、添加字段并设置校验与分支，再在机器人流程或人工会话中调用该表单，配置填写后的数据映射（到工单、客户资料或 Webhook），最后测试并上线。注意字段类型与必填、自动填充与隐私合规，优化触达与引导文案以提升提交率；出现问题按步骤排查字段权限、渠道授权与回调日志即可。
先把概念搞清楚：软表单是什么，为什么要用
软表单不是简单的网页表单，它更像是对话中的“可交互模块”。想象你在微信客服窗口里，客服发来一段小卡片，让你填收件地址、型号、上传凭证，这就是软表单的常见呈现。好处很直观：
- 上下文相关：表单出现在对话里，用户填写时有上下文，转化率更高。
- 结构化数据：替代自由文本回复，便于后端处理、自动分流与统计。
- 可自动化：能和机器人结合，遇到条件自动触发不同表单或字段。
- 易集成：可以同步到工单、CRM 或通过 Webhook 推送给第三方。
适合哪些场景
列举几个典型场景，帮助你判断是否该用软表单：
- 售后报修：收集设备型号、故障描述、购买凭证上传。
- 退换货：填写订单号、退货原因、退款方式。
- 售前询价：客户需求表单，自动把数据打到销售线索池。
- 问卷与满意度调查：会话结束后弹出，收集结构化评分与建议。
一步步教你在美洽创建并使用软表单（费曼式）
把复杂拆成小块讲，每一步都说明为什么这么做。
第 1 步：创建表单模板（先画草图）
- 去管理后台找到“表单管理”或“软表单”入口，点击新建。
- 先像画草稿一样列出你要收集的字段，比如姓名、手机号、订单号、图片上传等。
- 命名模板时写清用途（例如“退货-模板-2026Q1”），便于版本管理。
第 2 步：添加字段并设置类型与校验
每个字段都要问自己两件事：这个字段为什么必要？用户能快速填吗？
- 字段类型要选合适的——文本、手机号、邮箱、下拉、日期、文件、隐藏字段等。
- 设置必填/非必填、格式校验（正则）、最大长度和提示文案。
- 如需图片，限制格式（jpg/png）与大小，写好说明避免用户上传错误内容。
第 3 步：配置条件分支与动态字段
如果某些字段只在特定情形出现，用分支来控制，减少用户负担。例如：
- 若“是否保修”=否，则隐藏“保修单号”字段。
- 根据用户选择不同型号，动态展示相应的配件选项。
第 4 步：映射与自动化（把表单结果送到正确地方）
填写完后数据去哪儿？这一步决定后续自动化能否顺利进行。
- 将字段映射到工单字段、客户资料或第三方系统（CRM、ERP）。
- 配置触发器：表单提交后自动创建工单、分配给某组、或调用 Webhook。
- 如果有 API，可把表单结果通过美洽的回调推送给你的中台。
第 5 步：在会话或渠道中调用表单
你可以通过两种方式让用户看到表单：
- 人工发送：坐席在聊天界面直接发起表单卡片给用户填写。
- 机器人触发：在机器人的流程节点配置“展示软表单”，满足某个意图时自动推送。
字段类型速查表
| 字段类型 | 用途示例 | 注意点 |
| 文本 | 姓名、地址 | 长度限制、禁止特殊字符 |
| 手机号 | 联系号码、短信验证码 | 加国家码校验、唯一性校验 |
| 邮箱 | 收发凭证、通知 | 格式校验、可做替代登录 |
| 下拉/单选 | 产品型号、原因分类 | 选项要简洁明了，避免太多层级 |
| 文件/图片 | 发票、照片 | 大小/格式限制，开启防病毒或审核 |
| 隐藏字段 | 渠道来源、会话 ID | 用于传递上下文，不会展示给用户 |
示例：从创建到上线的真实操作流程（一个小案例）
假设你要为“退换货”场景建立软表单，我会按步骤写出实际要点，边做边说明：
- 新建模板“退换货 2026-春”：字段包括订单号（必填、数字校验）、退货原因（下拉）、照片上传（文件，最大 5MB）、退款方式（单选）。
- 设置分支：若退款方式选“原路返回”，显示“银行账号”字段；若选“原支付渠道”，隐藏该字段。
- 映射：订单号映射到工单的“外部订单号”，退款方式映射到自定义字段“退款方案”。
- 自动化：提交表单后触发工单状态为“待审核”，并通过机器人发出确认消息给用户。
- 测试：模拟不同渠道（微信、网站、短信）发起表单，检查回调日志与字段映射是否正确。
同步、集成与回调示例表（便于工程师参考）
| 表单字段 | 目标系统字段 | 回调/示例值 |
| 订单号 | crm.order_id | {“order_id”:”20260301-1234″} |
| 手机号 | ticket.customer_phone | {“customer_phone”:”+8613712345678″} |
| 照片 | attachments[] | {“attachments”:[“https://…/img1.jpg”]} |
测试清单：上线前必须过的八道关
- 字段校验（格式、必填）是否生效？
- 分支逻辑是否按预期显隐字段？
- 不同渠道渲染是否一致（H5、公众号、小程序、网页）？
- 表单提交后是否生成工单并映射字段？
- Webhook 是否收到正确的 JSON？
- 文件上传是否能正确存储与预览？
- 是否考虑了异常网络或重复提交场景？
- 隐私合规文案与数据保留策略是否明确？
合规与安全要点（不能忽视）
收集个人信息时务必合规：只收必要信息、明确告知用途、展示隐私政策、提供用户删除/查阅渠道。技术层面要注意传输加密（HTTPS）、回调签名校验、附件病毒扫描与访问权限控制。
常见问题与排查方法
- 用户看不到表单或卡片：检查渠道能力（部分渠道对富卡片支持有限）、消息权限与模板发布状态。
- 字段映射为空：确认字段名称一致并已保存映射，检查回调日志看是否有字段丢失。
- Webhook 收不到回调：看美洽回调日志，确认接收方能访问且未被防火墙/IP白名单阻断。
- 图片无法上传：检查文件大小限制、格式限制、临时目录权限与 CDN 回源是否异常。
优化建议（提升提交率和数据质量）
- 减少必填字段：只留关键字段，其他可后续补充。
- 分步填写：把长表单拆成 2-3 步，降低一次性完成难度。
- 预填已知信息：从会话上下文或用户资料预填手机号、姓名等。
- 增加进度提示与说明：短提示能显著提升完成率。
- A/B 测试：对不同文案、字段顺序做小规模测试再推广。
小结里不总结，只留一句话给你
把软表单当成会话里的“工具箱”去设计：想清楚每个字段的用途、用户的填写成本和数据接收端的处理流程，按着上面的步骤走一遍，遇到问题别慌，按日志和映射一步步排查，很快就能把它变成稳定的流量转化与数据采集入口。就先写到这里，去试一版简洁的表单，回头你会发现还能再调些小细节，效果会更好。