地址收集預先建構元件

地址收集預先建構元件會向使用者收集地址，並使用 Google Address Validation API 驗證地址。

限制

除了常見的預先建構元件限制外，這個預先建構元件還有以下限制：

• 僅支援 Address Validation API 涵蓋範圍詳細資料中所列國家/地區的地址。

其他功能

這個預先建構的元件會提供下列額外功能：

• 重複
• 等候室
• 播放

對話方塊範例

以下對話方塊範例說明這個預先建構元件處理的常見情境。以下對話方塊範例說明透過電話呼叫元件時的行為，這會在對話開始時觸發預設歡迎意圖和第一個服務專員回應。

完整的有效地址

使用者提供完整地址，地址收集元件成功驗證該地址。

含有推測元素的部分有效地址

使用者提供部分地址，服務專員猜測缺少的部分，並在使用者確認後成功驗證。

含有使用者提供元素的部分有效地址

使用者提供部分地址，代理程式會猜測缺少的部分，但使用者在說出「否」後提供自己的輸入內容，代理程式則成功接受地址。

無法辨識的輸入內容

當使用者三次提供未識別的輸入內容，元件就會退出流程。

不支援的地址

當使用者提供的地址目前不受 Address Validation API 支援時，元件就會退出流程。

地址驗證

如要瞭解地址收集元件如何驗證地址，請參閱「Address Validation API 總覽」。

地址收集元件會使用 @sys.address 系統實體擷取使用者輸入內容，並將擷取到的地址傳送至 Address Validation API，以便擷取地址元素供後續處理。

Address Validation API 會傳回下列地址元素，並由元件用於收集及驗證完整地址：

• administrative_area_level_1
• archipelago
• country
• locality
• postal_code
• route
• street_number

您可以使用支援地區的任何地址，試用 Google 地址驗證示範。

命名慣例

這個預先建構的元件採用下列命名慣例：

輸入參數

輸入參數是用來設定元件特定行為的參數。參數會由工作流程中的一或多個條件使用，用於決定元件的行為方式。流程範圍參數必須在元件的起始頁面中設定，如下所述。您可以透過呼叫流程或此元件的起始頁面，設定會話範圍參數。

您可以修改流程的起始頁面中的參數預設值，設定這個元件需要的地址元素。

這個預先建構的元件可接受下列輸入參數：

輸出參數

輸出參數是會在退出元件後仍保持啟用的會話參數。這些參數包含元件收集的重要資訊。這個預先建構的元件會為下列輸出參數提供值：

{
  "admin-area": string,
  "city": string,
  "country": string,
  "island": string,
  "route": string,
  "zip-code": string,
  "street-number": string
}

string

基本設定

如要設定這個預先建構的元件，請按照下列步驟操作：

1. 匯入預先建構的元件。
2. 啟用 Address Validation API。
3. 使用 Maps API 金鑰設定提供的彈性 Webhook，請參閱下方的 Webhook 設定。

設定 Webhook

如要使用 Address Validation API 驗證地址，您必須使用正確的憑證設定提供的彈性 webhook。

地址驗證 webhook

這個 webhook 會執行下列動作：

1. 處理擷取的 Conversational Agents (Dialogflow CX) 參數、表單要求，並使用 Address Validation API 驗證地址。
2. 從 Google Address Validation API 回應中擷取已確認、未確認、缺少和推斷的地址元素。

如要為此元件設定 webhook，您必須使用 Maps API 金鑰更新 webhook 設定。

1. 如要擷取 API 金鑰，請依序前往 Google Cloud Platform 主控台 >「API 和服務」>「憑證」，選取 Maps API 金鑰，然後複製「API 金鑰」欄位。

如要設定 Webhook，請按照下列步驟操作：

1. 開啟 Dialogflow CX 控制台。
2. 選擇 Google Cloud 專案。
3. 選取代理程式。
4. 選取「管理」分頁標籤。
5. 按一下「Webhook」。
6. 選取 prebuilt_components_address_collection:address_validation webhook。
7. 將「Conversational Agents (Dialogflow CX)」Webhook URL 欄位的網址，替換為含有 Google Maps API 金鑰的網址：https://addressvalidation.googleapis.com/v1:validateAddress?key=MAPS_API_KEY
8. 在「Authentication」設定中，將「Username」設為 key，並將「Password」設為 Maps API 金鑰。
9. 按一下 [儲存]。

完成

代理程式和 Webhook 應已設定完成，可以開始測試。