ナビゲーションにスキップ

Reception APIクイックスタート

顧客のワークスペースを作成してプランを販売し、受付担当に電話番号を割り当てます。

このガイドでは、Reception APIを使用して、1人の顧客を最初から最後までプロビジョニングします。有料プランのワークスペース、受付担当が回答に使用する事業プロフィール、受付担当につながる電話番号を設定します。

前提条件

  • リセラー管理パネルで取得し、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への着信に応答します。

次のステップ