這個預先建構的元件會擷取及驗證國家/地區代碼和電話號碼。
限制
除了常見的預先建構元件限制外，這個預先建構元件還有以下限制：
- 系統不接受超過 16 位數的電話號碼。
建議的代理程式設定
啟用 DTMF，讓使用者可透過電話鍵盤輸入數值。
其他功能
這個預先建構的元件會提供下列額外功能：
對話方塊範例
以下對話方塊範例說明這個預先建構元件處理的常見情境。以下對話方塊範例說明透過電話呼叫元件時的行為，這會在對話開始時觸發預設歡迎意圖和第一個服務專員回應。
兩次回合中提供有效的電話號碼
使用者先提供國家/地區代碼，然後再提供電話號碼；服務專員成功驗證並接受。
| 使用者輸入內容 | 服務專員回應 |
|---|---|
| 你的國家/地區名稱或代碼為何？ | |
| +1 | |
| 我知道了，你的國家/地區代碼是加上 1。請說出你的電話號碼。 | |
| 6502530000 | |
| 好的，你提到的號碼是 +1 6502530000，對嗎？ | |
| 是的，沒錯 | |
| 很好，我已經收集到電話號碼。 |
單向行程中的有效電話號碼
使用者同時提供國家/地區代碼和電話號碼，服務專員成功驗證並接受。
| 使用者輸入內容 | 服務專員回應 |
|---|---|
| 你的國家/地區名稱或代碼為何？ | |
| +1 6502530000 | |
| 好的，你提到的號碼是 +1 6502530000，對嗎？ | |
| 是的，沒錯 | |
| 很好，我已經收集到電話號碼。 |
電話號碼無效
使用者在一個回合中提供國家/地區代碼和電話號碼；服務專員檢查後發現，提供的電話號碼長度正確 (不超過 16 位數)，但不是有效的電話號碼。然後服務專員會再次提示使用者提供電話號碼。
| 使用者輸入內容 | 服務專員回應 |
|---|---|
| 你的國家/地區名稱或代碼為何？ | |
| +1 6502530001 | |
| 很抱歉，系統無法辨識這個電話號碼。我收集到的國家/地區代碼是加上 1。請提供有效的電話號碼。 | |
| 6502530000 | |
| 好的，你提到的號碼是 +1 6502530000，對嗎？ | |
| 是的，沒錯 | |
| 很好，我已經收集到電話號碼。 |
國家/地區代碼和電話號碼無效
使用者在一個回合中提供國家/地區代碼和電話號碼；服務專員檢查後發現提供的國家/地區代碼和電話號碼無效。接著，服務專員會再次提示使用者提供國家/地區代碼和電話號碼。
| 使用者輸入內容 | 服務專員回應 |
|---|---|
| 你的國家/地區名稱或代碼為何？ | |
| +0080000000000 | |
| 很抱歉，提供的國家/地區代碼或電話號碼似乎無效。讓我們重新開始。請說出國家/地區名稱或代碼。 | |
| 1 | |
| 我知道了，你的國家/地區代碼是加上 1 號碼。你的電話號碼是？ | |
| 6502530000 | |
| 好的，你提到的號碼是 +1 6502530000，對嗎？ | |
| 是的，沒錯 | |
| 很好，我已經收集到電話號碼。 |
無法辨識的輸入內容
當使用者三次提供未識別的輸入內容，元件就會退出流程。
| 使用者輸入內容 | 服務專員回應 |
|---|---|
| 你的國家/地區名稱或代碼為何？ | |
| 沒關係 | |
| 抱歉，我沒聽清楚。請再說一次或輸入國家/地區代碼。 | |
| 不錯 | |
| 嗯，我還是沒聽清楚。請確認你說的是國家/地區代碼。如果我聽不清楚，你也可以使用數字鍵盤輸入國家/地區代碼。 | |
| good | |
| 抱歉，我不懂你的意思。 |
電話號碼驗證
電話號碼預先建構元件會使用 IS_PHONE_NUMBER 系統函式，驗證電話號碼是否符合有效的模式。
命名慣例
這個預先建構的元件採用下列命名慣例：
| 功能 | 格式 | 範例 |
|---|---|---|
| 心流狀態 | [元件名稱] | 電話號碼收集 |
| 元件專屬意圖 | 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 | 這個參數會傳回元件擷取的國家/地區代碼 | 字串 |
基本設定
如要設定這個預先建構的元件，請按照下列步驟操作：
完成
您的服務專員現在應已設定完成，可以開始測試。