> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt.

# Reception API

Reception API를 사용하면 Reception.ai 리셀러는 리셀러 관리자 패널에서 수동으로 하는 작업을 코드로 수행할 수 있습니다. 고객별 워크스페이스를 만들고, 자체 요금제를 판매하며, 리셉셔니스트를 설정하고, 카드 청구 내역을 확인할 수 있습니다. 모든 엔드포인트는 `https://api.elevenlabs.io/v1/reception` 아래에 있으며, Python 및 TypeScript SDK에서 `reception`으로 사용할 수 있습니다.

> **Note**
>
> 리셀러 관리자 패널과 Reception API는 Reception.ai 파트너에게만 제공됩니다. ElevenLabs와의 파트너십에
> 관심이 있다면 [영업팀에 문의하세요](https://www.reception.ai/contact-sales).

## 인증

리셀러 관리자 패널에서 API 키를 만드세요. 여기에서 만든 키만 Reception API를 호출할 수 있으며, 다른 ElevenLabs API 키는 `not_a_reseller_api_key`와 함께 거부됩니다. 키는 한 번만 표시되므로 시크릿 관리자에 저장하세요.

키를 `xi-api-key` 헤더로 보내거나 `ELEVENLABS_API_KEY`를 설정하여 SDK가 읽도록 하세요.

## 리셀러 및 워크스페이스 엔드포인트

API는 두 가지 수준에서 작동합니다.

| 수준     | 대상                               | SDK 그룹                                                                                                                                                |
| ------ | -------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| 리셀러    | 리셀러 계정                           | `workspaces`, `tiers`, `subscriptions`, `billing`                                                                                                     |
| 워크스페이스 | `xi-workspace-id`로 지정한 고객 워크스페이스 | `business_profile`, `receptionists`, `phone_numbers`, `services`, `staff`, `locations`, `holidays`, `products`, `assets`, `knowledge_sources`, `team` |

워크스페이스 엔드포인트에는 생성한 워크스페이스 ID로 설정한 `xi-workspace-id` 헤더가 필요합니다. 이 헤더가 없거나 다른 리셀러의 워크스페이스를 대상으로 한 요청은 거부됩니다. SDK에서는 Python의 `xi_workspace_id` 인수와 TypeScript의 `xiWorkspaceId` 필드로 이 헤더를 지정합니다.

```python
from elevenlabs import ElevenLabs

elevenlabs = ElevenLabs()

workspaces = elevenlabs.reception.workspaces.list(page_size=50)
for workspace in workspaces.workspaces:
    print(workspace.workspace_id, workspace.business_name, workspace.billing_tier)

staff = elevenlabs.reception.staff.list(
    xi_workspace_id=workspaces.workspaces[0].workspace_id,
)
```

```typescript
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const elevenlabs = new ElevenLabsClient();

const { workspaces } = await elevenlabs.reception.workspaces.list({ pageSize: 50 });
for (const workspace of workspaces) {
  console.log(workspace.workspaceId, workspace.businessName, workspace.billingTier);
}

const staff = await elevenlabs.reception.staff.list({
  xiWorkspaceId: workspaces[0].workspaceId,
});
```

```bash
elevenlabs reception workspaces list --page-size 50
```

## 페이지네이션

`workspaces.list`와 `billing.list_invoices`는 한 번에 한 페이지를 반환합니다. 응답의 `next_cursor`를 `cursor`로 전달해 다음 페이지를 가져오고, `has_more`가 `false`가 되면 중지하세요.

## 속도 제한

제한은 모든 API 키를 통틀어 리셀러별로 적용됩니다.

| 요청             | 제한      |
| -------------- | ------- |
| 읽기 (`GET`)     | 분당 600회 |
| 쓰기(그 외 모든 메서드) | 분당 120회 |

제한을 초과한 요청은 `429`를 반환합니다. 잠시 기다린 후 다시 시도하세요.

## 다음 단계

* [빠른 시작](/docs/ko/reception-ai/reception-api/quickstart): 고객의 워크스페이스를 만들고 리셉셔니스트에 전화번호를 연결합니다.
* [프로비저닝 및 온보딩](/docs/ko/reception-ai/reception-api/provisioning-and-onboarding): 워크스페이스를 대량으로 만들고 비즈니스의 위치, 직원, 서비스 및 리셉셔니스트 설정을 추가하는 예시입니다.
* [구독 및 청구](/docs/ko/reception-ai/reception-api/subscriptions-and-billing): 고객의 요금제를 변경하고 카드 청구 내역을 확인합니다.