安排預約預先建構元件

安排預約的預先建構元件可讓新顧客和現有顧客預約。這個元件會使用自訂版本的出生日期收集預先建構元件收集預約日期，並使用電話號碼收集和郵遞區號收集預先建構元件收集使用者和預約地點的資訊。

預約原因和類型

這個元件支援多個預約原因類別，並根據使用者選取的原因提供不同類型的預約。

預約原因	可用的預約類型
貸款	面對面、虛擬、電話
抵押貸款	面對面、虛擬、電話
財富管理	面對面、虛擬、電話
信用卡	虛擬、電話
其他	手機

您可以修改 prebuilt_components_arrange_appt_reason 自訂實體，自訂預約類別。您可以修改每個預約類型的輸入參數，設定每個類別適用的預約類型。

限制

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

• 這個元件不會加密任何資料。

對話方塊範例

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

現有使用者預約現場服務

代理程式會指出使用者先前已驗證為現有使用者。使用者會提供預約原因，並選取預約面對面服務。服務專員會確認使用者想前往離註冊地址最近的分店，並確認使用者偏好的日期和時間是否可預約。服務專員確認時間和地點，並成功安排預約。

使用者輸入內容	服務專員回應
	在安排預約之前，我們會詢問幾個問題。請問你預約的原因為何？
我想與專員討論財富管理
	你想透過電話、視訊通話或親臨分店進行預約嗎？
我想親自前往
	好的，你想預約位於 1600 Amphitheatre Pkwy, Mountain View, CA 94043 的服務據點嗎？
是
	請提供您偏好的預約日期。請說出你偏好的月份，接著說出日期和年份。提醒你，我們的分店營業時間為週一至週五上午 9 點至下午 5 點，週六上午 9 點至下午 1 點。
	服務專員使用出生日期收集預先建構的元件，收集使用者偏好的預約日期
	很好，我們已收集到你偏好的日期。 請提供你偏好的時段。
上午 10 點
	你已選取上午 10:00。如要繼續使用所選的預約時間，請說「是」。
是
	我們將在 2023-09-23 上午 10:00 於銀行的地址 1600 Amphitheatre Pkwy, Mountain View, CA 94043 安排預約，是否正確？
是
	好的，我們已安排預約。你的確認編號為 818452。你想預約其他時間嗎？
不，就是這樣
	感謝你與我們聯絡。祝你有愉快的一天！

新客戶預約多個預約

代理人會判斷使用者先前是否已通過驗證，並收集使用者的電話號碼。使用者要求進行虛擬預約，以便討論貸款。使用者偏好的日期和時間無法使用，因此服務專員會向使用者提供可用的時間時段。使用者選取可用的時間時段，並成功安排預約。使用者確認想預約第二次諮詢，服務專員成功安排第二次諮詢。

使用者輸入內容	服務專員回應
	服務專員使用電話號碼收集預先建構的元件收集使用者的電話號碼
	很好，我們已收集到電話號碼。 在安排預約前，我們會請你回答幾個問題。請問你預約的原因為何？
我想申請貸款
	你想透過電話、視訊通話或親臨分店進行預約嗎？
虛擬預約即可
	請提供您偏好的預約日期。請說出你偏好的月份，接著說出日期和年份。提醒你，我們的分店營業時間為週一至週五上午 9 點至下午 5 點，週六上午 9 點至下午 1 點。
	服務專員使用出生日期收集預先建構的元件，收集使用者偏好的預約日期
	很好，我們已收集到你偏好的日期。 請提供你偏好的時段。
3:00 對我來說很方便
	您已選取下午 3 點。如要繼續進行所選預約時間，請回答「是」。
是
	我們將在 2023-10-03 下午 3 點安排與顧問的諮詢時間。對嗎？
好，我要啟用
	好的，我們已安排預約。您的確認編號為 754731。 是否要預約其他時間？
是的
	在安排預約之前，我們會詢問幾個問題。請問你預約的原因為何？
我需要預約信用卡服務
	你想與分公司代表進行電話或視訊通話嗎？
手機
	請提供您偏好的預約日期。請說出你偏好的月份，接著說出日期和年份。提醒你，我們的分店營業時間為週一至週五上午 9 點至下午 5 點，週六上午 9 點至下午 1 點。
	服務專員使用出生日期收集預先建構的元件，收集使用者偏好的預約日期
	很好，我們已收集到你偏好的日期。 請提供你偏好的時段。
早上 8 點可以嗎？
	你已選取上午 8:00。如要繼續使用所選的預約時間，請回答「是」。
是
	很抱歉，所選時段已額滿。2023 年 10 月 6 日的 11:30、12:30、01:30 和 03:00 都有空檔。你想變更時段，還是想在其他日期預約？
好，那就 1:30 吧
	您選取的時間為下午 1 點 30 分。如要繼續進行所選預約時間，請回答「是」。
是
	我們會在 2023-10-06 下午 1 點 30 分安排與顧問的諮詢時間。對嗎？
沒錯
	好的，我們已安排預約。你的確認編號為 714637。 你想預約其他時間嗎？
不，就是這樣
	感謝你與我們聯絡。祝你有愉快的一天！

命名慣例

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

功能	格式	範例
心流狀態	[元件名稱]	安排預約
元件專屬意圖	prebuilt_components_[component_name]_[intent_name]	prebuilt_components_arrange_appt_change_date_slot
實體類型	prebuilt_components_[component_name]_[entity_type]	prebuilt_components_arrange_appt_reason
Webhook	prebuilt_components_[component_name]:[webhook_action]	prebuilt_components_arrange_appointment:submit_appointment

輸入參數

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

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

參數名稱	說明	輸入格式
$session.params.phone_number	(選用) 用於驗證的客戶註冊電話號碼。	字串
$session.params.auth_level	(選用) 表示呼叫端的驗證層級。	整數
$flow.all_appointment_type	指定適用於所有預約類型的預約原因清單。預設值為 ["loans", "wealth"]。	清單 (字串)
$flow.video_phone_appointment_type	指定適用於所有預約類型的預約原因清單。預設值為 ["cards"]。	清單 (字串)
$flow.appointment_services	指定不必提供分店位置，且不會向使用者收集這類資訊的預約類型清單。預設值為 ["video", "phone"]。	清單 (字串)
$flow.working_hours	指定分店的營業時間，例如 "Monday to Friday: 9 AM to 5 PM, Saturday: 9 AM to 1 PM"。	字串
$session.params.arrange_appointment_max_days	指定允許預約預約的目前日期後天數上限。預設值為 90，表示預約日期不得超過目前日期後 90 天。這項參數會在首頁 true 路徑中設定。	整數
flow.max_retry_count	指定從使用者收集資訊時允許的重試次數。預設值為 3。	整數

輸出參數

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

參數名稱	說明	輸出格式
phone_number	使用者的當地電話號碼 (不含國家/地區代碼)，用於識別使用者。	字串
transfer_reason	如果流程未成功執行，這個參數會指出流程結束的原因。回傳的值為下列其中一個： agent：使用者在對話過程中某個時間點要求真人服務專員。 denial_of_information：使用者拒絕分享元件要求的資訊。 max_no_input：對話已達到無輸入事件的最大重試次數。請參閱無輸入內建事件。 max_no_match：對話已達到不相符事件的重試次數上限。請參閱不相符的內建事件。 webhook_error：發生 webhook 錯誤。請參閱「webhook.error 內建事件」。 webhook_not_found：無法連上 webhook 網址。請參閱 webhook.error.not-found 內建事件。	字串

基本設定

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

1. 匯入預先建構的元件。
2. 使用描述外部服務的設定，設定提供的彈性 webhook，請參閱下方的 webhook 設定。

設定 Webhook

如要使用這個元件，您必須設定隨附的彈性 webhook，才能從外部服務擷取所需資訊。

取得帳戶

如果已註冊帳戶，元件會使用 prebuilt_components_arrange_appointment:get_account webhook 取得提供的電話號碼帳戶詳細資料。

API 要求參數

元件會將下列參數提供為 API 要求的輸入內容。

參數名稱	說明	輸入格式
$session.params.phone_number	使用者的當地電話號碼 (不含國家/地區代碼)，用於識別使用者。	字串

API 回應參數

下列參數會從 API 回應中擷取，供元件使用。

參數名稱	說明	輸出格式
account_count	與註冊電話號碼相關聯的帳戶數量。	整數
cards_count	與註冊電話號碼相關聯的卡片數量。	整數
loans_count	與註冊電話號碼相關聯的貸款數量。	整數
mortgage_count	與註冊電話號碼相關聯的抵押貸款數量。	整數
branch_code	與註冊電話號碼相關聯的分店代碼，用於識別專屬的分店位置。	字串

取得分支版本

元件會使用 prebuilt_components_arrange_appointment:get_branch webhook，在指定分支代碼的情況下，擷取分支位置的相關資訊。

API 要求參數

元件會將下列參數提供為 API 要求的輸入內容。

參數名稱	說明	輸入格式
$flow.branch_code	分支機構代碼，用於識別特定分支機構位置。	字串

API 回應參數

下列參數會從 API 回應中擷取，供元件使用。

參數名稱	說明	輸出格式
branch_address	分支機構的地址。	字串

可用的分支

元件會使用 prebuilt_components_arrange_appointment:available_branch webhook，根據郵遞區號取得最近的分店位置。

API 要求參數

元件會將下列參數提供為 API 要求的輸入內容。

參數名稱	說明	輸入格式
$flow.zip_code	使用者提供的郵遞區號。	字串

API 回應參數

下列參數會從 API 回應中擷取，供元件使用。

參數名稱	說明	輸出格式
branch_address	分支機構的地址。	字串

取得可用的時段

元件會使用 prebuilt_components_arrange_appointment:get_available_slots webhook，針對使用者偏好的日期和預約類型，檢查可用的時間時段。

API 要求參數

元件會將下列參數提供為 API 要求的輸入內容。

參數名稱	說明	輸入格式
$flow.preferred_date	使用者提供的預約日期，格式為「YYYY-MM-DD」。	字串
$flow.appointment_type	預約的預約類型。	字串
$flow.branch_code	分店代碼，用於識別使用者選取的專屬分店位置。	字串

API 回應參數

下列參數會從 API 回應中擷取，供元件使用。

參數名稱	說明	輸出格式
available_slots	指定日期可預約的時間，格式為「HH:MM XM」，例如 ["09:00 AM", "2:30 PM"]。如果沒有可用的時段，這個參數就是空白清單 []。	清單 (字串)

提交預約

元件會使用 prebuilt_components_arrange_appointment:submit_appointment webhook，根據使用者選取的日期、時間、分店、預約原因和預約類型，安排預約。

API 要求參數

元件會將下列參數提供為 API 要求的輸入內容。

參數名稱	說明	輸入格式
$session.params.phone_number	使用者的當地電話號碼 (不含國家/地區代碼)，用於識別使用者。	字串
$flow.preferred_date	使用者提供的預約日期，格式為「YYYY-MM-DD」。	字串
$flow.preferred_slot	使用者提供的預約時間，格式為「HH:MM XM」。	字串
$flow.appointment_reason	預約的預約原因。	字串
$flow.appointment_type	預約的預約類型。	字串
$flow.branch_code	分店代碼，用於識別使用者選取的專屬分店位置。	字串

API 回應參數

下列參數會從 API 回應中擷取，供元件使用。

參數名稱	說明	輸出格式
request_number	預約的申請編號。	整數

完成

代理程式和相關的 webhook 應已設定完成，可以開始測試。