获取会话列表 (V2)

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

说明: 项目 ID (project_id) 已在后端 .env 配置文件中配置,无需手动填写。
请求参数 GET
默认值: 1,最大获取 50000 条内容
默认值: 10,最大值: 100
0 活跃会话,1 已结束会话
仅当 session_status=0 时生效
可选,筛选指定客服的会话
可选,JSON 格式 {"start":时间戳,"end":时间戳}
可选,仅 session_status=1 时有效
可选,指定会话 ID
响应
等待请求...

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

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

说明: 项目 ID (project_id) 已在后端 .env 配置文件中配置,无需手动填写。
请求参数 GET
注意:这里需要的是 chat_user_id(用户 ID),不是 session_id(会话 ID)。从"获取会话列表"响应中复制 chat_user_id 字段。
默认值: 1
默认值: 10,最大值: 100
响应
等待请求...

结束会话 (V2)

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

说明: 项目 ID (project_id) 已在后端 .env 配置文件中配置,无需手动填写。
请求参数 POST
必需,加密的会话 ID
必需,聊天用户 ID
响应
等待请求...

批量回聊 (V2)

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

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

分配会话 (V2)

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

说明: 项目 ID (project_id) 已在后端 .env 配置文件中配置,无需手动填写。
请求参数 POST
必需,加密的会话 ID
必需,聊天用户 ID
必需,目标客服人员 ID
响应
等待请求...

获取成员列表 (V2)

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

说明: 项目 ID (project_id) 已在后端 .env 配置文件中配置,无需手动填写。
请求参数 GET
默认值: 1
默认值: 100,最大值: 100
响应
等待请求...

获取标签列表 (V2)

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

说明: 项目 ID (project_id) 已在后端 .env 配置文件中配置,无需手动填写。
请求参数 GET
可选,用于搜索标签
默认值: 1
默认值: 100,最大值: 100
响应
等待请求...

获取客户列表 (V2)

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

说明: 项目 ID (project_id) 已在后端 .env 配置文件中配置,无需手动填写。
请求参数 GET
默认值: 1
默认值: 50,最大值: 100
可选,客户类型
可选,社媒渠道
可选,多个标签 ID 用逗号分隔
可选,国家代码
可选,城市名称
可选,语言代码
可选,在线状态
可选,JSON 格式 {"start":时间戳,"end":时间戳}
必需,JSON 格式 {"start":时间戳,"end":时间戳}
响应
等待请求...

发送消息给客户 (V2)

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

使用说明: 向指定聊天用户发送文本或图片消息
说明: 项目 ID (project_id) 已在后端 .env 配置文件中配置,无需手动填写。
请求参数 POST
必需,项目 ID (字符串形式)
必需,目标用户的 ID
可选,如果不填系统会自动获取或创建会话
默认值: 1 (Messenger)
选择消息类型
必需,要发送的消息文本
可选,消息标签
响应
等待请求...

获取消息列表 (V2)

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

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

获取全量消息列表 (V2)

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

请求参数 GET
必需,项目 ID (字符串形式)
默认值: 100,最大值: 100
可选,用于分页,从指定消息 ID 开始获取
可选,用于分页,到指定消息 ID 结束
响应
等待请求...

获取会话标签

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

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

更新客户资料 (V2)

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

请求参数 POST
必需,项目 ID (字符串形式)
必需,聊天用户 ID
可选,客户姓名
可选,客户昵称
可选,客户邮箱
可选,客户电话
可选,国家代码
可选,城市名称
可选,语言代码
可选,JSON 数组格式
响应
等待请求...

对客户贴标签 (V2)

POST /api/v2/update-user-info - 为客户添加或更新标签

说明: 此功能基于 update-user-info 接口实现,专门用于为客户添加标签。标签会追加到客户现有标签列表中。
请求参数 POST
必需,项目 ID (字符串形式)
必需,目标客户的聊天用户 ID
必需,多个标签用英文逗号分隔
选择是追加标签还是替换现有标签
响应
等待请求...