> ## 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.

# 차단 번호

> 수신·발신을 차단할 전화번호를 워크스페이스 단위로 관리하세요.

차단 번호는 워크스페이스에서 차단할 전화번호 목록입니다. 등록한 번호는 적용 범위와 차단 방향에 따라 자동으로 인입·발신이 차단됩니다. 수신 거부 요청을 받은 번호, 마케팅 발신 제외 대상 등을 한 곳에서 관리하세요.

## 페이지 위치

대시보드 **설정** → **차단 번호**에서 워크스페이스의 차단 번호 목록을 확인하고 관리할 수 있습니다.

## 차단 정책 구성

차단 번호 한 건은 다음 항목으로 구성됩니다.

| 항목        | 설명                                                              |
| --------- | --------------------------------------------------------------- |
| **번호**    | 차단할 전화번호. `010-1234-5678`, `+82 10-1234-5678` 등 표기는 자동으로 정규화됩니다 |
| **적용 범위** | `전체`(워크스페이스의 모든 번호선) 또는 `특정`(선택한 번호선에서만 차단)                     |
| **차단 방향** | `수신`(고객 → 우리 번호), `발신`(우리 → 고객 번호), `수신/발신`(양쪽 모두)              |
| **메모**    | 차단 사유나 메모를 자유롭게 입력 (선택)                                         |
| **활성 여부** | 비활성으로 두면 목록에는 남지만 차단 판정에는 적용되지 않습니다                             |

<Note>
  **수신**은 고객이 우리 번호로 거는 통화, **발신**은 우리가 고객 번호로 거는 통화입니다.
</Note>

## 단건 등록

<Steps>
  <Step title="추가 다이얼로그 열기">
    설정 → 차단 번호 페이지의 **추가** 버튼을 클릭하세요.
  </Step>

  <Step title="차단할 번호 입력">
    한 번에 여러 번호를 등록할 수 있습니다. 입력란마다 번호 하나씩 입력하세요.
  </Step>

  <Step title="적용 범위 선택">
    * **전체** — 워크스페이스에 등록된 모든 번호선에 적용됩니다.
    * **특정** — 선택한 번호선으로 걸려오거나 나가는 통화에만 적용됩니다. 적용할 번호선을 하나 이상 선택해야 합니다.
  </Step>

  <Step title="차단 방향 선택">
    `수신`, `발신`, `수신/발신` 중 하나를 선택합니다. 기본값은 `수신/발신`입니다.
  </Step>

  <Step title="(선택) 메모 입력">
    차단 사유를 짧게 적어 두면 나중에 정책을 정리할 때 편리합니다. 예: `수신 거부 요청`, `마케팅 발신 제외`
  </Step>
</Steps>

저장하면 즉시 목록에 반영됩니다.

## 일괄 등록

CSV·Excel 파일로 한 번에 여러 번호를 등록할 수 있습니다.

<Steps>
  <Step title="업로드 파일 준비">
    | 칼럼       | 설명                                                             |
    | -------- | -------------------------------------------------------------- |
    | `전화번호`   | 필수. 차단할 전화번호                                                   |
    | `차단 방향`  | `수신`, `발신`, `수신/발신` 중 하나. 비워두면 `수신/발신`으로 처리됩니다                 |
    | `적용 범위`  | `전체` 또는 `특정`. 비워두면 `전체`로 처리됩니다                                 |
    | `적용 번호선` | `적용 범위`가 `특정`일 때 필수. 번호선 ID 또는 전화번호를 `;`, `,`, 줄바꿈으로 구분해 입력합니다 |
    | `상태`     | `활성` 또는 `비활성`. 비워두면 `활성`으로 처리됩니다                               |
    | `메모`     | 선택. 사유 또는 메모                                                   |

    한 행이 한 건의 차단 번호로 등록됩니다. 업로드 다이얼로그의 템플릿 파일도 같은
    6개 칼럼을 사용합니다.
  </Step>

  <Step title="업로드 다이얼로그 열기">
    페이지 상단의 **업로드** 버튼을 클릭하세요.
  </Step>

  <Step title="행별 정책 확인">
    적용 범위, 차단 방향, 활성 상태는 파일의 각 행에 적은 값으로 등록됩니다.
    `특정` 범위를 사용하려면 해당 행의 `적용 번호선` 값이
    워크스페이스의 번호선과 일치해야 합니다.
  </Step>

  <Step title="(선택) 덮어쓰기 활성화">
    덮어쓰기를 켜면 업로드 파일을 기준으로 기존 차단 번호 목록이 교체됩니다. 기본값(꺼짐) 상태로 업로드하면 기존 목록 위에 새 번호가 추가됩니다.
  </Step>

  <Step title="업로드">
    업로드가 끝나면 결과 요약(생성·스킵·이미 존재·병합·유효하지 않음)이 토스트로 표시됩니다.
  </Step>
</Steps>

<Warning>
  덮어쓰기는 되돌릴 수 없습니다. 기존 목록을 백업하려면 업로드 전에 다운로드해 두세요.
</Warning>

## 다운로드

페이지 상단의 **다운로드** 버튼에서 현재 목록을 CSV로 내려받을 수 있습니다. 검색·필터가 적용된 상태에서 다운로드하면 화면에 보이는 목록만 받습니다.

## 활성 / 비활성 토글

목록의 각 행에서 **활성화 / 비활성화**를 즉시 전환할 수 있습니다. 비활성으로 두면 목록에는 남지만 차단 판정에는 적용되지 않으므로, 임시로 차단을 해제하고 싶을 때 사용하세요.

## 검색과 필터

페이지 상단 검색창에 번호 또는 메모 일부를 입력하면 목록이 즉시 필터링됩니다. 결과는 페이지 단위로 끊어 표시됩니다.

## API로 관리

차단 번호 등록·일괄 등록·수정·삭제를 API로도 처리할 수 있습니다. 수신 거부 접수 시스템이나 내부 CRM과 연동할 때 사용하세요. 전체 파라미터는 [v3 API 참조](/api-reference/v3/introduction)의 **차단 번호** 그룹에서 확인하세요.

## 관련 문서

* [번호 관리](/docs/operate/deploy/phone-numbers) — 워크스페이스 번호선 관리
* [대량 발신](/docs/operate/deploy/outbound-batch) — 캠페인 단위 발신
* [SIP 트렁크](/docs/operate/deploy/sip-telephony) — 인바운드 흐름

***

<Accordion title="연관 검색어">
  차단 번호, 블랙리스트, blocked numbers, 수신 거부, 발신 차단, do-not-call, DNC, 통화 차단, 번호 블록
</Accordion>