# 050 안심번호 (/docs/safety-numbers)

## 050 안심번호란

내 실제 번호를 알리지 않고 전화를 받을 수 있게 해 주는 050 번호입니다.
050 으로 걸려 온 전화는 내가 정한 번호로 이어집니다.

개인·비즈니스 요금제에서 바로 받을 수 있습니다.
Trial 과 앱 전용 계정에서는 받을 수 없습니다.

## 요금

- 번호 1개당 월 1,000원(부가세 포함)입니다.
- 번호를 받은 날부터 반납한 날까지 보유한 일수만큼 일할로 청구됩니다.
- 050 으로 걸려 온 전화의 수신 통화료는 없습니다.
- 050 에서 내 070 으로 전환되는 구간은 070 수신 요금이 발생합니다.
- 받을 수 있는 개수에 제한은 없습니다.

## 받는 곳 정하기

받는 곳은 두 가지 방식 중 하나로 정합니다.

- **통신사 직결(`carrier_direct`)**
  통신사가 입력한 전화번호로 바로 연결합니다.
  휴대전화·지역번호·070 을 최대 3개까지 넣을 수 있습니다.
  대표번호(8자리)는 직결할 수 없습니다.
- **내 번호로 연결(`platform`)**
  우리 시스템이 먼저 받아 내 070 이나 대표번호로 전환합니다.
  AI 에이전트·콜 플로우 같은 070 의 받는 방식을 그대로 쓰고 싶을 때 고릅니다.
  전환 대상은 이 계정이 가진 번호여야 합니다.

050 번호끼리는 서로 연결할 수 없습니다.
받는 곳을 바꾸면 통신사 반영까지 보통 바로, 늦어도 5분이 걸립니다.

## 콘솔에서 쓰기

콘솔 **전화번호 › 050 안심번호**에서 번호를 받고, 목록의 번호를 눌러 받는 곳을 바꾸고, 반납합니다.
받기와 반납은 소유자만 할 수 있습니다.

## API 로 쓰기

| 하는 일 | API |
| --- | --- |
| 발급 | [050 안심번호 발급](/docs/api/numbers/createSafetyNumber) |
| 목록 | [050 안심번호 목록](/docs/api/numbers/listSafetyNumbers) |
| 조회 | [050 안심번호 조회](/docs/api/numbers/getSafetyNumber) |
| 받는 곳 변경 | [050 안심번호 착신 변경](/docs/api/numbers/updateSafetyNumberForwarding) |
| 반납 | [번호 삭제](/docs/api/numbers/deleteNumber) |

내 번호로 연결하려면 `forwardMode` 를 `platform` 으로, `forwardTo` 를 내 070 이나 대표번호로 보냅니다.

```json
{ "forwardMode": "platform", "forwardTo": "07012345678" }
```

통신사 직결은 `forwardMode` 를 `carrier_direct` 로, `forwardTargets` 에 번호를 넣습니다.

```json
{ "forwardMode": "carrier_direct", "forwardTargets": ["01012345678"] }
```

응답의 `carrierStatus` 로 통신사 반영 여부를 확인합니다.

## MCP 로 쓰기

[MCP 서버](/docs/mcp)에서 아래 도구를 씁니다.

| 도구 | 하는 일 |
| --- | --- |
| `list_safety_numbers` · `get_safety_number` | 050 번호 목록 · 상세 |
| `create_safety_number` | 050 번호 발급 |
| `update_safety_number_forwarding` | 받는 곳 변경 |
| `delete_phone_number` | 반납 |

`create_safety_number` 와 `update_safety_number_forwarding` 은 `write:phone_numbers` 권한이 필요합니다.

## 반납

[번호 삭제 API](/docs/api/numbers/deleteNumber) 나 콘솔에서 반납합니다.
반납한 날부터 청구가 멈춥니다.
반납한 번호는 통신사 해지를 확인한 뒤 쉬는 기간을 거쳐 다시 배정됩니다.
같은 번호를 다시 받을 수 있다는 보장은 없습니다.
