전화번호

080 수신자부담 번호 발급

Markdown으로 보기
POST
/v1/accounts/{accountId}/toll-free-numbers

080 수신자부담 번호를 한 개 발급합니다. 번호는 재고에서 배정되며 직접 고를 수 없습니다. 받은 직후에는 받는 곳이 정해져 있지 않습니다. PUT /v1/accounts/{accountId}/numbers/{number} 로 AI 에이전트·콜 플로우·소프트폰·웹훅·SIP·내 번호로 전환 중 하나를 정하세요.

요금 번호당 월 11,000원(부가세 포함)이며, 발급받은 날부터 반납한 날까지 보유한 기간만큼 일할로 청구됩니다. 여기에 080 으로 걸려 온 통화의 착신료가 더해집니다. 전화를 건 사람은 무료이고, 착신료는 번호를 가진 계정이 냅니다. 착신료는 유선·인터넷전화에서 걸려 온 통화와 휴대폰에서 걸려 온 통화를 각각 한 달 분량으로 쌓아 구간마다 그 구간 단가를 매깁니다(부가세 포함, 원/분).

걸려 온 곳1만 분까지10만 분까지10만 분 초과
유선·인터넷전화7.336.96.2
휴대폰363431

휴대폰 여부는 발신번호로 정합니다(010·011·012·016~019). 발신번호가 없거나 표시제한이면 유선 단가입니다. 분량은 한 달 합계 초를 분으로 올림하고, 금액의 원 미만은 버립니다. 요금제에 포함된 수신 통화 분은 080 통화에 쓰이지 않고 줄지도 않습니다.

사용 조건 개인 또는 비즈니스 요금제의 활성 구독이 필요합니다(체험 요금제는 받을 수 없습니다). 계정당 받을 수 있는 개수에 상한이 있습니다.

반납 DELETE /v1/accounts/{accountId}/numbers/{number} 입니다. 반납하면 기본료 청구가 멈추고, 그 뒤 이 번호로 걸려 온 전화는 「없는 번호」로 안내됩니다. 080 번호로는 전화를 걸거나 문자를 보낼 수 없습니다.

Authorization

BearerAuth
AuthorizationBearer <token>

API Key를 Bearer 토큰으로 전달

In: header

Path Parameters

accountId*string

계정 ID

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/accounts/AC1a2b3c4d/toll-free-numbers"
{
  "number": "0801380012",
  "routingType": "webhook",
  "configured": true,
  "friendlyName": "string",
  "createdAt": "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·대표번호만 발급됩니다."
    }
  ],
  "numbers": [
    "07012345678"
  ]
}
{
  "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·대표번호만 발급됩니다."
    }
  ],
  "numbers": [
    "07012345678"
  ]
}
{
  "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·대표번호만 발급됩니다."
    }
  ],
  "numbers": [
    "07012345678"
  ]
}
{
  "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·대표번호만 발급됩니다."
    }
  ],
  "numbers": [
    "07012345678"
  ]
}