/data/analyze
1.接口描述
该API的功能对客服与客户的电话/企微催收对话进行 AI 分析,适用信用保证保险公司的客户贷后管理场景
请求方式:
POST
请求URL:
https://cloudapi.deepfinch.com/data/analyze
调试工具
Debugging Tool
2.请求参数
2.1 请求头域
| 字段 |
类型 |
必需 |
描述 |
| X-DF-API-ID |
string |
是 |
API调用凭证信息,详细信息请参考API调用 |
| X-DF-API-SECRET |
string |
是 |
API调用凭证信息,详细信息请参考API调用 |
2.2 请求体
| 字段 |
类型 |
必需 |
描述 |
| text |
string |
是 |
对话文本;risk 类型时传风险评分 JSON 字符串 |
| type |
string |
是 |
分析类型,取值见 2.2.1 类型说明 |
| mode |
string |
否 |
模型选择:fast、precise, 默认值:fast |
| policy_status |
string |
否 |
保单状态:C=正常,其他字符串=逾期。仅 customer_tags_full 使用, 默认值:C |
2.2.1 类型说明
| 参数 |
类型 |
说明 |
customer_tags |
精简客户标签 |
客户情绪+客服施压策略标签 |
customer_tags_full |
完整客户标签 |
客户/客服正负面能力全维度标签 |
complaint_violation |
投诉违规检测 |
投诉概率 + 违规识别 + 提前结清 |
faq |
客户诉求提取 |
显性/隐性诉求标准化提取 |
close |
提前结清分析 |
提前结清意图深度分析 |
manager |
客服能力画像 |
客服沟通风格+专业素养三级标签 |
risk |
机构风险评估 |
分部风险评分 → 审计建议 |
2.3 请求体text字段示例
# 其他类型
客服:您好,这里是某某信保,请问是张先生吗?\n客户:是我,什么事?\n客服:您的贷款本期还款已逾期3天,金额2800元,请问什么时候可以处理?\n客户:最近公司没发工资,能不能宽限几天?\n客服:我理解您的情况,但逾期会影响您的征信记录,建议您尽快处理。\n客户:好吧,我下周想办法还上。\n客服:好的,那我帮您登记一下,最晚下周五之前可以吗?\n客户:行,下周五之前我一定存进去。\n客服:好的,感谢您的配合。再见。
# risk类型
[{"id":"001","name":"北京分公司","score":85,"m1":90,"m2":82,"m3":88,"m4":75,"m5":92,"m6":80,"m7":86,"m8":91,"m9":79,"m10":84,"m11":87,"m12":83},{"id":"002","name":"上海分公司","score":62,"m1":55,"m2":68,"m3":45,"m4":70,"m5":60,"m6":52,"m7":78,"m8":65,"m9":50,"m10":72,"m11":58,"m12":63},{"id":"003","name":"广州分公司","score":73,"m1":70,"m2":75,"m3":68,"m4":80,"m5":72,"m6":76,"m7":85,"m8":71,"m9":74,"m10":69,"m11":77,"m12":82}]
# risk类型json格式字符串字段说明
| 字段 |
类型 |
描述 |
id |
string |
分部 ID |
name |
string |
分部名称 |
score |
int |
机构风险透视评分(越高越安全) |
m1~m12 |
int |
12 个分析模块得分 |
3.返回参数
正常响应 (200)
| 字段 |
类型 |
描述 |
| request_id |
string |
本次请求的 id |
| status |
string |
状态。正常为 OK ,其他值表示失败。详见详见错误码 |
| result |
object |
查询结果 |
其中result的字段如下:
| 字段 |
类型 |
描述 |
| tags |
array |
标签列表,列表项为object类型,字段如下 |
| 字段 |
类型 |
描述 |
| type |
string |
C=客户,M=客服 |
| tag1 |
string |
一级标签(情绪态度/应对模式/经济风险/危机预警/施压策略等) |
| tag1 |
string |
二级标签 |
| basis |
string |
判断依据 |
精简客户标签:适合快速概览,输出客户情绪态度 + 客服施压策略。
完整客户标签:包含客户正负面全维度标签 + 客服能力评估 + 违规行为检测。通过 policy_status 区分正常/逾期场景,逾期场景的客服话术评估更详细。
客户标签体系
| 一级标签 |
二级标签(示例) |
| 情绪态度 |
愤怒、焦虑、消极、抗拒、平静 |
| 应对模式 |
积极配合、责任转移或回避、延迟处理倾向、政策咨询、拒绝沟通、专业化反馈、他人协助、社会影响顾虑、媒介偏好、操作支持 |
| 经济风险 |
收入波动、定期收入、支出压力、短期偿付风险、长期偿付风险、资产处置、多家负债 |
| 危机预警 |
极端行为、信息真实性存疑、死亡疾病意外、亲属死亡疾病意外、群体事件、公共关系纠纷、投诉升级 |
客服标签体系(正面)
| 一级标签 |
对应客户标签 |
说明 |
| 施压策略 |
— |
已告知罚息/法律/征信/上门/联系人影响 |
| 情绪响应 |
愤怒→情绪安抚能力,焦虑→焦虑疏导能力,消极→积极鼓励能力,抗拒→耐心引导能力 |
情绪处理能力 |
| 行为应对 |
责任转移→主动引导,延迟处理→进度推动,政策咨询→政策回复,拒绝沟通→破冰沟通,专业化反馈→专业匹配,他人协助→责任引导,社会影响顾虑→社会影响说服,媒介偏好→媒介适配,操作支持→操作指引 |
行为应对能力 |
| 财务规划 |
收入波动→动态财务规划,定期收入→稳定型方案匹配,支出压力→共情风险提示,短期偿付→稳定型方案匹配,长期偿付→长期偿付规划,资产处置→资产处置优化,多家负债→多家负债整合 |
财务建议能力 |
| 危机干预 |
极端行为→紧急危机干预,信息真实性存疑→欺诈风险核查,死亡疾病→情感支持,群体事件→群体事件协调,公共关系→稳定性维护,投诉升级→投诉升级处理 |
危机处理能力 |
客服标签体系(负面)
| 一级标签 |
示例 |
| 情绪激化 |
反驳对抗、激化情绪、消极应对、强行推进 |
| 行为应对不当 |
指责式表述、放任模糊承诺、隐瞒条款、超限沟通、敷衍应对、扩大社会影响威胁等 |
| 财务规划不当 |
否定收入、轻信盲从、缺乏共情、打击积极性、模糊主次 |
| 危机干预不当 |
激化情绪、反欺诈能力弱、漠视意外、无视群体事件、否定投诉权利 |
| 违规应对 |
侮辱辱骂、恐吓威胁、虚假身份 |
complaint_violation类型
| 字段 |
类型 |
描述 |
| complaint_probability |
float |
投诉概率 0.0~1.0 |
| complaint_reason |
string |
投诉原因(≤30字) |
| customer_attitude |
string |
客户态度与情绪(≤10字) |
| support_attitude |
string |
客服专业性评估 |
| violation_type |
string |
违规类型:无违规/违规收费/违规宣传/捆绑销售/非法集资/协助造假/AB贷款/代客还款/资金用途虚假/违法催收/数据泄露 |
| violation_probability |
float |
违规概率 0.0~1.0 |
| violation_reason |
string |
违规原因(≤30字) |
| whether_advance |
string |
是否有提前结清意图:有/无 |
| advance_probability |
float |
提前结清概率 0.0~1.0 |
| advance_reason |
string |
提前结清原因(≤30字) |
faq类型
| 字段 |
类型 |
描述 |
| questions |
array |
诉求列表,列表项为object类型,字段如下 |
| 字段 |
类型 |
描述 |
| question |
string |
标准化的客户问题(能否/如何/是否句式) |
| catalog |
string |
问题分类(还款困难/费用疑问/减少提醒/流程优化等) |
诉求提取规则说明如下
| 类型 |
识别规则 |
示例 |
| 显性诉求 |
含明确疑问词/问句 |
"怎么算利息?" → "利息如何计算?" |
| 隐性诉求 |
否定式声明/抱怨 |
"别老打电话" → "能否调整电话提醒频率?" |
| 陈述转化 |
含疑问词+不确定表述 |
"不明白利息怎么算" → "利息如何计算?" |
| 语义聚合 |
近义表述合并归一 |
"能不能延期?"/"可以展期吗?" → "能否延期还款?" |
| 模糊处理 |
具体数值脱敏 |
"能否延期到29号?" → "能否延期还款?" |
close类型
| 字段 |
类型 |
描述 |
| whether_advance |
string |
是否有提前结清意图:有/无 |
| settle_in_advance_type |
string |
结清类型:部分还款/全部还款 |
| settle_in_advance_reason |
string |
结清原因:资金周转情况/利率对比/还款计划调整/其他 |
| plan_by_client |
string |
客户提出的方案或诉求 |
| core_doubt |
string |
核心疑点问题 |
manager类型
| 字段 |
类型 |
描述 |
| labels |
array |
标签列表,列表项为object类型,字段如下 |
| 字段 |
类型 |
描述 |
| label1 |
string |
一级标签 |
| label2 |
string |
二级标签 |
| label3 |
string |
三级标签 |
| frequency |
int |
跨会话出现频次 |
| basis |
string |
判断依据 |
标签体系
| 一级标签 |
二级标签 |
三级标签示例 |
| 沟通风格特质 |
性格倾向 |
外向型、内向型、分析型 |
| 沟通风格特质 |
情绪管理 |
稳定型、波动型、消极型 |
| 沟通风格特质 |
沟通态度 |
积极态度、消极态度、中立态度 |
| 服务效能 |
问题解决 |
高效解决、常规处理、推诿应对 |
| 服务效能 |
投诉处理 |
危机化解、投诉激化 |
| 合规与风控 |
操作合规性 |
合规操作、违规迹象 |
| 合规与风控 |
法律应用 |
精准法条引用、法律风险操作 |
| 策略执行能力 |
催收策略 |
施压型、协商型、教育型 |
| 策略执行能力 |
压力控制 |
有效施压、过度施压、压力不足 |
| 客户关系管理 |
维护策略 |
长期维护、短期解决 |
| 客户关系管理 |
风险预警 |
关系恶化 |
| 专业素养 |
知识储备 |
产品精通、知识欠缺 |
| 专业素养 |
表达质量 |
清晰表达、模糊表达 |
risk类型
| 字段 |
类型 |
描述 |
| branches |
array |
分部结果列表,列表项为object类型,字段如下 |
| 字段 |
类型 |
描述 |
| id |
string |
分部ID |
| name |
string |
分部名称 |
| score |
int |
风险评分 |
| risk_direction |
string |
风险指向分析 |
| advice |
string |
审计优先级:立即启动全面审计 / 季度专项检查 / 年度常规审计 |
输出示例:
{
"request_id": "TIDc528326e240c47a583b0b661fcf8423a",
"status": "OK",
"result": {
"tags": [
{
"type": "C",
"tag1": "情绪态度",
"tag2": "焦虑",
"basis": "客户表示'最近公司没发工资,能不能宽限几天',表现出对还款的担忧"
},
{
"type": "C",
"tag1": "情绪态度",
"tag2": "平静",
"basis": "经过客服解释后,客户表示'行,下周五之前我一定存进去',转为协商态度"
},
{
"type": "C",
"tag1": "应对模式",
"tag2": "延迟处理倾向",
"basis": "客户提出'能不能宽限几天',寻求时间缓冲"
},
{
"type": "C",
"tag1": "应对模式",
"tag2": "积极配合",
"basis": "客服给出方案后客户承诺'下周五之前一定存进去',达成具体约定"
},
{
"type": "M",
"tag1": "施压策略",
"tag2": "已告知征信影响",
"basis": "客服说明'逾期会影响您的征信记录',利用征信影响施压"
}
]
}
}
# complaint_violation类型
{
"request_id": "TIDc528326e240c47a583b0b661fcf8423a",
"status": "OK",
"result": {
"complaint_probability": 0.1,
"complaint_reason": "客户态度配合,未表达不满",
"customer_attitude": "平静配合",
"support_attitude": "专业规范",
"violation_type": "无违规",
"violation_probability": 0.0,
"violation_reason": "",
"whether_advance": "无",
"advance_probability": 0.0,
"advance_reason": ""
}
}
# faq类型
{
"request_id": "TIDc528326e240c47a583b0b661fcf8423a",
"status": "OK",
"result": {
"questions": [
{
"question": "能否分期还款?",
"catalog": "还款方式"
},
{
"question": "利息如何计算?",
"catalog": "费用疑问"
},
{
"question": "能否改为短信联系?",
"catalog": "减少提醒"
}
]
}
}
# close类型
{
"request_id": "TIDc528326e240c47a583b0b661fcf8423a",
"status": "OK",
"result": {
"whether_advance": "有",
"settle_in_advance_type": "全部还款",
"settle_in_advance_reason": "资金周转情况",
"plan_by_client": "要求一次性还清全部贷款,查询结清总金额",
"core_doubt": "结清证明的获取时间和方式"
}
}
# manager类型
{
"request_id": "TIDc528326e240c47a583b0b661fcf8423a",
"status": "OK",
"result": {
"labels": [
{
"label1": "沟通风格特质",
"label2": "性格倾向",
"label3": "外向型",
"frequency": 1,
"basis": "客服主动自我介绍并引导对话,互动主导意识强"
},
{
"label1": "沟通风格特质",
"label2": "情绪管理",
"label3": "稳定型",
"frequency": 1,
"basis": "全程使用标准化话术,语气平稳专业"
},
{
"label1": "沟通风格特质",
"label2": "沟通态度",
"label3": "积极态度",
"frequency": 1,
"basis": "使用'不客气''祝您生活愉快'等正向激励表述"
},
{
"label1": "服务效能",
"label2": "问题解决",
"label3": "高效解决",
"frequency": 1,
"basis": "清晰告知还款金额和日期,提醒征信影响,提供后续咨询渠道"
},
{
"label1": "客户关系管理",
"label2": "维护策略",
"label3": "长期维护",
"frequency": 1,
"basis": "提供APP查询和后续联系渠道,建立持续沟通机制"
}
]
}
}
# risk类型
{
"request_id": "TIDc528326e240c47a583b0b661fcf8423a",
"status": "OK",
"result": {
"branches": [
{
"id": "001",
"name": "北京分公司",
"score": 85,
"risk_direction": "整体风险可控,承保合规性和保后管理表现良好,操作支持模块(m4=75)和客户投诉处理模块(m9=79)存在轻微短板,需关注持续改善情况",
"advice": "年度常规审计"
},
{
"id": "002",
"name": "上海分公司",
"score": 62,
"risk_direction": "整体风险偏高,合规操作(m3=45)和反欺诈能力(m9=50)为明显薄弱环节,存在监管合规和运营风险隐患",
"advice": "立即启动全面审计"
},
{
"id": "003",
"name": "广州分公司",
"score": 73,
"risk_direction": "中等风险,各模块表现较为均衡,催收策略和客户关系管理需重点优化",
"advice": "季度专项检查"
}
]
}
}
4.错误码
| 状态码 |
status 字段 |
说明 |
400 |
INVALID_ARGUMENT |
请求参数错误 |
401 |
UNAUTHORIZED |
未授权或授权失败 |
403 |
RATE_LIMIT_EXCEEDED |
调用频率超出限额 |
404 |
NOT_FOUND |
请求路径错误 |
500 |
INTERNAL_ERROR |
服务器内部错误 |
输出示例:
{
"status": "RATE_LIMIT_EXCEEDED",
"request_id": "TID8bf47ab6eda64476973cc5f5b6ebf57e"
}
5.输入示例