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는 두 가지 수준에서 작동합니다.
워크스페이스 엔드포인트에는 생성한 워크스페이스 ID로 설정한 xi-workspace-id 헤더가 필요합니다. 이 헤더가 없거나 다른 리셀러의 워크스페이스를 대상으로 한 요청은 거부됩니다. SDK에서는 Python의 xi_workspace_id 인수와 TypeScript의 xiWorkspaceId 필드로 이 헤더를 지정합니다.
페이지네이션
workspaces.list와 billing.list_invoices는 한 번에 한 페이지를 반환합니다. 응답의 next_cursor를 cursor로 전달해 다음 페이지를 가져오고, has_more가 false가 되면 중지하세요.
속도 제한
제한은 모든 API 키를 통틀어 리셀러별로 적용됩니다.
제한을 초과한 요청은 429를 반환합니다. 잠시 기다린 후 다시 시도하세요.
다음 단계
- 빠른 시작: 고객의 워크스페이스를 만들고 리셉셔니스트에 전화번호를 연결합니다.
- 프로비저닝 및 온보딩: 워크스페이스를 대량으로 만들고 비즈니스의 위치, 직원, 서비스 및 리셉셔니스트 설정을 추가하는 예시입니다.
- 구독 및 청구: 고객의 요금제를 변경하고 카드 청구 내역을 확인합니다.