탐색으로 건너뛰기

Reception API

자체 시스템에서 고객의 Reception.ai 워크스페이스를 만들고 관리하세요.

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

리셀러 관리자 패널과 Reception API는 Reception.ai 파트너에게만 제공됩니다. ElevenLabs와의 파트너십에 관심이 있다면 영업팀에 문의하세요.

인증

리셀러 관리자 패널에서 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 필드로 이 헤더를 지정합니다.

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,
)

페이지네이션

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

속도 제한

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

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

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

다음 단계

  • 빠른 시작: 고객의 워크스페이스를 만들고 리셉셔니스트에 전화번호를 연결합니다.
  • 프로비저닝 및 온보딩: 워크스페이스를 대량으로 만들고 비즈니스의 위치, 직원, 서비스 및 리셉셔니스트 설정을 추가하는 예시입니다.
  • 구독 및 청구: 고객의 요금제를 변경하고 카드 청구 내역을 확인합니다.