グリーティングの事前構築済みコンポーネントは、発信者の電話番号(ANI)を取得します(利用可能な場合)。システムが電話番号を取得すると、コンポーネントは、電話番号を使用してソフト認証を行い、登録済みの電話番号に対して検証を行います。エージェントは、アカウント情報に基づいてパーソナライズされたメッセージでユーザーに挨拶します。
制限事項
一般的な事前構築済みコンポーネントの制限に加えて、この事前構築済みコンポーネントには次の制限があります。
- このコンポーネントは、電話番号が顧客管理(CRM)システムやその他のサービスで維持されていることを前提としています。
- 既存のお客様が別の電話番号を使用して問い合わせた場合、このコンポーネントでは認証されません。
サンプル ダイアログ
次のサンプル ダイアログは、この事前構築されたコンポーネントが処理する一般的なシナリオを示しています。これらは、テレフォニーがコンポーネントを開始したときに何が起こるかを示しています。これにより、Default Welcome Intent と会話開始時の最初のエージェント レスポンスがトリガーされます。
認証済みユーザー
ユーザーは通話番号に基づいて識別され、パーソナライズされた応答メッセージを受け取ります。
| ユーザー入力 | エージェントの応答 |
|---|---|
| [発信者のファースト ネーム] 様。[会社名] にお問い合わせいただきありがとうございます。お客様の財務面の健全性に全力で取り組んでいます。ご用件をお聞かせください。 |
特定できないユーザー
システムは発信者の番号を識別せず、標準の応答メッセージでユーザーに応答します。
| ユーザー入力 | エージェントの応答 |
|---|---|
| [会社名] にお問い合わせいただきありがとうございます。お客様の財務面の健全性に全力で取り組んでいます。ご用件をお聞かせください。 |
命名規則
この事前構築済みコンポーネントでは、次の命名規則が使用されています。
| 機能 | 形式 | 例 |
|---|---|---|
| フロー | [コンポーネント名] | 挨拶 |
| パラメータ | [param_name] | ani_auth |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_greeting:get_account_details |
入力パラメータ
入力パラメータは、コンポーネントの特定の動作を構成します。フロー内の 1 つ以上の条件がこれらのパラメータを使用して、コンポーネントの動作を決定します。後述するように、コンポーネントのスタートページでフロースコープのパラメータを設定する必要があります。セッション スコープのパラメータは、呼び出しフローまたはこのコンポーネントのスタートページで設定できます。
この事前構築済みコンポーネントは、次の入力パラメータを受け入れます。
| パラメータ名 | 説明 | 入力形式 |
|---|---|---|
| $flow.company_name | グリーティングのプロンプトで動的に使用される会社の名前を取得します。 | 文字列 |
このコンポーネントの入力パラメータを構成するには、開いて手順を確認します。
- Dialogflow CX コンソールを開きます。
- ご自身の Google Cloud プロジェクトを選択します。
- エージェントを選択します。
- [Build] タブを選択します。
- [Flows] セクションでインポートされたコンポーネントをクリックします。
- [Pages] セクションで [Start Page] をクリックします。
- スタートページで true ルートをクリックします。
- [Route] ウィンドウで、必要に応じて [Parameter Presets] 値を編集します。
- [Save] をクリックします。
出力パラメータ
出力パラメータは、コンポーネントを終了した後もアクティブな状態を継続するセッション パラメータです。これらのパラメータには、コンポーネントが収集する重要な情報が含まれます。
| パラメータ名 | 説明 | 出力形式 |
|---|---|---|
| ani_auth | ANI ベースの認証の結果をキャプチャします。デフォルトでは、値は false です。 |
ブール値 |
| auth_level | 発信者の認証レベルを示します。デフォルトでは、値は null です。-1 は、お客様が ANI で認証されなかったことを示します。0 は、ANI 認証が成功したことを示します。 |
integer |
基本設定
この事前構築済みコンポーネントを設定するには:
- 事前構築済みコンポーネントをインポートします。
- 付属の柔軟な Webhook を外部サービスで構成します。Webhook の設定をご覧ください。
Webhook の設定
このコンポーネントを使用するには、付属の柔軟な Webhook を構成して外部サービスから必要な情報を取得します。
アカウントの詳細を取得
コンポーネントは、prebuilt_components_greeting:get_account_details Webhook を使用して、ANI を使用して発信者を識別します。構成された外部サービスに発信者の電話番号が存在する場合、コンポーネントはエクスペリエンスをカスタマイズするための関連情報(発信者の名前やメールなど)を取得します。
API リクエスト パラメータ
コンポーネントは、API リクエストへの入力として次のパラメータを提供します。
| パラメータ名 | 説明 | 出力形式 |
|---|---|---|
| phone_number | 発信者の電話番号(ANI)。 | integer |
API レスポンス パラメータ
コンポーネントは、API レスポンスから次のパラメータを取得します。
| パラメータ名 | 説明 | 出力形式 |
|---|---|---|
| user_first_name | ユーザーの名。パーソナライズされた挨拶に使用されます。 | 文字列 |
| user_email | ユーザーのメールアドレス。 | 文字列 |
このコンポーネントの Get Account Details Webhook を構成するには、開いて手順を確認してください。
- Dialogflow CX コンソールを開きます。
- ご自身の Google Cloud プロジェクトを選択します。
- エージェントを選択します。
- [Manage] タブを選択します。
- [Webhooks] をクリックします。
- prebuilt_components_greeting:get_account_details Webhook を選択します。
- Dialogflow CX Webhook URL フィールドの URL を、統合するサービスのエンドポイントに置き換えます。プルダウンで適切なメソッドを選択します。
- Webhook に適したリクエスト形式になるように、リクエスト本文を確認して更新します。
- レスポンス構成を確認して更新し、Webhook のレスポンスから特定のフィールドを抽出します。パラメータ名は、コンポーネントが返されたフィールド値にアクセスするために必要であるため、変更しないでください。
- 必要に応じて [Authentication] の設定を確認し、更新します。
- [Save] をクリックします。
完了
これで、ビルド済みコンポーネントとその Webhook が設定され、テストの準備が整いました。