탐색으로 건너뛰기

Reception API 빠른 시작

고객의 워크스페이스를 만들고 요금제를 판매한 뒤 리셉셔니스트에 전화번호를 연결하세요.

이 가이드에서는 Reception API를 사용해 한 고객을 처음부터 끝까지 프로비저닝합니다. 유료 요금제의 워크스페이스, 리셉셔니스트가 답변에 활용할 비즈니스 프로필, 그리고 리셉셔니스트로 연결되는 전화번호를 설정합니다.

사전 요구 사항

  • ELEVENLABS_API_KEY로 설정한 리셀러 관리자 패널의 API 키. 관리자 패널은 Reception.ai 파트너에게만 제공되며, 파트너가 되려면 영업팀에 문의하세요.
  • 리셀러 계정에 등록된 카드. 워크스페이스를 구독하면 카드로 청구됩니다.
  • Python SDK(pip install elevenlabs) 또는 TypeScript SDK(npm install @elevenlabs/elevenlabs-js).

고객 프로비저닝

1

요금제 선택

판매할 티어를 나열합니다. 가장 저렴한 순으로 표시되며, 첫 번째 티어는 체험판입니다.

from elevenlabs import ElevenLabs
elevenlabs = ElevenLabs()
tiers = elevenlabs.reception.tiers.list()
for tier in tiers:
print(tier.tier_id, tier.display_name, tier.tier_economics.monthly_price_usd)
2

워크스페이스 생성

고객의 워크스페이스를 만들고, 유료 티어를 구독시키고, 비즈니스 소유자를 초대합니다. 초대는 최선의 노력으로 처리되며, 각 초대의 결과는 member_results에 있습니다.

from elevenlabs import ProvisionResellerWorkspaceSubscription, TeamInviteRequest
workspace = elevenlabs.reception.workspaces.create(
business_name="Bright Smile Dental",
subscription=ProvisionResellerWorkspaceSubscription(
tier_id=tiers[1].tier_id,
billing_period="monthly_period",
),
members=[
TeamInviteRequest(email="owner@brightsmiledental.com", role="workspace_admin"),
],
)
workspace_id = workspace.workspace_id

subscription을 생략하면 요금제 없이 워크스페이스를 만들고 나중에 할당할 수 있습니다.

3

비즈니스 설명

리셉셔니스트는 비즈니스 프로필을 기반으로 답변합니다. 여기부터 모든 호출은 새 워크스페이스를 대상으로 하므로 xi-workspace-id 헤더를 포함합니다. operating_hours의 요일은 0(월요일)부터 6(일요일)까지이며, 항목이 없는 날은 휴무입니다.

from elevenlabs import TimeRangeModel, WorkingHours
weekday = [TimeRangeModel(start_hour=8, start_minute=0, end_hour=17, end_minute=0)]
elevenlabs.reception.business_profile.update(
xi_workspace_id=workspace_id,
business_country="US",
business_description="Family dental practice offering cleanings, fillings, crowns and teeth whitening.",
timezone="America/Los_Angeles",
operating_hours=WorkingHours(hours={str(day): weekday for day in range(5)}),
)
elevenlabs.reception.knowledge_sources.add_url(
xi_workspace_id=workspace_id,
url="https://brightsmiledental.com",
crawl_entire_site=True,
)

서비스, 직원, 위치 및 휴일도 services, staff, locations, holidays 그룹을 사용해 같은 방식으로 추가합니다.

4

온보딩 완료

온보딩을 완료하면 비즈니스 프로필을 기반으로 워크스페이스의 리셉셔니스트가 생성됩니다. 안전하게 재시도할 수 있습니다. 워크스페이스를 만들 때 complete_onboarding=True를 전달할 수도 있지만, 이 경우 리셉셔니스트는 비즈니스 이름만으로 생성됩니다.

onboarding = elevenlabs.reception.workspaces.complete_onboarding(workspace_id)
receptionist_id = onboarding.customer_facing_agent_id
5

리셉셔니스트에 전화번호 제공

미국과 캐나다에서는 요청한 지역 번호 중 하나를 가진 번호를 풀에서 가져오거나 구매합니다. 해당 번호가 없으면 비즈니스 소재 국가의 아무 번호로 대체됩니다.

assignment = elevenlabs.reception.phone_numbers.create(
xi_workspace_id=workspace_id,
customer_facing_agent_id=receptionist_id,
area_codes=["415", "628"],
)
print(assignment.phone_number)

이제 리셉셔니스트가 phone_number로 걸려 오는 전화를 받습니다.

다음 단계