在美洽里，排队中的会话主要出现在坐席端的“排队/等待队列”视图（网页版坐席台或移动坐席 APP），主管/管理员也可在管理后台的坐席或统计模块看到实时队列；如果需要机器读取或二次处理，可通过美洽开放平台的实时事件（Webhook）或查询类 API 拉取“等待中/未接入”状态的会话列表，权限、过滤器和渠道设置会影响可见性。
先把概念讲清楚：什么是“排队对话”
把它想像成实体商店门口排队：访客发起的咨询先到达“等候区”，等待有空位的坐席接入。排队对话通常处在“未被坐席接入”或“等待中”的状态，既不是已经结束，也不是正在活跃但被具体坐席接手的会话。
在哪里能看到排队对话（按场景分）
1. 坐席网页版控制台（最常用）
操作路径通常是：登录美洽后台 → 切换到对应工作区/项目 → 打开“坐席/客服台”或“会话中心”。在左侧或上方会有“排队”“等待队列”“未接会话”等标签，点击即可看到当前等待分配或等待坐席接入的会话列表。点击条目可以预览访客信息、历史消息摘要、等待时长并选择“接入/领取/指派”。
2. 管理后台/主管视图
主管和管理员在“监控/坐席监控/实时看板”模块能看到全局排队情况，包含每个坐席的占用情况、队列长度、最长等待时间等汇总数据，方便调度人员做人员调整或触发报警。
3. 坐席移动端（APP）
移动坐席 App（iOS/Android）也会把“等待会话”放在首页或底栏的“会话/排队”里。移动端通常强调一键接入和通知推送，适合外出或远程值班的坐席使用。
4. 通过开放平台（API / Webhook）获取
如果需要自动化监控或与第三方系统联动，可以使用美洽的开放平台：一类是订阅实时事件（Webhook），当有新的会话创建且处于等待状态时会推送事件；另一类是通过查询接口获取“状态为等待/排队”的会话列表，然后按需拉取摘要或全文会话记录并显示在自建控制台中。注意鉴权和频率限制。
坐席端页面各元素如何读？（别被名字吓住）
- 访客 ID / 昵称：快速识别是谁在问。
- 渠道：来自网页、APP、微信、短信等，影响消息到达和多渠道合并。
- 等待时长：从访客发起开始计时，判断是否超过 SLA。
- 会话优先级/标签：高优先级或已打标签的会话可能排在前面或走不同队列。
- 来源页/入口：知道访客从哪个页面来，有助于快速理解问题背景。
- 历史摘要：简短展示访客以往的留言或系统抓取的关键词。
为什么有时候看不到排队会话？常见原因和排查顺序
- 权限问题：你所在的账号可能没有查看队列的权限。检查账号角色和坐席分组设置。
- 过滤器生效：页面上可能开启了只看某个渠道、某个标签或某个坐席组的过滤器，取消过滤再看。
- 渠道/机器人拦截：有些会话被机器人自动接入或通过自动化流程处理，直接就不进入人工排队了。
- 会话已结束：访客关闭会话或超时离开，记录会进入历史而不再显示在等待队列。
- 网络或同步延迟：实时性受网络和推送影响，刷新或检查后端状态。
如何通过 API / Webhook 获取排队会话（思路与注意点）
如果不想只依赖美洽自带界面，可以用两种方式拿到“排队”数据：
- Webhook（推荐用于实时告警）：订阅会话创建/会话状态变更事件，收到新会话且状态为“等待”时，立即在你的系统里把它加入待办队列并推送提醒。
- 查询接口（适合定时拉取与批处理）：定期调用会话列表接口，带上状态筛选（如 status=waiting/queued），分页拉取并处理。注意不要把拉取频率设太高，避免触碰 API 限速。
实操建议：Webhook 用于触发告警与即时展示，查询接口用于数据聚合、统计或补偿式读取。无论哪种方式，都要做好错误重试、幂等处理和鉴权保护。
关于权限与坐席分组：谁能看到哪些排队会话
权限通常由“角色”+“坐席分组”共同决定。一般规则如下：
- 普通坐席：看到分配给自己或自己坐席组的排队会话，或系统分配给可抢占的公共队列。
- 组长/主管：可查看本组内全部排队会话，并能进行指派或强制接入。
- 管理员：查看全局队列、修改队列规则和导出数据。
所以遇到看不到问题，先确认自己属于哪个坐席组、是否有“查看队列/管理会话”的操作权限。
导出、存档与审计：如何把排队数据留存
多数客服系统提供会话导出或报表功能，导出的内容通常包括会话 ID、访客信息、开始时间、等待时长、最终状态、接入坐席与会话记录。常见做法：
- 在管理后台的“报表/会话导出”里按时间区间导出 CSV 或 Excel。
- 通过 API 批量拉取会话详情并存入自建数据库做长期保留与分析。
- 把实时事件通过中间件（如消息队列）入库，保证断网时也不会丢失关键日志。
表格：查看排队会话的快速对照表
| 入口 | 谁能看 | 适用场景 |
| 坐席网页版控制台 | 坐席/组长 | 日常接入与处理单条会话 |
| 管理后台实时看板 | 主管/管理员 | 监控队列长度与 SLA，调度人力 |
| 移动坐席 App | 外勤坐席/轮班坐席 | 远程接入与推送提醒 |
| Webhook / API | 开发/运维/中台 | 系统集成、自动化告警、统计分析 |
运营与技术结合的实战建议（那些小技巧）
- 设定 SLA 与最大等待阈值：当最长等待超过阈值时自动告警或补派人手。
- 优先级与技能路由：对重要用户或高价值单独设置优先队列，或根据问题类型分发至不同技能组。
- 机器人预处理：机器人先做问题筛查并收集关键信息，减少人工排查时间。
- 可抢占的公共队列：允许有空坐席从公共队列抢单，提升响应速度，但要避免频繁打断正在处理的坐席。
- 队列可视化面板：把队列长度、最长等待和未回复数放到大屏或主管手机上，便于实时决策。
常见故障与对策（快速排查清单）
- 看不到排队会话：确认账号权限 → 取消页面过滤 → 刷新或切换工作区。
- 排队数突增：检查活动/推广流量来源 → 启动临时客服或机器人 → 调整分流规则。
- Webhook 不触发：检查回调地址可达性、证书/鉴权、事件订阅配置。
- API 拉取慢：确认分页参数、并发限制，考虑使用增量拉取或后端缓存。
举个小例子，帮你把流程串起来（像教小白一样解释）
想像一个餐馆：访客到门口先排队（会话创建），前台把领号牌放到排队显示屏（排队列表）。当有服务员空闲时，服务员会看显示屏选择一个号来服务（坐席接入）。如果这是 VIP（优先级高），就会被提前安排；如果是自动点餐的机器人能解决的，就直接在自助机上搞定（机器人拦截）。技术上，Web 管理台就是显示屏，Webhook 就像保安的对讲机——有人来了会第一时间通知你。
最后一点建议（别着急，这很实用）
如果你负责日常运营，先从权限和过滤器检查起，确保坐席可以看到他们需要的队列；同时建立简单的报警规则（如队列长度、最长等待）和常用话术模板，机器人承担前置收集信息的工作，这样既能提高接入速度，也让坐席能更有针对性地解决问题。需要更深的自动化或自定义报表时，再考虑用 API 把数据拉回自家系统，把可视化和告警做成团队的“第二大脑”。嗯，这样想一想，差不多就够用了。