Ctrlk
X2BEE 바로가기
For the complete documentation index, see llms.txt. This page is also available as Markdown.

상담할당관리

OB 업무 일괄 등록

post

API 설명

  • OB 일괄등록 엑셀 파일을 읽어들여 선택한 OB 상담유형으로 일괄 등록합니다.

상세 설명

  • 주문번호는 필수가 아니며 존재할 경우 정상적인 주문번호가 아니면 등록이 불가능 합니다.

  • 정상적인 회원번호가 아니면 등록이 불가능 합니다.

  • OB 일괄등록을 통해 상담 등록 시 주문상품정보는 등록되지 않습니다.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
mbrNoStringOptional

회원번호

ordNoStringOptional

주문번호

accpTitleStringRequired

문의제목

accpContStringOptional

접수내용

cnslTypNoStringOptional

상담유형번호

obTypNoStringOptional

OB유형번호

Body
Responses
200

성공

*/*
totalCountinteger · int32Optional
post/v2/customerservice/csAllocationMgmt/saveObCsCounselInfoListExcel
POST /api/bo/v2/customerservice/csAllocationMgmt/saveObCsCounselInfoListExcel?accpTitle=null HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 766

{
  "all": [
    {
      "mbrNo": 100001115,
      "ordNo": "20230823O213183",
      "accpTitle": "주문번호 정상 케이스 문의",
      "accpCont": "주문번호 정상 케이스 문의",
      "cnslTypNo": 10020,
      "obTypNo": 10020
    }
  ],
  "create": [
    {
      "mbrNo": 100001115,
      "ordNo": "20230823O213183",
      "accpTitle": "주문번호 정상 케이스 문의",
      "accpCont": "주문번호 정상 케이스 문의",
      "cnslTypNo": 10020,
      "obTypNo": 10020
    }
  ],
  "update": [
    {
      "mbrNo": 100001115,
      "ordNo": "20230823O213183",
      "accpTitle": "주문번호 정상 케이스 문의",
      "accpCont": "주문번호 정상 케이스 문의",
      "cnslTypNo": 10020,
      "obTypNo": 10020
    }
  ],
  "delete": [
    {
      "mbrNo": 100001115,
      "ordNo": "20230823O213183",
      "accpTitle": "주문번호 정상 케이스 문의",
      "accpCont": "주문번호 정상 케이스 문의",
      "cnslTypNo": 10020,
      "obTypNo": 10020
    }
  ]
}
{
  "totalCount": 1,
  "payloads": [
    {
      "mbrNo": "text",
      "ordNo": "text",
      "accpTitle": "text",
      "accpCont": "text",
      "yn": "text",
      "failCont": "text",
      "cnslTypNo": "text",
      "obTypNo": "text"
    }
  ]
}

수동할당 저장

post

API 설명

  • 담당자에게 선택한 상담을 수동할당 처리 합니다.

상세 설명

  • 업무유형별 담당자 할당 현황에서 선택한 담당자에게 미할당 상태 상담을 수동으로 할당 합니다.

  • 수동할당은 상담원이 당일 할당가능한 수량을 초과한 상태에도 할당이 가능합니다.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
ccnNoStringOptional

상담번호

ccnPrgsStatCdStringOptional

처리상태

procmnIdStringOptional

처리자ID

Body
Responses
200

성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

post/v2/customerservice/csAllocationMgmt/saveManualAssign
POST /api/bo/v2/customerservice/csAllocationMgmt/saveManualAssign HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 298

{
  "all": [
    {
      "ccnNo": 10004781,
      "ccnPrgsStatCd": 10,
      "procmnId": "zyoonforCX44"
    }
  ],
  "create": [
    {
      "ccnNo": 10004781,
      "ccnPrgsStatCd": 10,
      "procmnId": "zyoonforCX44"
    }
  ],
  "update": [
    {
      "ccnNo": 10004781,
      "ccnPrgsStatCd": 10,
      "procmnId": "zyoonforCX44"
    }
  ],
  "delete": [
    {
      "ccnNo": 10004781,
      "ccnPrgsStatCd": 10,
      "procmnId": "zyoonforCX44"
    }
  ]
}
{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

자동배분 설정 저장(등록/수정/삭제)

post

API 설명

  • 자동배분 설정 정보를 저장(등록/수정/삭제) 합니다.

상세 설명

  • 선택한 담당자를 특정 상담유형 처리가능한 상담원으로 등록 합니다.

  • 등록된 담당자가 하루 처리 가능한 할당 수량을 수정 합니다.

  • 등록된 담당자를 자동배분 대상에서 삭제 합니다.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
Responses
200

성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

post/v2/customerservice/csAllocationMgmt/saveAutoDistributionManager
POST /api/bo/v2/customerservice/csAllocationMgmt/saveAutoDistributionManager HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 518

{
  "all": [
    {
      "autoDivNo": 1000442,
      "aempId": "zyoonforCX2",
      "autoDivGbCd": 20,
      "autoDivDtlNo": 10131,
      "dayclQuotQty": 5,
      "autoDivPsbYn": "Y"
    }
  ],
  "create": [
    {
      "autoDivNo": 1000442,
      "aempId": "zyoonforCX2",
      "autoDivGbCd": 20,
      "autoDivDtlNo": 10131,
      "dayclQuotQty": 5,
      "autoDivPsbYn": "Y"
    }
  ],
  "update": [
    {
      "autoDivNo": 1000442,
      "aempId": "zyoonforCX2",
      "autoDivGbCd": 20,
      "autoDivDtlNo": 10131,
      "dayclQuotQty": 5,
      "autoDivPsbYn": "Y"
    }
  ],
  "delete": [
    {
      "autoDivNo": 1000442,
      "aempId": "zyoonforCX2",
      "autoDivGbCd": 20,
      "autoDivDtlNo": 10131,
      "dayclQuotQty": 5,
      "autoDivPsbYn": "Y"
    }
  ]
}
{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}
post
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
excelColumnsstringRequired
cnslTypNostringRequired
obTypNostringRequired
Body
excelFilestring · binaryRequired
Responses
200

OK

*/*
totalCountinteger · int32Optional
post/v2/customerservice/csAllocationMgmt/getObCsCounselInfoListExcel
POST /api/bo/v2/customerservice/csAllocationMgmt/getObCsCounselInfoListExcel?excelColumns=text&cnslTypNo=text&obTypNo=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 22

{
  "excelFile": "binary"
}
200

OK

{
  "totalCount": 1,
  "payloads": [
    {
      "mbrNo": 100001115,
      "ordNo": "20230823O213183",
      "accpTitle": "주문번호 정상 케이스 문의",
      "accpCont": "주문번호 정상 케이스 문의",
      "cnslTypNo": 10020,
      "obTypNo": 10020
    }
  ]
}

자동배분 담당자 할당 진행 상태 수정

post

API 설명

  • 자동배분설정 등록된 담당자의 할당 진행 상태를 수정한다.

상세 설명

  • 등록된 자동배분 담당자 할당 진행 상태를 변경한다.

  • 사용안함으로 변경된 담당자에게는 할당이 중지된다.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body

자동배분 담당자 할당 진행상태 변경 요청 DTO

statestringOptional

할당진행상태

Example: N
autoDivNoListstring[]Optional

자동배분번호목록

Example: [{1000442}]
Responses
200

성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

post/v2/customerservice/csAllocationMgmt/changeAutoDivideAllocationPossibleYn
POST /api/bo/v2/customerservice/csAllocationMgmt/changeAutoDivideAllocationPossibleYn HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 43

{
  "state": "N",
  "autoDivNoList": "[{1000442}]"
}
{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

수동할당 목록 조회

get

API 설명

  • 수동할당 가능한 상담목록을 조회 한다.

상세 설명

  • 선택한 상담원이 처리 가능한 미할당 상태 상담정보 목록을 조회 한다.

  • 처리 가능한 상담정보 : 선택한 상담원정보의 업무유형(대), 업무유형(중) 상담유형이 동일합니다.

  • 상품Q&A는 업무유형(대)만 값이 존재 합니다.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
autoDivGbCdstringOptional

자동배분구분코드(CS023)

Example: 50
autoDivDtlNostringOptional

자동배분상세번호

Example: 10020
Responses
200

성공

*/*
totalCountinteger · int32Optional
get/v2/customerservice/csAllocationMgmt/manualAssignList
GET /api/bo/v2/customerservice/csAllocationMgmt/manualAssignList HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "totalCount": 1,
  "payloads": [
    {
      "ccnNo": "text",
      "accpDtm": "text",
      "ccnPrgsStatCd": "text",
      "custCnslGbCd": "text",
      "accpTypCd": "text",
      "cnslTypNo": "text",
      "cnslTypText": "text",
      "accpMediaCd": "text",
      "accpCont": "text",
      "mbrId": "text",
      "mbrNm": "text",
      "acptmnNm": "text",
      "procmnNm": "text",
      "quotDtm": "text",
      "fnshmnNm": "text",
      "fnshDtm": "text"
    }
  ]
}

고객센터 부서별 사용자 목록 조회

get

API 설명

  • 선택한 고객센터 부서에 속한 사용자 목록을 조회 합니다.

상세 설명

  • 근무상태코드가 재직중(01)인 사용자 수를 조회 합니다.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
deptCdstringOptional

부서코드

Example: 10141
userIdstringOptional

사용자ID

Example: x2bee
Responses
200

성공

*/*
totalCountinteger · int32Optional
get/v2/customerservice/csAllocationMgmt/getCsDeptUserList
GET /api/bo/v2/customerservice/csAllocationMgmt/getCsDeptUserList HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "totalCount": 1,
  "payloads": [
    {
      "userId": "text",
      "userNm": "text",
      "userGbCd": "text"
    }
  ]
}

부서목록 조회

get

API 설명

  • 자동배분 설정 팝업 화면에서 사용하는 부서코드를 Tree 형태로 조회 합니다.

상세 설명

  • 업무그룹코드가 고객센터인 부서정보를 조회 합니다.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Responses
200

성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

get/v2/customerservice/csAllocationMgmt/getCsDeptList
GET /api/bo/v2/customerservice/csAllocationMgmt/getCsDeptList HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": [
    {
      "deptCd": "text",
      "deptNm": "text",
      "sortSeq": "text",
      "useYn": "text",
      "uprDeptCd": "text",
      "jobGrpCd": "SYSTEM_MANAGER",
      "userId": "text",
      "level": "text",
      "hierarchy": "text",
      "hierarchyText": "text",
      "leafYn": "text"
    }
  ],
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

자동배분코드에 따른 업무유형상세번호 조회

get

API 설명

  • 상담할당 관리 화면에서 업무유형(자동배분유형) 변경 시 하위 업무유형상세번호를 조회합니다.

상세 설명

  • 업무유형 변경시 하위 업무유형상세번호를 조회 합니다.

  • OB 상담일 때 업무유형상세번호는 OB유형번호 입니다.

  • 1:1문의 상담 일 때 업무유형상세번호는 고객문의유형코드 입니다.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
autoDivGbCdStringOptional

자동배분구분코드

Responses
200

성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

get/v2/customerservice/csAllocationMgmt/getAutoDivideDetailNo
GET /api/bo/v2/customerservice/csAllocationMgmt/getAutoDivideDetailNo HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": [
    {
      "autoDivNo": "text",
      "aempId": "text",
      "autoDivGbCd": "text",
      "autoDivDtlNo": "text",
      "autoDivDtlNm": "text",
      "dayclQuotQty": 1,
      "autoDivPsbYn": "text"
    }
  ],
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

자동배분 설정 등록된 담당자 목록 조회

get

API 설명

  • 자동배분 대상자로 등록된 담당자 정보를 조회 합니다.

상세 설명

  • 할당상태 기준은 아래와 같습니다.

  • 대기: 자동배분여부(Y), 접수된 상담 존재 X

  • 할당진행: 자동배분여부(Y), 접수된 상담 존재

  • 할당중단: 자동배분여부(N)

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
deptCdstringOptional

부서코드

Example: 10141
userIdstringOptional

사용자ID

Example: x2bee
Responses
200

성공

*/*
totalCountinteger · int32Optional
get/v2/customerservice/csAllocationMgmt/getAutoDistributionManagerList
GET /api/bo/v2/customerservice/csAllocationMgmt/getAutoDistributionManagerList HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "totalCount": 1,
  "payloads": [
    {
      "state": "text",
      "autoDivNo": "text",
      "aempId": "text",
      "aempNm": "text",
      "autoDivGbCd": "text",
      "autoDivGbNm": "text",
      "autoDivDtlNo": "text",
      "dayclQuotQty": 1,
      "autoDivPsbYn": "text"
    }
  ]
}

자동배분 설정 등록된 담당자 목록 수 조회

get

API 설명

  • 자동배분 대상자로 등록된 담당자 목록 수 를 조회 합니다.

상세 설명

  • 고객센터 대시보드에서 자동배분 대상자 여부에 따라 특정 로직을 처리할 때 사용할 수 있습니다.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
deptCdstringOptional

부서코드

Example: 10141
userIdstringOptional

사용자ID

Example: x2bee
Responses
200

성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadinteger · int32Optional

payload

errorbooleanOptional

is error

get/v2/customerservice/csAllocationMgmt/getAutoDistributionManagerListCount
GET /api/bo/v2/customerservice/csAllocationMgmt/getAutoDistributionManagerListCount HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": 1,
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

상담할당 현황 목록 조회

get

API 설명

  • 상담할당 관리 화면에서 상담할당 현황 목록을 조회 합니다.

상세 설명

  • 선택한 접수일자 동안 업무유형 별 할당현황을 조회 합니다.

  • 당일 할당현황은 접수일자에 영향받지 않습니다.

수정 번호

  • Release v2.00_240613: 기간 검색 조건 개선

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
startDatestring · dateOptional

시작일자

Example: 2023-09-08
endDatestring · dateOptional

종료일자

Example: 2023-09-11
dateSelectstringOptional

날짜기간선택

Example: all_day
autoDivGbCdstringOptional

자동배분구분코드

Example: 50
autoDivDtlNostringOptional

자동배분구분상세코드

Example: 50
userIdstringOptional

담당자ID

Example: zyoonforCX44
Responses
200

성공

*/*
totalCountinteger · int32Optional
get/v2/customerservice/csAllocationMgmt/csAllocationMgmtList
GET /api/bo/v2/customerservice/csAllocationMgmt/csAllocationMgmtList HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "totalCount": 1,
  "payloads": [
    {
      "state": "text",
      "autoDivNo": "text",
      "autoDivGbCd": "text",
      "autoDivGbNm": "text",
      "autoDivDtlNo": "text",
      "autoDivDtlNm": "text",
      "numOfAssignments": "text",
      "numOfUnassignments": "text",
      "receipt": "text",
      "inProgress": "text",
      "complete": "text",
      "already": "text",
      "numOfPeopleHandling": "text",
      "numOfAllotableCases": "text",
      "acptmnId": "text",
      "aempNm": "text"
    }
  ]
}

업무유형별 담당자 할당 현황 목록 조회

get

API 설명

  • 상담할당 관리 화면에서 선택한 업무유형에 속한 담당자 할당 현황 목록을 조회 합니다.

상세 설명

  • 당일 기준 담당자 할당 현황을 조회 합니다.

  • 할당중지 상태인 상담사 정보도 조회 합니다.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
subAutoDivGbCdstringOptional

업무유형별 담당자 자동배분구분코드

Example: 50
subAutoDivDtlNostringOptional

업무유형별 담당자 자동배분상세번호

Example: 10020
userIdstringOptional

담당자ID

Example: zyoonforCX44
Responses
200

성공

*/*
totalCountinteger · int32Optional
get/v2/customerservice/csAllocationMgmt/csAllocationDetailMgmtList
GET /api/bo/v2/customerservice/csAllocationMgmt/csAllocationDetailMgmtList HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "totalCount": 1,
  "payloads": [
    {
      "state": "text",
      "autoDivNo": "text",
      "autoDivGbCd": "text",
      "autoDivGbNm": "text",
      "autoDivDtlNo": "text",
      "autoDivDtlNm": "text",
      "numOfAssignments": "text",
      "numOfUnassignments": "text",
      "receipt": "text",
      "inProgress": "text",
      "complete": "text",
      "already": "text",
      "numOfPeopleHandling": "text",
      "numOfAllotableCases": "text",
      "acptmnId": "text",
      "aempNm": "text"
    }
  ]
}

자동배분 설정 담당자 중복 확인

get

API 설명

  • 자동배분 설정 이전 담당자 중복 여부를 확인 한다.

상세 설명

  • 등록하려는 상담원이 선택한 업무유형 담당자로 등록되어 있는지 중복 여부를 확인 한다.

  • 존재하면 true, 존재하지 않으면 false 를 응답 한다.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
aempIdstringOptional

담당자ID

Example: zyoonforCX3
autoDivGbCdstringOptional

자동배분구분코드(CS023)

Example: 20
autoDivDtlNostringOptional

자동배분상세번호

Example: 10880
deptCdstringOptional

부서코드

Example: 10141
Responses
200

성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadbooleanOptional

payload

errorbooleanOptional

is error

get/v2/customerservice/csAllocationMgmt/checkValidateManager
GET /api/bo/v2/customerservice/csAllocationMgmt/checkValidateManager HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": true,
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

고객센터 팀장 여부 조회

get

API 설명

  • 고객센터 팀장 여부를 조회합니다.

상세 설명

  • 고객센터 부서별 배분 목록에 노출되지 않으면서 부서별 상담사 목록에 노출된 회원은 팀장(리더)으로 간주합니다.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Responses
200

성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

get/v2/customerservice/csAllocationMgmt/checkLeader
GET /api/bo/v2/customerservice/csAllocationMgmt/checkLeader HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": {
    "isLeader": true
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}
이전고객서비스 공지사항
다음상담유형관리

마지막 업데이트