대표번호 발급
대표번호 발급
대표번호 풀에서 전화번호를 발급합니다. representative_number 부가서비스가 활성화된 계정에서만 발급할 수 있습니다.
법인 계정은 법인 인증(business_snapshot)이 완료되어 있어야 합니다.
Authentication
API Key를 Bearer 토큰으로 전달
Path parameters
계정 ID
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 이면 이 번호로 걸려온 통화 전사에 계정 기본 사전을 사용.