這個預建元件會擷取並驗證國家/地區代碼和電話號碼。
限制
除了常見的預建元件限制外，這項預建元件還有下列限制：
- 電話號碼長度不得超過 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 | [Component Name] | 收集電話號碼 |
| 元件專屬意圖 | 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 | 這個參數會傳回元件擷取的國家/地區代碼 | 字串 |
基本設定
如要設定這項預建元件，請按照下列步驟操作：
完成
代理應已設定完成，可以開始測試。