Consultation Assignment Management

Bulk Register OB Tasks

post

API Description

Reads the OB bulk registration Excel file and bulk-registers it under the selected OB consultation type.

Detailed Description

The order number is not required; if provided, registration is not possible unless it is a valid order number.
Registration is not possible unless it is a valid member number.
Ordered product information is not registered when registering consultations via OB bulk registration.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

mbrNoStringOptional

Member No.

ordNoStringOptional

Order No.

accpTitleStringRequired

Inquiry Title

accpContStringOptional

Receipt Details

cnslTypNoStringOptional

Consultation Type No.

obTypNoStringOptional

OB Type Number

Body

Responses

200

Success

*/*

totalCountinteger · int32Optional

900

Business processing error details

*/*

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"
    }
  ]
}

Save Manual Assignment

post

API Description

Manually assigns the selected consultation to an agent.

Detailed Description

Manually assigns an unassigned consultation to the selected agent in the Agent Assignment Status by Task Type view.
Manual assignment is possible even when the agent has exceeded their same-day assignable quantity.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

ccnNoStringOptional

Consultation No.

ccnPrgsStatCdStringOptional

Processing Status

procmnIdStringOptional

Processor ID

Body

Responses

200

Success

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

900

Business processing error details

*/*

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"
    }
  ]
}

Save Auto-Distribution Settings (Register/Modify/Delete)

post

API Description

Saves (registers/modifies/deletes) auto-distribution setting information.

Detailed Description

Registers the selected agent as an agent able to handle a specific consultation type.
Modifies the daily assignable quantity for a registered agent.
Removes a registered agent from the auto-distribution targets.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

Responses

200

Success

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

900

Business processing error details

*/*

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

*/*

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

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

Modify Auto-Distribution Agent Assignment Progress Status

post

API Description

Modifies the assignment progress status of an agent registered in the auto-distribution settings.

Detailed Description

Changes the assignment progress status of a registered auto-distribution agent.
Assignment is stopped for an agent whose status is changed to Disabled.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

Auto-Distribution Agent Assignment Progress Status Change Request DTO

statestringOptional

Assignment Progress Status

Example: N

autoDivNoListstring[]Optional

Auto-Distribution No. List

Example: [{1000442}]

Responses

200

Success

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

900

Business processing error details

*/*

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"
    }
  ]
}

Retrieve Manual Assignment List

get

API Description

Retrieves the list of consultations available for manual assignment.

Detailed Description

Retrieves the list of unassigned consultations that the selected agent can handle.
Handleable consultations: those whose consultation type matches the selected agent's task type (major) and task type (middle).
For Product Q&A, only the task type (major) value exists.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

autoDivGbCdstringOptional

Auto-Distribution Classification Code (CS023)

Example: 50

autoDivDtlNostringOptional

Auto-Distribution Detail No.

Example: 10020

Responses

200

Success

*/*

totalCountinteger · int32Optional

900

Business processing error details

*/*

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"
    }
  ]
}

Retrieve User List by Customer Center Department

get

API Description

Retrieves the list of users belonging to the selected customer center department.

Detailed Description

Retrieves the number of users whose work status code is Active (01).

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

deptCdstringOptional

Department Code

Example: 10141

userIdstringOptional

User ID

Example: x2bee

Responses

200

Success

*/*

totalCountinteger · int32Optional

900

Business processing error details

*/*

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"
    }
  ]
}

Retrieve Department List

get

API Description

Retrieves the department codes used in the Auto-Distribution Settings popup screen in a tree structure.

Detailed Description

Retrieves department information whose task group code is Customer Center.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

Success

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

Business processing error details

*/*

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"
    }
  ]
}

Retrieve Task Type Detail No. by Auto-Distribution Code

get

API Description

Retrieves the sub-task type detail number when the task type (auto-distribution type) is changed on the Consultation Assignment Management screen.

Detailed Description

Retrieves the sub-task type detail number when the task type is changed.
For an OB consultation, the task type detail number is the OB type number.
For a 1:1 inquiry consultation, the task type detail number is the customer inquiry type code.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

autoDivGbCdStringOptional

Auto Distribution Type Code

Responses

200

Success

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

Business processing error details

*/*

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"
    }
  ]
}

Retrieve List of Agents Registered in Auto-Distribution Settings

get

API Description

Retrieves the information of agents registered as auto-distribution targets.

Detailed Description

The assignment status criteria are as follows.
Waiting: Auto-distribution status (Y), no received consultations exist
Assignment in Progress: Auto-distribution status (Y), received consultations exist
Assignment Stopped: Auto-distribution status (N)

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

deptCdstringOptional

Department Code

Example: 10141

userIdstringOptional

User ID

Example: x2bee

Responses

200

Success

*/*

totalCountinteger · int32Optional

900

Business processing error details

*/*

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"
    }
  ]
}

Retrieve Count of Agents Registered in Auto-Distribution Settings

get

API Description

Retrieves the count of agents registered as auto-distribution targets.

Detailed Description

Can be used in the customer center dashboard to process specific logic depending on whether an auto-distribution target exists.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

deptCdstringOptional

Department Code

Example: 10141

userIdstringOptional

User ID

Example: x2bee

Responses

200

Success

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadinteger · int32Optional

payload

errorbooleanOptional

is error

900

Business processing error details

*/*

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"
    }
  ]
}

Retrieve Consultation Assignment Status List

get

API Description

Retrieves the consultation assignment status list from the Consultation Assignment Management screen.

Detailed Description

Retrieves the assignment status by task type for the selected receipt date.
The same-day assignment status is not affected by the receipt date.

Revision History

Release v2.00_240613: Improved period search conditions

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

startDatestring · dateOptional

Start Date

Example: 2023-09-08

endDatestring · dateOptional

End Date

Example: 2023-09-11

dateSelectstringOptional

Date Period Selection

Example: all_day

autoDivGbCdstringOptional

Auto Distribution Type Code

Example: 50

autoDivDtlNostringOptional

Auto-Distribution Type Detail Code

Example: 50

userIdstringOptional

Person in Charge ID

Example: zyoonforCX44

Responses

200

Success

*/*

totalCountinteger · int32Optional

900

Business processing error details

*/*

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"
    }
  ]
}

Retrieve Agent Assignment Status List by Task Type

get

API Description

Retrieves the agent assignment status list belonging to the selected task type on the Consultation Assignment Management screen.

Detailed Description

Retrieves the agent assignment status as of today.
Also retrieves information for agents in Assignment Stopped status.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

subAutoDivGbCdstringOptional

Assignee Auto-Distribution Type Code by Task Type

Example: 50

subAutoDivDtlNostringOptional

Assignee Auto-Distribution Detail No. by Task Type

Example: 10020

userIdstringOptional

Person in Charge ID

Example: zyoonforCX44

Responses

200

Success

*/*

totalCountinteger · int32Optional

900

Business processing error details

*/*

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"
    }
  ]
}

Check Agent Duplication for Auto-Distribution Settings

get

API Description

Checks for agent duplication prior to auto-distribution setting.

Detailed Description

Checks whether the agent to be registered is already registered as an agent for the selected task type.
Responds with true if it exists, and false if it does not.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

aempIdstringOptional

Person in Charge ID

Example: zyoonforCX3

autoDivGbCdstringOptional

Auto-Distribution Classification Code (CS023)

Example: 20

autoDivDtlNostringOptional

Auto-Distribution Detail No.

Example: 10880

deptCdstringOptional

Department Code

Example: 10141

Responses

200

Success

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadbooleanOptional

payload

errorbooleanOptional

is error

900

Business processing error details

*/*

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"
    }
  ]
}

Retrieve Customer Center Team Leader Status

get

API Description

Retrieves the customer center team leader status.

Detailed Description

A member who is not displayed in the customer center distribution list by department but is displayed in the agent list by department is considered a team leader.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

Success

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

Business processing error details

*/*

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"
    }
  ]
}

PreviousCustomer Service Notices

NextConsultation Type Management

Last updated 2 months ago