プロビジョニングとオンボーディング
顧客ワークスペースを作成し、受付担当に必要な情報を設定する例を紹介します。
以下の例は、クイックスタートの続きです。同じBright Smile Dentalという顧客を使用し、ワークスペースへの各呼び出しでは、そのIDをxi-workspace-idに設定します。
ワークスペースをプロビジョニングする
1回のリクエストでプロビジョニングする
事業の詳細情報がまだない場合は、1回の呼び出しでワークスペースの作成、サブスクリプションへの加入、オーナーの招待、オンボーディングの完了まで実行します。受付担当は事業名だけを基に作成されるため、その後で事業プロフィールを入力してください。タイムアウト後の再試行で2つ目のワークスペースが作成されないよう、idempotency_keyを渡します。
作成時のオンボーディングはベストエフォートで実行されます。失敗した場合、onboarding_completed_at_unixはnullになり、complete_onboardingで再試行できます。
CRMから顧客をプロビジョニングする
各idempotency_keyを独自の顧客IDから生成します。これにより、インポートを再実行しても新しいワークスペースは作成されず、作成済みのワークスペースが返されます。同じキーを異なる本文で使用すると、idempotency_key_reusedで拒否されます。
設定中のワークスペースのオンボーディングを完了する
workspaces.listを使用すると、オンボーディングが完了していないワークスペースを確認できます。complete_onboardingは安全に再試行できるため、スケジュールに沿って実行できます。
事業情報を設定する
オンボーディングを完了する前に、事業の拠点、スタッフ、サービス、休業日を追加してください。受付担当はこれらの情報を基に作成されます。オンボーディング完了後も、いつでも追加または変更できます。
オンボーディングが完了するまでは、事業オーナーがサインインしたときに表示される設定ウィザードによって、 このデータが置き換えられたり削除されたりする可能性があります。オーナーがサインインする前にオンボーディングを完了してください。
拠点を追加する
拠点ごとに営業時間を設定できます。曜日は0(月曜日)から6(日曜日)で表し、エントリがない曜日は休業日となります。
スタッフを追加する
拠点に所属するスタッフは、独自のworking_hoursを指定しない限り、その拠点の営業時間に従います。customer_facing_nameは発信者に案内される名前で、nameは内部用のラベルです。
サービスを追加する
サービスには1つ以上のvariantsがあり、それぞれに所要時間と価格を設定します。最初のものがデフォルトになります。対応可能なスタッフを限定するには、any_staff_memberをfalseに設定します。
作業内容によって価格が変わる場合は、pricing_mode="quote"を使用してintake_questionsを追加します。受付担当は質問を行い、価格を伝える代わりに見積もり依頼を受け付けます。
祝日に休業する
休業期間は、start_dateからend_dateまでの終日を対象とします。事業全体の休業にはtime_off_type="location"を使用します。特定のスタッフを休みにする場合は"staff"を使用し、そのスタッフのIDをresource_idに設定します。
ドキュメントをアップロードする
FAQや価格表など、受付担当が回答に使用するドキュメントを追加します。ウェブサイトには、クイックスタートと同様にknowledge_sources.add_urlを使用します。
受付担当を設定する
これらの呼び出しには、受付担当のIDが必要です。complete_onboardingのcustomer_facing_agent_id、またはreceptionists.listのagent_idを使用します。
あいさつ、言語、収集する情報を設定する
送信した設定だけが変更されます。
通話を転送してルールを追加する
転送ルールは、conditionを満たした場合に通話を担当者へ転送します。転送の可否はプランによって異なるため、まず受付担当のis_transfer_allowedを確認してください。ルールは受付担当の動作を指定します。strictルールには常に従い、suggestionはガイドラインとして扱います。
チームを招待する
ワークスペースの作成後は、いつでもメンバーを招待できます。保留中の招待もシートを使用するため、メンバーと招待の合計がプランのチーム人数に達すると、新しい招待は拒否されます。