에이전트 사람 전환 설정 교체

PUT

https://api.claw-ops.com/v1/accounts/:accountId/agents/:agentId/transfer

PUT

/v1/accounts/:accountId/agents/:agentId/transfer

curl -X PUT https://api.claw-ops.com/v1/accounts/AC1a2b3c4d/agents/agentId/transfer \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "enabled": true,
  "targets": [
    {
      "label": "상담팀",
      "number": "010-1234-5678"
    }
  ]
}'

{
  "enabled": true,
  "targets": [
    {
      "label": "상담팀",
      "number": "01012345678",
      "weeklySchedule": {
        "timezone": "Asia/Seoul",
        "windows": [
          {
            "day": 0,
            "start": "13:00",
            "end": "18:00"
          }
        ],
        "excludedDates": [
          "2026-12-25"
        ]
      }
    }
  ],
  "callerId": "account",
  "whisper": {
    "enabled": true,
    "template": "{발신번호} 고객님, {사유} 문의입니다"
  },
  "timeout": 30,
  "holdMedia": "moh",
  "onFailure": {
    "enabled": true,
    "message": "지금은 상담원 연결이 어렵습니다."
  },
  "activeFrom": "2024-01-15T09:30:00Z",
  "activeUntil": "2024-01-15T09:30:00Z"
}

전환 설정 전체를 교체합니다. 보내지 않은 항목은 기본값으로 돌아가므로 조회 응답을 고쳐서 보내세요. 통화가 나갈 번호가 바뀌는 설정입니다. 변경은 다음 통화부터 적용됩니다. 발신번호 범위를 지정한 API 키로는 호출할 수 없습니다.

Authentication

AuthorizationBearer

API Key를 Bearer 토큰으로 전달

Path parameters

accountIdstringRequired

계정 ID

agentIdstringRequired

에이전트 ID

Request

This endpoint expects an object.

enabledbooleanRequired

사람 전환 사용 여부. 끄면 번호 형식과 안내 문구 내용은 검사하지 않습니다.

targetslist of objectsRequired

callerIdenumOptional

담당자 단말에 표시할 번호. 생략하면 account 입니다.

Allowed values:

whisperobjectOptional

timeoutintegerOptional10-60

담당자 응답 대기 시간(초). 생략하면 30입니다.

holdMediaenumOptional

대기 중 발신자에게 들리는 소리. 생략하면 moh 입니다.

Allowed values:

onFailureobjectOptional

activeFromdatetime or nullOptional

전환 허용 시작 시각. 오프셋을 포함해 2026-11-04T09:00:00+09:00 형식으로 보내고 activeUntil 과 함께 지정합니다.

activeUntildatetime or nullOptional

Response

저장된 전환 설정

enabledboolean

사람 전환 사용 여부

targetslist of objects

callerIdenum

담당자 단말에 표시할 번호. account 는 계정 번호, original 은 걸려 온 전화의 발신자 번호입니다.

Allowed values:

whisperobject

담당자가 받은 직후 담당자에게만 들려주는 안내

timeoutinteger

담당자 응답 대기 시간(초)

holdMediaenum

대기 중 발신자에게 들리는 소리

Allowed values:

onFailureobject

연결되지 않았을 때 발신자에게 들려주는 안내

activeFromdatetime or null

전환 허용 시작 시각. activeUntil 과 함께 지정합니다.

activeUntildatetime or null

전환 허용 종료 시각

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error