상담할당관리

OB 업무 일괄 등록

post

API 설명

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

---

상세 설명

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

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

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

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

mbrNoStringOptional

회원번호

ordNoStringOptional

주문번호

accpContStringOptional

접수내용

cnslTypNoStringOptional

상담유형번호

obTypNoStringOptional

OB유형번호

Body

application/json

Responses

200

성공

*/*

900

업무처리 오류 내용

*/*

post

/v2/customerservice/csAllocationMgmt/saveObCsCounselInfoListExcel

HTTPcURLJavaScriptPython

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

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

{
  "totalCount": 1,
  "payloads": [
    {
      "mbrNo": "text",
      "ordNo": "text",
      "accpCont": "text",
      "yn": "text",
      "failCont": "text",
      "cnslTypNo": "text",
      "obTypNo": "text"
    }
  ]
}

수동할당 저장

post

API 설명

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

---

상세 설명

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

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

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

ccnNoStringOptional

상담번호

ccnPrgsStatCdStringOptional

처리상태

procmnIdStringOptional

처리자ID

Body

application/json

Responses

200

성공

*/*

900

업무처리 오류 내용

*/*

post

/v2/customerservice/csAllocationMgmt/saveManualAssign

HTTPcURLJavaScriptPython

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-03-11T21:16:18.855Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

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

post

API 설명

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

---

상세 설명

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

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

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

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

Responses

200

성공

*/*

900

업무처리 오류 내용

*/*

post

/v2/customerservice/csAllocationMgmt/saveAutoDistributionManager

HTTPcURLJavaScriptPython

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-03-11T21:16:18.855Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

post

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

excelColumnsstringRequired

cnslTypNostringRequired

obTypNostringRequired

Body

application/json

excelFilestring · binaryRequired

Responses

200

OK

*/*

post

/v2/customerservice/csAllocationMgmt/getObCsCounselInfoListExcel

HTTPcURLJavaScriptPython

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",
      "accpCont": "주문번호 정상 케이스 문의",
      "cnslTypNo": 10020,
      "obTypNo": 10020
    }
  ]
}

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

post

API 설명

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

---

상세 설명

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

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

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

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

statestringOptional

할당진행상태

Example: N

autoDivNoListstring[]Optional

자동배분번호목록

Example: [{1000442}]

Responses

200

성공

*/*

900

업무처리 오류 내용

*/*

post

/v2/customerservice/csAllocationMgmt/changeAutoDivideAllocationPossibleYn

HTTPcURLJavaScriptPython

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-03-11T21:16:18.855Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

수동할당 목록 조회

get

API 설명

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

---

상세 설명

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

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

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

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

autoDivGbCdstringOptional

자동배분구분코드(CS023)

Example: 50

autoDivDtlNostringOptional

자동배분상세번호

Example: 10020

Responses

200

성공

*/*

900

업무처리 오류 내용

*/*

get

/v2/customerservice/csAllocationMgmt/manualAssignList

HTTPcURLJavaScriptPython

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

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

deptCdstringOptional

부서코드

Example: 10141

userIdstringOptional

사용자ID

Example: x2bee

Responses

200

성공

*/*

900

업무처리 오류 내용

*/*

get

/v2/customerservice/csAllocationMgmt/getCsDeptUserList

HTTPcURLJavaScriptPython

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

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

성공

*/*

900

업무처리 오류 내용

*/*

get

/v2/customerservice/csAllocationMgmt/getCsDeptList

HTTPcURLJavaScriptPython

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

{
  "timestamp": "2026-03-11T21:16:18.855Z",
  "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

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

autoDivGbCdStringOptional

자동배분구분코드

Responses

200

성공

*/*

900

업무처리 오류 내용

*/*

get

/v2/customerservice/csAllocationMgmt/getAutoDivideDetailNo

HTTPcURLJavaScriptPython

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

{
  "timestamp": "2026-03-11T21:16:18.855Z",
  "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

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

deptCdstringOptional

부서코드

Example: 10141

userIdstringOptional

사용자ID

Example: x2bee

Responses

200

성공

*/*

900

업무처리 오류 내용

*/*

get

/v2/customerservice/csAllocationMgmt/getAutoDistributionManagerList

HTTPcURLJavaScriptPython

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

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

deptCdstringOptional

부서코드

Example: 10141

userIdstringOptional

사용자ID

Example: x2bee

Responses

200

성공

*/*

900

업무처리 오류 내용

*/*

get

/v2/customerservice/csAllocationMgmt/getAutoDistributionManagerListCount

HTTPcURLJavaScriptPython

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

{
  "timestamp": "2026-03-11T21:16:18.855Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": 1,
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

상담할당 현황 목록 조회

get

API 설명

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

---

상세 설명

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

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

---

수정 번호

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

Authorizations

accessToken

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

성공

*/*

900

업무처리 오류 내용

*/*

get

/v2/customerservice/csAllocationMgmt/csAllocationMgmtList

HTTPcURLJavaScriptPython

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

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

subAutoDivGbCdstringOptional

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

Example: 50

subAutoDivDtlNostringOptional

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

Example: 10020

userIdstringOptional

담당자ID

Example: zyoonforCX44

Responses

200

성공

*/*

900

업무처리 오류 내용

*/*

get

/v2/customerservice/csAllocationMgmt/csAllocationDetailMgmtList

HTTPcURLJavaScriptPython

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

accessToken

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

성공

*/*

900

업무처리 오류 내용

*/*

get

/v2/customerservice/csAllocationMgmt/checkValidateManager

HTTPcURLJavaScriptPython

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

{
  "timestamp": "2026-03-11T21:16:18.855Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": true,
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

고객센터 팀장 여부 조회

get

API 설명

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

---

상세 설명

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

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

성공

*/*

900

업무처리 오류 내용

*/*

get

/v2/customerservice/csAllocationMgmt/checkLeader

HTTPcURLJavaScriptPython

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

{
  "timestamp": "2026-03-11T21:16:18.855Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": {
    "isLeader": true
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}