美洽怎么设置访客端聊天窗口留言表单字段?
在美洽后台里,进入“设置/访客端(或渠道)→聊天窗口→留言表单/访客信息”,点“新增字段”或编辑已有字段,选择字段类型(文本、下拉、单选、多选、邮箱、手机号、隐藏等)、填写字段名称与字段标识(用于接口传参)、设置必填/默认值/占位提示与校验规则、配置显示位置(聊天窗口即时、离线留言或仅弹窗)、保存并发布;需要前端预填或动态控制时,配合美洽的 SDK/嵌入脚本传入字段标识或访客属性即可。

先把要做的事说清楚(为什么要设置留言表单)
说到底,留言表单的目的是在与访客还没建立人工对话时,尽量收集到关键信息,方便快速识别用户、分流问题、自动建单或作后续跟进。把表单做好,可以减少坐席反复问询,提高首响应质量,也能把访客带入更合适的处理流程。
一步步教你在美洽里设置(按费曼法:先说明步骤,再逐步拆开)
整体流程概览(5 步)
- 登录美洽管理后台(企业账号)
- 进入访客端/渠道/聊天窗口相关设置,找到“留言表单”“访客信息”或“表单配置”入口
- 新增或编辑字段,定义类型、标识、校验、显示位置等属性
- 保存并发布配置;如果有多渠道,确认应用到正确的渠道或站点
- 在前端测试并(如有需要)通过 SDK/嵌入脚本进行预填或动态控制
每一步拆解(详细操作)
下面我把每步的关键点和常见选项拆开解释,别急,照着做就行。
1)登录并找到表单配置入口
- 登录管理后台后,通常路径是“设置(或者工作台)→ 渠道/访客端 → 聊天窗口/留言设置 → 留言表单(或访客信息)”。不同版本菜单名可能略有差异,但基本在“设置/渠道/访客端”类目下。
- 如果看不到,确认账号权限是否有“设置”或“管理员”权限,或者是否使用的是多站点/多渠道控制台。
2)新增字段或编辑已有字段
- 点击“新增字段”/“添加表单项”。
- 常见配置项包括:字段名称(访客看到的标签)、字段标识(key,用于接口与映射)、字段类型、是否必填、占位提示、默认值、校验规则(正则)、可见性/显示位置、选项值(针对下拉/单选/多选)等。
3)字段类型说明(一张表说明清楚)
| 类型 | 用途/说明 | 注意点 |
| 单行文本 | 通用文本输入,姓名、工单号等 | 设置最大长度与占位提示 |
| 多行文本 | 留言内容、问题描述 | 适合长文本,提交时可能有字数限制 |
| 下拉 / 单选 | 问题分类、商品分类、渠道来源 | 预先定义选项,便于分流与统计 |
| 多选 | 场景选择、兴趣点 | 注意前端展示与后台存储格式 |
| 电话 / 手机 | 收集电话号码,通常有默认格式校验 | 可配置为必填,并增加正则校验 |
| 邮箱 | 收集邮箱地址,便于后续邮件联系 | 配合正则校验,防止脏数据 |
| 隐藏字段 | 用于传递来源、渠道、广告 ID 等 | 不显示给访客,但可由前端或链接带入 |
| 文件上传 | 允许访客上传截图或凭证 | 注意文件大小与类型限制、存储时间 |
4)校验规则与必填策略
校验规则能有效保证数据质量。常见做法:
- 手机号(中国)常用正则:^1[3-9]\d{9}$
- 邮箱常用正则:^[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}$
- 数字或订单号可以用:^[0-9A-Za-z\-]+$(允许字母数字短横)
- 必填字段应尽量精简——只把最关键的设成必填,避免访客放弃留言
显示位置与触发条件
表单不一定在所有场景都显示。美洽通常支持的显示位置包括:
- 聊天窗口顶部的访客信息栏(打开窗口即可见)
- 点击“留言”或在线离线状态下的弹窗
- 仅在离线(坐席不在线或营业外)时显示为留言表单
- 按渠道或网站域名分配不同表单(多站点或多渠道)
保存、发布与生效范围
做完配置后一定要“保存”并“发布/生效”。如果你有多站点、多个嵌入码或渠道,需要确认该表单已应用到对应的渠道/网站/小程序。常见问题是改了但没生效,往往是因为忘记点击“发布”或没选对渠道。
如何在前端预填和动态控制表单(让体验更流畅)
最常见的场景是登录用户或者已知访客信息,想把姓名、手机号、订单号预填到表单,减少重复输入。还有场景是基于页面或来源展示不同的表单项。
两条常用路径
- 管理后台“字段标识(key)”与前端参数对接:在新增字段时填写唯一的字段标识,前端通过 SDK 或嵌入脚本把对应 key 的值传给美洽。
- 通过 URL 或隐藏字段带入:把来源、campaign、商品 ID 等当隐藏字段放入页面,或在打开消息窗口时通过函数调用填充。
示例(伪代码,说明思路):
/* 假设字段标识为 orderId、phone */
MQ && MQ.setVisitor({
orderId: 'A123456',
phone: '13800138000'
});
具体函数名会随美洽 SDK 版本而不同,最好查阅当前管理后台的“开发接入”或“帮助文档”里的 SDK 调用示例。
表单与业务系统的映射(把访客信息接入 CRM/工单)
设置表单字段后,你通常还需要把这些数据映射到企业后台(CRM、工单系统或数据仓库)。在美洽后台可以做以下配置:
- 字段标识与访客属性映射:把表单值存为访客属性(方便在会话中查阅)
- 表单值映射到工单或工单自定义字段,方便后续统计与分配
- 使用 webhook 或 API 把留言数据实时推送到你的业务系统
如果你需要复杂的映射逻辑(比如把“问题类型”根据值分配到不同组),可以在后台设置自动化规则或在接收方系统中做二次处理。
实战示例:电商场景的留言表单设计
举个例子吧,假设你是电商客服,想在访客打开聊天窗口时收集关键信息以便快速定位订单:
- 表单项:姓名(单行)、手机号(电话,必填)、订单号(单行)、问题分类(下拉:退货/物流/商品/售后)、详情(多行)
- 配置要点:手机号必填并做正则校验;订单号可非必填但加占位示例;问题分类做下拉便于坐席标签化和工单分流
- 前端优化:如果用户已登录,预填姓名、手机号和历史订单号;如果来源是订单页,可自动填入 orderId 隐藏字段
常见问题与排查技巧(别被坑了)
- 表单改了但前端看不到:确认已发布、确认你访问的是当前渠道/站点、清除页面缓存或浏览器缓存。
- 必填导致无法留言:检查是否必要字段过多,尝试把必填项减少或提供“跳过/稍后补充”的选项。
- 前端预填不生效:核对字段“标识(key)”是否一致,检查 SDK 版本与调用方式,查看控制台是否有错误。
- 数据无法映射到 CRM:确认字段标识在双方系统一致,查看 webhook/推送日志,检查字段类型是否兼容。
- GDPR/隐私合规:收集个人信息前给出隐私说明或复选同意,敏感信息(身份证、银行卡)慎用或加密传输。
安全与隐私注意事项
- 尽量避免在表单中收集敏感信息,若必须收集,确认传输与存储的加密策略。
- 合理设置字段可见性,限制只有有权限的坐席能查看敏感字段。
- 合规显示隐私/同意条款,遵守本地法律(如中国个人信息保护相关要求、欧盟 GDPR 等)。
最佳实践(让访客不反感又能拿到关键数据)
- 最小化必填字段:只要拿到能启动服务的最少信息,其他可以后续补全。
- 使用智能预填:登录用户或来源带参自动填充,减少重复输入。
- 设计清晰的占位与错误提示:即时校验并提示错误原因(例如“手机号格式错误”),不要只给“必填”警告。
- 用下拉或单选规范化分类:方便统计与自动化分配坐席。
- 把隐藏字段用于埋点:来源、渠道、广告编号等自动带入,便于归因与优化。
遇到技术难题时的快速检查清单
- 是否用的是正确的管理账号和渠道?
- 字段标识(key)是否唯一且与前端一致?
- 发布步骤是否完成?是否选择了正确的应用范围?
- 浏览器控制台是否有脚本错误或跨域问题?
- 服务器/中台是否接收到了 webhook 或 API 调用?返回是否有报错?
总结一下(好像还没完,但就这么多要点)
总之,设置美洽访客端的聊天窗口留言表单,核心是:在后台定义清晰的字段(名称、标识、类型、校验、显示位置),发布到正确渠道,并结合前端 SDK 或隐藏字段做到预填与动态控制。别忘了映射到你的 CRM/工单系统、做好数据校验与隐私合规,以及在真实场景里反复优化表单项以提升转化率。
如果你要我,我可以接着帮你把一套典型的电商/金融/教育三套表单模板写出来,或者把你当前的字段清单审一遍,提出改进建议——不过先把你后台截图或字段导出来发来,我好按实际字段给出更精确的改法。