美洽如何传递自定义字段？

直接回答：在美洽中传递自定义字段通常有三步，先在后台建立字段，再在前端或埋点中填写并通过SDK或API传入，最后在客服侧或自动化规则中读取并使用，注意字段名和格式要统一并做好测试。若不确定可先小范围验证再全量上线。避免数据混乱并留审计记录。

美洽后台创建自定义字段流程

新增字段与命名规则

• 创建字段：在美洽后台找到自定义字段管理，点击新增并输入名称，建议用简短且有意义的名字，方便客服和自动化规则识别，避免使用特殊符号。
• 选择类型：根据需要选文本、数字或下拉等类型，字段类型会影响前端填写方式和后续匹配逻辑，合理选择有助于减少数据错误。
• 设置必填：如果该信息很重要可以设置为必填项，这样在前端不填写就无法提交，能在源头减少缺失数据，提高后续使用准确性。

字段权限与可见性设置

• 控制权限：给不同岗位分配查看或编辑权限，防止不相关人员误改关键字段，权限设置能保护数据并减少操作错误。
• 设置可见范围：决定该字段对访客、客服或第三方应用是否可见，按实际需求隐藏敏感信息，既满足业务又保障隐私。
• 字段说明：在字段配置中写清楚用途和填写规范，团队成员看到说明就能统一填写方式，减少后续解释和数据清洗工作。

美洽前端埋点传参示例

页面埋点填写访客信息

• 监听事件：在网站或小程序关键页面埋点，监听用户提交表单或触达事件，然后把表单值映射到美洽字段并传送，保证字段名一致。
• 格式转换：前端传参前做简单验证和格式化，比如把手机号、日期统一格式，能避免后台出现不规范数据，客服看着也更直观。
• 默认值设置：遇到空值可以填默认提示或占位值，减少空字段带来的处理难度，后续再由客服或自动化补充真实信息。

通过SDK调用传入字段

• 初始化参数：在接入美洽的SDK时把常用访客信息作为初始化参数传入，这样一进会话客服端就能看到基础资料，省去重复询问。
• 动态更新：用户在页面发生新的操作时，用SDK提供的更新方法把最新字段推送到美洽，保持资料实时同步，避免信息滞后。
• 错误处理：前端调用失败时要有本地重试或记录机制，避免一时网络问题丢失关键资料，重试策略能提高数据完整性。

美洽通过API同步自定义字段方法

批量同步与单条更新

• 批量上传：当有大量历史用户资料需要导入时，用美洽提供的批量接口一次性同步，提前做好字段映射表，避免导入后大量修正工作。
• 单条更新：对单个用户的异动信息，可用单条更新接口实时写入，适合表单提交或客服编辑后即时更新用户画像。
• 幂等设计：调用API时尽量设计幂等逻辑，避免重复写入或冲突，方便出现异常时安全回滚和数据校对。

接口安全与频率控制

• 校验密钥：用API时妥善保管密钥或凭证，后端调用时将敏感信息放在服务器端，避免泄露给前端，保护用户数据安全。
• 限流策略：接口调用不要短时间内过量请求，按照美洽的推荐频率控制发送频次，避免被限流导致同步失败。
• 日志记录：记录每次同步请求和返回结果，出问题时可以快速定位是哪条数据或哪个时段出现异常，便于快速修复。

美洽在会话和访客资料中使用字段

在会话侧展示自定义字段

• 会话侧展示：把关键自定义字段放在会话界面明显位置，客服一打开就能看到背景信息，提高首次响应的效率和服务体验。
• 展示优先级：不同字段根据重要性设置展示顺序，把高价值信息放前面，常见问题或低频信息可以折叠隐藏，界面更清爽。
• 快速编辑：允许客服在会话中直接编辑字段并同步回访客资料，减少切换页面的操作，节省处理时间并保证信息及时更新。

访客资料与历史记录结合

• 资料聚合：把自定义字段和历史会话、工单或充值记录聚合展示，客服能快速了解客户全貌，做出更贴合的建议和回应。
• 变更记录：保留字段变更日志，能看到什么时候谁修改了什么，方便追溯和纠偏，遇到数据异常可以更快找到原因。
• 侧边栏快捷：把常用字段放在访客侧边栏，客服随时能快速查看和参考，减少来回翻找资料影响沟通节奏。

美洽结合工单与自动化规则应用

自动化触发与字段联动

• 触发条件：利用自定义字段作为自动化触发条件，比如字段值达到某个状态就自动分配工单或推送提醒，减少人工干预。
• 自动补填：通过规则自动为会话补填某些字段，遇到常见场景时系统预设信息帮助客服节省输入时间，提高响应一致性。
• 通知策略：根据字段变化自动通知相关人员或系统，例如VIP字段变更时自动提醒客户经理跟进，提升客户体验。

工单处理与字段利用

• 字段映射工单：把自定义字段映射到工单模板中，工单创建时自动带出关键信息，处理人员可直接看到要点，回复更精准。
• 优先级判断：用字段信息决定工单优先级或分级处理，例如投诉次数字段较高则自动提升处理优先级，缩短处理时长。
• 闭环验证：在工单关闭前检查相关字段是否已被更新，确保问题处理后用户资料已同步，避免后续重复投诉或信息不一致。

美洽排查与测试自定义字段问题

本地与小范围验证方法

• 小范围试点：先在少量真实用户或测试环境进行字段传递验证，观察数据是否按预期入库并显示，发现问题再调整方案。
• 模拟场景：把常见用户行为在本地或测试账号上模拟一遍，确保前端埋点、SDK或API都能正确传参并触发目标流程。
• 回退预案：设计回退流程，若大规模上线出现问题能迅速回滚或暂停数据同步，保护线上数据和客户体验。

日志查错与常见问题解决

• 查看日志：当字段未正确入库或展示异常时，先查接口和系统日志，定位是前端未传、接口错误还是字段映射错位，然后逐步排查。
• 校验格式：常见问题包括日期、手机号或枚举值格式不一致，统一校验规范并在前端做验收，可以大幅降低错误率。
• 联系人协同：遇到跨系统问题时及时联系美洽支持或开发同事，将日志和复现步骤一并提交，加快问题定位和修复速度。