# salesmartly_api ## Docs - [响应码文档](https://salesmartly-api.apifox.cn/%E5%93%8D%E5%BA%94%E7%A0%81%E6%96%87%E6%A1%A3-6319090m0.md): - [接口QPS限制文档](https://salesmartly-api.apifox.cn/%E6%8E%A5%E5%8F%A3qps%E9%99%90%E5%88%B6%E6%96%87%E6%A1%A3-6974984m0.md): - [系统常量相关文档](https://salesmartly-api.apifox.cn/%E7%B3%BB%E7%BB%9F%E5%B8%B8%E9%87%8F%E7%9B%B8%E5%85%B3%E6%96%87%E6%A1%A3-7151545m0.md): - [渠道id和渠道名称映射](https://salesmartly-api.apifox.cn/%E6%B8%A0%E9%81%93id%E5%92%8C%E6%B8%A0%E9%81%93%E5%90%8D%E7%A7%B0%E6%98%A0%E5%B0%84-8358938m0.md): ## API Docs - V2 > 客户管理 > 访客标签管理 [获取访客标签列表](https://salesmartly-api.apifox.cn/%E8%8E%B7%E5%8F%96%E8%AE%BF%E5%AE%A2%E6%A0%87%E7%AD%BE%E5%88%97%E8%A1%A8-456389145e0.md): 获取项目下的客户标签列表,支持分页与按标签名(单值或逗号分隔多值)筛选。结果按 created_time 倒序返回。 - V2 > 客户管理 > 访客标签管理 [获取访客标签分类列表](https://salesmartly-api.apifox.cn/%E8%8E%B7%E5%8F%96%E8%AE%BF%E5%AE%A2%E6%A0%87%E7%AD%BE%E5%88%86%E7%B1%BB%E5%88%97%E8%A1%A8-476331012e0.md): - V2 > 客户管理 > 访客标签管理 [新增访客标签分类](https://salesmartly-api.apifox.cn/%E6%96%B0%E5%A2%9E%E8%AE%BF%E5%AE%A2%E6%A0%87%E7%AD%BE%E5%88%86%E7%B1%BB-476331013e0.md): - V2 > 客户管理 > 访客标签管理 [编辑访客标签分类](https://salesmartly-api.apifox.cn/%E7%BC%96%E8%BE%91%E8%AE%BF%E5%AE%A2%E6%A0%87%E7%AD%BE%E5%88%86%E7%B1%BB-476331014e0.md): - V2 > 客户管理 > 访客标签管理 [删除访客标签分类](https://salesmartly-api.apifox.cn/%E5%88%A0%E9%99%A4%E8%AE%BF%E5%AE%A2%E6%A0%87%E7%AD%BE%E5%88%86%E7%B1%BB-476331015e0.md): 如果分类下仍存在未删除的标签名,返回 code=400,不做隐式级联删除。 - V2 > 客户管理 > 访客标签管理 [获取访客标签名列表](https://salesmartly-api.apifox.cn/%E8%8E%B7%E5%8F%96%E8%AE%BF%E5%AE%A2%E6%A0%87%E7%AD%BE%E5%90%8D%E5%88%97%E8%A1%A8-476331016e0.md): - V2 > 客户管理 > 访客标签管理 [获取访客标签名详情](https://salesmartly-api.apifox.cn/%E8%8E%B7%E5%8F%96%E8%AE%BF%E5%AE%A2%E6%A0%87%E7%AD%BE%E5%90%8D%E8%AF%A6%E6%83%85-476331017e0.md): - V2 > 客户管理 > 访客标签管理 [新增访客标签名](https://salesmartly-api.apifox.cn/%E6%96%B0%E5%A2%9E%E8%AE%BF%E5%AE%A2%E6%A0%87%E7%AD%BE%E5%90%8D-476331018e0.md): 可同时创建多个标签值;标签名同项目唯一,标签值同项目唯一。 - V2 > 客户管理 > 访客标签管理 [编辑访客标签名](https://salesmartly-api.apifox.cn/%E7%BC%96%E8%BE%91%E8%AE%BF%E5%AE%A2%E6%A0%87%E7%AD%BE%E5%90%8D-476331019e0.md): - V2 > 客户管理 > 访客标签管理 [删除访客标签名](https://salesmartly-api.apifox.cn/%E5%88%A0%E9%99%A4%E8%AE%BF%E5%AE%A2%E6%A0%87%E7%AD%BE%E5%90%8D-476331020e0.md): 软删标签名,并软删其下所有标签值。 - V2 > 客户管理 > 访客标签管理 [新增访客标签值](https://salesmartly-api.apifox.cn/%E6%96%B0%E5%A2%9E%E8%AE%BF%E5%AE%A2%E6%A0%87%E7%AD%BE%E5%80%BC-476331021e0.md): - V2 > 客户管理 > 访客标签管理 [编辑访客标签值](https://salesmartly-api.apifox.cn/%E7%BC%96%E8%BE%91%E8%AE%BF%E5%AE%A2%E6%A0%87%E7%AD%BE%E5%80%BC-476331022e0.md): - V2 > 客户管理 > 访客标签管理 [删除访客标签值](https://salesmartly-api.apifox.cn/%E5%88%A0%E9%99%A4%E8%AE%BF%E5%AE%A2%E6%A0%87%E7%AD%BE%E5%80%BC-476331023e0.md): - V2 > 客户管理 > 自定义字段管理 [获取自定义字段列表](https://salesmartly-api.apifox.cn/%E8%8E%B7%E5%8F%96%E8%87%AA%E5%AE%9A%E4%B9%89%E5%AD%97%E6%AE%B5%E5%88%97%E8%A1%A8-464923729e0.md): 获取项目下未删除的自定义字段定义,列表项已展开选择字段配置,可直接用于编辑回填。 - V2 > 客户管理 > 自定义字段管理 [新增或编辑自定义字段](https://salesmartly-api.apifox.cn/%E6%96%B0%E5%A2%9E%E6%88%96%E7%BC%96%E8%BE%91%E8%87%AA%E5%AE%9A%E4%B9%89%E5%AD%97%E6%AE%B5-479792747e0.md): id 为空或 0 时新增;id 大于 0 时编辑。选择字段新增项不传 id,后端按 web 逻辑生成选项 id。 - V2 > 客户管理 > 自定义字段管理 [启用或禁用自定义字段](https://salesmartly-api.apifox.cn/%E5%90%AF%E7%94%A8%E6%88%96%E7%A6%81%E7%94%A8%E8%87%AA%E5%AE%9A%E4%B9%89%E5%AD%97%E6%AE%B5-479792748e0.md): - V2 > 客户管理 > 自定义字段管理 [删除自定义字段](https://salesmartly-api.apifox.cn/%E5%88%A0%E9%99%A4%E8%87%AA%E5%AE%9A%E4%B9%89%E5%AD%97%E6%AE%B5-479792749e0.md): 先清理 Mongo 客户扩展信息中的对应 system_id 字段值,成功后再软删 MySQL 字段定义。 - V2 > 客户管理 > 自定义字段管理 [修改自定义字段排序](https://salesmartly-api.apifox.cn/%E4%BF%AE%E6%94%B9%E8%87%AA%E5%AE%9A%E4%B9%89%E5%AD%97%E6%AE%B5%E6%8E%92%E5%BA%8F-479792750e0.md): - V2 > 客户管理 [获取客户列表](https://salesmartly-api.apifox.cn/%E8%8E%B7%E5%8F%96%E5%AE%A2%E6%88%B7%E5%88%97%E8%A1%A8-258167563e0.md): - V2 > 客户管理 [新增客户](https://salesmartly-api.apifox.cn/%E6%96%B0%E5%A2%9E%E5%AE%A2%E6%88%B7-276530997e0.md): - V2 > 客户管理 [批量操作标签(异步执行)](https://salesmartly-api.apifox.cn/%E6%89%B9%E9%87%8F%E6%93%8D%E4%BD%9C%E6%A0%87%E7%AD%BE%E5%BC%82%E6%AD%A5%E6%89%A7%E8%A1%8C-296178103e0.md): - V2 > 客户管理 [更新客户资料](https://salesmartly-api.apifox.cn/%E6%9B%B4%E6%96%B0%E5%AE%A2%E6%88%B7%E8%B5%84%E6%96%99-296183457e0.md): - V2 > 客户管理 [导入客户订单](https://salesmartly-api.apifox.cn/%E5%AF%BC%E5%85%A5%E5%AE%A2%E6%88%B7%E8%AE%A2%E5%8D%95-311462851e0.md): - V2 > 客户管理 [批量分配客户](https://salesmartly-api.apifox.cn/%E6%89%B9%E9%87%8F%E5%88%86%E9%85%8D%E5%AE%A2%E6%88%B7-426704813e0.md): - V2 > 团队管理 [获取团队成员](https://salesmartly-api.apifox.cn/%E8%8E%B7%E5%8F%96%E5%9B%A2%E9%98%9F%E6%88%90%E5%91%98-310397215e0.md): - V2 > 会话管理 > 会话标签管理 [获取会话标签分类列表](https://salesmartly-api.apifox.cn/%E8%8E%B7%E5%8F%96%E4%BC%9A%E8%AF%9D%E6%A0%87%E7%AD%BE%E5%88%86%E7%B1%BB%E5%88%97%E8%A1%A8-480312755e0.md): 分页获取会话标签分类。 - V2 > 会话管理 > 会话标签管理 [新增会话标签分类](https://salesmartly-api.apifox.cn/%E6%96%B0%E5%A2%9E%E4%BC%9A%E8%AF%9D%E6%A0%87%E7%AD%BE%E5%88%86%E7%B1%BB-480312756e0.md): 创建一级分类或二级分类。 - V2 > 会话管理 > 会话标签管理 [更新会话标签分类](https://salesmartly-api.apifox.cn/%E6%9B%B4%E6%96%B0%E4%BC%9A%E8%AF%9D%E6%A0%87%E7%AD%BE%E5%88%86%E7%B1%BB-480312757e0.md): 重命名一级分类或二级分类。 - V2 > 会话管理 > 会话标签管理 [获取会话标签列表](https://salesmartly-api.apifox.cn/%E8%8E%B7%E5%8F%96%E4%BC%9A%E8%AF%9D%E6%A0%87%E7%AD%BE%E5%88%97%E8%A1%A8-466603366e0.md): 分页获取最终会话标签列表,仅返回可打到会话上的 level=3 标签。 - V2 > 会话管理 > 会话标签管理 [删除会话标签分类](https://salesmartly-api.apifox.cn/%E5%88%A0%E9%99%A4%E4%BC%9A%E8%AF%9D%E6%A0%87%E7%AD%BE%E5%88%86%E7%B1%BB-480312758e0.md): 软删除一级分类或二级分类。 - V2 > 会话管理 > 会话标签管理 [新增会话标签](https://salesmartly-api.apifox.cn/%E6%96%B0%E5%A2%9E%E4%BC%9A%E8%AF%9D%E6%A0%87%E7%AD%BE-480312759e0.md): 在二级分类下创建最终会话标签。 - V2 > 会话管理 > 会话标签管理 [更新会话标签](https://salesmartly-api.apifox.cn/%E6%9B%B4%E6%96%B0%E4%BC%9A%E8%AF%9D%E6%A0%87%E7%AD%BE-480312760e0.md): 重命名最终会话标签。 - V2 > 会话管理 > 会话标签管理 [删除会话标签](https://salesmartly-api.apifox.cn/%E5%88%A0%E9%99%A4%E4%BC%9A%E8%AF%9D%E6%A0%87%E7%AD%BE-480312761e0.md): 软删除最终会话标签。 - V2 > 会话管理 > 会话标签管理 [给会话打标签](https://salesmartly-api.apifox.cn/%E7%BB%99%E4%BC%9A%E8%AF%9D%E6%89%93%E6%A0%87%E7%AD%BE-466603367e0.md): 给指定会话追加、替换或删除会话标签。 - V2 > 会话管理 [获取聊天记录列表(指定用户)](https://salesmartly-api.apifox.cn/%E8%8E%B7%E5%8F%96%E8%81%8A%E5%A4%A9%E8%AE%B0%E5%BD%95%E5%88%97%E8%A1%A8%E6%8C%87%E5%AE%9A%E7%94%A8%E6%88%B7-317790952e0.md): - V2 > 会话管理 [获取聊天记录列表(全量)](https://salesmartly-api.apifox.cn/%E8%8E%B7%E5%8F%96%E8%81%8A%E5%A4%A9%E8%AE%B0%E5%BD%95%E5%88%97%E8%A1%A8%E5%85%A8%E9%87%8F-385681563e0.md): - V2 > 会话管理 [会话分配接口(搭配webhook使用)](https://salesmartly-api.apifox.cn/%E4%BC%9A%E8%AF%9D%E5%88%86%E9%85%8D%E6%8E%A5%E5%8F%A3%E6%90%AD%E9%85%8Dwebhook%E4%BD%BF%E7%94%A8-323506414e0.md): - V2 > 会话管理 [结束会话](https://salesmartly-api.apifox.cn/%E7%BB%93%E6%9D%9F%E4%BC%9A%E8%AF%9D-339565482e0.md): - V2 > 会话管理 [批量回聊](https://salesmartly-api.apifox.cn/%E6%89%B9%E9%87%8F%E5%9B%9E%E8%81%8A-425955043e0.md): 请注意这个是一个异步处理接口,不会实时处理完成 - V2 > 会话管理 [获取会话列表](https://salesmartly-api.apifox.cn/%E8%8E%B7%E5%8F%96%E4%BC%9A%E8%AF%9D%E5%88%97%E8%A1%A8-429104830e0.md): 获取活跃会话或已结束会话的列表,支持分页和按状态、时间等条件筛选。 - V2 > 营销管理 [获取分流链接列表](https://salesmartly-api.apifox.cn/%E8%8E%B7%E5%8F%96%E5%88%86%E6%B5%81%E9%93%BE%E6%8E%A5%E5%88%97%E8%A1%A8-326349441e0.md): - V2 > 营销管理 [获取分流链接记录表](https://salesmartly-api.apifox.cn/%E8%8E%B7%E5%8F%96%E5%88%86%E6%B5%81%E9%93%BE%E6%8E%A5%E8%AE%B0%E5%BD%95%E8%A1%A8-326351442e0.md): - V2 > 营销管理 [获取分流链接列表](https://salesmartly-api.apifox.cn/%E8%8E%B7%E5%8F%96%E5%88%86%E6%B5%81%E9%93%BE%E6%8E%A5%E5%88%97%E8%A1%A8-490920131e0.md): - V2 > 集成管理 > WhatsApp App [获取WhatsApp APP列表](https://salesmartly-api.apifox.cn/%E8%8E%B7%E5%8F%96whatsapp-app%E5%88%97%E8%A1%A8-326572731e0.md): - V2 > 集成管理 > WhatsApp App [获取WhatsApp App登录二维码/重连设备](https://salesmartly-api.apifox.cn/%E8%8E%B7%E5%8F%96whatsapp-app%E7%99%BB%E5%BD%95%E4%BA%8C%E7%BB%B4%E7%A0%81%E9%87%8D%E8%BF%9E%E8%AE%BE%E5%A4%87-328937730e0.md): - V2 > 集成管理 > WhatsApp App [新增WhatsApp App设备](https://salesmartly-api.apifox.cn/%E6%96%B0%E5%A2%9Ewhatsapp-app%E8%AE%BE%E5%A4%87-334587546e0.md): - V2 > 集成管理 > WhatsApp App [设置WhatsApp App设备代理(仅支持未连接设备)](https://salesmartly-api.apifox.cn/%E8%AE%BE%E7%BD%AEwhatsapp-app%E8%AE%BE%E5%A4%87%E4%BB%A3%E7%90%86%E4%BB%85%E6%94%AF%E6%8C%81%E6%9C%AA%E8%BF%9E%E6%8E%A5%E8%AE%BE%E5%A4%87-334594569e0.md): - V2 > 集成管理 > WhatsApp App [删除WhatsApp App设备](https://salesmartly-api.apifox.cn/%E5%88%A0%E9%99%A4whatsapp-app%E8%AE%BE%E5%A4%87-334595469e0.md): - V2 > 集成管理 > WhatsApp Api [获取WhatsApp Api列表](https://salesmartly-api.apifox.cn/%E8%8E%B7%E5%8F%96whatsapp-api%E5%88%97%E8%A1%A8-450018303e0.md): - V2 > 集成管理 > Messenger [获取Messenger列表](https://salesmartly-api.apifox.cn/%E8%8E%B7%E5%8F%96messenger%E5%88%97%E8%A1%A8-454758726e0.md): - V2 > 集成管理 > Line [获取 LINE 官方账号列表](https://salesmartly-api.apifox.cn/%E8%8E%B7%E5%8F%96-line-%E5%AE%98%E6%96%B9%E8%B4%A6%E5%8F%B7%E5%88%97%E8%A1%A8-475299323e0.md): 查询当前项目下未删除的 LINE 官方账号,返回集成管理列表所需字段。 - V2 > 集成管理 > Line App [获取 LINE APP 云设备列表](https://salesmartly-api.apifox.cn/%E8%8E%B7%E5%8F%96-line-app-%E4%BA%91%E8%AE%BE%E5%A4%87%E5%88%97%E8%A1%A8-475298421e0.md): 查询当前项目下未删除的 LINE APP 云设备,返回集成管理列表所需字段。 - V2 > 报表 [获取在线时长报表](https://salesmartly-api.apifox.cn/%E8%8E%B7%E5%8F%96%E5%9C%A8%E7%BA%BF%E6%97%B6%E9%95%BF%E6%8A%A5%E8%A1%A8-430632162e0.md): 按客服与日期范围查询在线时长汇总数据 - V2 > 报表 [获取大报表](https://salesmartly-api.apifox.cn/%E8%8E%B7%E5%8F%96%E5%A4%A7%E6%8A%A5%E8%A1%A8-439775778e0.md): 查询会话统计大报表数据,包含接起会话数、结束会话数、消息量、响应时长、会话时长、评价、质检等全量指标。 - V2 > 报表 [获取客户分析报表](https://salesmartly-api.apifox.cn/%E8%8E%B7%E5%8F%96%E5%AE%A2%E6%88%B7%E5%88%86%E6%9E%90%E6%8A%A5%E8%A1%A8-439777624e0.md): 按接待成员、社媒渠道、社媒账号或时间维度查询新增客户数据。 ## Schemas - [ProjectId](https://salesmartly-api.apifox.cn/projectid-289718635d0.md): - [IdResponse](https://salesmartly-api.apifox.cn/idresponse-287007646d0.md): - [CustomField](https://salesmartly-api.apifox.cn/customfield-289372363d0.md): - [ApiResponseBase](https://salesmartly-api.apifox.cn/apiresponsebase-289718636d0.md): - [EmptyResponse](https://salesmartly-api.apifox.cn/emptyresponse-287007647d0.md): - [CustomFieldListResponse](https://salesmartly-api.apifox.cn/customfieldlistresponse-289372364d0.md): - [PageData](https://salesmartly-api.apifox.cn/pagedata-289718637d0.md): - [Category](https://salesmartly-api.apifox.cn/category-287007648d0.md): - [CustomFieldSaveResponse](https://salesmartly-api.apifox.cn/customfieldsaveresponse-289372365d0.md): - [SessionTagCategoryItem](https://salesmartly-api.apifox.cn/sessiontagcategoryitem-289718638d0.md): - [LabelValue](https://salesmartly-api.apifox.cn/labelvalue-287007649d0.md): - [EmptySuccessResponse](https://salesmartly-api.apifox.cn/emptysuccessresponse-289372366d0.md): - [SessionTagItem](https://salesmartly-api.apifox.cn/sessiontagitem-289718639d0.md): - [Label](https://salesmartly-api.apifox.cn/label-287007650d0.md): - [SimpleData](https://salesmartly-api.apifox.cn/simpledata-289718640d0.md): - [CategoryListResponse](https://salesmartly-api.apifox.cn/categorylistresponse-287007651d0.md): - [SessionTagCategoryListResponse](https://salesmartly-api.apifox.cn/sessiontagcategorylistresponse-289718641d0.md): - [LabelListResponse](https://salesmartly-api.apifox.cn/labellistresponse-287007652d0.md): - [SessionTagListResponse](https://salesmartly-api.apifox.cn/sessiontaglistresponse-289718642d0.md): - [LabelDetailResponse](https://salesmartly-api.apifox.cn/labeldetailresponse-287007653d0.md): - [SessionTagCategoryMutationResponse](https://salesmartly-api.apifox.cn/sessiontagcategorymutationresponse-289718643d0.md): - [SessionTagMutationResponse](https://salesmartly-api.apifox.cn/sessiontagmutationresponse-289718644d0.md): - [SimpleMutationResponse](https://salesmartly-api.apifox.cn/simplemutationresponse-289718645d0.md):