這個預先建構的元件會擷取並驗證國家/地區代碼和電話號碼。
限制
除了常見的預先建構元件限制外，這個預先建構元件還有下列限制：
- 電話號碼不得超過 16 位數。
建議的代理程式設定
啟用 DTMF，允許使用者透過電話鍵盤輸入數值。
其他功能
這個預先建構的元件提供下列額外功能：
對話範例
下列範例對話方塊展示了這個預先建構元件處理的常見情境。範例對話會示範透過電話呼叫元件時的行為，這會觸發預設的歡迎意圖，並在對話開始時提供第一個代理程式回應。
兩輪對話中提供有效的電話號碼
使用者先提供國家/地區代碼，然後提供電話號碼；服務專員成功驗證並接受。
| 使用者輸入內容 | 代理回覆 |
|---|---|
| 請輸入國家/地區名稱或代碼。 | |
| +1 | |
| 瞭解，你的國家/地區代碼是 +1。請說出電話號碼。 | |
| 6502530000 | |
| 好的，你提到的號碼是 +1 6502530000，對嗎？ | |
| 是的，資訊正確無誤 | |
| 很好，電話號碼已收集完畢。 |
單一回合中的有效電話號碼
使用者同時提供國家/地區代碼和電話號碼，服務專員成功驗證並接受。
| 使用者輸入內容 | 代理回覆 |
|---|---|
| 請輸入國家/地區名稱或代碼。 | |
| +1 6502530000 | |
| 好的，你提到的號碼是 +1 6502530000，對嗎？ | |
| 是的，資訊正確無誤 | |
| 很好，電話號碼已收集完畢。 |
電話號碼無效
使用者在同一回合中提供國家/地區代碼和電話號碼；服務專員檢查後發現，提供的電話號碼長度有效 (不超過 16 位數)，但不是有效的電話號碼。接著，代理程式會再次提示使用者提供電話號碼。
| 使用者輸入內容 | 代理回覆 |
|---|---|
| 請輸入國家/地區名稱或代碼。 | |
| +1 6502530001 | |
| 很抱歉，系統無法辨識這個電話號碼。我已收集國家/地區代碼 (加號和 1)。請提供有效的電話號碼。 | |
| 6502530000 | |
| 好的，你提到的號碼是 +1 6502530000，對嗎？ | |
| 是的，資訊正確無誤 | |
| 很好，電話號碼已收集完畢。 |
國家/地區代碼和電話號碼無效
使用者在同一回合中提供國家/地區代碼和電話號碼；服務專員檢查後發現提供的國家/地區代碼和電話號碼無效。然後，服務專員會再次提示使用者提供國家/地區代碼和電話號碼。
| 使用者輸入內容 | 代理回覆 |
|---|---|
| 請輸入國家/地區名稱或代碼。 | |
| +0080000000000 | |
| 抱歉，提供的國家/地區代碼或電話號碼無效。讓我們重新開始。請說出國家/地區名稱或代碼。 | |
| 1 | |
| 瞭解，你的國家/地區代碼是 +1。你的電話號碼是？ | |
| 6502530000 | |
| 好的，你提到的號碼是 +1 6502530000，對嗎？ | |
| 是的，資訊正確無誤 | |
| 很好，電話號碼已收集完畢。 |
無法辨識的輸入內容
如果使用者提供無法辨識的輸入內容三次，元件就會結束流程。
| 使用者輸入內容 | 代理回覆 |
|---|---|
| 請輸入國家/地區名稱或代碼。 | |
| 沒關係 | |
| 抱歉，我沒聽清楚。請再次說出或輸入國家/地區代碼。 | |
| nice | |
| 抱歉，我還是沒聽清楚。請確認你說出國家/地區代碼，如果我聽不清楚你說的內容，你也可以使用數字鍵盤輸入國家/地區代碼。 | |
| good | |
| 抱歉，我不太瞭解你的回覆。 |
電話號碼驗證
電話號碼預先建構元件會使用 IS_PHONE_NUMBER 系統函式，驗證電話號碼是否符合有效模式。
命名慣例
這個預先建構的元件採用下列命名慣例：
| 功能 | 格式 | 範例 |
|---|---|---|
| Flow | [元件名稱] | 收集電話號碼 |
| 元件專屬意圖 | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_telephone_number_collection_incorrect_country_code |
| 參數 | [param_name] | telephone_number |
| 實體類型 | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_telephone_no_country_code |
輸出參數
輸出參數是工作階段參數，離開元件後仍會保持有效狀態。這些參數包含元件收集的重要資訊。這個預先建構的元件會提供下列輸出參數的值：
| 參數名稱 | 說明 | 輸出格式 |
|---|---|---|
| telephone_number_collection_telephone_number | 這個參數會傳回元件擷取的電話號碼 | 字串 |
| telephone_number_collection_country_code | 這個參數會傳回元件擷取的國家/地區代碼 | 字串 |
基本設定
如要設定這個預先建構的元件，請按照下列步驟操作：
完成
代理程式現在應已設定完成，可以開始測試。