グリーティングの事前構築済みコンポーネントは、発信者の電話番号（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 | エンドユーザーのファースト ネーム（パーソナライズされたグリーティングを提供するのに使用される）。 | 文字列 |
このコンポーネントの 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 が設定され、テストの準備が整いました。