상담 AI 관리

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

post

기능설명

• 상담 AI 분석 정보의 제안 답변을 상담 답변에 적용여부를 등록 합니다.

---

상세 설명

• 1:1문의, 상품Q&A 상담만 제안답변 적용이 가능합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

고객 상담 AI 분석 요청 DTO

ccnNostringOptional

상담 번호

Example: 10002651

startAnalyDtstringOptional

시작분석일

Example: 2024-01-01

endAnalyDtstringOptional

종료분석일

Example: 2024-07-01

goodsAnalyIncYnstringOptional

상품분석포함여부

Example: Y

Responses

200

성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

900

업무처리 오류 내용

*/*

post

/v2/customerservice/ai/updateCustomerAIAnalysisHist

HTTPcURLJavaScriptPython

POST /api/bo/v2/customerservice/ai/updateCustomerAIAnalysisHist HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 286

{
  "ccnNo": 10002651,
  "counselGoodsInfo": {
    "custCnslSeq": 1,
    "ordNo": "20230831O000001",
    "goodsNo": 100000001,
    "goodsNm": "폴로티셔츠",
    "itmNo": "001",
    "itmNm": "화이트>95",
    "stdCtgNm": "의류",
    "entrNm": "플래티어"
  },
  "startAnalyDt": "2024-01-01",
  "endAnalyDt": "2024-07-01",
  "goodsAnalyIncYn": "Y"
}

{
  "timestamp": "2026-02-27T16:43:12.143Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

상담 대응 방안 AI 분석

post

기능 설명

상담, 고객, 상품평에 대한 AI 분석 결과를 토대로 대응방안을 제시합니다.

상세 내용

• 상담 정보와 고객, 상품 AI 분석 결과를 파라메터로 AI 대응방안 분석 API를 호출합니다. ( 호출 URL : /api/ai/bo/v1/member_response_plan )

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

고객 상담 AI 분석 요청 DTO

ccnNostringOptional

상담 번호

Example: 10002651

startAnalyDtstringOptional

시작분석일

Example: 2024-01-01

endAnalyDtstringOptional

종료분석일

Example: 2024-07-01

goodsAnalyIncYnstringOptional

상품분석포함여부

Example: Y

Responses

200

성공

*/*

고객 상담 AI 분석 응답 DTO

900

업무처리 오류 내용

*/*

post

/v2/customerservice/ai/generateResponsePlanAIAnalysis

HTTPcURLJavaScriptPython

POST /api/bo/v2/customerservice/ai/generateResponsePlanAIAnalysis HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 286

{
  "ccnNo": 10002651,
  "counselGoodsInfo": {
    "custCnslSeq": 1,
    "ordNo": "20230831O000001",
    "goodsNo": 100000001,
    "goodsNm": "폴로티셔츠",
    "itmNo": "001",
    "itmNm": "화이트>95",
    "stdCtgNm": "의류",
    "entrNm": "플래티어"
  },
  "startAnalyDt": "2024-01-01",
  "endAnalyDt": "2024-07-01",
  "goodsAnalyIncYn": "Y"
}

{
  "counselInfo": {
    "ccnNo": 10002151,
    "mbrNo": 10000123,
    "mbrNm": "홍길동",
    "brth": 19990101,
    "sexGbCdNm": "남",
    "accpTypCd": 20,
    "custInqTyp": "쿠폰사용 오류",
    "accpCont": "쿠폰 사용시 오류가 발생 합니다.",
    "counselGoodsList": [
      {
        "custCnslSeq": 1,
        "ordNo": "20230831O000001",
        "goodsNo": 100000001,
        "goodsNm": "폴로티셔츠",
        "itmNo": "001",
        "itmNm": "화이트>95",
        "stdCtgNm": "의류",
        "entrNm": "플래티어"
      }
    ],
    "startAnalyDt": "2024-01-01",
    "endAnalyDt": "2024-07-01"
  },
  "analysisResult": {
    "reviewPoint": 1,
    "reviewCount": 1,
    "inquiryCount": 1,
    "goodsQnaCount": 1,
    "orderCount": 1,
    "aiAnalyNo": "text",
    "analyDtm": "text",
    "analyOrderResult": "text",
    "analyResultPositive": "text",
    "analyResultNegative": "text",
    "analyResultResponse": "text",
    "analyGoodsResultPositive": "text",
    "analyGoodsResultNegative": "text",
    "analyResultAnswer": "text",
    "analyOrderResultSumr": "text",
    "analyGoodsReviewSumr": "text",
    "consultingContSumr": "text",
    "analyResultAnswerSumr": "text",
    "startAnalyDt": "text",
    "endAnalyDt": "text",
    "goodsAnalyIncYn": "text",
    "writeReviewCount": 1,
    "memberCount": 1
  }
}

상담 상품 AI 분석

post

기능 설명

상담 상품 한건의 상품에 대해, 상품 리뷰를 분석 합니다.

상세 내용

• 선택된 한건의 상품에 대해 작성된 상품평 내용들을 분석합니다.

• 상품평 내용을 토대로 긍정적인 상품평과 부정적인 상품평을 구분하고, 평점을 도출합니다.

• 상품 정보와 상품평 목록을 파라메터 AI 분석 API를 호출합니다. ( 호출 URL : /api/ai/bo/v1/goods_review_tendency )

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

고객 상담 AI 분석 요청 DTO

ccnNostringOptional

상담 번호

Example: 10002651

startAnalyDtstringOptional

시작분석일

Example: 2024-01-01

endAnalyDtstringOptional

종료분석일

Example: 2024-07-01

goodsAnalyIncYnstringOptional

상품분석포함여부

Example: Y

Responses

200

성공

*/*

고객 상담 AI 분석 응답 DTO

900

업무처리 오류 내용

*/*

post

/v2/customerservice/ai/generateGoodsReviewAIAnalysis

HTTPcURLJavaScriptPython

POST /api/bo/v2/customerservice/ai/generateGoodsReviewAIAnalysis HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 286

{
  "ccnNo": 10002651,
  "counselGoodsInfo": {
    "custCnslSeq": 1,
    "ordNo": "20230831O000001",
    "goodsNo": 100000001,
    "goodsNm": "폴로티셔츠",
    "itmNo": "001",
    "itmNm": "화이트>95",
    "stdCtgNm": "의류",
    "entrNm": "플래티어"
  },
  "startAnalyDt": "2024-01-01",
  "endAnalyDt": "2024-07-01",
  "goodsAnalyIncYn": "Y"
}

{
  "counselInfo": {
    "ccnNo": 10002151,
    "mbrNo": 10000123,
    "mbrNm": "홍길동",
    "brth": 19990101,
    "sexGbCdNm": "남",
    "accpTypCd": 20,
    "custInqTyp": "쿠폰사용 오류",
    "accpCont": "쿠폰 사용시 오류가 발생 합니다.",
    "counselGoodsList": [
      {
        "custCnslSeq": 1,
        "ordNo": "20230831O000001",
        "goodsNo": 100000001,
        "goodsNm": "폴로티셔츠",
        "itmNo": "001",
        "itmNm": "화이트>95",
        "stdCtgNm": "의류",
        "entrNm": "플래티어"
      }
    ],
    "startAnalyDt": "2024-01-01",
    "endAnalyDt": "2024-07-01"
  },
  "analysisResult": {
    "reviewPoint": 1,
    "reviewCount": 1,
    "inquiryCount": 1,
    "goodsQnaCount": 1,
    "orderCount": 1,
    "aiAnalyNo": "text",
    "analyDtm": "text",
    "analyOrderResult": "text",
    "analyResultPositive": "text",
    "analyResultNegative": "text",
    "analyResultResponse": "text",
    "analyGoodsResultPositive": "text",
    "analyGoodsResultNegative": "text",
    "analyResultAnswer": "text",
    "analyOrderResultSumr": "text",
    "analyGoodsReviewSumr": "text",
    "consultingContSumr": "text",
    "analyResultAnswerSumr": "text",
    "startAnalyDt": "text",
    "endAnalyDt": "text",
    "goodsAnalyIncYn": "text",
    "writeReviewCount": 1,
    "memberCount": 1
  }
}

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

post

기능 설명

XGEN 통합 워크플로우(customer-counseling-analysis) 1회 호출로 고객성향·상품리뷰·응대계획 분석을 한 번에 수행합니다.

상세 내용

• 고객성향분석, 상품리뷰분석, 회원응대계획을 하나의 XGEN 워크플로우에서 체인 실행합니다.

• 요청 스펙은 기존 generateCustomerAIAnalysis / generateGoodsReviewAIAnalysis와 동일합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

고객 상담 AI 분석 요청 DTO

ccnNostringOptional

상담 번호

Example: 10002651

startAnalyDtstringOptional

시작분석일

Example: 2024-01-01

endAnalyDtstringOptional

종료분석일

Example: 2024-07-01

goodsAnalyIncYnstringOptional

상품분석포함여부

Example: Y

Responses

200

성공

*/*

고객 상담 AI 분석 응답 DTO

900

업무처리 오류 내용

*/*

post

/v2/customerservice/ai/generateCustomerCounselingAnalysis

HTTPcURLJavaScriptPython

POST /api/bo/v2/customerservice/ai/generateCustomerCounselingAnalysis HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 286

{
  "ccnNo": 10002651,
  "counselGoodsInfo": {
    "custCnslSeq": 1,
    "ordNo": "20230831O000001",
    "goodsNo": 100000001,
    "goodsNm": "폴로티셔츠",
    "itmNo": "001",
    "itmNm": "화이트>95",
    "stdCtgNm": "의류",
    "entrNm": "플래티어"
  },
  "startAnalyDt": "2024-01-01",
  "endAnalyDt": "2024-07-01",
  "goodsAnalyIncYn": "Y"
}

{
  "counselInfo": {
    "ccnNo": 10002151,
    "mbrNo": 10000123,
    "mbrNm": "홍길동",
    "brth": 19990101,
    "sexGbCdNm": "남",
    "accpTypCd": 20,
    "custInqTyp": "쿠폰사용 오류",
    "accpCont": "쿠폰 사용시 오류가 발생 합니다.",
    "counselGoodsList": [
      {
        "custCnslSeq": 1,
        "ordNo": "20230831O000001",
        "goodsNo": 100000001,
        "goodsNm": "폴로티셔츠",
        "itmNo": "001",
        "itmNm": "화이트>95",
        "stdCtgNm": "의류",
        "entrNm": "플래티어"
      }
    ],
    "startAnalyDt": "2024-01-01",
    "endAnalyDt": "2024-07-01"
  },
  "analysisResult": {
    "reviewPoint": 1,
    "reviewCount": 1,
    "inquiryCount": 1,
    "goodsQnaCount": 1,
    "orderCount": 1,
    "aiAnalyNo": "text",
    "analyDtm": "text",
    "analyOrderResult": "text",
    "analyResultPositive": "text",
    "analyResultNegative": "text",
    "analyResultResponse": "text",
    "analyGoodsResultPositive": "text",
    "analyGoodsResultNegative": "text",
    "analyResultAnswer": "text",
    "analyOrderResultSumr": "text",
    "analyGoodsReviewSumr": "text",
    "consultingContSumr": "text",
    "analyResultAnswerSumr": "text",
    "startAnalyDt": "text",
    "endAnalyDt": "text",
    "goodsAnalyIncYn": "text",
    "writeReviewCount": 1,
    "memberCount": 1
  }
}

상담 고객 AI 분석

post

기능 설명

상담 고객의 주문 이력과 상품평 작성 내용을 토대로 고객 성향을 분석합니다.

상세 내용

• 상담 고객의 주문, 주문취소, 교환, 반품 이력을 주문접수일자 기준 내림차순으로 정렬하여 최대 100건까지 조회합니다.

• 주문 상품 중 상품평을 작성한 경우, 상품평 이럭을 조회합니다.

• 상담 정보와 주문이력, 상품평 작성 내용을 파라메터로 AI 분석 API를 호출합니다. ( 호출 URL : /api/ai/bo/v1/member_goods_purchase_tendency )

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

고객 상담 AI 분석 요청 DTO

ccnNostringOptional

상담 번호

Example: 10002651

startAnalyDtstringOptional

시작분석일

Example: 2024-01-01

endAnalyDtstringOptional

종료분석일

Example: 2024-07-01

goodsAnalyIncYnstringOptional

상품분석포함여부

Example: Y

Responses

200

성공

*/*

고객 상담 AI 분석 응답 DTO

900

업무처리 오류 내용

*/*

post

/v2/customerservice/ai/generateCustomerAIAnalysis

HTTPcURLJavaScriptPython

POST /api/bo/v2/customerservice/ai/generateCustomerAIAnalysis HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 286

{
  "ccnNo": 10002651,
  "counselGoodsInfo": {
    "custCnslSeq": 1,
    "ordNo": "20230831O000001",
    "goodsNo": 100000001,
    "goodsNm": "폴로티셔츠",
    "itmNo": "001",
    "itmNm": "화이트>95",
    "stdCtgNm": "의류",
    "entrNm": "플래티어"
  },
  "startAnalyDt": "2024-01-01",
  "endAnalyDt": "2024-07-01",
  "goodsAnalyIncYn": "Y"
}

{
  "counselInfo": {
    "ccnNo": 10002151,
    "mbrNo": 10000123,
    "mbrNm": "홍길동",
    "brth": 19990101,
    "sexGbCdNm": "남",
    "accpTypCd": 20,
    "custInqTyp": "쿠폰사용 오류",
    "accpCont": "쿠폰 사용시 오류가 발생 합니다.",
    "counselGoodsList": [
      {
        "custCnslSeq": 1,
        "ordNo": "20230831O000001",
        "goodsNo": 100000001,
        "goodsNm": "폴로티셔츠",
        "itmNo": "001",
        "itmNm": "화이트>95",
        "stdCtgNm": "의류",
        "entrNm": "플래티어"
      }
    ],
    "startAnalyDt": "2024-01-01",
    "endAnalyDt": "2024-07-01"
  },
  "analysisResult": {
    "reviewPoint": 1,
    "reviewCount": 1,
    "inquiryCount": 1,
    "goodsQnaCount": 1,
    "orderCount": 1,
    "aiAnalyNo": "text",
    "analyDtm": "text",
    "analyOrderResult": "text",
    "analyResultPositive": "text",
    "analyResultNegative": "text",
    "analyResultResponse": "text",
    "analyGoodsResultPositive": "text",
    "analyGoodsResultNegative": "text",
    "analyResultAnswer": "text",
    "analyOrderResultSumr": "text",
    "analyGoodsReviewSumr": "text",
    "consultingContSumr": "text",
    "analyResultAnswerSumr": "text",
    "startAnalyDt": "text",
    "endAnalyDt": "text",
    "goodsAnalyIncYn": "text",
    "writeReviewCount": 1,
    "memberCount": 1
  }
}

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

post

기능설명

• 상담 AI 분석 정보의 제안 답변을 상담 답변에 적용여부를 등록 합니다.

---

상세 설명

• 1:1문의, 상품Q&A 상담만 제안답변 적용이 가능합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

고객 상담 AI 분석 요청 DTO

ccnNostringOptional

상담 번호

Example: 10002651

startAnalyDtstringOptional

시작분석일

Example: 2024-01-01

endAnalyDtstringOptional

종료분석일

Example: 2024-07-01

goodsAnalyIncYnstringOptional

상품분석포함여부

Example: Y

Responses

200

성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

900

업무처리 오류 내용

*/*

post

/v1/customerservice/ai/updateCustomerAIAnalysisHist

HTTPcURLJavaScriptPython

POST /api/bo/v1/customerservice/ai/updateCustomerAIAnalysisHist HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 286

{
  "ccnNo": 10002651,
  "counselGoodsInfo": {
    "custCnslSeq": 1,
    "ordNo": "20230831O000001",
    "goodsNo": 100000001,
    "goodsNm": "폴로티셔츠",
    "itmNo": "001",
    "itmNm": "화이트>95",
    "stdCtgNm": "의류",
    "entrNm": "플래티어"
  },
  "startAnalyDt": "2024-01-01",
  "endAnalyDt": "2024-07-01",
  "goodsAnalyIncYn": "Y"
}

{
  "timestamp": "2026-02-27T16:43:12.143Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

상담 대응 방안 AI 분석

post

기능 설명

상담, 고객, 상품평에 대한 AI 분석 결과를 토대로 대응방안을 제시합니다.

상세 내용

• 상담 정보와 고객, 상품 AI 분석 결과를 파라메터로 AI 대응방안 분석 API를 호출합니다. ( 호출 URL : /api/ai/bo/v1/member_response_plan )

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

고객 상담 AI 분석 요청 DTO

ccnNostringOptional

상담 번호

Example: 10002651

startAnalyDtstringOptional

시작분석일

Example: 2024-01-01

endAnalyDtstringOptional

종료분석일

Example: 2024-07-01

goodsAnalyIncYnstringOptional

상품분석포함여부

Example: Y

Responses

200

성공

*/*

고객 상담 AI 분석 응답 DTO

900

업무처리 오류 내용

*/*

post

/v1/customerservice/ai/generateResponsePlanAIAnalysis

HTTPcURLJavaScriptPython

POST /api/bo/v1/customerservice/ai/generateResponsePlanAIAnalysis HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 286

{
  "ccnNo": 10002651,
  "counselGoodsInfo": {
    "custCnslSeq": 1,
    "ordNo": "20230831O000001",
    "goodsNo": 100000001,
    "goodsNm": "폴로티셔츠",
    "itmNo": "001",
    "itmNm": "화이트>95",
    "stdCtgNm": "의류",
    "entrNm": "플래티어"
  },
  "startAnalyDt": "2024-01-01",
  "endAnalyDt": "2024-07-01",
  "goodsAnalyIncYn": "Y"
}

{
  "counselInfo": {
    "ccnNo": 10002151,
    "mbrNo": 10000123,
    "mbrNm": "홍길동",
    "brth": 19990101,
    "sexGbCdNm": "남",
    "accpTypCd": 20,
    "custInqTyp": "쿠폰사용 오류",
    "accpCont": "쿠폰 사용시 오류가 발생 합니다.",
    "counselGoodsList": [
      {
        "custCnslSeq": 1,
        "ordNo": "20230831O000001",
        "goodsNo": 100000001,
        "goodsNm": "폴로티셔츠",
        "itmNo": "001",
        "itmNm": "화이트>95",
        "stdCtgNm": "의류",
        "entrNm": "플래티어"
      }
    ],
    "startAnalyDt": "2024-01-01",
    "endAnalyDt": "2024-07-01"
  },
  "analysisResult": {
    "reviewPoint": 1,
    "reviewCount": 1,
    "inquiryCount": 1,
    "goodsQnaCount": 1,
    "orderCount": 1,
    "aiAnalyNo": "text",
    "analyDtm": "text",
    "analyOrderResult": "text",
    "analyResultPositive": "text",
    "analyResultNegative": "text",
    "analyResultResponse": "text",
    "analyGoodsResultPositive": "text",
    "analyGoodsResultNegative": "text",
    "analyResultAnswer": "text",
    "analyOrderResultSumr": "text",
    "analyGoodsReviewSumr": "text",
    "consultingContSumr": "text",
    "analyResultAnswerSumr": "text",
    "startAnalyDt": "text",
    "endAnalyDt": "text",
    "goodsAnalyIncYn": "text",
    "writeReviewCount": 1,
    "memberCount": 1
  }
}

상담 상품 AI 분석

post

기능 설명

상담 상품 한건의 상품에 대해, 상품 리뷰를 분석 합니다.

상세 내용

• 선택된 한건의 상품에 대해 작성된 상품평 내용들을 분석합니다.

• 상품평 내용을 토대로 긍정적인 상품평과 부정적인 상품평을 구분하고, 평점을 도출합니다.

• 상품 정보와 상품평 목록을 파라메터 AI 분석 API를 호출합니다. ( 호출 URL : /api/ai/bo/v1/goods_review_tendency )

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

고객 상담 AI 분석 요청 DTO

ccnNostringOptional

상담 번호

Example: 10002651

startAnalyDtstringOptional

시작분석일

Example: 2024-01-01

endAnalyDtstringOptional

종료분석일

Example: 2024-07-01

goodsAnalyIncYnstringOptional

상품분석포함여부

Example: Y

Responses

200

성공

*/*

고객 상담 AI 분석 응답 DTO

900

업무처리 오류 내용

*/*

post

/v1/customerservice/ai/generateGoodsReviewAIAnalysis

HTTPcURLJavaScriptPython

POST /api/bo/v1/customerservice/ai/generateGoodsReviewAIAnalysis HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 286

{
  "ccnNo": 10002651,
  "counselGoodsInfo": {
    "custCnslSeq": 1,
    "ordNo": "20230831O000001",
    "goodsNo": 100000001,
    "goodsNm": "폴로티셔츠",
    "itmNo": "001",
    "itmNm": "화이트>95",
    "stdCtgNm": "의류",
    "entrNm": "플래티어"
  },
  "startAnalyDt": "2024-01-01",
  "endAnalyDt": "2024-07-01",
  "goodsAnalyIncYn": "Y"
}

{
  "counselInfo": {
    "ccnNo": 10002151,
    "mbrNo": 10000123,
    "mbrNm": "홍길동",
    "brth": 19990101,
    "sexGbCdNm": "남",
    "accpTypCd": 20,
    "custInqTyp": "쿠폰사용 오류",
    "accpCont": "쿠폰 사용시 오류가 발생 합니다.",
    "counselGoodsList": [
      {
        "custCnslSeq": 1,
        "ordNo": "20230831O000001",
        "goodsNo": 100000001,
        "goodsNm": "폴로티셔츠",
        "itmNo": "001",
        "itmNm": "화이트>95",
        "stdCtgNm": "의류",
        "entrNm": "플래티어"
      }
    ],
    "startAnalyDt": "2024-01-01",
    "endAnalyDt": "2024-07-01"
  },
  "analysisResult": {
    "reviewPoint": 1,
    "reviewCount": 1,
    "inquiryCount": 1,
    "goodsQnaCount": 1,
    "orderCount": 1,
    "aiAnalyNo": "text",
    "analyDtm": "text",
    "analyOrderResult": "text",
    "analyResultPositive": "text",
    "analyResultNegative": "text",
    "analyResultResponse": "text",
    "analyGoodsResultPositive": "text",
    "analyGoodsResultNegative": "text",
    "analyResultAnswer": "text",
    "analyOrderResultSumr": "text",
    "analyGoodsReviewSumr": "text",
    "consultingContSumr": "text",
    "analyResultAnswerSumr": "text",
    "startAnalyDt": "text",
    "endAnalyDt": "text",
    "goodsAnalyIncYn": "text",
    "writeReviewCount": 1,
    "memberCount": 1
  }
}

상담 고객 AI 분석

post

기능 설명

상담 고객의 주문 이력과 상품평 작성 내용을 토대로 고객 성향을 분석합니다.

상세 내용

• 상담 고객의 주문, 주문취소, 교환, 반품 이력을 주문접수일자 기준 내림차순으로 정렬하여 최대 100건까지 조회합니다.

• 주문 상품 중 상품평을 작성한 경우, 상품평 이럭을 조회합니다.

• 상담 정보와 주문이력, 상품평 작성 내용을 파라메터로 AI 분석 API를 호출합니다. ( 호출 URL : /api/ai/bo/v1/member_goods_purchase_tendency )

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

고객 상담 AI 분석 요청 DTO

ccnNostringOptional

상담 번호

Example: 10002651

startAnalyDtstringOptional

시작분석일

Example: 2024-01-01

endAnalyDtstringOptional

종료분석일

Example: 2024-07-01

goodsAnalyIncYnstringOptional

상품분석포함여부

Example: Y

Responses

200

성공

*/*

고객 상담 AI 분석 응답 DTO

900

업무처리 오류 내용

*/*

post

/v1/customerservice/ai/generateCustomerAIAnalysis

HTTPcURLJavaScriptPython

POST /api/bo/v1/customerservice/ai/generateCustomerAIAnalysis HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 286

{
  "ccnNo": 10002651,
  "counselGoodsInfo": {
    "custCnslSeq": 1,
    "ordNo": "20230831O000001",
    "goodsNo": 100000001,
    "goodsNm": "폴로티셔츠",
    "itmNo": "001",
    "itmNm": "화이트>95",
    "stdCtgNm": "의류",
    "entrNm": "플래티어"
  },
  "startAnalyDt": "2024-01-01",
  "endAnalyDt": "2024-07-01",
  "goodsAnalyIncYn": "Y"
}

{
  "counselInfo": {
    "ccnNo": 10002151,
    "mbrNo": 10000123,
    "mbrNm": "홍길동",
    "brth": 19990101,
    "sexGbCdNm": "남",
    "accpTypCd": 20,
    "custInqTyp": "쿠폰사용 오류",
    "accpCont": "쿠폰 사용시 오류가 발생 합니다.",
    "counselGoodsList": [
      {
        "custCnslSeq": 1,
        "ordNo": "20230831O000001",
        "goodsNo": 100000001,
        "goodsNm": "폴로티셔츠",
        "itmNo": "001",
        "itmNm": "화이트>95",
        "stdCtgNm": "의류",
        "entrNm": "플래티어"
      }
    ],
    "startAnalyDt": "2024-01-01",
    "endAnalyDt": "2024-07-01"
  },
  "analysisResult": {
    "reviewPoint": 1,
    "reviewCount": 1,
    "inquiryCount": 1,
    "goodsQnaCount": 1,
    "orderCount": 1,
    "aiAnalyNo": "text",
    "analyDtm": "text",
    "analyOrderResult": "text",
    "analyResultPositive": "text",
    "analyResultNegative": "text",
    "analyResultResponse": "text",
    "analyGoodsResultPositive": "text",
    "analyGoodsResultNegative": "text",
    "analyResultAnswer": "text",
    "analyOrderResultSumr": "text",
    "analyGoodsReviewSumr": "text",
    "consultingContSumr": "text",
    "analyResultAnswerSumr": "text",
    "startAnalyDt": "text",
    "endAnalyDt": "text",
    "goodsAnalyIncYn": "text",
    "writeReviewCount": 1,
    "memberCount": 1
  }
}

상담 AI 분석 이력 목록 조회

get

기능 설명

상담 고객의 AI 분석 이력 목록을 조회합니다.

상세 내용

• 상담 고객의 AI 분석 이력 정보를 조회합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

mbrNostringRequired

Responses

200

성공

*/*

totalCountinteger · int32Optional

900

업무처리 오류 내용

*/*

get

/v2/customerservice/ai/getCounselAiAnalysisHistList

HTTPcURLJavaScriptPython

GET /api/bo/v2/customerservice/ai/getCounselAiAnalysisHistList?mbrNo=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "totalCount": 1,
  "payloads": [
    {
      "sysRegId": "text",
      "sysModId": "text",
      "aiAnalyNo": "text",
      "histTypCd": "text",
      "ccnNo": "text",
      "mbrNo": "text",
      "inqCnt": 1,
      "goodsQnaCnt": 1,
      "ordCnt": 1,
      "wrtRevCnt": 1,
      "custTendencySumr": "text",
      "custTendencyPosi": "text",
      "custTendencyNega": "text",
      "custResPlan": "text",
      "revCnt": 1,
      "mbrCnt": 1,
      "goodsNo": "text",
      "goodsAnalySumr": "text",
      "goodsAnalyPosi": "text",
      "goodsAnalyNega": "text",
      "accpContSumr": "text",
      "accpCont": "text",
      "ansCont": "text",
      "ansContSumr": "text",
      "custInqTyp": "text",
      "accpTypCd": "text",
      "accpTyp": "text",
      "ansUseYn": "text",
      "analyItems": "text",
      "startAnalyDt": "text",
      "endAnalyDt": "text",
      "analyPeriod": "text",
      "analyDtm": "text",
      "goodsAnalyIncYn": "text"
    }
  ]
}

상담 AI 분석 이력 정보 조회

get

기능 설명

선택한 분석 번호의 AI 분석 이력 정보를 조회합니다.

상세 내용

• 선택한 분석 번호의 AI 분석 이력 정보를 조회합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

aiAnalyNostringRequired

Responses

200

성공

*/*

상담 AI 분석 결과 이력 DTO

sysRegIdstringOptional

등록자ID

sysModIdstringOptional

수정자ID

aiAnalyNostringOptional

AI분석번호

histTypCdstringOptional

이력유형코드

ccnNostringOptional

문의번호

mbrNostringOptional

회원번호

inqCntinteger · int32Optional

1:1문의분석수

goodsQnaCntinteger · int32Optional

상품Q&A분석수

ordCntinteger · int32Optional

주문분석수

wrtRevCntinteger · int32Optional

작성상품평분석수

custTendencySumrstringOptional

고객성향요약

custTendencyPosistringOptional

고객성향(긍정)

custTendencyNegastringOptional

고객성향(부정)

custResPlanstringOptional

고객응대요령

revCntinteger · int32Optional

분석대상상품평수

mbrCntinteger · int32Optional

분석대상회원수

goodsNostringOptional

상품번호

goodsAnalySumrstringOptional

상품분석요약

goodsAnalyPosistringOptional

상품분석(긍정)

goodsAnalyNegastringOptional

상품분석(부정)

accpContSumrstringOptional

접수내용요약

accpContstringOptional

접수내용

ansContstringOptional

답변내용

ansContSumrstringOptional

답변내용요약

custInqTypstringOptional

문의유형

accpTypCdstringOptional

접수유형코드

accpTypstringOptional

접수유형

ansUseYnstringOptional

답변사용여부

analyItemsstringOptional

분석항목

startAnalyDtstringOptional

시작분석일

endAnalyDtstringOptional

종료분석일

analyPeriodstringOptional

분석기간

analyDtmstringOptional

분석일시

goodsAnalyIncYnstringOptional

상품분석포함여부

900

업무처리 오류 내용

*/*

get

/v2/customerservice/ai/getCounselAiAnalysisHistInfo

HTTPcURLJavaScriptPython

GET /api/bo/v2/customerservice/ai/getCounselAiAnalysisHistInfo?aiAnalyNo=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "sysRegId": "text",
  "sysModId": "text",
  "aiAnalyNo": "text",
  "histTypCd": "text",
  "ccnNo": "text",
  "mbrNo": "text",
  "inqCnt": 1,
  "goodsQnaCnt": 1,
  "ordCnt": 1,
  "wrtRevCnt": 1,
  "custTendencySumr": "text",
  "custTendencyPosi": "text",
  "custTendencyNega": "text",
  "custResPlan": "text",
  "revCnt": 1,
  "mbrCnt": 1,
  "goodsNo": "text",
  "goodsAnalySumr": "text",
  "goodsAnalyPosi": "text",
  "goodsAnalyNega": "text",
  "accpContSumr": "text",
  "accpCont": "text",
  "ansCont": "text",
  "ansContSumr": "text",
  "custInqTyp": "text",
  "accpTypCd": "text",
  "accpTyp": "text",
  "ansUseYn": "text",
  "analyItems": "text",
  "startAnalyDt": "text",
  "endAnalyDt": "text",
  "analyPeriod": "text",
  "analyDtm": "text",
  "goodsAnalyIncYn": "text"
}

상담 AI 분석 대상 정보 조회

get

기능 설명

상담 AI 분석 대상 정보를 조회합니다.

상세 내용

• 분석할 고객 상담 내역의 상세 정보를 조회합니다.

• 상담 등록 시 선택된 주문 상품이 있는 경우, 상품 목록을 조회합니다.

• 비회원, 탈퇴회원, 휴면회원은 분석 대상에서 제외합니다.

---

수정번호

• Release v2.00_240829 : 개인정보 권한 체크 후 일괄 마스킹 처리 추가

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

Responses

200

성공

*/*

고객 상담 AI 분석 응답 DTO

900

업무처리 오류 내용

*/*

get

/v2/customerservice/ai/getCounselAiAnalysisBaseInfo

HTTPcURLJavaScriptPython

GET /api/bo/v2/customerservice/ai/getCounselAiAnalysisBaseInfo?request=[object+Object] HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "counselInfo": {
    "ccnNo": 10002151,
    "mbrNo": 10000123,
    "mbrNm": "홍길동",
    "brth": 19990101,
    "sexGbCdNm": "남",
    "accpTypCd": 20,
    "custInqTyp": "쿠폰사용 오류",
    "accpCont": "쿠폰 사용시 오류가 발생 합니다.",
    "counselGoodsList": [
      {
        "custCnslSeq": 1,
        "ordNo": "20230831O000001",
        "goodsNo": 100000001,
        "goodsNm": "폴로티셔츠",
        "itmNo": "001",
        "itmNm": "화이트>95",
        "stdCtgNm": "의류",
        "entrNm": "플래티어"
      }
    ],
    "startAnalyDt": "2024-01-01",
    "endAnalyDt": "2024-07-01"
  },
  "analysisResult": {
    "reviewPoint": 1,
    "reviewCount": 1,
    "inquiryCount": 1,
    "goodsQnaCount": 1,
    "orderCount": 1,
    "aiAnalyNo": "text",
    "analyDtm": "text",
    "analyOrderResult": "text",
    "analyResultPositive": "text",
    "analyResultNegative": "text",
    "analyResultResponse": "text",
    "analyGoodsResultPositive": "text",
    "analyGoodsResultNegative": "text",
    "analyResultAnswer": "text",
    "analyOrderResultSumr": "text",
    "analyGoodsReviewSumr": "text",
    "consultingContSumr": "text",
    "analyResultAnswerSumr": "text",
    "startAnalyDt": "text",
    "endAnalyDt": "text",
    "goodsAnalyIncYn": "text",
    "writeReviewCount": 1,
    "memberCount": 1
  }
}

상담 AI 분석 이력 목록 조회

get

기능 설명

상담 고객의 AI 분석 이력 목록을 조회합니다.

상세 내용

• 상담 고객의 AI 분석 이력 정보를 조회합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

mbrNostringRequired

Responses

200

성공

*/*

totalCountinteger · int32Optional

900

업무처리 오류 내용

*/*

get

/v1/customerservice/ai/getCounselAiAnalysisHistList

HTTPcURLJavaScriptPython

GET /api/bo/v1/customerservice/ai/getCounselAiAnalysisHistList?mbrNo=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "totalCount": 1,
  "payloads": [
    {
      "sysRegId": "text",
      "sysModId": "text",
      "aiAnalyNo": "text",
      "histTypCd": "text",
      "ccnNo": "text",
      "mbrNo": "text",
      "inqCnt": 1,
      "goodsQnaCnt": 1,
      "ordCnt": 1,
      "wrtRevCnt": 1,
      "custTendencySumr": "text",
      "custTendencyPosi": "text",
      "custTendencyNega": "text",
      "custResPlan": "text",
      "revCnt": 1,
      "mbrCnt": 1,
      "goodsNo": "text",
      "goodsAnalySumr": "text",
      "goodsAnalyPosi": "text",
      "goodsAnalyNega": "text",
      "accpContSumr": "text",
      "accpCont": "text",
      "ansCont": "text",
      "ansContSumr": "text",
      "custInqTyp": "text",
      "accpTypCd": "text",
      "accpTyp": "text",
      "ansUseYn": "text",
      "analyItems": "text",
      "startAnalyDt": "text",
      "endAnalyDt": "text",
      "analyPeriod": "text",
      "analyDtm": "text",
      "goodsAnalyIncYn": "text"
    }
  ]
}

상담 AI 분석 이력 정보 조회

get

기능 설명

선택한 분석 번호의 AI 분석 이력 정보를 조회합니다.

상세 내용

• 선택한 분석 번호의 AI 분석 이력 정보를 조회합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

aiAnalyNostringRequired

Responses

200

성공

*/*

상담 AI 분석 결과 이력 DTO

sysRegIdstringOptional

등록자ID

sysModIdstringOptional

수정자ID

aiAnalyNostringOptional

AI분석번호

histTypCdstringOptional

이력유형코드

ccnNostringOptional

문의번호

mbrNostringOptional

회원번호

inqCntinteger · int32Optional

1:1문의분석수

goodsQnaCntinteger · int32Optional

상품Q&A분석수

ordCntinteger · int32Optional

주문분석수

wrtRevCntinteger · int32Optional

작성상품평분석수

custTendencySumrstringOptional

고객성향요약

custTendencyPosistringOptional

고객성향(긍정)

custTendencyNegastringOptional

고객성향(부정)

custResPlanstringOptional

고객응대요령

revCntinteger · int32Optional

분석대상상품평수

mbrCntinteger · int32Optional

분석대상회원수

goodsNostringOptional

상품번호

goodsAnalySumrstringOptional

상품분석요약

goodsAnalyPosistringOptional

상품분석(긍정)

goodsAnalyNegastringOptional

상품분석(부정)

accpContSumrstringOptional

접수내용요약

accpContstringOptional

접수내용

ansContstringOptional

답변내용

ansContSumrstringOptional

답변내용요약

custInqTypstringOptional

문의유형

accpTypCdstringOptional

접수유형코드

accpTypstringOptional

접수유형

ansUseYnstringOptional

답변사용여부

analyItemsstringOptional

분석항목

startAnalyDtstringOptional

시작분석일

endAnalyDtstringOptional

종료분석일

analyPeriodstringOptional

분석기간

analyDtmstringOptional

분석일시

goodsAnalyIncYnstringOptional

상품분석포함여부

900

업무처리 오류 내용

*/*

get

/v1/customerservice/ai/getCounselAiAnalysisHistInfo

HTTPcURLJavaScriptPython

GET /api/bo/v1/customerservice/ai/getCounselAiAnalysisHistInfo?aiAnalyNo=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "sysRegId": "text",
  "sysModId": "text",
  "aiAnalyNo": "text",
  "histTypCd": "text",
  "ccnNo": "text",
  "mbrNo": "text",
  "inqCnt": 1,
  "goodsQnaCnt": 1,
  "ordCnt": 1,
  "wrtRevCnt": 1,
  "custTendencySumr": "text",
  "custTendencyPosi": "text",
  "custTendencyNega": "text",
  "custResPlan": "text",
  "revCnt": 1,
  "mbrCnt": 1,
  "goodsNo": "text",
  "goodsAnalySumr": "text",
  "goodsAnalyPosi": "text",
  "goodsAnalyNega": "text",
  "accpContSumr": "text",
  "accpCont": "text",
  "ansCont": "text",
  "ansContSumr": "text",
  "custInqTyp": "text",
  "accpTypCd": "text",
  "accpTyp": "text",
  "ansUseYn": "text",
  "analyItems": "text",
  "startAnalyDt": "text",
  "endAnalyDt": "text",
  "analyPeriod": "text",
  "analyDtm": "text",
  "goodsAnalyIncYn": "text"
}

상담 AI 분석 대상 정보 조회

get

기능 설명

상담 AI 분석 대상 정보를 조회합니다.

상세 내용

• 분석할 고객 상담 내역의 상세 정보를 조회합니다.

• 상담 등록 시 선택된 주문 상품이 있는 경우, 상품 목록을 조회합니다.

• 비회원, 탈퇴회원, 휴면회원은 분석 대상에서 제외합니다.

---

수정번호

• Release v2.00_240829 : 개인정보 권한 체크 후 일괄 마스킹 처리 추가

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

Responses

200

성공

*/*

고객 상담 AI 분석 응답 DTO

900

업무처리 오류 내용

*/*

get

/v1/customerservice/ai/getCounselAiAnalysisBaseInfo

HTTPcURLJavaScriptPython

GET /api/bo/v1/customerservice/ai/getCounselAiAnalysisBaseInfo?request=[object+Object] HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "counselInfo": {
    "ccnNo": 10002151,
    "mbrNo": 10000123,
    "mbrNm": "홍길동",
    "brth": 19990101,
    "sexGbCdNm": "남",
    "accpTypCd": 20,
    "custInqTyp": "쿠폰사용 오류",
    "accpCont": "쿠폰 사용시 오류가 발생 합니다.",
    "counselGoodsList": [
      {
        "custCnslSeq": 1,
        "ordNo": "20230831O000001",
        "goodsNo": 100000001,
        "goodsNm": "폴로티셔츠",
        "itmNo": "001",
        "itmNm": "화이트>95",
        "stdCtgNm": "의류",
        "entrNm": "플래티어"
      }
    ],
    "startAnalyDt": "2024-01-01",
    "endAnalyDt": "2024-07-01"
  },
  "analysisResult": {
    "reviewPoint": 1,
    "reviewCount": 1,
    "inquiryCount": 1,
    "goodsQnaCount": 1,
    "orderCount": 1,
    "aiAnalyNo": "text",
    "analyDtm": "text",
    "analyOrderResult": "text",
    "analyResultPositive": "text",
    "analyResultNegative": "text",
    "analyResultResponse": "text",
    "analyGoodsResultPositive": "text",
    "analyGoodsResultNegative": "text",
    "analyResultAnswer": "text",
    "analyOrderResultSumr": "text",
    "analyGoodsReviewSumr": "text",
    "consultingContSumr": "text",
    "analyResultAnswerSumr": "text",
    "startAnalyDt": "text",
    "endAnalyDt": "text",
    "goodsAnalyIncYn": "text",
    "writeReviewCount": 1,
    "memberCount": 1
  }
}