获取会话列表 (V2)

GET /api/v2/get-session-list - 获取所有会话列表,支持分页和筛选

官方文档: 获取会话列表

请求参数 GET
默认值: 1,最大获取 50000 条内容
默认值: 10,最大值: 100
0 活跃会话,1 已结束会话
仅当 session_status=0 时生效
可选,筛选指定客服的会话
可选,JSON 格式 {"start":时间戳,"end":时间戳}
可选,仅 session_status=1 时有效
可选,指定会话 ID
响应
等待请求...

获取指定用户的会话列表 (V2)

GET /api/v2/get-user-sessions - 获取指定聊天用户的所有会话记录

官方文档: 获取聊天记录列表(指定用户)

请求参数 GET
注意:这里需要的是 chat_user_id(用户 ID),不是 session_id(会话 ID)。从"获取会话列表"响应中复制 chat_user_id 字段。
默认值: 1
默认值: 10,最大值: 100
响应
等待请求...

结束会话 (V2)

POST /api/v2/end-session - 主动结束进行中的会话

官方文档: 结束会话

请求参数 POST
必需,加密的会话 ID
必需,聊天用户 ID
响应
等待请求...

批量回聊 (V2)

POST /api/v2/batch-talk-back - 批量发送消息到多个用户会话

官方文档: 批量回聊

使用说明: 用于系统通知、活动消息推送等场景,向多个用户发送相同消息。消息内容在 Salesmartly 平台后台配置。
请求参数 POST
可选,发送消息的客服人员 ID
必需,多个用户 ID 用英文逗号分隔,上限 100 个
响应
等待请求...

分配会话 (V2)

POST /api/v2/assign-chat-user - 将会话分配给指定的销售人员

官方文档: 会话分配接口

请求参数 POST
必需,加密的会话 ID
必需,聊天用户 ID
必需,目标客服人员 ID
响应
等待请求...

获取成员列表 (V2)

GET /api/v2/get-member-list - 获取销售人员列表

官方文档: 获取团队成员

请求参数 GET
默认值: 1
默认值: 100,最大值: 100
响应
等待请求...

获取标签列表 (V2)

GET /api/v2/get-label-list - 获取所有标签列表,支持按标签名搜索

官方文档: 获取访客标签名详情

请求参数 GET
可选,用于搜索标签
默认值: 1
默认值: 100,最大值: 100
响应
等待请求...

获取客户列表 (V2)

GET /api/v2/get-contact-list - 获取客户列表,支持按标签、更新时间筛选

官方文档: 获取客户列表

请求参数 GET
默认值: 1
默认值: 50,最大值: 100
可选,客户类型
可选,社媒渠道
可选,多个标签 ID 用逗号分隔
可选,国家代码
可选,城市名称
可选,语言代码
可选,在线状态
可选,JSON 格式 {"start":时间戳,"end":时间戳}
必需,JSON 格式 {"start":时间戳,"end":时间戳}
响应
等待请求...

发送消息给客户 (V2)

POST /api/v2/send-message - 向指定客户发送消息

官方文档: 获取会话列表

使用说明: 向指定聊天用户发送文本或图片消息
请求参数 POST
必需,目标用户的 ID
可选,如果不填系统会自动获取或创建会话
默认值: 1 (Messenger)
选择消息类型
必需,要发送的消息文本
可选,消息标签
响应
等待请求...

获取消息列表 (V2)

GET /api/v2/get-message-list - 获取指定用户的聊天记录列表

官方文档: 获取聊天记录列表(指定用户)

请求参数 GET
必需,聊天用户 ID
默认值: 100,最大值: 100
可选,开始消息 ID
可选,结束消息 ID
必需,JSON 格式 {"start":时间戳,"end":时间戳}
响应
等待请求...

获取全量消息列表 (V2)

GET /api/v2/get-all-message-list - 获取所有聊天记录列表 (全量)

官方文档: 获取聊天记录列表(全量)

请求参数 GET
默认值: 100,最大值: 100
可选,用于分页,从指定消息 ID 开始获取
可选,用于分页,到指定消息 ID 结束
响应
等待请求...

获取会话标签

从会话列表中提取并解析会话标签(tags)

官方文档: 获取会话标签列表

使用说明: 会话标签包含在会话列表响应中,此工具用于获取会话列表并解析 tags 字段
请求参数 GET
默认值: 1
默认值: 50,最大值: 100
0 活跃会话,1 已结束会话
可选,指定则只获取该会话的标签
响应
等待请求...

更新客户资料 (V2)

POST /api/v2/update-user-info - 更新客户资料

官方文档: 更新客户资料

说明: 客户标签新增、更新、绑定请使用“访客标签值调试”标签页。本页仅用于资料字段更新,不再作为标签联调入口。
请求参数 POST
必需,聊天用户 ID
可选,客户姓名
可选,客户昵称
可选,客户邮箱
可选,客户电话
可选,国家代码
可选,城市名称
可选,语言代码
响应
等待请求...

访客标签值调试

统一测试标签分类、标签名、标签值的补建,标签值更新,以及给客户绑定具体标签值。

官方文档: 编辑访客标签值

统一链路: 本页所有操作都走同一套后端服务。`webhook -> AI 回调 -> 给客户打标签` 也复用这套逻辑。
1. 补建标签值 POST
例如 阶段、语言、国家
默认与分类名一致,可留空
例如 综合诊断、印地语、沙特阿拉伯
补建响应
等待请求...
2. 更新标签值 POST
更新响应
等待请求...
3. 给客户绑定具体值 POST
支持 JSON 数组,或输入 `阶段:综合诊断, 语言:印地语, 国家:沙特阿拉伯`
绑定响应
等待请求...
4. 一键补建并绑定 POST
推荐用于验证“没有就新建,有了就绑定”的完整链路。
一键补建响应
等待请求...