美洽历史对话列表字段怎么设置？

在美洽里，历史对话列表的字段设置有两条常用路径：一是通过后台“对话/会话列表设置”在界面上选取并排序要显示的列（比如会话ID、客户昵称、渠道、最后消息、未读数、客服、标签、创建/更新时间、自定义字段等）；二是通过 API/导出接口把所需字段拉取到自建报表或 BI 中（常见字段名：conversation_id、visitor_id、channel、status、last_message、unread_count、assigned_agent、tags、created_at、updated_at、custom_fields）。设置时要注意性能、隐私和展示优先级，最好先确定业务场景（客服监控、绩效统计、复盘导出），再为不同角色设计默认列与可选列，同时把关键字段（时间戳、最后消息、状态、工单/订单号）做索引或缓存以保证列表加载速度。

先讲为什么要把字段设置好（像跟朋友解释）

想象你每天要处理上百条历史对话，就像翻一本厚厚的账本。如果每页都只显示客户名字和一句话，你要找关键信息就很费劲；相反，如果页面一打开就有订单号、客服、最后交流时间、未读数和标签，你的工作流程就顺畅多了。字段设置的目的就是把“对你有用的信息”优先呈现出来，减少点击、减少等待、减少失误。

常见使用场景（决定哪些字段优先）

• 客服实时分配与跟进：需要未读数、排队状态、分配客服、优先级、SLA 到期提醒。
• 绩效与质检：需要客服、会话时长、首次响应时间、满意度、评分。
• 售后与订单跟踪：需要订单号、购买时间、商品信息、退款标记、标签/话题。
• 数据分析/导出：需要标准化时间戳、渠道来源、用户ID、自定义属性。

在美洽后台（UI）如何设置字段：一步步来

不同账号版本界面可能有细微差别，但总体流程类似，下面按通用步骤写，按着做通常就能找到对应入口。

步骤一：登录并进入会话/对话列表设置

• 登录美洽管理后台，寻找“对话/会话/会话管理”等模块。
• 在会话列表界面，通常右上角或表格上会有“列设置”“显示字段”或齿轮图标，点开进入字段配置面板。

步骤二：选择与排序列

• 从可选项中勾选需要显示的列（常见有：会话ID、访客昵称、渠道、最后消息、客服、未读数、标签、状态、创建时间、更新时间、自定义字段等）。
• 拖动或上下调整顺序，决定默认的列展示顺序（最常用的字段放前面）。

步骤三：设置默认视图和角色权限

• 如果产品支持视图保存，可以保存为“默认视图”或为不同角色（客服、主管、运营）保存不同视图。
• 设置谁可以修改列（管理员权限）与谁只能使用默认视图（普通客服）。

步骤四：保存并检验

• 保存设置后在会话列表页刷新，检查列是否按预期显示、排序是否正确。
• 模拟几种常见查询（搜索客户、按未读筛选、按时间排序），确认性能与可读性都不错。

如果要更灵活：通过 API 或数据导出定义字段（给开发看的）

UI 设置方便，但当你需要把历史对话接入 BI、做复杂报表或与自家用户库对接时，开发会通过美洽的 API 或数据导出能力来控制字段。大体思路是：在 API 请求中指定要返回的字段，或在导出模板里选择列并映射到你自己的字段名。

常见 API 请求示例（示意）

下面是一个通用的 REST 风格的请求示意（不同版本的美洽 API 路径与参数会有差异，按文档为准）：

GET /api/v1/conversations?start_time=2026-01-01T00:00:00Z&end_time=2026-01-31T23:59:59Z&fields=conversation_id,visitor_id,channel,status,last_message,unread_count,assigned_agent,created_at,updated_at,custom_fields&page=1&page_size=50
Authorization: Bearer {token}

返回的 JSON 中，你会看到类似的字段结构：

{
  "data": [
    {
      "conversation_id": "conv_12345",
      "visitor_id": "v_67890",
      "channel": "WhatsApp",
      "status": "closed",
      "last_message": "您好，订单已经发货",
      "unread_count": 0,
      "assigned_agent": "zhangsan",
      "tags": ["refund","priority"],
      "created_at": "2026-01-10T09:12:34Z",
      "updated_at": "2026-01-11T15:20:00Z",
      "custom_fields": {"order_id": "ORD987654", "vip_level": "gold"}
    }
  ],
  "paging": { "page":1, "page_size":50, "total": 345 }
}

在导出/报表中映射自定义字段

• 定义导出模板，把美洽字段映射为你报表所需的列名（例如 meiqia.custom_fields.order_id → order_no）。
• 如果需要实时同步，把 webhook/消息推送到你方服务，接收到事件后将字段写入你方数据库。
• 注意字段类型一致性（时间戳统一为 UTC 或本地时区）、编码（UTF-8）和缺失值处理。

常用字段清单（表格：名称、英文、类型、含义、示例、是否可排序/搜索、推荐展示）

设计字段展示时的实用建议（贴近操作）

• 少即是多：默认列不宜超过 8-10 列，否则会话列表横向滚动或视觉拥挤。把最常用的字段（最后消息、未读数、客服、时间）放前。
• 按角色定制：客服侧重点是未读数和最后消息，主管侧重绩效指标，运营侧重标签与订单字段。
• 利用自定义字段：把订单号、渠道订单ID、用户等级等放在 custom_fields 并提供列映射，方便筛选与导出。
• 索引关键字段：会话ID、访客ID、时间戳、订单号应在后端建立索引，避免列表翻页变慢。
• 注意隐私合规：敏感信息（身份证号、银行卡）尽量不要在会话列表显示，必要时做脱敏或按权限显示。
• 加载策略：先加载会话元信息（ID、最后消息、时间、未读），把完整消息体异步懒加载，提升首屏速度。

典型问题与故障排查小贴士

为什么我在 UI 勾选了某字段，但看不到？

可能原因包括角色权限限制、列宽被挤压（需要横向滚动）、或者该字段为空（比如未配置自定义字段）。检查权限与是否切换到正确的视图，确认数据源确实有值。

导出后自定义字段为空怎么办？

核查两端字段名称是否一致，确认 webhook 或 SDK 是否在会话创建/更新时推送了 custom_fields。必要时可以写一个小脚本补填历史数据。

列表很慢或分页时间长

• 检查是否在查询时拉取了完整消息体（message bodies），应只拉取摘要或最后消息。
• 对时间、会话ID、订单号等字段建索引或使用搜索服务（Elasticsearch）。
• 分页参数合理设置（page_size 不要太大），并考虑使用滚动或 cursor 分页。

举个实战例子：为跨境电商客服设置字段（一步步来）

假设你负责一个跨境电商客服团队，常见需求是快速定位退货/物流问题、查看订单信息和判断是否 VIP 客户。下面是一个简单的字段配置流程：

• 确定必看列：未读数、最后消息、访客昵称、渠道、assigned_agent、order_id（custom_field）、created_at。
• 在后台列设置里勾选这些列并把 order_id 放在靠前位置。
• 为“主管视图”添加绩效字段：first_response_ms、会话时长、满意度。
• 开发同学在后端把订单号写入 conversation.custom_fields.order_id，并在 API 导出模板映射为“订单号”。
• 测试：用真实或测试会话生成数据，确认列表能按订单号筛选并导出。

技术实现小结（给开发和运维的提醒）

• 接口层面支持 fields 参数以减少带宽。
• 列表首屏只返回必要列，消息内容做懒加载。
• 对可搜索字段（ID、订单号、手机号）专门建立倒排索引或使用搜索引擎。
• 统一时间格式（建议 UTC 存储，前端按用户时区展示）。
• 自定义字段尽量提前约定字段名与类型，避免后期混乱。

好了，就是这些按步骤去做基本就稳了。你可以从确定业务场景开始，把常用字段先固定下来，再在后台试验不同的列组合；需要更复杂的报表时，把数据拉到自己的 BI 平台做二次加工。别忘了定期清理和优化索引，权限和隐私也要一直放在心上——这样字段设置既实用又长久。