> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api/back-office-api/cs-bo-api/ai.md).

# 상담 AI 관리

## AI 분석 정보 제안답변 적용여부 수정

> \## 기능설명\
> \* 상담 AI 분석 정보의 제안 답변을 상담 답변에 적용여부를 등록 합니다.\
> \---\
> \## 상세 설명\
> \* 1:1문의, 상품Q\&A 상담만 제안답변 적용이 가능합니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"CounselAIAnalysisRequest":{"type":"object","description":"고객 상담 AI 분석 요청 DTO","properties":{"ccnNo":{"type":"string","description":"상담 번호"},"counselGoodsInfo":{"$ref":"#/components/schemas/CounselGoodsInfo","description":"상담 상품"},"startAnalyDt":{"type":"string","description":"시작분석일"},"endAnalyDt":{"type":"string","description":"종료분석일"},"goodsAnalyIncYn":{"type":"string","description":"상품분석포함여부"}}},"CounselGoodsInfo":{"type":"object","description":"상담 대상 상품 정보 DTO","properties":{"custCnslSeq":{"type":"string","description":"고객상담순번"},"ordNo":{"type":"string","description":"주문번호"},"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"itmNo":{"type":"string","description":"단품번호"},"itmNm":{"type":"string","description":"단품명"},"stdCtgNm":{"type":"string","description":"표준카테고리명"},"entrNm":{"type":"string","description":"협력사명"}}},"ResponseString":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"string","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/v2/customerservice/ai/updateCustomerAIAnalysisHist":{"post":{"tags":["상담 AI 관리"],"summary":"AI 분석 정보 제안답변 적용여부 수정","description":"## 기능설명\n* 상담 AI 분석 정보의 제안 답변을 상담 답변에 적용여부를 등록 합니다.\n---\n## 상세 설명\n* 1:1문의, 상품Q&A 상담만 제안답변 적용이 가능합니다.\n","operationId":"updateCustomerAIAnalysisHist","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CounselAIAnalysisRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 상담 대응 방안 AI 분석

> \## 기능 설명\
> 상담, 고객, 상품평에 대한 AI 분석 결과를 토대로 대응방안을 제시합니다.\
> \<br>\<br>\
> \---\
> \## 상세 내용\
> \* 상담 정보와 고객, 상품 AI 분석 결과를 파라메터로 AI 대응방안 분석 API를 호출합니다.\<br>\<br>\
> ( 호출 URL : /api/ai/bo/v1/member\_response\_plan )<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"CounselAIAnalysisRequest":{"type":"object","description":"고객 상담 AI 분석 요청 DTO","properties":{"ccnNo":{"type":"string","description":"상담 번호"},"counselGoodsInfo":{"$ref":"#/components/schemas/CounselGoodsInfo","description":"상담 상품"},"startAnalyDt":{"type":"string","description":"시작분석일"},"endAnalyDt":{"type":"string","description":"종료분석일"},"goodsAnalyIncYn":{"type":"string","description":"상품분석포함여부"}}},"CounselGoodsInfo":{"type":"object","description":"상담 대상 상품 정보 DTO","properties":{"custCnslSeq":{"type":"string","description":"고객상담순번"},"ordNo":{"type":"string","description":"주문번호"},"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"itmNo":{"type":"string","description":"단품번호"},"itmNm":{"type":"string","description":"단품명"},"stdCtgNm":{"type":"string","description":"표준카테고리명"},"entrNm":{"type":"string","description":"협력사명"}}},"CounselAIAnalysisResponse":{"type":"object","description":"고객 상담 AI 분석 응답 DTO","properties":{"counselInfo":{"$ref":"#/components/schemas/CounselInfo","description":"상담 정보"},"analysisResult":{"$ref":"#/components/schemas/CounselAIAnalysisResult","description":"상담 AI 분석 결과"}}},"CounselInfo":{"type":"object","description":"상담 정보 DTO","properties":{"ccnNo":{"type":"string","description":"상담번호"},"mbrNo":{"type":"string","description":"회원번호"},"mbrNm":{"type":"string","description":"회원명"},"brth":{"type":"string","description":"생년월일"},"sexGbCdNm":{"type":"string","description":"성별구분코드명(ME017)"},"accpTypCd":{"type":"string","description":"접수유형코드"},"custInqTyp":{"type":"string","description":"고객문의유형"},"accpCont":{"type":"string","description":"접수내용"},"counselGoodsList":{"type":"array","description":"상담 상품 목록","items":{"$ref":"#/components/schemas/CounselGoodsInfo"}},"startAnalyDt":{"type":"string","description":"시작분석일"},"endAnalyDt":{"type":"string","description":"종료분석일"}}},"CounselAIAnalysisResult":{"type":"object","description":"상담 AI 분석 결과 DTO","properties":{"reviewPoint":{"type":"number","format":"float","description":"분석 리뷰 점수"},"reviewCount":{"type":"integer","format":"int32","description":"분석 리뷰 갯수"},"inquiryCount":{"type":"integer","format":"int32","description":"분석 1:1문의 갯수"},"goodsQnaCount":{"type":"integer","format":"int32","description":"분석 상품Q&A 갯수"},"orderCount":{"type":"integer","format":"int32","description":"분석 주문 갯수"},"aiAnalyNo":{"type":"string","description":"분석 번호"},"analyDtm":{"type":"string","description":"분석 일시"},"analyOrderResult":{"type":"string","description":"고객 구매 성향 분석내용"},"analyResultPositive":{"type":"string","description":"고객 긍정성향 생성"},"analyResultNegative":{"type":"string","description":"고객 부정성향 생성"},"analyResultResponse":{"type":"string","description":"고객 응대요령"},"analyGoodsResultPositive":{"type":"string","description":"고객 리뷰 긍정분석내용"},"analyGoodsResultNegative":{"type":"string","description":"고객 리뷰 부정분석내용"},"analyResultAnswer":{"type":"string","description":"제안 답변"},"analyOrderResultSumr":{"type":"string","description":"고객 구매 성향 분석내용 요약"},"analyGoodsReviewSumr":{"type":"string","description":"고객 리뷰 분석내용 요약"},"consultingContSumr":{"type":"string","description":"문의내용 요약"},"analyResultAnswerSumr":{"type":"string","description":"제안 답변"},"startAnalyDt":{"type":"string","description":"시작분석일"},"endAnalyDt":{"type":"string","description":"종료분석일"},"goodsAnalyIncYn":{"type":"string","description":"상품분석포함여부"},"writeReviewCount":{"type":"integer","format":"int32","description":"작성리뷰갯수"},"memberCount":{"type":"integer","format":"int32","description":"작성리뷰갯수"},"defaultResult":{"description":"상담 AI 분석 결과 DTO","writeOnly":true}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v2/customerservice/ai/generateResponsePlanAIAnalysis":{"post":{"tags":["상담 AI 관리"],"summary":"상담 대응 방안 AI 분석","description":"## 기능 설명\n상담, 고객, 상품평에 대한 AI 분석 결과를 토대로 대응방안을 제시합니다.\n<br><br>\n---\n## 상세 내용\n* 상담 정보와 고객, 상품 AI 분석 결과를 파라메터로 AI 대응방안 분석 API를 호출합니다.<br><br>\n( 호출 URL : /api/ai/bo/v1/member_response_plan )\n","operationId":"generateResponsePlanAIAnalysis","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CounselAIAnalysisRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CounselAIAnalysisResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 상담 상품 AI 분석

> \## 기능 설명\
> 상담 상품 한건의 상품에 대해, 상품 리뷰를 분석 합니다.\
> \<br>\<br>\
> \---\
> \## 상세 내용\
> \* 선택된 한건의 상품에 대해 작성된 상품평 내용들을 분석합니다.\<br>\<br>\
> \* 상품평 내용을 토대로 긍정적인 상품평과 부정적인 상품평을 구분하고, 평점을 도출합니다.\<br>\<br>\
> \* 상품 정보와 상품평 목록을 파라메터 AI 분석 API를 호출합니다.\<br>\<br>\
> ( 호출 URL : /api/ai/bo/v1/goods\_review\_tendency )<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"CounselAIAnalysisRequest":{"type":"object","description":"고객 상담 AI 분석 요청 DTO","properties":{"ccnNo":{"type":"string","description":"상담 번호"},"counselGoodsInfo":{"$ref":"#/components/schemas/CounselGoodsInfo","description":"상담 상품"},"startAnalyDt":{"type":"string","description":"시작분석일"},"endAnalyDt":{"type":"string","description":"종료분석일"},"goodsAnalyIncYn":{"type":"string","description":"상품분석포함여부"}}},"CounselGoodsInfo":{"type":"object","description":"상담 대상 상품 정보 DTO","properties":{"custCnslSeq":{"type":"string","description":"고객상담순번"},"ordNo":{"type":"string","description":"주문번호"},"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"itmNo":{"type":"string","description":"단품번호"},"itmNm":{"type":"string","description":"단품명"},"stdCtgNm":{"type":"string","description":"표준카테고리명"},"entrNm":{"type":"string","description":"협력사명"}}},"CounselAIAnalysisResponse":{"type":"object","description":"고객 상담 AI 분석 응답 DTO","properties":{"counselInfo":{"$ref":"#/components/schemas/CounselInfo","description":"상담 정보"},"analysisResult":{"$ref":"#/components/schemas/CounselAIAnalysisResult","description":"상담 AI 분석 결과"}}},"CounselInfo":{"type":"object","description":"상담 정보 DTO","properties":{"ccnNo":{"type":"string","description":"상담번호"},"mbrNo":{"type":"string","description":"회원번호"},"mbrNm":{"type":"string","description":"회원명"},"brth":{"type":"string","description":"생년월일"},"sexGbCdNm":{"type":"string","description":"성별구분코드명(ME017)"},"accpTypCd":{"type":"string","description":"접수유형코드"},"custInqTyp":{"type":"string","description":"고객문의유형"},"accpCont":{"type":"string","description":"접수내용"},"counselGoodsList":{"type":"array","description":"상담 상품 목록","items":{"$ref":"#/components/schemas/CounselGoodsInfo"}},"startAnalyDt":{"type":"string","description":"시작분석일"},"endAnalyDt":{"type":"string","description":"종료분석일"}}},"CounselAIAnalysisResult":{"type":"object","description":"상담 AI 분석 결과 DTO","properties":{"reviewPoint":{"type":"number","format":"float","description":"분석 리뷰 점수"},"reviewCount":{"type":"integer","format":"int32","description":"분석 리뷰 갯수"},"inquiryCount":{"type":"integer","format":"int32","description":"분석 1:1문의 갯수"},"goodsQnaCount":{"type":"integer","format":"int32","description":"분석 상품Q&A 갯수"},"orderCount":{"type":"integer","format":"int32","description":"분석 주문 갯수"},"aiAnalyNo":{"type":"string","description":"분석 번호"},"analyDtm":{"type":"string","description":"분석 일시"},"analyOrderResult":{"type":"string","description":"고객 구매 성향 분석내용"},"analyResultPositive":{"type":"string","description":"고객 긍정성향 생성"},"analyResultNegative":{"type":"string","description":"고객 부정성향 생성"},"analyResultResponse":{"type":"string","description":"고객 응대요령"},"analyGoodsResultPositive":{"type":"string","description":"고객 리뷰 긍정분석내용"},"analyGoodsResultNegative":{"type":"string","description":"고객 리뷰 부정분석내용"},"analyResultAnswer":{"type":"string","description":"제안 답변"},"analyOrderResultSumr":{"type":"string","description":"고객 구매 성향 분석내용 요약"},"analyGoodsReviewSumr":{"type":"string","description":"고객 리뷰 분석내용 요약"},"consultingContSumr":{"type":"string","description":"문의내용 요약"},"analyResultAnswerSumr":{"type":"string","description":"제안 답변"},"startAnalyDt":{"type":"string","description":"시작분석일"},"endAnalyDt":{"type":"string","description":"종료분석일"},"goodsAnalyIncYn":{"type":"string","description":"상품분석포함여부"},"writeReviewCount":{"type":"integer","format":"int32","description":"작성리뷰갯수"},"memberCount":{"type":"integer","format":"int32","description":"작성리뷰갯수"},"defaultResult":{"description":"상담 AI 분석 결과 DTO","writeOnly":true}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v2/customerservice/ai/generateGoodsReviewAIAnalysis":{"post":{"tags":["상담 AI 관리"],"summary":"상담 상품 AI 분석","description":"## 기능 설명\n상담 상품 한건의 상품에 대해, 상품 리뷰를 분석 합니다.\n<br><br>\n---\n## 상세 내용\n* 선택된 한건의 상품에 대해 작성된 상품평 내용들을 분석합니다.<br><br>\n* 상품평 내용을 토대로 긍정적인 상품평과 부정적인 상품평을 구분하고, 평점을 도출합니다.<br><br>\n* 상품 정보와 상품평 목록을 파라메터 AI 분석 API를 호출합니다.<br><br>\n( 호출 URL : /api/ai/bo/v1/goods_review_tendency )\n","operationId":"generateGoodsReviewAIAnalysis","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CounselAIAnalysisRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CounselAIAnalysisResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 통합 고객 상담 AI 분석 (XGEN)

> \## 기능 설명\
> XGEN 통합 워크플로우(customer-counseling-analysis) 1회 호출로 고객성향·상품리뷰·응대계획 분석을 한 번에 수행합니다.\
> \<br>\<br>\
> \---\
> \## 상세 내용\
> \* 고객성향분석, 상품리뷰분석, 회원응대계획을 하나의 XGEN 워크플로우에서 체인 실행합니다.\<br>\<br>\
> \* 요청 스펙은 기존 generateCustomerAIAnalysis / generateGoodsReviewAIAnalysis와 동일합니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"CounselAIAnalysisRequest":{"type":"object","description":"고객 상담 AI 분석 요청 DTO","properties":{"ccnNo":{"type":"string","description":"상담 번호"},"counselGoodsInfo":{"$ref":"#/components/schemas/CounselGoodsInfo","description":"상담 상품"},"startAnalyDt":{"type":"string","description":"시작분석일"},"endAnalyDt":{"type":"string","description":"종료분석일"},"goodsAnalyIncYn":{"type":"string","description":"상품분석포함여부"}}},"CounselGoodsInfo":{"type":"object","description":"상담 대상 상품 정보 DTO","properties":{"custCnslSeq":{"type":"string","description":"고객상담순번"},"ordNo":{"type":"string","description":"주문번호"},"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"itmNo":{"type":"string","description":"단품번호"},"itmNm":{"type":"string","description":"단품명"},"stdCtgNm":{"type":"string","description":"표준카테고리명"},"entrNm":{"type":"string","description":"협력사명"}}},"CounselAIAnalysisResponse":{"type":"object","description":"고객 상담 AI 분석 응답 DTO","properties":{"counselInfo":{"$ref":"#/components/schemas/CounselInfo","description":"상담 정보"},"analysisResult":{"$ref":"#/components/schemas/CounselAIAnalysisResult","description":"상담 AI 분석 결과"}}},"CounselInfo":{"type":"object","description":"상담 정보 DTO","properties":{"ccnNo":{"type":"string","description":"상담번호"},"mbrNo":{"type":"string","description":"회원번호"},"mbrNm":{"type":"string","description":"회원명"},"brth":{"type":"string","description":"생년월일"},"sexGbCdNm":{"type":"string","description":"성별구분코드명(ME017)"},"accpTypCd":{"type":"string","description":"접수유형코드"},"custInqTyp":{"type":"string","description":"고객문의유형"},"accpCont":{"type":"string","description":"접수내용"},"counselGoodsList":{"type":"array","description":"상담 상품 목록","items":{"$ref":"#/components/schemas/CounselGoodsInfo"}},"startAnalyDt":{"type":"string","description":"시작분석일"},"endAnalyDt":{"type":"string","description":"종료분석일"}}},"CounselAIAnalysisResult":{"type":"object","description":"상담 AI 분석 결과 DTO","properties":{"reviewPoint":{"type":"number","format":"float","description":"분석 리뷰 점수"},"reviewCount":{"type":"integer","format":"int32","description":"분석 리뷰 갯수"},"inquiryCount":{"type":"integer","format":"int32","description":"분석 1:1문의 갯수"},"goodsQnaCount":{"type":"integer","format":"int32","description":"분석 상품Q&A 갯수"},"orderCount":{"type":"integer","format":"int32","description":"분석 주문 갯수"},"aiAnalyNo":{"type":"string","description":"분석 번호"},"analyDtm":{"type":"string","description":"분석 일시"},"analyOrderResult":{"type":"string","description":"고객 구매 성향 분석내용"},"analyResultPositive":{"type":"string","description":"고객 긍정성향 생성"},"analyResultNegative":{"type":"string","description":"고객 부정성향 생성"},"analyResultResponse":{"type":"string","description":"고객 응대요령"},"analyGoodsResultPositive":{"type":"string","description":"고객 리뷰 긍정분석내용"},"analyGoodsResultNegative":{"type":"string","description":"고객 리뷰 부정분석내용"},"analyResultAnswer":{"type":"string","description":"제안 답변"},"analyOrderResultSumr":{"type":"string","description":"고객 구매 성향 분석내용 요약"},"analyGoodsReviewSumr":{"type":"string","description":"고객 리뷰 분석내용 요약"},"consultingContSumr":{"type":"string","description":"문의내용 요약"},"analyResultAnswerSumr":{"type":"string","description":"제안 답변"},"startAnalyDt":{"type":"string","description":"시작분석일"},"endAnalyDt":{"type":"string","description":"종료분석일"},"goodsAnalyIncYn":{"type":"string","description":"상품분석포함여부"},"writeReviewCount":{"type":"integer","format":"int32","description":"작성리뷰갯수"},"memberCount":{"type":"integer","format":"int32","description":"작성리뷰갯수"},"defaultResult":{"description":"상담 AI 분석 결과 DTO","writeOnly":true}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v2/customerservice/ai/generateCustomerCounselingAnalysis":{"post":{"tags":["상담 AI 관리"],"summary":"통합 고객 상담 AI 분석 (XGEN)","description":"## 기능 설명\nXGEN 통합 워크플로우(customer-counseling-analysis) 1회 호출로 고객성향·상품리뷰·응대계획 분석을 한 번에 수행합니다.\n<br><br>\n---\n## 상세 내용\n* 고객성향분석, 상품리뷰분석, 회원응대계획을 하나의 XGEN 워크플로우에서 체인 실행합니다.<br><br>\n* 요청 스펙은 기존 generateCustomerAIAnalysis / generateGoodsReviewAIAnalysis와 동일합니다.\n","operationId":"generateCustomerCounselingAnalysis","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CounselAIAnalysisRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CounselAIAnalysisResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 상담 고객 AI 분석

> \## 기능 설명\
> 상담 고객의 주문 이력과 상품평 작성 내용을 토대로 고객 성향을 분석합니다.\
> \<br>\<br>\
> \---\
> \## 상세 내용\
> \* 상담 고객의 주문, 주문취소, 교환, 반품 이력을 주문접수일자 기준 내림차순으로 정렬하여 최대 100건까지 조회합니다.\<br>\<br>\
> \* 주문 상품 중 상품평을 작성한 경우, 상품평 이럭을 조회합니다.\<br>\<br>\
> \* 상담 정보와 주문이력, 상품평 작성 내용을 파라메터로 AI 분석 API를 호출합니다.\<br>\<br>\
> ( 호출 URL : /api/ai/bo/v1/member\_goods\_purchase\_tendency )<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"CounselAIAnalysisRequest":{"type":"object","description":"고객 상담 AI 분석 요청 DTO","properties":{"ccnNo":{"type":"string","description":"상담 번호"},"counselGoodsInfo":{"$ref":"#/components/schemas/CounselGoodsInfo","description":"상담 상품"},"startAnalyDt":{"type":"string","description":"시작분석일"},"endAnalyDt":{"type":"string","description":"종료분석일"},"goodsAnalyIncYn":{"type":"string","description":"상품분석포함여부"}}},"CounselGoodsInfo":{"type":"object","description":"상담 대상 상품 정보 DTO","properties":{"custCnslSeq":{"type":"string","description":"고객상담순번"},"ordNo":{"type":"string","description":"주문번호"},"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"itmNo":{"type":"string","description":"단품번호"},"itmNm":{"type":"string","description":"단품명"},"stdCtgNm":{"type":"string","description":"표준카테고리명"},"entrNm":{"type":"string","description":"협력사명"}}},"CounselAIAnalysisResponse":{"type":"object","description":"고객 상담 AI 분석 응답 DTO","properties":{"counselInfo":{"$ref":"#/components/schemas/CounselInfo","description":"상담 정보"},"analysisResult":{"$ref":"#/components/schemas/CounselAIAnalysisResult","description":"상담 AI 분석 결과"}}},"CounselInfo":{"type":"object","description":"상담 정보 DTO","properties":{"ccnNo":{"type":"string","description":"상담번호"},"mbrNo":{"type":"string","description":"회원번호"},"mbrNm":{"type":"string","description":"회원명"},"brth":{"type":"string","description":"생년월일"},"sexGbCdNm":{"type":"string","description":"성별구분코드명(ME017)"},"accpTypCd":{"type":"string","description":"접수유형코드"},"custInqTyp":{"type":"string","description":"고객문의유형"},"accpCont":{"type":"string","description":"접수내용"},"counselGoodsList":{"type":"array","description":"상담 상품 목록","items":{"$ref":"#/components/schemas/CounselGoodsInfo"}},"startAnalyDt":{"type":"string","description":"시작분석일"},"endAnalyDt":{"type":"string","description":"종료분석일"}}},"CounselAIAnalysisResult":{"type":"object","description":"상담 AI 분석 결과 DTO","properties":{"reviewPoint":{"type":"number","format":"float","description":"분석 리뷰 점수"},"reviewCount":{"type":"integer","format":"int32","description":"분석 리뷰 갯수"},"inquiryCount":{"type":"integer","format":"int32","description":"분석 1:1문의 갯수"},"goodsQnaCount":{"type":"integer","format":"int32","description":"분석 상품Q&A 갯수"},"orderCount":{"type":"integer","format":"int32","description":"분석 주문 갯수"},"aiAnalyNo":{"type":"string","description":"분석 번호"},"analyDtm":{"type":"string","description":"분석 일시"},"analyOrderResult":{"type":"string","description":"고객 구매 성향 분석내용"},"analyResultPositive":{"type":"string","description":"고객 긍정성향 생성"},"analyResultNegative":{"type":"string","description":"고객 부정성향 생성"},"analyResultResponse":{"type":"string","description":"고객 응대요령"},"analyGoodsResultPositive":{"type":"string","description":"고객 리뷰 긍정분석내용"},"analyGoodsResultNegative":{"type":"string","description":"고객 리뷰 부정분석내용"},"analyResultAnswer":{"type":"string","description":"제안 답변"},"analyOrderResultSumr":{"type":"string","description":"고객 구매 성향 분석내용 요약"},"analyGoodsReviewSumr":{"type":"string","description":"고객 리뷰 분석내용 요약"},"consultingContSumr":{"type":"string","description":"문의내용 요약"},"analyResultAnswerSumr":{"type":"string","description":"제안 답변"},"startAnalyDt":{"type":"string","description":"시작분석일"},"endAnalyDt":{"type":"string","description":"종료분석일"},"goodsAnalyIncYn":{"type":"string","description":"상품분석포함여부"},"writeReviewCount":{"type":"integer","format":"int32","description":"작성리뷰갯수"},"memberCount":{"type":"integer","format":"int32","description":"작성리뷰갯수"},"defaultResult":{"description":"상담 AI 분석 결과 DTO","writeOnly":true}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v2/customerservice/ai/generateCustomerAIAnalysis":{"post":{"tags":["상담 AI 관리"],"summary":"상담 고객 AI 분석","description":"## 기능 설명\n상담 고객의 주문 이력과 상품평 작성 내용을 토대로 고객 성향을 분석합니다.\n<br><br>\n---\n## 상세 내용\n* 상담 고객의 주문, 주문취소, 교환, 반품 이력을 주문접수일자 기준 내림차순으로 정렬하여 최대 100건까지 조회합니다.<br><br>\n* 주문 상품 중 상품평을 작성한 경우, 상품평 이럭을 조회합니다.<br><br>\n* 상담 정보와 주문이력, 상품평 작성 내용을 파라메터로 AI 분석 API를 호출합니다.<br><br>\n( 호출 URL : /api/ai/bo/v1/member_goods_purchase_tendency )\n","operationId":"generateCustomerAIAnalysis","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CounselAIAnalysisRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CounselAIAnalysisResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## AI 분석 정보 제안답변 적용여부 수정

> \## 기능설명\
> \* 상담 AI 분석 정보의 제안 답변을 상담 답변에 적용여부를 등록 합니다.\
> \---\
> \## 상세 설명\
> \* 1:1문의, 상품Q\&A 상담만 제안답변 적용이 가능합니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"CounselAIAnalysisRequest":{"type":"object","description":"고객 상담 AI 분석 요청 DTO","properties":{"ccnNo":{"type":"string","description":"상담 번호"},"counselGoodsInfo":{"$ref":"#/components/schemas/CounselGoodsInfo","description":"상담 상품"},"startAnalyDt":{"type":"string","description":"시작분석일"},"endAnalyDt":{"type":"string","description":"종료분석일"},"goodsAnalyIncYn":{"type":"string","description":"상품분석포함여부"}}},"CounselGoodsInfo":{"type":"object","description":"상담 대상 상품 정보 DTO","properties":{"custCnslSeq":{"type":"string","description":"고객상담순번"},"ordNo":{"type":"string","description":"주문번호"},"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"itmNo":{"type":"string","description":"단품번호"},"itmNm":{"type":"string","description":"단품명"},"stdCtgNm":{"type":"string","description":"표준카테고리명"},"entrNm":{"type":"string","description":"협력사명"}}},"ResponseString":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"string","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/v1/customerservice/ai/updateCustomerAIAnalysisHist":{"post":{"tags":["상담 AI 관리"],"summary":"AI 분석 정보 제안답변 적용여부 수정","description":"## 기능설명\n* 상담 AI 분석 정보의 제안 답변을 상담 답변에 적용여부를 등록 합니다.\n---\n## 상세 설명\n* 1:1문의, 상품Q&A 상담만 제안답변 적용이 가능합니다.\n","operationId":"updateCustomerAIAnalysisHist_1","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CounselAIAnalysisRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 상담 대응 방안 AI 분석

> \## 기능 설명\
> 상담, 고객, 상품평에 대한 AI 분석 결과를 토대로 대응방안을 제시합니다.\
> \<br>\<br>\
> \---\
> \## 상세 내용\
> \* 상담 정보와 고객, 상품 AI 분석 결과를 파라메터로 AI 대응방안 분석 API를 호출합니다.\<br>\<br>\
> ( 호출 URL : /api/ai/bo/v1/member\_response\_plan )<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"CounselAIAnalysisRequest":{"type":"object","description":"고객 상담 AI 분석 요청 DTO","properties":{"ccnNo":{"type":"string","description":"상담 번호"},"counselGoodsInfo":{"$ref":"#/components/schemas/CounselGoodsInfo","description":"상담 상품"},"startAnalyDt":{"type":"string","description":"시작분석일"},"endAnalyDt":{"type":"string","description":"종료분석일"},"goodsAnalyIncYn":{"type":"string","description":"상품분석포함여부"}}},"CounselGoodsInfo":{"type":"object","description":"상담 대상 상품 정보 DTO","properties":{"custCnslSeq":{"type":"string","description":"고객상담순번"},"ordNo":{"type":"string","description":"주문번호"},"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"itmNo":{"type":"string","description":"단품번호"},"itmNm":{"type":"string","description":"단품명"},"stdCtgNm":{"type":"string","description":"표준카테고리명"},"entrNm":{"type":"string","description":"협력사명"}}},"CounselAIAnalysisResponse":{"type":"object","description":"고객 상담 AI 분석 응답 DTO","properties":{"counselInfo":{"$ref":"#/components/schemas/CounselInfo","description":"상담 정보"},"analysisResult":{"$ref":"#/components/schemas/CounselAIAnalysisResult","description":"상담 AI 분석 결과"}}},"CounselInfo":{"type":"object","description":"상담 정보 DTO","properties":{"ccnNo":{"type":"string","description":"상담번호"},"mbrNo":{"type":"string","description":"회원번호"},"mbrNm":{"type":"string","description":"회원명"},"brth":{"type":"string","description":"생년월일"},"sexGbCdNm":{"type":"string","description":"성별구분코드명(ME017)"},"accpTypCd":{"type":"string","description":"접수유형코드"},"custInqTyp":{"type":"string","description":"고객문의유형"},"accpCont":{"type":"string","description":"접수내용"},"counselGoodsList":{"type":"array","description":"상담 상품 목록","items":{"$ref":"#/components/schemas/CounselGoodsInfo"}},"startAnalyDt":{"type":"string","description":"시작분석일"},"endAnalyDt":{"type":"string","description":"종료분석일"}}},"CounselAIAnalysisResult":{"type":"object","description":"상담 AI 분석 결과 DTO","properties":{"reviewPoint":{"type":"number","format":"float","description":"분석 리뷰 점수"},"reviewCount":{"type":"integer","format":"int32","description":"분석 리뷰 갯수"},"inquiryCount":{"type":"integer","format":"int32","description":"분석 1:1문의 갯수"},"goodsQnaCount":{"type":"integer","format":"int32","description":"분석 상품Q&A 갯수"},"orderCount":{"type":"integer","format":"int32","description":"분석 주문 갯수"},"aiAnalyNo":{"type":"string","description":"분석 번호"},"analyDtm":{"type":"string","description":"분석 일시"},"analyOrderResult":{"type":"string","description":"고객 구매 성향 분석내용"},"analyResultPositive":{"type":"string","description":"고객 긍정성향 생성"},"analyResultNegative":{"type":"string","description":"고객 부정성향 생성"},"analyResultResponse":{"type":"string","description":"고객 응대요령"},"analyGoodsResultPositive":{"type":"string","description":"고객 리뷰 긍정분석내용"},"analyGoodsResultNegative":{"type":"string","description":"고객 리뷰 부정분석내용"},"analyResultAnswer":{"type":"string","description":"제안 답변"},"analyOrderResultSumr":{"type":"string","description":"고객 구매 성향 분석내용 요약"},"analyGoodsReviewSumr":{"type":"string","description":"고객 리뷰 분석내용 요약"},"consultingContSumr":{"type":"string","description":"문의내용 요약"},"analyResultAnswerSumr":{"type":"string","description":"제안 답변"},"startAnalyDt":{"type":"string","description":"시작분석일"},"endAnalyDt":{"type":"string","description":"종료분석일"},"goodsAnalyIncYn":{"type":"string","description":"상품분석포함여부"},"writeReviewCount":{"type":"integer","format":"int32","description":"작성리뷰갯수"},"memberCount":{"type":"integer","format":"int32","description":"작성리뷰갯수"},"defaultResult":{"description":"상담 AI 분석 결과 DTO","writeOnly":true}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/customerservice/ai/generateResponsePlanAIAnalysis":{"post":{"tags":["상담 AI 관리"],"summary":"상담 대응 방안 AI 분석","description":"## 기능 설명\n상담, 고객, 상품평에 대한 AI 분석 결과를 토대로 대응방안을 제시합니다.\n<br><br>\n---\n## 상세 내용\n* 상담 정보와 고객, 상품 AI 분석 결과를 파라메터로 AI 대응방안 분석 API를 호출합니다.<br><br>\n( 호출 URL : /api/ai/bo/v1/member_response_plan )\n","operationId":"generateResponsePlanAIAnalysis_1","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CounselAIAnalysisRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CounselAIAnalysisResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 상담 상품 AI 분석

> \## 기능 설명\
> 상담 상품 한건의 상품에 대해, 상품 리뷰를 분석 합니다.\
> \<br>\<br>\
> \---\
> \## 상세 내용\
> \* 선택된 한건의 상품에 대해 작성된 상품평 내용들을 분석합니다.\<br>\<br>\
> \* 상품평 내용을 토대로 긍정적인 상품평과 부정적인 상품평을 구분하고, 평점을 도출합니다.\<br>\<br>\
> \* 상품 정보와 상품평 목록을 파라메터 AI 분석 API를 호출합니다.\<br>\<br>\
> ( 호출 URL : /api/ai/bo/v1/goods\_review\_tendency )<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"CounselAIAnalysisRequest":{"type":"object","description":"고객 상담 AI 분석 요청 DTO","properties":{"ccnNo":{"type":"string","description":"상담 번호"},"counselGoodsInfo":{"$ref":"#/components/schemas/CounselGoodsInfo","description":"상담 상품"},"startAnalyDt":{"type":"string","description":"시작분석일"},"endAnalyDt":{"type":"string","description":"종료분석일"},"goodsAnalyIncYn":{"type":"string","description":"상품분석포함여부"}}},"CounselGoodsInfo":{"type":"object","description":"상담 대상 상품 정보 DTO","properties":{"custCnslSeq":{"type":"string","description":"고객상담순번"},"ordNo":{"type":"string","description":"주문번호"},"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"itmNo":{"type":"string","description":"단품번호"},"itmNm":{"type":"string","description":"단품명"},"stdCtgNm":{"type":"string","description":"표준카테고리명"},"entrNm":{"type":"string","description":"협력사명"}}},"CounselAIAnalysisResponse":{"type":"object","description":"고객 상담 AI 분석 응답 DTO","properties":{"counselInfo":{"$ref":"#/components/schemas/CounselInfo","description":"상담 정보"},"analysisResult":{"$ref":"#/components/schemas/CounselAIAnalysisResult","description":"상담 AI 분석 결과"}}},"CounselInfo":{"type":"object","description":"상담 정보 DTO","properties":{"ccnNo":{"type":"string","description":"상담번호"},"mbrNo":{"type":"string","description":"회원번호"},"mbrNm":{"type":"string","description":"회원명"},"brth":{"type":"string","description":"생년월일"},"sexGbCdNm":{"type":"string","description":"성별구분코드명(ME017)"},"accpTypCd":{"type":"string","description":"접수유형코드"},"custInqTyp":{"type":"string","description":"고객문의유형"},"accpCont":{"type":"string","description":"접수내용"},"counselGoodsList":{"type":"array","description":"상담 상품 목록","items":{"$ref":"#/components/schemas/CounselGoodsInfo"}},"startAnalyDt":{"type":"string","description":"시작분석일"},"endAnalyDt":{"type":"string","description":"종료분석일"}}},"CounselAIAnalysisResult":{"type":"object","description":"상담 AI 분석 결과 DTO","properties":{"reviewPoint":{"type":"number","format":"float","description":"분석 리뷰 점수"},"reviewCount":{"type":"integer","format":"int32","description":"분석 리뷰 갯수"},"inquiryCount":{"type":"integer","format":"int32","description":"분석 1:1문의 갯수"},"goodsQnaCount":{"type":"integer","format":"int32","description":"분석 상품Q&A 갯수"},"orderCount":{"type":"integer","format":"int32","description":"분석 주문 갯수"},"aiAnalyNo":{"type":"string","description":"분석 번호"},"analyDtm":{"type":"string","description":"분석 일시"},"analyOrderResult":{"type":"string","description":"고객 구매 성향 분석내용"},"analyResultPositive":{"type":"string","description":"고객 긍정성향 생성"},"analyResultNegative":{"type":"string","description":"고객 부정성향 생성"},"analyResultResponse":{"type":"string","description":"고객 응대요령"},"analyGoodsResultPositive":{"type":"string","description":"고객 리뷰 긍정분석내용"},"analyGoodsResultNegative":{"type":"string","description":"고객 리뷰 부정분석내용"},"analyResultAnswer":{"type":"string","description":"제안 답변"},"analyOrderResultSumr":{"type":"string","description":"고객 구매 성향 분석내용 요약"},"analyGoodsReviewSumr":{"type":"string","description":"고객 리뷰 분석내용 요약"},"consultingContSumr":{"type":"string","description":"문의내용 요약"},"analyResultAnswerSumr":{"type":"string","description":"제안 답변"},"startAnalyDt":{"type":"string","description":"시작분석일"},"endAnalyDt":{"type":"string","description":"종료분석일"},"goodsAnalyIncYn":{"type":"string","description":"상품분석포함여부"},"writeReviewCount":{"type":"integer","format":"int32","description":"작성리뷰갯수"},"memberCount":{"type":"integer","format":"int32","description":"작성리뷰갯수"},"defaultResult":{"description":"상담 AI 분석 결과 DTO","writeOnly":true}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/customerservice/ai/generateGoodsReviewAIAnalysis":{"post":{"tags":["상담 AI 관리"],"summary":"상담 상품 AI 분석","description":"## 기능 설명\n상담 상품 한건의 상품에 대해, 상품 리뷰를 분석 합니다.\n<br><br>\n---\n## 상세 내용\n* 선택된 한건의 상품에 대해 작성된 상품평 내용들을 분석합니다.<br><br>\n* 상품평 내용을 토대로 긍정적인 상품평과 부정적인 상품평을 구분하고, 평점을 도출합니다.<br><br>\n* 상품 정보와 상품평 목록을 파라메터 AI 분석 API를 호출합니다.<br><br>\n( 호출 URL : /api/ai/bo/v1/goods_review_tendency )\n","operationId":"generateGoodsReviewAIAnalysis_1","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CounselAIAnalysisRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CounselAIAnalysisResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 상담 고객 AI 분석

> \## 기능 설명\
> 상담 고객의 주문 이력과 상품평 작성 내용을 토대로 고객 성향을 분석합니다.\
> \<br>\<br>\
> \---\
> \## 상세 내용\
> \* 상담 고객의 주문, 주문취소, 교환, 반품 이력을 주문접수일자 기준 내림차순으로 정렬하여 최대 100건까지 조회합니다.\<br>\<br>\
> \* 주문 상품 중 상품평을 작성한 경우, 상품평 이럭을 조회합니다.\<br>\<br>\
> \* 상담 정보와 주문이력, 상품평 작성 내용을 파라메터로 AI 분석 API를 호출합니다.\<br>\<br>\
> ( 호출 URL : /api/ai/bo/v1/member\_goods\_purchase\_tendency )<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"CounselAIAnalysisRequest":{"type":"object","description":"고객 상담 AI 분석 요청 DTO","properties":{"ccnNo":{"type":"string","description":"상담 번호"},"counselGoodsInfo":{"$ref":"#/components/schemas/CounselGoodsInfo","description":"상담 상품"},"startAnalyDt":{"type":"string","description":"시작분석일"},"endAnalyDt":{"type":"string","description":"종료분석일"},"goodsAnalyIncYn":{"type":"string","description":"상품분석포함여부"}}},"CounselGoodsInfo":{"type":"object","description":"상담 대상 상품 정보 DTO","properties":{"custCnslSeq":{"type":"string","description":"고객상담순번"},"ordNo":{"type":"string","description":"주문번호"},"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"itmNo":{"type":"string","description":"단품번호"},"itmNm":{"type":"string","description":"단품명"},"stdCtgNm":{"type":"string","description":"표준카테고리명"},"entrNm":{"type":"string","description":"협력사명"}}},"CounselAIAnalysisResponse":{"type":"object","description":"고객 상담 AI 분석 응답 DTO","properties":{"counselInfo":{"$ref":"#/components/schemas/CounselInfo","description":"상담 정보"},"analysisResult":{"$ref":"#/components/schemas/CounselAIAnalysisResult","description":"상담 AI 분석 결과"}}},"CounselInfo":{"type":"object","description":"상담 정보 DTO","properties":{"ccnNo":{"type":"string","description":"상담번호"},"mbrNo":{"type":"string","description":"회원번호"},"mbrNm":{"type":"string","description":"회원명"},"brth":{"type":"string","description":"생년월일"},"sexGbCdNm":{"type":"string","description":"성별구분코드명(ME017)"},"accpTypCd":{"type":"string","description":"접수유형코드"},"custInqTyp":{"type":"string","description":"고객문의유형"},"accpCont":{"type":"string","description":"접수내용"},"counselGoodsList":{"type":"array","description":"상담 상품 목록","items":{"$ref":"#/components/schemas/CounselGoodsInfo"}},"startAnalyDt":{"type":"string","description":"시작분석일"},"endAnalyDt":{"type":"string","description":"종료분석일"}}},"CounselAIAnalysisResult":{"type":"object","description":"상담 AI 분석 결과 DTO","properties":{"reviewPoint":{"type":"number","format":"float","description":"분석 리뷰 점수"},"reviewCount":{"type":"integer","format":"int32","description":"분석 리뷰 갯수"},"inquiryCount":{"type":"integer","format":"int32","description":"분석 1:1문의 갯수"},"goodsQnaCount":{"type":"integer","format":"int32","description":"분석 상품Q&A 갯수"},"orderCount":{"type":"integer","format":"int32","description":"분석 주문 갯수"},"aiAnalyNo":{"type":"string","description":"분석 번호"},"analyDtm":{"type":"string","description":"분석 일시"},"analyOrderResult":{"type":"string","description":"고객 구매 성향 분석내용"},"analyResultPositive":{"type":"string","description":"고객 긍정성향 생성"},"analyResultNegative":{"type":"string","description":"고객 부정성향 생성"},"analyResultResponse":{"type":"string","description":"고객 응대요령"},"analyGoodsResultPositive":{"type":"string","description":"고객 리뷰 긍정분석내용"},"analyGoodsResultNegative":{"type":"string","description":"고객 리뷰 부정분석내용"},"analyResultAnswer":{"type":"string","description":"제안 답변"},"analyOrderResultSumr":{"type":"string","description":"고객 구매 성향 분석내용 요약"},"analyGoodsReviewSumr":{"type":"string","description":"고객 리뷰 분석내용 요약"},"consultingContSumr":{"type":"string","description":"문의내용 요약"},"analyResultAnswerSumr":{"type":"string","description":"제안 답변"},"startAnalyDt":{"type":"string","description":"시작분석일"},"endAnalyDt":{"type":"string","description":"종료분석일"},"goodsAnalyIncYn":{"type":"string","description":"상품분석포함여부"},"writeReviewCount":{"type":"integer","format":"int32","description":"작성리뷰갯수"},"memberCount":{"type":"integer","format":"int32","description":"작성리뷰갯수"},"defaultResult":{"description":"상담 AI 분석 결과 DTO","writeOnly":true}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/customerservice/ai/generateCustomerAIAnalysis":{"post":{"tags":["상담 AI 관리"],"summary":"상담 고객 AI 분석","description":"## 기능 설명\n상담 고객의 주문 이력과 상품평 작성 내용을 토대로 고객 성향을 분석합니다.\n<br><br>\n---\n## 상세 내용\n* 상담 고객의 주문, 주문취소, 교환, 반품 이력을 주문접수일자 기준 내림차순으로 정렬하여 최대 100건까지 조회합니다.<br><br>\n* 주문 상품 중 상품평을 작성한 경우, 상품평 이럭을 조회합니다.<br><br>\n* 상담 정보와 주문이력, 상품평 작성 내용을 파라메터로 AI 분석 API를 호출합니다.<br><br>\n( 호출 URL : /api/ai/bo/v1/member_goods_purchase_tendency )\n","operationId":"generateCustomerAIAnalysis_1","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CounselAIAnalysisRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CounselAIAnalysisResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 상담 AI 분석 이력 목록 조회

> \## 기능 설명\
> 상담 고객의 AI 분석 이력 목록을 조회합니다.\
> \<br>\<br>\
> \---\
> \## 상세 내용\
> \* 상담 고객의 AI 분석 이력 정보를 조회합니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"RealGridListResponseCounselAIAnalysisHistInfo":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/CounselAIAnalysisHistInfo"}}}},"CounselAIAnalysisHistInfo":{"type":"object","description":"상담 AI 분석 결과 이력 DTO","properties":{"sysRegId":{"type":"string","description":"등록자ID"},"sysModId":{"type":"string","description":"수정자ID"},"aiAnalyNo":{"type":"string","description":"AI분석번호"},"histTypCd":{"type":"string","description":"이력유형코드"},"ccnNo":{"type":"string","description":"문의번호"},"mbrNo":{"type":"string","description":"회원번호"},"inqCnt":{"type":"integer","format":"int32","description":"1:1문의분석수"},"goodsQnaCnt":{"type":"integer","format":"int32","description":"상품Q&A분석수"},"ordCnt":{"type":"integer","format":"int32","description":"주문분석수"},"wrtRevCnt":{"type":"integer","format":"int32","description":"작성상품평분석수"},"custTendencySumr":{"type":"string","description":"고객성향요약"},"custTendencyPosi":{"type":"string","description":"고객성향(긍정)"},"custTendencyNega":{"type":"string","description":"고객성향(부정)"},"custResPlan":{"type":"string","description":"고객응대요령"},"revCnt":{"type":"integer","format":"int32","description":"분석대상상품평수"},"mbrCnt":{"type":"integer","format":"int32","description":"분석대상회원수"},"goodsNo":{"type":"string","description":"상품번호"},"goodsAnalySumr":{"type":"string","description":"상품분석요약"},"goodsAnalyPosi":{"type":"string","description":"상품분석(긍정)"},"goodsAnalyNega":{"type":"string","description":"상품분석(부정)"},"accpContSumr":{"type":"string","description":"접수내용요약"},"accpCont":{"type":"string","description":"접수내용"},"ansCont":{"type":"string","description":"답변내용"},"ansContSumr":{"type":"string","description":"답변내용요약"},"custInqTyp":{"type":"string","description":"문의유형"},"accpTypCd":{"type":"string","description":"접수유형코드"},"accpTyp":{"type":"string","description":"접수유형"},"ansUseYn":{"type":"string","description":"답변사용여부"},"analyItems":{"type":"string","description":"분석항목"},"startAnalyDt":{"type":"string","description":"시작분석일"},"endAnalyDt":{"type":"string","description":"종료분석일"},"analyPeriod":{"type":"string","description":"분석기간"},"analyDtm":{"type":"string","description":"분석일시"},"goodsAnalyIncYn":{"type":"string","description":"상품분석포함여부"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v2/customerservice/ai/getCounselAiAnalysisHistList":{"get":{"tags":["상담 AI 관리"],"summary":"상담 AI 분석 이력 목록 조회","description":"## 기능 설명\n상담 고객의 AI 분석 이력 목록을 조회합니다.\n<br><br>\n---\n## 상세 내용\n* 상담 고객의 AI 분석 이력 정보를 조회합니다.\n","operationId":"getCounselAiAnalysisHistList","parameters":[{"name":"mbrNo","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseCounselAIAnalysisHistInfo"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 상담 AI 분석 이력 정보 조회

> \## 기능 설명\
> 선택한 분석 번호의 AI 분석 이력 정보를 조회합니다.\
> \<br>\<br>\
> \---\
> \## 상세 내용\
> \* 선택한 분석 번호의 AI 분석 이력 정보를 조회합니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"CounselAIAnalysisHistInfo":{"type":"object","description":"상담 AI 분석 결과 이력 DTO","properties":{"sysRegId":{"type":"string","description":"등록자ID"},"sysModId":{"type":"string","description":"수정자ID"},"aiAnalyNo":{"type":"string","description":"AI분석번호"},"histTypCd":{"type":"string","description":"이력유형코드"},"ccnNo":{"type":"string","description":"문의번호"},"mbrNo":{"type":"string","description":"회원번호"},"inqCnt":{"type":"integer","format":"int32","description":"1:1문의분석수"},"goodsQnaCnt":{"type":"integer","format":"int32","description":"상품Q&A분석수"},"ordCnt":{"type":"integer","format":"int32","description":"주문분석수"},"wrtRevCnt":{"type":"integer","format":"int32","description":"작성상품평분석수"},"custTendencySumr":{"type":"string","description":"고객성향요약"},"custTendencyPosi":{"type":"string","description":"고객성향(긍정)"},"custTendencyNega":{"type":"string","description":"고객성향(부정)"},"custResPlan":{"type":"string","description":"고객응대요령"},"revCnt":{"type":"integer","format":"int32","description":"분석대상상품평수"},"mbrCnt":{"type":"integer","format":"int32","description":"분석대상회원수"},"goodsNo":{"type":"string","description":"상품번호"},"goodsAnalySumr":{"type":"string","description":"상품분석요약"},"goodsAnalyPosi":{"type":"string","description":"상품분석(긍정)"},"goodsAnalyNega":{"type":"string","description":"상품분석(부정)"},"accpContSumr":{"type":"string","description":"접수내용요약"},"accpCont":{"type":"string","description":"접수내용"},"ansCont":{"type":"string","description":"답변내용"},"ansContSumr":{"type":"string","description":"답변내용요약"},"custInqTyp":{"type":"string","description":"문의유형"},"accpTypCd":{"type":"string","description":"접수유형코드"},"accpTyp":{"type":"string","description":"접수유형"},"ansUseYn":{"type":"string","description":"답변사용여부"},"analyItems":{"type":"string","description":"분석항목"},"startAnalyDt":{"type":"string","description":"시작분석일"},"endAnalyDt":{"type":"string","description":"종료분석일"},"analyPeriod":{"type":"string","description":"분석기간"},"analyDtm":{"type":"string","description":"분석일시"},"goodsAnalyIncYn":{"type":"string","description":"상품분석포함여부"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v2/customerservice/ai/getCounselAiAnalysisHistInfo":{"get":{"tags":["상담 AI 관리"],"summary":"상담 AI 분석 이력 정보 조회","description":"## 기능 설명\n선택한 분석 번호의 AI 분석 이력 정보를 조회합니다.\n<br><br>\n---\n## 상세 내용\n* 선택한 분석 번호의 AI 분석 이력 정보를 조회합니다.\n","operationId":"getCounselAiAnalysisHistInfo","parameters":[{"name":"aiAnalyNo","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CounselAIAnalysisHistInfo"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 상담 AI 분석 대상 정보 조회

> \## 기능 설명\
> 상담 AI 분석 대상 정보를 조회합니다.\
> \<br>\<br>\
> \---\
> \## 상세 내용\
> \* 분석할 고객 상담 내역의 상세 정보를 조회합니다.\<br>\<br>\
> \* 상담 등록 시 선택된 주문 상품이 있는 경우, 상품 목록을 조회합니다.\<br>\<br>\
> \* 비회원, 탈퇴회원, 휴면회원은 분석 대상에서 제외합니다.\
> \---\
> \## 수정번호\
> \* Release v2.00\_240829 : 개인정보 권한 체크 후 일괄 마스킹 처리 추가<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"CounselAIAnalysisRequest":{"type":"object","description":"고객 상담 AI 분석 요청 DTO","properties":{"ccnNo":{"type":"string","description":"상담 번호"},"counselGoodsInfo":{"$ref":"#/components/schemas/CounselGoodsInfo","description":"상담 상품"},"startAnalyDt":{"type":"string","description":"시작분석일"},"endAnalyDt":{"type":"string","description":"종료분석일"},"goodsAnalyIncYn":{"type":"string","description":"상품분석포함여부"}}},"CounselGoodsInfo":{"type":"object","description":"상담 대상 상품 정보 DTO","properties":{"custCnslSeq":{"type":"string","description":"고객상담순번"},"ordNo":{"type":"string","description":"주문번호"},"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"itmNo":{"type":"string","description":"단품번호"},"itmNm":{"type":"string","description":"단품명"},"stdCtgNm":{"type":"string","description":"표준카테고리명"},"entrNm":{"type":"string","description":"협력사명"}}},"CounselAIAnalysisResponse":{"type":"object","description":"고객 상담 AI 분석 응답 DTO","properties":{"counselInfo":{"$ref":"#/components/schemas/CounselInfo","description":"상담 정보"},"analysisResult":{"$ref":"#/components/schemas/CounselAIAnalysisResult","description":"상담 AI 분석 결과"}}},"CounselInfo":{"type":"object","description":"상담 정보 DTO","properties":{"ccnNo":{"type":"string","description":"상담번호"},"mbrNo":{"type":"string","description":"회원번호"},"mbrNm":{"type":"string","description":"회원명"},"brth":{"type":"string","description":"생년월일"},"sexGbCdNm":{"type":"string","description":"성별구분코드명(ME017)"},"accpTypCd":{"type":"string","description":"접수유형코드"},"custInqTyp":{"type":"string","description":"고객문의유형"},"accpCont":{"type":"string","description":"접수내용"},"counselGoodsList":{"type":"array","description":"상담 상품 목록","items":{"$ref":"#/components/schemas/CounselGoodsInfo"}},"startAnalyDt":{"type":"string","description":"시작분석일"},"endAnalyDt":{"type":"string","description":"종료분석일"}}},"CounselAIAnalysisResult":{"type":"object","description":"상담 AI 분석 결과 DTO","properties":{"reviewPoint":{"type":"number","format":"float","description":"분석 리뷰 점수"},"reviewCount":{"type":"integer","format":"int32","description":"분석 리뷰 갯수"},"inquiryCount":{"type":"integer","format":"int32","description":"분석 1:1문의 갯수"},"goodsQnaCount":{"type":"integer","format":"int32","description":"분석 상품Q&A 갯수"},"orderCount":{"type":"integer","format":"int32","description":"분석 주문 갯수"},"aiAnalyNo":{"type":"string","description":"분석 번호"},"analyDtm":{"type":"string","description":"분석 일시"},"analyOrderResult":{"type":"string","description":"고객 구매 성향 분석내용"},"analyResultPositive":{"type":"string","description":"고객 긍정성향 생성"},"analyResultNegative":{"type":"string","description":"고객 부정성향 생성"},"analyResultResponse":{"type":"string","description":"고객 응대요령"},"analyGoodsResultPositive":{"type":"string","description":"고객 리뷰 긍정분석내용"},"analyGoodsResultNegative":{"type":"string","description":"고객 리뷰 부정분석내용"},"analyResultAnswer":{"type":"string","description":"제안 답변"},"analyOrderResultSumr":{"type":"string","description":"고객 구매 성향 분석내용 요약"},"analyGoodsReviewSumr":{"type":"string","description":"고객 리뷰 분석내용 요약"},"consultingContSumr":{"type":"string","description":"문의내용 요약"},"analyResultAnswerSumr":{"type":"string","description":"제안 답변"},"startAnalyDt":{"type":"string","description":"시작분석일"},"endAnalyDt":{"type":"string","description":"종료분석일"},"goodsAnalyIncYn":{"type":"string","description":"상품분석포함여부"},"writeReviewCount":{"type":"integer","format":"int32","description":"작성리뷰갯수"},"memberCount":{"type":"integer","format":"int32","description":"작성리뷰갯수"},"defaultResult":{"description":"상담 AI 분석 결과 DTO","writeOnly":true}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v2/customerservice/ai/getCounselAiAnalysisBaseInfo":{"get":{"tags":["상담 AI 관리"],"summary":"상담 AI 분석 대상 정보 조회","description":"## 기능 설명\n상담 AI 분석 대상 정보를 조회합니다.\n<br><br>\n---\n## 상세 내용\n* 분석할 고객 상담 내역의 상세 정보를 조회합니다.<br><br>\n* 상담 등록 시 선택된 주문 상품이 있는 경우, 상품 목록을 조회합니다.<br><br>\n* 비회원, 탈퇴회원, 휴면회원은 분석 대상에서 제외합니다.\n---\n## 수정번호\n* Release v2.00_240829 : 개인정보 권한 체크 후 일괄 마스킹 처리 추가\n","operationId":"getCounselAiAnalysisBaseInfo","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/CounselAIAnalysisRequest"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CounselAIAnalysisResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 상담 AI 분석 이력 목록 조회

> \## 기능 설명\
> 상담 고객의 AI 분석 이력 목록을 조회합니다.\
> \<br>\<br>\
> \---\
> \## 상세 내용\
> \* 상담 고객의 AI 분석 이력 정보를 조회합니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"RealGridListResponseCounselAIAnalysisHistInfo":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/CounselAIAnalysisHistInfo"}}}},"CounselAIAnalysisHistInfo":{"type":"object","description":"상담 AI 분석 결과 이력 DTO","properties":{"sysRegId":{"type":"string","description":"등록자ID"},"sysModId":{"type":"string","description":"수정자ID"},"aiAnalyNo":{"type":"string","description":"AI분석번호"},"histTypCd":{"type":"string","description":"이력유형코드"},"ccnNo":{"type":"string","description":"문의번호"},"mbrNo":{"type":"string","description":"회원번호"},"inqCnt":{"type":"integer","format":"int32","description":"1:1문의분석수"},"goodsQnaCnt":{"type":"integer","format":"int32","description":"상품Q&A분석수"},"ordCnt":{"type":"integer","format":"int32","description":"주문분석수"},"wrtRevCnt":{"type":"integer","format":"int32","description":"작성상품평분석수"},"custTendencySumr":{"type":"string","description":"고객성향요약"},"custTendencyPosi":{"type":"string","description":"고객성향(긍정)"},"custTendencyNega":{"type":"string","description":"고객성향(부정)"},"custResPlan":{"type":"string","description":"고객응대요령"},"revCnt":{"type":"integer","format":"int32","description":"분석대상상품평수"},"mbrCnt":{"type":"integer","format":"int32","description":"분석대상회원수"},"goodsNo":{"type":"string","description":"상품번호"},"goodsAnalySumr":{"type":"string","description":"상품분석요약"},"goodsAnalyPosi":{"type":"string","description":"상품분석(긍정)"},"goodsAnalyNega":{"type":"string","description":"상품분석(부정)"},"accpContSumr":{"type":"string","description":"접수내용요약"},"accpCont":{"type":"string","description":"접수내용"},"ansCont":{"type":"string","description":"답변내용"},"ansContSumr":{"type":"string","description":"답변내용요약"},"custInqTyp":{"type":"string","description":"문의유형"},"accpTypCd":{"type":"string","description":"접수유형코드"},"accpTyp":{"type":"string","description":"접수유형"},"ansUseYn":{"type":"string","description":"답변사용여부"},"analyItems":{"type":"string","description":"분석항목"},"startAnalyDt":{"type":"string","description":"시작분석일"},"endAnalyDt":{"type":"string","description":"종료분석일"},"analyPeriod":{"type":"string","description":"분석기간"},"analyDtm":{"type":"string","description":"분석일시"},"goodsAnalyIncYn":{"type":"string","description":"상품분석포함여부"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/customerservice/ai/getCounselAiAnalysisHistList":{"get":{"tags":["상담 AI 관리"],"summary":"상담 AI 분석 이력 목록 조회","description":"## 기능 설명\n상담 고객의 AI 분석 이력 목록을 조회합니다.\n<br><br>\n---\n## 상세 내용\n* 상담 고객의 AI 분석 이력 정보를 조회합니다.\n","operationId":"getCounselAiAnalysisHistList_1","parameters":[{"name":"mbrNo","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseCounselAIAnalysisHistInfo"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 상담 AI 분석 이력 정보 조회

> \## 기능 설명\
> 선택한 분석 번호의 AI 분석 이력 정보를 조회합니다.\
> \<br>\<br>\
> \---\
> \## 상세 내용\
> \* 선택한 분석 번호의 AI 분석 이력 정보를 조회합니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"CounselAIAnalysisHistInfo":{"type":"object","description":"상담 AI 분석 결과 이력 DTO","properties":{"sysRegId":{"type":"string","description":"등록자ID"},"sysModId":{"type":"string","description":"수정자ID"},"aiAnalyNo":{"type":"string","description":"AI분석번호"},"histTypCd":{"type":"string","description":"이력유형코드"},"ccnNo":{"type":"string","description":"문의번호"},"mbrNo":{"type":"string","description":"회원번호"},"inqCnt":{"type":"integer","format":"int32","description":"1:1문의분석수"},"goodsQnaCnt":{"type":"integer","format":"int32","description":"상품Q&A분석수"},"ordCnt":{"type":"integer","format":"int32","description":"주문분석수"},"wrtRevCnt":{"type":"integer","format":"int32","description":"작성상품평분석수"},"custTendencySumr":{"type":"string","description":"고객성향요약"},"custTendencyPosi":{"type":"string","description":"고객성향(긍정)"},"custTendencyNega":{"type":"string","description":"고객성향(부정)"},"custResPlan":{"type":"string","description":"고객응대요령"},"revCnt":{"type":"integer","format":"int32","description":"분석대상상품평수"},"mbrCnt":{"type":"integer","format":"int32","description":"분석대상회원수"},"goodsNo":{"type":"string","description":"상품번호"},"goodsAnalySumr":{"type":"string","description":"상품분석요약"},"goodsAnalyPosi":{"type":"string","description":"상품분석(긍정)"},"goodsAnalyNega":{"type":"string","description":"상품분석(부정)"},"accpContSumr":{"type":"string","description":"접수내용요약"},"accpCont":{"type":"string","description":"접수내용"},"ansCont":{"type":"string","description":"답변내용"},"ansContSumr":{"type":"string","description":"답변내용요약"},"custInqTyp":{"type":"string","description":"문의유형"},"accpTypCd":{"type":"string","description":"접수유형코드"},"accpTyp":{"type":"string","description":"접수유형"},"ansUseYn":{"type":"string","description":"답변사용여부"},"analyItems":{"type":"string","description":"분석항목"},"startAnalyDt":{"type":"string","description":"시작분석일"},"endAnalyDt":{"type":"string","description":"종료분석일"},"analyPeriod":{"type":"string","description":"분석기간"},"analyDtm":{"type":"string","description":"분석일시"},"goodsAnalyIncYn":{"type":"string","description":"상품분석포함여부"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/customerservice/ai/getCounselAiAnalysisHistInfo":{"get":{"tags":["상담 AI 관리"],"summary":"상담 AI 분석 이력 정보 조회","description":"## 기능 설명\n선택한 분석 번호의 AI 분석 이력 정보를 조회합니다.\n<br><br>\n---\n## 상세 내용\n* 선택한 분석 번호의 AI 분석 이력 정보를 조회합니다.\n","operationId":"getCounselAiAnalysisHistInfo_1","parameters":[{"name":"aiAnalyNo","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CounselAIAnalysisHistInfo"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 상담 AI 분석 대상 정보 조회

> \## 기능 설명\
> 상담 AI 분석 대상 정보를 조회합니다.\
> \<br>\<br>\
> \---\
> \## 상세 내용\
> \* 분석할 고객 상담 내역의 상세 정보를 조회합니다.\<br>\<br>\
> \* 상담 등록 시 선택된 주문 상품이 있는 경우, 상품 목록을 조회합니다.\<br>\<br>\
> \* 비회원, 탈퇴회원, 휴면회원은 분석 대상에서 제외합니다.\
> \---\
> \## 수정번호\
> \* Release v2.00\_240829 : 개인정보 권한 체크 후 일괄 마스킹 처리 추가<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"CounselAIAnalysisRequest":{"type":"object","description":"고객 상담 AI 분석 요청 DTO","properties":{"ccnNo":{"type":"string","description":"상담 번호"},"counselGoodsInfo":{"$ref":"#/components/schemas/CounselGoodsInfo","description":"상담 상품"},"startAnalyDt":{"type":"string","description":"시작분석일"},"endAnalyDt":{"type":"string","description":"종료분석일"},"goodsAnalyIncYn":{"type":"string","description":"상품분석포함여부"}}},"CounselGoodsInfo":{"type":"object","description":"상담 대상 상품 정보 DTO","properties":{"custCnslSeq":{"type":"string","description":"고객상담순번"},"ordNo":{"type":"string","description":"주문번호"},"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"itmNo":{"type":"string","description":"단품번호"},"itmNm":{"type":"string","description":"단품명"},"stdCtgNm":{"type":"string","description":"표준카테고리명"},"entrNm":{"type":"string","description":"협력사명"}}},"CounselAIAnalysisResponse":{"type":"object","description":"고객 상담 AI 분석 응답 DTO","properties":{"counselInfo":{"$ref":"#/components/schemas/CounselInfo","description":"상담 정보"},"analysisResult":{"$ref":"#/components/schemas/CounselAIAnalysisResult","description":"상담 AI 분석 결과"}}},"CounselInfo":{"type":"object","description":"상담 정보 DTO","properties":{"ccnNo":{"type":"string","description":"상담번호"},"mbrNo":{"type":"string","description":"회원번호"},"mbrNm":{"type":"string","description":"회원명"},"brth":{"type":"string","description":"생년월일"},"sexGbCdNm":{"type":"string","description":"성별구분코드명(ME017)"},"accpTypCd":{"type":"string","description":"접수유형코드"},"custInqTyp":{"type":"string","description":"고객문의유형"},"accpCont":{"type":"string","description":"접수내용"},"counselGoodsList":{"type":"array","description":"상담 상품 목록","items":{"$ref":"#/components/schemas/CounselGoodsInfo"}},"startAnalyDt":{"type":"string","description":"시작분석일"},"endAnalyDt":{"type":"string","description":"종료분석일"}}},"CounselAIAnalysisResult":{"type":"object","description":"상담 AI 분석 결과 DTO","properties":{"reviewPoint":{"type":"number","format":"float","description":"분석 리뷰 점수"},"reviewCount":{"type":"integer","format":"int32","description":"분석 리뷰 갯수"},"inquiryCount":{"type":"integer","format":"int32","description":"분석 1:1문의 갯수"},"goodsQnaCount":{"type":"integer","format":"int32","description":"분석 상품Q&A 갯수"},"orderCount":{"type":"integer","format":"int32","description":"분석 주문 갯수"},"aiAnalyNo":{"type":"string","description":"분석 번호"},"analyDtm":{"type":"string","description":"분석 일시"},"analyOrderResult":{"type":"string","description":"고객 구매 성향 분석내용"},"analyResultPositive":{"type":"string","description":"고객 긍정성향 생성"},"analyResultNegative":{"type":"string","description":"고객 부정성향 생성"},"analyResultResponse":{"type":"string","description":"고객 응대요령"},"analyGoodsResultPositive":{"type":"string","description":"고객 리뷰 긍정분석내용"},"analyGoodsResultNegative":{"type":"string","description":"고객 리뷰 부정분석내용"},"analyResultAnswer":{"type":"string","description":"제안 답변"},"analyOrderResultSumr":{"type":"string","description":"고객 구매 성향 분석내용 요약"},"analyGoodsReviewSumr":{"type":"string","description":"고객 리뷰 분석내용 요약"},"consultingContSumr":{"type":"string","description":"문의내용 요약"},"analyResultAnswerSumr":{"type":"string","description":"제안 답변"},"startAnalyDt":{"type":"string","description":"시작분석일"},"endAnalyDt":{"type":"string","description":"종료분석일"},"goodsAnalyIncYn":{"type":"string","description":"상품분석포함여부"},"writeReviewCount":{"type":"integer","format":"int32","description":"작성리뷰갯수"},"memberCount":{"type":"integer","format":"int32","description":"작성리뷰갯수"},"defaultResult":{"description":"상담 AI 분석 결과 DTO","writeOnly":true}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/customerservice/ai/getCounselAiAnalysisBaseInfo":{"get":{"tags":["상담 AI 관리"],"summary":"상담 AI 분석 대상 정보 조회","description":"## 기능 설명\n상담 AI 분석 대상 정보를 조회합니다.\n<br><br>\n---\n## 상세 내용\n* 분석할 고객 상담 내역의 상세 정보를 조회합니다.<br><br>\n* 상담 등록 시 선택된 주문 상품이 있는 경우, 상품 목록을 조회합니다.<br><br>\n* 비회원, 탈퇴회원, 휴면회원은 분석 대상에서 제외합니다.\n---\n## 수정번호\n* Release v2.00_240829 : 개인정보 권한 체크 후 일괄 마스킹 처리 추가\n","operationId":"getCounselAiAnalysisBaseInfo_1","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/CounselAIAnalysisRequest"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CounselAIAnalysisResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```