콘텐츠로 이동

상담원 자동 배정

Endpoint

[PUT] API URL 정보

https://patch-bnd.happytalk.io/user/api/chat-rooms/counselors/assignments/auto

https://bnd.happytalk.io/user/api/chat-rooms/counselors/assignments/auto

Request (Json)

None

Body

Field Name Type (Length) Required Description Default
token String Y 고객사 토큰
chat_room_ids String[] Y 자동 배정 대상 상담방 ID 목록

Example

REST API Sample 
curl --location --request PUT 'https://patch-bnd.happytalk.io/user/api/chat-rooms/counselors/assignments/auto' \
--header 'Content-Type: application/json' \
--data-raw '{
    "token" : "고객사 토큰",
    "chat_room_ids" : ["1234567890", "0987654321"]
}'

curl --location --request PUT 'https://bnd.happytalk.io/user/api/chat-rooms/counselors/assignments/auto' \
--header 'Content-Type: application/json' \
--data-raw '{
    "token" : "고객사 토큰",
    "chat_room_ids" : ["1234567890", "0987654321"]
}'

Response (Json)

응답 해석 안내

result는 API 호출 자체의 처리 여부를 의미하며 (인증·검증 통과 시 항상 success), 실제 상담방별 처리 결과는 data.items[]로 전달됩니다.
따라서 result: "success"이더라도 success_count: 0 / 모든 items[].result: false 인 전체 실패 케이스가 존재할 수 있으니, 클라이언트는 반드시 success_count 와 items[].result / items[].message 를 함께 확인하세요.
전체 실패의 대표 사유: 사이트 정보 없음, 운영시간 아님, 자동 배정 봇 미설정 등.

Parameter

Field Name Type Description
result String API 호출 처리 여부 (success : 정상 처리 / fail : 인증·파라미터 오류 등)
data Object 응답 데이터
success_count Int 성공 건수 (items 중 result=true 합산)
fail_count Int 실패 건수 (items 중 result=false 합산)
items Object[] 상담방별 자동 배정 처리 결과 목록
result Boolean 배정 성공 여부
chat_room_id String 상담방 ID
assigned_counselor_id Int 배정된 상담원 ID (실패 시 null)
message String 실패 사유 (성공 시 null)

Example

전체 성공 
{
    "result": "success",
    "data": {
        "success_count": 2,
        "fail_count": 0,
        "items": [
            { "result": true, "chat_room_id": "1234567890", "assigned_counselor_id": 53176, "message": null },
            { "result": true, "chat_room_id": "0987654321", "assigned_counselor_id": 53177, "message": null }
        ]
    }
}
일부 실패 
{
    "result": "success",
    "data": {
        "success_count": 1,
        "fail_count": 1,
        "items": [
            { "result": true, "chat_room_id": "1234567890", "assigned_counselor_id": 53176, "message": null },
            { "result": false, "chat_room_id": "0987654321", "assigned_counselor_id": null, "message": "배정 가능한 상담원이 없습니다" }
        ]
    }
}
전체 실패 (시스템 사유)

API 호출 자체는 정상 처리되었으나(result: "success"), 사이트 정보 누락·운영시간 외·자동 배정 봇 미설정 등 시스템 사유로 요청한 모든 상담방의 자동 배정이 실패한 케이스입니다. 클라이언트는 success_count: 0 과 items[].message 로 판별합니다.

{
    "result": "success",
    "data": {
        "success_count": 0,
        "fail_count": 2,
        "items": [
            { "result": false, "chat_room_id": "1234567890", "assigned_counselor_id": null, "message": "현재 상담 운영시간이 아닙니다" },
            { "result": false, "chat_room_id": "0987654321", "assigned_counselor_id": null, "message": "현재 상담 운영시간이 아닙니다" }
        ]
    }
}

Fail

Failure

Fail Code 정보

Data Dictionary

Data Dictionary

None

None