> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryvox.co/llms.txt
> Use this file to discover all available pages before exploring further.

# 전화번호

> 전화번호를 구매하고 에이전트를 연결하세요.

전화번호를 구매하고 에이전트를 연결하면 인바운드/아웃바운드 통화를 처리할 수 있습니다.

```mermaid theme={null}
flowchart LR
    A[번호 구매] --> B[에이전트 연결]
    B --> C{용도}
    C -->|인바운드| D[수신 대기 완료]
    C -->|아웃바운드| E[발신 준비 완료]
```

대시보드의 **번호 관리** 페이지에서 번호 목록을 확인하고, 번호를 선택하면 오른쪽에 상세 설정이 나타납니다.

## 새 번호 구매

vox.ai에서 직접 번호를 구매하면 별도 통신 인프라 없이 바로 사용할 수 있습니다.

<Steps>
  <Step title="번호 관리 페이지 진입">
    대시보드 사이드바에서 **번호 관리**를 클릭하세요.
  </Step>

  <Step title="새 번호 구매 선택">
    번호 목록 상단의 **+** 버튼을 클릭하고 **새 번호 구매**를 선택하세요.

    <Note>
      번호 구매에는 다음 세 가지가 모두 완료되어 있어야 합니다. 미완료 항목이 있으면 구매 화면에서 통합 인증 다이얼로그가 먼저 표시됩니다.

      * 본인 인증 — 사용자 계정의 휴대폰 본인 인증
      * [워크스페이스 인증](/docs/workspace/verification) — 개인 또는 사업자 명의 확인
      * [결제 수단 등록](/docs/workspace/settings) — 워크스페이스 설정의 결제 메뉴에서 카드 또는 후불 정산 계정 등록
    </Note>
  </Step>

  <Step title="번호 선택">
    구매 가능한 번호 목록이 표시됩니다. 각 번호에는 통신사, SMS 가능 여부, 월정액이 표시됩니다. 원하는 번호의 **구매** 버튼을 클릭하세요.
  </Step>

  <Step title="구매 확인">
    **구매 확인**을 클릭하면 번호가 즉시 활성화됩니다.

    <Info>
      당월 요금은 남은 일수에 따라 일할 계산됩니다. 크레딧 잔액이 있으면 크레딧이 먼저 차감됩니다.
    </Info>

    <Note>
      번호를 해지하더라도 해당 월 말일까지는 정상 사용할 수 있습니다. 만료 전까지 해지를 취소할 수도 있습니다.
    </Note>
  </Step>
</Steps>

### 구매 제한

인증 유형에 따라 보유할 수 있는 번호 수가 다릅니다.
한도에 도달하면 [워크스페이스 인증](/docs/workspace/verification)에서 번호 구매 한도를 확인하고 더 높은 인증 유형으로 재인증하세요.

## 대표번호 구매

대표번호(전국대표번호, 1588 등)는 vox.ai에서 구매해 070 번호로 착신받는 상품입니다. 수신자에게 익숙한 대표번호를 노출하거나 여러 회선을 하나의 번호로 모을 때 사용합니다.

구매하려면 다음 조건을 만족해야 합니다.

* [워크스페이스 인증](/docs/workspace/verification)이 완료되어 있을 것
* 사용자 역할이 [오너 또는 관리자](/docs/workspace/roles)일 것
* 착신용으로 사용할 **활성 070 번호가 1개 이상** 있을 것

<Steps>
  <Step title="대표번호 선택">
    구매 가능한 대표번호 목록에서 번호를 선택하세요. 각 번호에는 통신사, SMS 가능 여부, 월정액이 표시됩니다.
  </Step>

  <Step title="착신 070 선택">
    대표번호로 걸려온 전화를 받을 070 번호를 선택하세요. 대표번호로 들어온 전화는 선택한 070으로 착신됩니다.
  </Step>

  <Step title="구매 신청">
    **구매 신청**을 클릭하면 접수됩니다. 신청 시점에는 요금이 청구되지 않습니다. 운영팀의 개통 승인(영업일 기준 2\~3일) 후 활성화되면서 해당 월 일할 요금으로 과금이 시작됩니다.
  </Step>
</Steps>

### 대표번호 상태

| 상태        | 설명                                                    |
| --------- | ----------------------------------------------------- |
| **개통 대기** | 구매 신청 후 개통 승인을 기다리는 중. 이 상태에서 신청을 취소하면 과금되지 않습니다      |
| **정상**    | 개통 완료되어 사용 중                                          |
| **해지 예정** | 해지를 신청해 이번 달 말 만료 예정. 월말까지 정상 사용할 수 있고 해지를 취소할 수 있습니다 |
| **만료됨**   | 해지되어 사용이 종료됨                                          |

착신 070을 지정하지 않으면 정상 상태라도 착신 번호를 설정하라는 안내가 표시됩니다. 대표번호의 통신서비스 이용증명원은 개통 후 대시보드에서 직접 발급할 수 있습니다. 자세한 방법은 [통신가입증명원](/docs/operate/deploy/phone/telecom-cert)을 참고하세요.

## 에이전트 연결

번호를 선택하면 오른쪽 상세 패널에서 에이전트를 연결할 수 있습니다.

### 인바운드 에이전트

해당 번호로 걸려오는 전화를 처리할 에이전트를 선택하세요. 에이전트를 연결하지 않으면 인바운드 통화가 연결되지 않습니다.

### 아웃바운드 에이전트

해당 번호를 발신번호로 사용할 때 기본으로 연결할 에이전트를 선택하세요. [단건 발신](/docs/operate/deploy/outbound-single) 페이지에서 이 번호를 선택하면 지정된 에이전트가 자동으로 선택됩니다.

### 버전 지정

에이전트를 선택할 때 적용할 버전을 함께 지정합니다.

| 옵션              | 동작                      |
| --------------- | ----------------------- |
| **프로덕션**        | 배포된 프로덕션 버전을 사용합니다 (권장) |
| **현재**          | 편집 중인 최신 상태를 실시간 반영합니다  |
| **v1, v2, ...** | 특정 버전을 고정합니다            |

<Tip>
  운영 환경에서는 **프로덕션**을 사용하세요. 테스트 번호에만 **현재**를 지정하면 편집 중인 에이전트를 안전하게 검증할 수 있습니다. 한 번호에서 여러 버전을 나눠 테스트해야 한다면 [A/B 테스트](/docs/operate/monitor/ab-testing)를 사용하세요.
</Tip>

## 번호 정보

번호를 선택하면 상세 패널 하단에서 번호 정보를 확인할 수 있습니다.

* **상태** — 활성, 해지 요청, 만료
* **월정액** — vox 번호의 월 사용료
* **통신사** — 번호를 제공하는 통신사
* **서비스 기간** — 시작일 \~ 종료일
* **메모** — 번호를 구분할 이름 (클릭하여 편집)

## 번호 해지 및 삭제

번호 목록에서 번호의 **메뉴(⋯)** 를 클릭하면 번호 유형에 따라 해지 또는 삭제할 수 있습니다.

| 번호 유형                   | 동작                                                                          |
| ----------------------- | --------------------------------------------------------------------------- |
| vox.ai에서 구매한 번호         | **해지**를 요청하면 해당 월 말일에 자동 만료됩니다. 만료 전까지는 정상 사용할 수 있고, **해지 취소**로 되돌릴 수 있습니다. |
| 직접 연동한 번호 또는 SIP 트렁크 번호 | **삭제**하면 즉시 목록에서 제거됩니다. 삭제 작업은 되돌릴 수 없습니다.                                  |

<Warning>
  번호를 해지하거나 삭제하면 해당 번호로 연결된 인바운드 통화가 더 이상 수신되지 않습니다. 번호에 연결된 에이전트와 캠페인을 미리 확인하세요.
</Warning>

## 전화번호 관련 설정

<CardGroup cols={2}>
  <Card title="착신전환" icon="phone-arrow-down-left" href="/docs/operate/deploy/phone/call-forwarding">
    기존 전화번호를 유지하면서 AI 에이전트로 통화를 연결하세요.
  </Card>

  <Card title="장애 시 우회연결" icon="phone-arrow-right" href="/docs/operate/deploy/phone/fallback-routing">
    장애로 전화를 받지 못할 때 지정한 번호나 SIP로 자동 전환하세요.
  </Card>

  <Card title="발신표기번호" icon="id-badge" href="/docs/operate/deploy/phone/caller-id">
    수신자에게 표시할 번호를 기존 유선번호나 대표번호로 변경하세요.
  </Card>

  <Card title="레터링" icon="font" href="/docs/operate/deploy/phone/lettering">
    수신자 화면에 전화번호 대신 업체명을 표시하세요.
  </Card>

  <Card title="통신가입증명원" icon="file-certificate" href="/docs/operate/deploy/phone/telecom-cert">
    전화번호 가입 사실을 증명하는 서류를 발급하세요.
  </Card>
</CardGroup>

## 관련 문서

* [단건 발신](/docs/operate/deploy/outbound-single) — 번호를 사용해 단건 통화 실행
* [대량 발신](/docs/operate/deploy/outbound-batch) — 번호를 사용해 캠페인 실행
* [에이전트 버전 관리](/docs/build/versioning) — 버전별 배포와 롤백
* [워크스페이스 인증](/docs/workspace/verification) — 전화번호 구매에 필요한 인증

***

<Accordion title="연관 검색어">
  전화번호, 번호 구매, 번호 관리, 번호 해지, phone number, 에이전트 연결, 070, 발신번호, 대표번호, 전국대표번호, 1588, 착신번호
</Accordion>
