這個預建元件會收集五位數郵遞區號。
限制
除了常見的預建元件限制外，這項預建元件還有下列限制：
- 不接受超過五位數的郵遞區號。
- 不接受英數字元郵遞區號。
建議的代理設定
啟用 DTMF，允許使用者透過電話撥號鍵盤輸入數值。
其他功能
這項預建元件提供下列額外功能：
對話範例
下列對話範例說明這項預建元件處理的常見情境。範例對話會示範透過電話呼叫元件時的行為，這會觸發預設歡迎意圖，並在對話開始時觸發第一個代理回覆。
有效的郵遞區號
使用者提供五位數郵遞區號，服務專員成功收集。
| 使用者輸入內容 | 代理回覆 |
|---|---|
| 請說出或輸入五位數郵遞區號。 | |
| 27656 | |
| 你剛才提到的郵遞區號是 27656，對嗎？ | |
| 是 | |
| 好的，我已收集到郵遞區號。 |
重試
使用者在第二次嘗試時提供五位數郵遞區號，服務專員成功接受。
| 使用者輸入內容 | 代理回覆 |
|---|---|
| 請說出或輸入五位數郵遞區號。 | |
| 27656 | |
| 你剛才說郵遞區號是 27657，對嗎？ | |
| 否 | |
| 抱歉，我沒聽清楚。 請說出或輸入五位數郵遞區號。 |
|
| 27656 | |
| 你剛才提到的郵遞區號是 27656，對嗎？ | |
| 是 | |
| 好的，我已收集到郵遞區號。 |
郵遞區號無效
使用者提供無效的郵遞區號 (超過五位數)，服務專員重新提示，並成功收集更正後的郵遞區號。
| 使用者輸入內容 | 代理回覆 |
|---|---|
| 請說出或輸入五位數郵遞區號。 | |
| 276566 | |
| 我聽到的郵遞區號是 123456，但這不是有效的五位數郵遞區號。 請說出或輸入五位數郵遞區號。 |
|
| 27656 | |
| 你剛才提到的郵遞區號是 27656，對嗎？ | |
| 是 | |
| 好的，我已收集到郵遞區號。 |
無法辨識的輸入內容
使用者提供無法辨識的輸入內容三次後，元件就會退出流程。
| 使用者輸入內容 | 代理回覆 |
|---|---|
| 請說出或輸入五位數郵遞區號。 | |
| 沒關係 | |
| 抱歉，我聽不懂，可以請你再說一次或輸入五位數郵遞區號嗎？ | |
| 良好 | |
| 嗯，我還是聽不清楚。請確認你說的是五位數郵遞區號。你也可以使用撥號鍵盤輸入郵遞區號。 | |
| Nice | |
| 抱歉，我不懂你的意思。 |
命名慣例
這個預建元件採用下列命名慣例：
| 功能 | 格式 | 範例 |
|---|---|---|
| Flow | [Component Name] | 收集郵遞區號 |
| 元件專屬意圖 | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_zip_code_collection_collect_zip_code |
| 參數 | [param_name] | zip_code |
輸出參數
輸出參數是工作階段參數，在退出元件後仍會保持有效。這些參數包含元件收集的重要資訊。這個預建元件會提供下列輸出參數的值：
| 參數名稱 | 說明 | 輸出格式 |
|---|---|---|
| zip_code_collection_zip_code | 這個參數會傳回對話流程收集到的郵遞區號 | 字串 |
基本設定
如要設定這項預建元件，請按照下列步驟操作：
完成
代理應已設定完成，可以開始測試。