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

# 하위 워크스페이스

> 상위 워크스페이스 아래에 하위 워크스페이스를 두어 팀과 번호는 나누고 청구는 모으는 방법을 안내합니다.

하위 워크스페이스는 상위 워크스페이스 아래에 두는 별도 워크스페이스입니다.
고객사별, 부서별, 브랜드별로 워크스페이스를 나누되 요금은 상위 워크스페이스 한 곳으로 모으고 싶을 때 사용합니다.

<Note>
  하위 워크스페이스는 상위 워크스페이스 바로 아래 한 단계까지만 만들 수 있습니다.
  하위 워크스페이스가 또 다른 하위 워크스페이스를 만들 수는 없습니다.
</Note>

## 언제 사용하나요

| 상황         | 예시                                 |
| ---------- | ---------------------------------- |
| 대행사·리셀러 운영 | 고객사마다 워크스페이스를 분리하되 요금은 한 곳에서 정산할 때 |
| 부서·브랜드 분리  | 한 회사가 팀이나 브랜드별로 에이전트와 번호를 나눠 운영할 때 |

## 상위 워크스페이스와 하위 워크스페이스

하위 워크스페이스는 멤버, 전화번호, 에이전트, 인증을 상위 워크스페이스와 따로 관리합니다.
다른 점은 **청구**와 **생성 권한**입니다.

| 영역           | 상위 워크스페이스     | 하위 워크스페이스        |
| ------------ | ------------- | ---------------- |
| 청구           | 자체 구독 플랜으로 결제 | 상위 워크스페이스에 합산    |
| 멤버와 역할       | 독립 관리         | 독립 관리            |
| 전화번호와 에이전트   | 독립 관리         | 독립 관리            |
| 워크스페이스 인증    | 직접 신청         | 상위 워크스페이스가 대신 신청 |
| 하위 워크스페이스 생성 | 가능            | 불가               |

## 청구와 구독

하위 워크스페이스는 무엇보다 청구를 상위 워크스페이스로 모으는 데 쓰입니다.

* 하위 워크스페이스는 별도 구독 플랜이나 결제 수단을 두지 않습니다. 사용 요금은 상위 워크스페이스의 구독 플랜을 따르고 청구서도 상위 워크스페이스에 합산됩니다.
* 하위 워크스페이스의 구독 플랜을 조회하면 상위 워크스페이스의 구독 플랜이 표시됩니다.
* 청구서 안내 이메일을 하위 워크스페이스에 따로 지정하지 않으면 상위 워크스페이스 설정을 물려받습니다. (상위 워크스페이스의 수신 이메일을 먼저 쓰고 없으면 오너 이메일을 씁니다.)

<Note>
  상위 워크스페이스에서는 그룹 전체의 통화 사용량을 하위 워크스페이스별로 나눠 확인할 수 있습니다.
</Note>

## 멤버와 인증

* 하위 워크스페이스마다 멤버와 역할을 따로 관리합니다. 역할별 권한은 [워크스페이스 역할](/docs/workspace/roles)과 같습니다.
* 하위 워크스페이스의 [워크스페이스 인증](/docs/workspace/verification)은 상위 워크스페이스가 대신 신청합니다. 신청자는 본인 인증을 마친 하위 워크스페이스 멤버여야 합니다.

## API 키

하위 워크스페이스별로 API 키를 발급해 접근 범위를 나눌 수 있습니다.

* 키 전체 값은 발급할 때 **한 번만** 표시되며 다시 확인할 수 없습니다. 안전한 곳에 즉시 저장하세요.
* 키는 이름과 끝 4자리로 구분합니다.
* 하위 워크스페이스를 삭제하면 그 워크스페이스의 API 키는 모두 폐기됩니다.

## 하위 워크스페이스 삭제

하위 워크스페이스를 삭제하려면 먼저 다음을 정리해야 합니다. 하나라도 남아 있으면 삭제가 막힙니다.

* 미납 청구서
* 사용 중인 전화번호
* 활성 부가 서비스 (해지 예약된 것은 제외)

<Warning>
  삭제는 되돌릴 수 없습니다. 삭제하면 하위 워크스페이스의 API 키가 모두 폐기되고, 상위 워크스페이스에서 더 이상 운영할 수 없습니다.
</Warning>

## 관리 방법

하위 워크스페이스는 vox.ai API로 생성하고 관리합니다.
하위 워크스페이스를 만들고 조회·수정·삭제하는 일부터 멤버·인증·API 키 관리까지 모두 API에서 할 수 있습니다.

## 관련 문서

<CardGroup cols={2}>
  <Card title="워크스페이스 역할" icon="users" href="/docs/workspace/roles">
    오너, 관리자, 멤버의 권한 차이를 확인하세요.
  </Card>

  <Card title="워크스페이스 인증" icon="badge-check" href="/docs/workspace/verification">
    인증 신청 절차와 필요한 서류를 확인하세요.
  </Card>

  <Card title="워크스페이스 웹훅" icon="bell" href="/docs/operate/monitor/webhooks/organization">
    외부 시스템으로 보낼 이벤트를 설정하세요.
  </Card>

  <Card title="요금" icon="receipt" href="/docs/start/pricing">
    구독 플랜과 통화 요금을 확인하세요.
  </Card>
</CardGroup>

***

<Accordion title="연관 검색어">
  하위 워크스페이스, 상위 워크스페이스, 하위 조직, 상위 조직, 서브 조직, 워크스페이스 계층, 청구 합산, 통합 청구, 리셀러, 대행사, 멀티 워크스페이스, sub organization, parent organization, sub-org
</Accordion>