번호 설정 수정
번호 설정 수정
Authentication
API Key를 Bearer 토큰으로 전달
Path parameters
계정 ID
수정할 전화번호
Request
routingType=‘webhook’에서 수신 전화를 처리할 VoiceML Webhook URL
routingType=‘agent’에서 Managed Agent 시작 직전에 통화별 CallContext를 조회할 동기 endpoint. 응답은 {“CallContext”:{“Instruction”:”…”,“Variables”:{…}}} 형식이며, 조회 실패 시 저장된 Agent 설정만으로 통화를 계속합니다.
Webhook 호출 HTTP 메서드
routingType=‘sip’ 일 때 라우팅할 SipEndpoint id. 같은 계정 소유 + status=active + 활성 라우트 1개 이상이어야 함.
routingType=‘softphone’ 일 때 착신할 등록 SIP credential(단말) id. 같은 계정 소유 + status=active + enabled 여야 하며, ephemeral(세션) credential 은 사용 불가.
routingType=‘forward’ 일 때 내부 착신전환할 대상 번호(같은 계정 보유 번호). 한국 번호 정규화 후 저장.
routingType=‘callflow’ 일 때 인입을 처리할 콜 플로우 id. 같은 계정 소유여야 합니다. id 는 GET /v1/accounts/{accountId}/call-flows 로 조회합니다.
routingType=‘agent’ 일 때 인입을 처리할 매니지드 에이전트 id. 같은 계정 소유여야 합니다. id 는 GET /v1/accounts/{accountId}/agents 로 조회합니다.
Inbound webhook 호출 시 추가될 HTTP 헤더. 키는 “X-” prefix 필수 (case-insensitive), reserved 헤더(X-Signature, X-Forwarded-*, X-Real-IP) 거절. 최대 10 entries, key ≤ 64 bytes, value ≤ 2048 bytes, ASCII printable. null 전송 시 헤더 제거, 미포함 시 변경 없음.
수신(inbound) 통화 상태 webhook URL. 빈 문자열/null 전송 시 해제.
구독할 상태 이벤트(공백 구분, 선택). 미지정 시 initiated ringing answered completed 가 적용됩니다. transfer(호전환 진행 상황)는 기본에 포함되지 않으므로 받으려면 직접 나열하세요. 전체 목록은 Status Callback.
받아쓰기 사전 부착. 같은 계정 소유 사전 id 를 지정하면 이 번호로 걸려온 통화 전사에 해당 사전을 대체 적용(병합 아님). null 전송 시 부착 해제(계정 기본 사전 폴백). 미포함 시 변경 없음.
Response
수정 성공
전화번호
번호 출처 (pool 등)
routingType=‘agent’에서 Managed Agent 시작 전에 통화별 CallContext를 조회하는 동기 endpoint.
Agent 미연결/거부 시 fallback 라우팅. ‘webhook’ = webhookUrl 호출, ‘sip’ = sipEndpointId 의 OriginationRoute 로 외부 PBX 다이얼, ‘softphone’ = sipCredentialId 의 등록 단말로 착신(Kamailio usrloc fork), ‘forward’ = forwardTo(보유 번호)로 내부 착신전환, ‘callflow’ = callFlowId 의 콜 플로우(결정적 ARS)가 인입을 받음, ‘agent’ = agentId 의 매니지드 에이전트가 받음.
routingType=‘sip’ 일 때 사용할 SipEndpoint id. 그 외 라우팅에서는 null.
routingType=‘softphone’ 일 때 착신할 등록 SIP credential(단말) id. 그 외 라우팅에서는 null.
routingType=‘forward’ 일 때 내부 착신전환 대상 번호(같은 계정 보유 번호). 그 외 라우팅에서는 null.
routingType=‘callflow’ 일 때 인입을 처리할 콜 플로우 id. 그 외 라우팅에서는 null.
routingType=‘agent’ 일 때 인입을 처리할 매니지드 에이전트 id. 그 외 라우팅에서는 null.
Inbound webhook 호출 시 추가될 HTTP 헤더. 키는 “X-” prefix 필수 (case-insensitive), reserved 헤더(X-Signature, X-Forwarded-*, X-Real-IP) 거절. 최대 10 entries, key ≤ 64 bytes, value ≤ 2048 bytes, ASCII printable. null 전송 시 헤더 제거, 미포함 시 변경 없음.
수신(inbound) 통화 상태 webhook URL. 발신은 통화 생성 시 statusCallback 으로 별도 관리.
구독할 상태 이벤트(공백 구분). 미지정 시 기본 전체.
번호 유형. did = 일반 번호, representative = 대표번호.
부착된 받아쓰기 사전 id. null 이면 이 번호로 걸려온 통화 전사에 계정 기본 사전을 사용.