預先建構的問候語元件

問候語預建元件會擷取來電者的電話號碼 (ANI) (如有)。如果系統擷取到電話號碼,元件會使用該號碼執行軟驗證,並與已註冊的電話號碼進行比對。接著,代理會根據使用者的帳戶資訊,向使用者傳送個人化問候訊息。

限制

除了常見的預建元件限制外,這項預建元件還有下列限制:

  • 這個元件假設電話號碼是由客戶關係管理 (CRM) 系統或其他服務維護。
  • 如果現有客戶使用其他電話號碼聯絡,這個元件不會驗證其身分。

對話範例

對話範例顯示這項預建元件處理的常見情境。當使用者透過電話呼叫元件時,系統會觸發預設歡迎意圖,並在對話開始時顯示第一個代理回覆。

通過驗證的使用者

系統會根據來電號碼識別使用者,並播放個人化問候訊息。

使用者輸入內容 代理回覆
[Caller First Name],你好。感謝您與 [公司名稱]聯絡,我們致力於協助您維持良好的財務狀況。您今天需要什麼協助?

不明使用者

系統無法辨識來電者的號碼,並以標準問候訊息問候使用者。

使用者輸入內容 代理回覆
感謝您與 [公司名稱]聯絡,我們致力於協助您維持良好的財務狀況。您今天需要什麼協助?

命名慣例

這個預建元件採用下列命名慣例:

功能 格式 範例
Flow [Component Name] 問候語
參數 [param_name] ani_auth
Webhook prebuilt_components_[component_name]:[webhook_action] prebuilt_components_greeting:get_account_details

輸入參數

輸入參數會設定元件的特定行為。流程中的一或多個條件會使用這些參數,決定元件的行為。您必須按照下方說明,在元件的起始頁面設定流程範圍參數。您可以使用呼叫流程,或在這個元件的開始頁面設定以工作階段為範圍的參數。

這個預建元件接受下列輸入參數:

參數名稱 說明 輸入格式
$flow.company_name 擷取公司名稱,以便在問候語提示中動態使用。 字串

如要設定這項元件的輸入參數,請展開查看操作說明。

  1. 開啟 Dialogflow CX 控制台。
  2. 選擇 Google Cloud 雲端專案。
  3. 選取代理。
  4. 選取「Build」(建構) 分頁標籤。
  5. 在「Flows」(流程) 部分,點選匯入的元件。
  6. 按一下「Pages」部分中的「Start Page」。
  7. 在「Start Page」中,點選「true」路徑。
  8. 在「Route」視窗中,視需要編輯「Parameter Presets」值。
  9. 按一下「儲存」。

輸出參數

輸出參數是工作階段參數,在退出元件後仍會保持有效。這些參數包含元件收集的重要資訊。

參數名稱 說明 輸出格式
ani_auth 擷取 ANI 驗證結果。預設值為 false。 布林值
auth_level 指出呼叫者的驗證層級。預設值為 null。-1 表示使用者未通過 ANI 驗證。0 表示 ANI 驗證成功。 整數

基本設定

如要設定這項預建元件,請按照下列步驟操作:

  1. 匯入預先建構的元件。
  2. 使用外部服務設定提供的彈性 Webhook。詳情請參閱「Webhook 設定」一節。

Webhook 設定

如要使用這個元件,請設定內含的彈性 Webhook,從外部服務擷取必要資訊。

取得帳戶詳細資料

該元件會使用 prebuilt_components_greeting:get_account_details Webhook,根據來電號碼識別來電者。如果來電者的電話號碼存在於設定的外部服務中,元件會擷取相關資訊,提供個人化體驗,包括來電者姓名和電子郵件。

API 要求參數

元件會提供下列參數,做為 API 要求的輸入內容:

參數名稱 說明 輸出格式
phone_number 來電者的電話號碼 (ANI)。 整數

API 回應參數

元件會從 API 回應擷取下列參數:

參數名稱 說明 輸出格式
user_first_name 使用者的名字,用於提供個人化問候語。 字串
user_email 使用者的電子郵件地址。 字串

如要為這個元件設定「取得帳戶詳細資料」Webhook,請展開查看操作說明。

  1. 開啟 Dialogflow CX 控制台。
  2. 選擇 Google Cloud 雲端專案。
  3. 選取代理。
  4. 選取「管理」分頁標籤。
  5. 按一下「Webhooks」。
  6. 選取 prebuilt_components_greeting:get_account_details Webhook。
  7. 將 Dialogflow CX「Webhook URL」欄位中的 Webhook 網址,替換成要整合的服務端點。在下拉式選單中選取適當的「Method」。
  8. 查看並更新要求主體,為 Webhook 建立適當的要求格式。
  9. 查看並更新回應設定,從 Webhook 的回應中擷取特定欄位。請勿修改參數名稱,因為元件需要這些名稱才能存取傳回的欄位值。
  10. 視需要查看及更新「驗證」設定。
  11. 按一下「儲存」。

完成

預建元件和其 Webhook 已設定完成,可以開始測試。