AI 음성 에이전트
에이전트 사람 전환 설정 교체
전환 설정 전체를 교체합니다. 보내지 않은 항목은 기본값으로 돌아가므로 조회 응답을 고쳐서 보내세요. 통화가 나갈 번호가 바뀌는 설정입니다. 변경은 다음 통화부터 적용됩니다. 발신번호 범위를 지정한 API 키로는 호출할 수 없습니다.
Authorization
BearerAuth AuthorizationBearer <token>
API Key를 Bearer 토큰으로 전달
In: header
Path Parameters
accountId*string
계정 ID
agentId*string
에이전트 ID
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X PUT "https://example.com/v1/accounts/AC1a2b3c4d/agents/string/transfer" \ -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": "2019-08-24T14:15:22Z",
"activeUntil": "2019-08-24T14:15:22Z"
}{
"error": "string",
"code": "recipient_blocked",
"ip": "52.79.213.41",
"processedAt": "2026-10-21T04:10:34.303Z",
"blockers": [
{
"number": "07012340002",
"code": "number_not_carrier_issued",
"message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
}
]
}{
"error": "string",
"code": "recipient_blocked",
"ip": "52.79.213.41",
"processedAt": "2026-10-21T04:10:34.303Z",
"blockers": [
{
"number": "07012340002",
"code": "number_not_carrier_issued",
"message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
}
]
}{
"error": "string",
"code": "recipient_blocked",
"ip": "52.79.213.41",
"processedAt": "2026-10-21T04:10:34.303Z",
"blockers": [
{
"number": "07012340002",
"code": "number_not_carrier_issued",
"message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
}
]
}{
"error": "string",
"code": "recipient_blocked",
"ip": "52.79.213.41",
"processedAt": "2026-10-21T04:10:34.303Z",
"blockers": [
{
"number": "07012340002",
"code": "number_not_carrier_issued",
"message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
}
]
}{
"error": "string",
"code": "recipient_blocked",
"ip": "52.79.213.41",
"processedAt": "2026-10-21T04:10:34.303Z",
"blockers": [
{
"number": "07012340002",
"code": "number_not_carrier_issued",
"message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
}
]
}