本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 將 Amazon Lex 機器人新增到 Amazon Connect **重要** **支援終止通知**：2025 年 9 月 15 日， AWS 將停止對 Amazon Lex V1 的支援。2025 年 9 月 15 日之後，您將無法再存取 Amazon Lex V1 主控台或 Amazon Lex V1 資源。若要了解如何遷移至 Amazon Lex V2，請參閱[遷移機器人](https://docs.aws.amazon.com/lex/latest/dg/migrate.html)。 在這篇文章中，我們會引導您完成新增 Amazon Lex 機器人到 Amazon Connect 的步驟。 使用 Amazon Lex，您可以建立讓客戶感到自然的對話式互動 (機器人)。Amazon Connect 搭配 Amazon Lex 機器人也可以擷取客戶輸入，做為客戶在 Amazon Connect 流程中使用數字鍵盤輸入的數字。如此一來，客戶可選擇他們輸入敏感資訊 (例如帳戶號碼) 的方式。 若要按照此逐步教學進行，您需要以下資訊： + 作用中 AWS 的帳戶。 + Amazon Connect 執行個體。 **提示** 您也可以使用 Amazon Lex 為 Amazon Connect 聊天提供互動式訊息。互動式訊息是豐富的訊息，可提供提示和預先設定的顯示選項供客戶選擇。這些訊息由 Amazon Lex 提供支援，並透過 Amazon Lex 使用 Lambda 進行設定。如需詳細資訊，請參閱[在聊天中為客戶新增 Amazon Lex 互動式訊息](interactive-messages.md)。 ## 建立 Amazon Lex 機器人 在此步驟中，您將建立一個自訂機器人，以示範與 Amazon Connect 整合的 Press or Say。機器人將提示撥打者按下或說出符合功能表選項的數字，以完成任務。在此案例中，該輸入會檢查其帳戶平衡。 ------ #### [ Amazon Lex ] 1. 開啟 [Amazon Lex 主控台。](https://console.aws.amazon.com/lexv2/home) 1. 選擇**建立機器人**。 1. 在**設定機器人設定**頁面上，選擇**建立 - 建立空白機器人**，並提供下列資訊： + **機器人名稱** – 在此演練中，將機器人命名為 **AccountBalance**。 + **IAM 許可** – 如果您已建立角色，請選取一個角色。否則，請選擇**建立具有基本 Amazon Lex 許可的角色**。 + **COPPA** – 選擇機器人是否遵循兒童線上隱私保護法。 + **工作階段逾時** – 選擇機器人在結束工作階段前，應該等待發話者輸入的時間長度。 1. 選擇**下一步**。 1. 提供語言和語音特定資訊： + **語言** – 從 [Amazon Lex 支援的語言和地區](https://docs.aws.amazon.com/lexv2/latest/dg/how-languages.html)清單中選取語言和地區。 + **語音互動** – 選取您與撥打者對話所用的機器人語音。Joanna 是 Amazon Connect 的預設語音。 1. 選擇**完成**。AccountBalance 機器人隨即建立，並顯示**意圖**頁面。 ------ #### [ Amazon Lex (Classic) ] 1. 開啟 [Amazon Lex 主控台。](https://console.aws.amazon.com/lex/) 1. 如果這是您第一次建立機器人，請選擇 **Get Started (開始使用)**。否則，請選擇 **Bots, Create (機器人，建立)**。 1. 在**Create your bot (建立您的機器人)** 頁面上，選擇 **Custom bot (自訂機器人)** 並提供以下資訊： + **機器人名稱** – 在此演練中，將機器人命名為 **AccountBalance**。 + **輸出語音** – 選取您與撥打者對話所用的機器人語音。Joanna 是 Amazon Connect 的預設語音。 + **工作階段逾時** – 選擇機器人在結束工作階段前，應該等待發話者輸入的時間長度。 + **COPPA** – 選擇機器人是否遵循兒童線上隱私保護法。 1. 選擇**建立**。 ------ ## 設定 Amazon Lex 機器人 在此步驟中，您將透過提供意圖、範例表達用語、輸入的槽和錯誤處理，來決定機器人回應客戶的方式。 在此範例中，您將以兩個意圖來設定機器人：一個用於查詢帳戶資訊，而另一個則與客服人員對話。 ### 建立 AccountLookup 意圖 ------ #### [ Amazon Lex ] 1. 建立機器人之後，您將位於 Amazon Lex 主控台的**意圖**頁面上。如果您未在該頁面，可以透過選擇**機器人**、**AccountBalance**、**機器人版本**、**草稿版本**、**意圖**前往該頁面。選擇**新增意圖**、**新增空白意圖**。 1. 在**意圖名稱**方塊中，輸入 **AccountLookup**。 1. 往下捲動頁面至**範例表達用語**。在此步驟中，您會輸入允許客戶引出 AccountLookup 意圖的表達用語。輸入下列表達用語，然後選擇在每個表達用語之後**新增表達用語**。 + **查看我的帳戶餘額** + **One**：這會將 "one" 的表達用語或按鍵 "1" 指派到 **AccountLookup** 意圖。 下圖顯示了**範例表達用語**區段中新增表達用語的位置。 ![\[意圖頁面的範例表達用語區段。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/lexv2-enter-utterances.png) 1. 捲動至**插槽**區段，然後選擇**新增插槽**。按以下內容完成方塊： 1. **此意圖的必要項目** = 已選取。 1. **名稱** = **AccountNumber**。 1. **插槽類型** = **AMAZON.Number**。 1. **提示** = 請新增接聽通話時要說的文字。例如，要求撥打者使用鍵盤輸入其帳戶號碼：**使用您的按鍵式鍵盤，請輸入您的帳戶號碼**。選擇**新增**。 下圖顯示完成的**新增插槽**區段。 ![\[意圖頁面的新增插槽區段。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/lexv2-add-slots.png) 1. 捲動至**關閉回應**區段。新增機器人要對客戶說的訊息。例如，**您的帳戶餘額為 1,234.56 美元**。(在此逐步解說中，我們不會真正取得資料，這是您在現實中要做的。) 下圖顯示完成的**關閉回應**區段。 ![\[意圖頁面的關閉回應區段。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/lexv2-response1.png) 1. 選擇**儲存意圖**。 ------ #### [ Amazon Lex (Classic) ] 1. 從 Amazon Lex 主控台選擇**意圖**旁的加號 **\$1** 圖示，然後選擇**建立新意圖**。 1. 將意圖命名為 **AccountLookup**。 1. 新增範例表達用語，例如 *Check my account balance (檢查我的帳戶餘額)*，然後選擇 **\$1** 圖示。 1. 新增第二個表達用語，例如 *One (1)* 並選擇 **\$1** 圖示。這會將 "one" 的表達用語或按鍵 "1" 指派到 **AccountLookup** 意圖。 **提示** 您必須在機器人中新增「一」的表達用語，而不是數字「1」。這是因為 Amazon Lex 沒有直接支援數字輸入。為了解決這個問題，您稍後將在本演練中，使用數字輸入內容來與流程中調用的 Lex 機器人互動。 1. 在 **Slots (槽)** 下新增一個名為 **AccountNumber** 的槽。 下圖顯示頁面上**插槽**區段的位置。 ![\[意圖頁面的插槽區段。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/lex-slots.png) 1. 對於 **Slot type (槽類型)**，請使用下拉式清單以選擇 **AMAZON.NUMBER**。 1. 對於 **提示**，請新增接聽通話時要說的文字。例如，要求撥打者使用鍵盤輸入其帳戶號碼：*使用您的按鍵式鍵盤，請輸入您的帳戶號碼*。 1. 選擇 \$1 圖示。 1. 確定 **Required (必要的)** 核取方塊已選取。 1. 在 **Response (回應)** 區段中，新增機器人要對客戶說的訊息。例如，**您的帳戶餘額為 1,234.56 美元**。 1. 選擇 **Save Intent (儲存意圖)**。 ------ ### 建立 SpeakToAgent 意圖 ------ #### [ Amazon Lex ] 1. 導覽至**意圖**頁面：選擇**返回至意圖清單**。 1. 選擇**新增意圖**、**新增空白意圖**。 1. 在**意圖名稱**方塊中，輸入 **SpeakToAgent**，然後選擇**新增**。 1. 向下捲動至**範例表達用語**區段。輸入下列表達用語，可讓客戶引出 SpeakToAgent 意圖： + **與客服人員交談** + **Two** 1. 向下捲動至**關閉回應**區段。新增機器人要對客戶說的訊息。例如，**好的，客服人員將很快為您服務**。 1. 選擇**儲存意圖**。 ------ #### [ Amazon Lex (Classic) ] 1. 從 Amazon Lex 主控台選擇**意圖**旁的加號 **\$1** 圖示，然後選擇**建立新意圖**。 1. 將意圖命名為 **SpeakToAgent**。 1. 選取 **SpeakToAgent (SpeakToAgent)**。 1. 新增範例表達用語，例如 *Speak to an agent (與客服人員談話)*，然後選擇 **\$1**。 1. 新增第二個表達用語，例如 *Two (2)*，然後選擇 **\$1**。 1. 請新增訊息，以讓撥打者知道他們的通話正在連接到客服人員。例如，「好的，客服人員將很快為您服務。」 1. 選擇 **Save Intent (儲存意圖)**。 ------ ## 建置及測試 Amazon Lex 機器人 在您建立機器人後，請確定它的運作一如預期。 ------ #### [ Amazon Lex ] 1. 請在頁面底部選擇**建置**。這可能需要花費一至二分鐘。下圖顯示了**建置**按鈕的位置。 ![\[建置按鈕在頁面上的位置。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/lexv2-build-test-intent.png) 1. 建置完成後，請選擇**測試**。 1. 測試 **AccountLookup** 意圖：在**測試草稿版本**窗格中的**輸入訊息**方塊中，輸入 **1**，然後按 Enter。然後輸入虛構的帳戶號碼，並按 Enter 鍵。下圖顯示您輸入意圖的位置。 ![\[您要鍵入欲測試意圖的方塊。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/lexv2-test1.png) 1. 清除測試方塊。 1. 輸入要測試的意圖。 1. 若要確認 **SpeakToAgent** 意圖是否正常運作，請清除測試方塊，然後鍵入 **2** 並按 Enter。下圖顯示清除測試後，然後輸入 2 之後的外觀。 ![\[測試方塊。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/lexv2-test2.png) 1. 關閉**測試草稿版本**窗格。 ------ #### [ Amazon Lex (Classic) ] 1. 選擇 **Build** (建置)。這可能需要花費一至二分鐘。 1. 建立完成後，選擇**測試 Chatbot**，如下圖所示。 ![\[測試聊天機器人按鈕，位於頁面右側。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/lex-test-chatbot.png) 1. 讓我們來測試 **AccountLookup** 意圖：在 **Test Chatbot (測試聊天機器人)** 窗格的 **Chat with your bot (與您的機器人聊天)** 方塊中，輸入 **1**。然後輸入一個虛構的帳戶號碼。在下圖中，箭頭指向您鍵入 1 的方塊。 ![\[測試機器人，用於輸入您訊息的方塊。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/lex-test-run.png) 1. 選擇 **Clear chat history (清除聊天歷史記錄)**。 1. 若要確認 **SpeakToAgent** 意圖運作正常，請輸入 **2**。 ------ ## 建立機器人版本 (選用) 在此步驟中，您將建立要在別名中使用的新機器人版本。這是建立可用於生產環境別名的做法。測試別名受限於較低的限流限制。雖然這是測試逐步解說，但建立版本是最佳作法。 ------ #### [ Amazon Lex ] 1. 如果您在**意圖**頁面上，請選擇**返回意圖清單**。 1. 在左側選單中，選擇**機器人版本**。 1. 選擇**建立版本**。 1. 檢閱 **AccountBalance** 機器人的詳細資料，然後選擇**建立**。 這會建立您的機器人 (版本 1) 的一個版本。您可以在非測試別名上切換版本，而不必追蹤要發佈的版本。 ![\[列出版本 1 的版本頁面。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/lexv2-version1.png) ------ ## 建立機器人別名 ------ #### [ Amazon Lex ] 1. 在左側選單中，選擇**別名**。 1. 在**別名**索引標籤中，選擇**建立別名**。 1. 在**別名名稱**方塊中，輸入名稱，例如**測試**。在本逐步解說的稍後，您將使用此別名在流程中指定此版本的機器人。 **重要** 在生產環境中，請務必使用與 Amazon Lex 的 **TestBotAlias** 和 Amazon Lex classic 的 **\$1LATEST** 不同的別名。**TestBotAlias** 和 **\$1LATEST** 支援對 Amazon Lex 機器人有限數量的同時呼叫。如需詳細資訊，請參閱[執行期配額](https://docs.aws.amazon.com/lexv2/latest/dg/quotas.html#quotas-service)。 1. 針對**關聯版本**，請選擇您剛建立的版本，例如**版本 1**。 1. 選擇**建立**。 ------ #### [ Amazon Lex (Classic) ] 1. 選擇**發布**。 1. 為機器人提供別名。使用別名以在流程中指定此版本的機器人，例如，**測試**。 **重要** 在生產環境中，請務必使用與 Amazon Lex 的 **TestBotAlias** 和 Amazon Lex classic 的 **\$1LATEST** 不同的別名。**TestBotAlias** 和 **\$1LATEST** 支援對 Amazon Lex 機器人有限數量的同時呼叫。如需詳細資訊，請參閱[執行期 Service Quotas](https://docs.aws.amazon.com/lex/latest/dg/gl-limits.html#gl-limits-runtime)。 1. 選擇**發布**。 ------ ## 將 Amazon Lex 機器人新增到您的 Amazon Connect 執行個體 ------ #### [ Amazon Lex ] 1. 開啟 [Amazon Connect 主控台。](https://console.aws.amazon.com/connect/) 1. 選取您要與 Amazon Lex 機器人整合的 Amazon Connect 執行個體。 ![\[Amazon Connect 虛擬聯絡中心執行個體頁面，即執行個體別名。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/instance.png) 1. 在導覽功能表中，選擇**流程**。 1. 在 **Amazon Lex** 下，使用下拉式清單選取 Amazon Lex 機器人的區域，然後選取您的 Amazon Lex 機器人 **AccountBalance**。 1. 從下拉式清單中選取 Amazon Lex 機器人別名 (**測試**)，然後選擇 **\$1 新增 Lex 機器人**。下圖顯示設定完成後的 Amazon Lex 區段。 ![\[流程頁面、Amazon Lex 區段。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/lexv2-region-bot.png) **注意** Amazon Connect 會使用 Amazon Lex 資源型政策來呼叫您的 Amazon Lex 機器人。當您將 Amazon Lex 機器人與 Amazon Connect 執行個體建立關聯時，機器人上的資源型政策會更新，以授予 Amazon Connect 調用機器人的許可。如需 Amazon Lex 資源型政策的詳細資訊，請參閱 [Amazon Lex 如何與 IAM 搭配使用](https://docs.aws.amazon.com/lexv2/latest/dg/security_iam_service-with-iam.html#security_iam_service-with-iam-resource-based-policies)。 ------ #### [ Amazon Lex (Classic) ] 1. 開啟 [Amazon Connect 主控台。](https://console.aws.amazon.com/connect/) 1. 選取您要與 Amazon Lex 機器人整合的 Amazon Connect 執行個體。 1. 在導覽功能表中，選擇**聯絡流程**。 1. 在 **Amazon Lex** 下，使用下拉式清單選取 Amazon Lex 傳統機器人的區域，然後選取您的 Amazon Lex 傳統機器人。它的名稱後綴為「(傳統)」。然後選擇**新增 Lex 機器人**。 ------ ## 建立流程並新增您的 Amazon Lex 機器人 **重要** 如果您使用的是 Amazon Lex V2 機器人，則 Amazon Connect 中的語言屬性必須與用於建立 Lex 機器人的語言模型相符。這與 Amazon Lex (經典) 是不同的。使用[設定語音](set-voice.md#set-voice-lexv2bot)區塊來指出 Amazon Connect 語言模型，或使用 [設定聯絡屬性](set-contact-attributes.md) 區塊。 接著，建立使用 Amazon Lex 機器人的新流程。在您建立流程後，您將設定對呼叫者播放的訊息。 1. 使用具有聯絡流程和 Amazon Lex 機器人許可的帳戶登入您的 Amazon Connect 執行個體。 1. 在導覽功能表上，選擇**路由、流程、建立流程**，然後鍵入流程的名稱。 1. 在**互動**下，將 [取得客戶輸入內容](get-customer-input.md) 區塊拖曳到設計工具中，並將其連接到**進入點區塊**。 1. 按一下**取得客戶輸入**區塊以將其開啟。選擇**文字轉換語音或聊天文字、輸入文字**。 1. 輸入訊息，以提供撥打者可執行操作的相關資訊。例如，使用符合用於機器人內的意圖之訊息，例如「若要檢查您的帳戶餘額，請按 1 或說 1。若要與客服人員對話，請按 2 或說 2。」 下圖顯示了**取得客戶輸入**區塊屬性頁面上的此訊息。 ![\[取得客戶輸入區塊的屬性頁面。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/lex-get-customer-input.png) 1. 選取 **Amazon Lex** 索引標籤，如下圖所示。 ![\[取得客戶輸入區塊屬性頁面上的 Amazon Lex 索引標籤。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/lexv2-get-customer-input2.png) 1. 在**名稱**下拉式清單中，選取您先前建立的 **AccountBalance** 機器人。 1. 如果您選取 Amazon Lex 機器人，請在**別名**下使用下拉式選單選取機器人別名 (**測試**)。 1. Amazon Lex 傳統機器人的名稱後綴為「(傳統)」。如果您已選取傳統機器人，請在**別名**欄位中輸入要使用的別名。 1. 對於 Amazon Lex V2 機器人，您也可以選擇手動設定機器人別名 ARN。選擇**手動設定**，然後輸入您要使用的機器人別名的 ARN，或使用動態屬性設定 ARN。 1. 在 **Intents (意圖)** 下，請選擇 **Add an intent (新增意圖)**。 1. 輸入 **AccountLookup (查看帳戶)** 並選擇 **Add another intent (新增另一個意圖)**。下圖顯示了使用此資訊設定的**意圖**區段。 ![\[Amazon Lex 選項標籤的意圖區段。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/lex-get-customer-input3.png) 1. 輸入 **SpeakToAgent (與客服人員對話)** 然後選擇 **Save (儲存)**。 ### 完成流程 在此步驟中，您將完成在呼叫者與機器人互動後執行流程中的新增部分： 1. 如果撥打者按下 1 取得其帳戶餘額，請使用 **Prompt (提示)** 區塊以播放訊息並中斷通話。 1. 如果撥打者按下 2 與客服人員對話，請使用**設定佇列**區塊來設定佇列並轉接該呼叫者到佇列，這會結束該流程。 以下是建立流程的步驟： 1. 在**互動**下，將**播放提示區塊**拖曳至設計工具，並將**取得客戶輸入**區塊的 **AccountLookup** 節點連線至該區塊。在客戶從 Amazon Lex 機器人取得帳戶餘額後，便會播放**播放提示**區塊中的訊息。 1. 在**終止/轉接**下，將**中斷連線**區塊拖曳至設計工具，並和**播放提示**區塊連接。播放提示訊息後，電話中斷。 完成 **SpeakToAgent (與客服人員對話)** 意圖： 1. 新增**設定工作佇列**區塊，並將其連接至**取得客戶輸入**區塊的 **SpeakToAgent** 節點。 1. 新增**轉接到佇列**區塊。 1. 將**設定客戶佇列流程**區塊的成功節點連接到**轉接佇列**。 1. 選擇 **Save (儲存)**，然後選擇 **Publish (發佈)**。 您完成的流程看起來會如下圖所示：該流程會從**取得客戶輸入**區塊開始。該區塊會分支到**播放提示**或**設定客戶佇列**。 ![\[流程設計工具中完成的流程。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/lex-contactflow-designer.png) **提示** 如果您的企業在單一機器人中使用多個地區設定，請在流程的開頭新增 [設定聯絡屬性](set-contact-attributes.md) 區塊。將此區塊設定為使用 [\$1.LanguageCode](connect-attrib-list.md#attribs-system-table) 系統屬性。 ## 將流程指派到電話號碼 當客戶呼叫您的聯絡中心時，他們將被傳送到指派給他們撥打的電話號碼流程。為了讓新的流程作用，請將其指派給執行個體的電話號碼。 1. 開啟 Amazon Connect 主控台。 1. 選擇**轉接、電話號碼**。 1. 在**管理電話號碼**頁面上，選取要指派給流程的電話號碼。 1. 新增描述。 1. 在**流程/IVR** 選單中，選擇您剛建立的流程。 1. 選擇**儲存**。 ## 試試看！ 若要嘗試機器人與流程，請撥打您指派到流程的號碼。依照提示進行。 # 使用聊天頻道和 Amazon Lex 的最佳實務 以下是一起使用聊天頻道和 Amazon Lex 的一些建議最佳實務。 + 您可以在語音和聊天頻道中都使用相同的機器人。不過，您可能希望機器人能根據頻道，以不同的方式回應。例如，您想要傳回 SSML 供語音使用，以便將號碼讀取為電話號碼，但您想要將正常文字傳回聊天。您可以藉由傳遞**頻道**屬性來完成此操作。如需說明，請參閱[如何將相同的 Amazon Lex 機器人用於語音和聊天](one-bot-voice-chat.md)。 + 若是語音，有些單字最好以語音方式拼寫，以取得正確的發音，例如姓氏。如果您的案例是這種情況，請將該語音包含在機器人的設計中。或者，您可以將語音和聊天機器人分開。 + 告訴客服人員機器人的相關資訊。將聯絡案例連接到客服人員時，客服人員會在其視窗中看到整個文字記錄。文字記錄包含來自客戶和機器人的文字。 # 在聊天中為客戶新增 Amazon Lex 互動式訊息 互動式訊息是豐富的訊息，可提供提示和預先設定的顯示選項以供客戶選擇。這些訊息由 Amazon Lex 提供支援，並使用 AWS Lambda 函數透過 Amazon Lex 設定。 **提示** 如果您已與 Apple Messages for Business 整合，請參閱 Apple 網站上的[互動式訊息類型](https://register.apple.com/resources/messages/msp-rest-api/type-interactive)。 ## 驗證限制 字串欄位限制 (例如標題、副標題等) 預計將由用戶端 (即自訂建置介面或託管通炫小工具) 強制執行。[SendMessage](https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_SendMessage.html) API 只會檢查字串的總大小是否小於 20 KB。 + 在您使用託管通訊小工具而不進行自訂時，如果字串超過欄位限制，則該字串在使用者介面上將被截斷，並附加省略符號 (......)。您可以透過自訂小工具來決定如何強制執行欄位限制。 + 如果您要與其他平台整合 (例如 Apple Messages for Business)，請檢閱本主題中 Amazon Connect 的限制，並檢閱其他平台說明文件中的限制。例如，較舊版本的 iOS 不支援快速回覆。 必須遵循所有其他欄位限制，才能順利傳送訊息。 ## 訊息顯示範本 Amazon Connect 提供下列訊息顯示範本。使用它們在聊天中將資訊呈現給客戶： + [清單挑選器](#list-picker) + [時間挑選器](#time-picker) + [面板](#panel) + [快速回覆](#quick-reply-template) + [浮動切換](#carousel-template) + [Apple 表單範本](#apple-form-template) + [Apple Pay 範本](#apple-pay-template) + [iMessage 應用程式範本](#imessage-app-template) + [WhatsApp 清單](#whatsapp-list) + [WhatsApp 回覆按鈕](#whatsapp-reply-button) + [標題和字幕的豐富格式](#rich-link-formatting) 這些範本定義了資訊的呈現方式，以及在聊天介面中顯示的資訊。透過聊天傳送互動式訊息時，流程會驗證訊息格式是否遵循其中一個範本。 ## 清單挑選器範本 使用清單挑選器範本，向客戶呈現最多六個選項的清單。每個選擇都可以有自己的圖片。 下列圖片顯示清單挑選器範本如何在聊天中呈現資訊的兩個範例。 + 一張圖片顯示三個按鈕，每個按鈕都具備文字中的水果名稱：蘋果、柳橙、香蕉。 + 第二張圖片顯示一家商店的圖片，然後在下面的三個按鈕，每個按鈕都附有名稱、影像和水果的價格。 ![\[清單挑選器範本會呈現在聊天中的資訊。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/interactive-messages-listpicker-images2.png) 下列程式碼是您可以在 Lambda 中使用的清單挑選器範本。注意下列事項： + **粗體文字**表示強制性參數。 + 在某些情況下，如果父元素非強制性，但其中的欄位是強制性，則這些欄位是必要的。例如，請參閱下列範本中的 `data.replyMessage` 結構。如果結構存在，`title` 是強制性的。否則，可選擇是否完成 `replyMessage`。 ``` { "templateType":"ListPicker", "version":"1.0", "data":{ "replyMessage":{ "title":"Thanks for selecting!", "subtitle":"Produce selected", "imageType":"URL", "imageData":"https://interactive-msg.s3-us-west-2.amazonaws.com/fruit_34.3kb.jpg", "imageDescription":"Select a produce to buy" }, "content":{ "title":"What produce would you like to buy?", "subtitle":"Tap to select option", "imageType":"URL", "imageData":"https://interactive-msg.s3-us-west-2.amazonaws.com/fruit_34.3kb.jpg", "imageDescription":"Select a produce to buy", "elements":[ { "title":"Apple", "subtitle":"$1.00", "imageType":"URL", "imageData":"https://interactive-message-testing.s3-us-west-2.amazonaws.com/apple_4.2kb.jpg" }, { "title":"Orange", "subtitle":"$1.50", "imageType":"URL", "imageData":"https://interactive-message-testing.s3-us-west-2.amazonaws.com/orange_17.7kb.jpg", }, { "title":"Banana", "subtitle":"$10.00", "imageType":"URL", "imageData":"https://interactive-message-testing.s3-us-west-2.amazonaws.com/banana_7.9kb.jpg", "imageDescription":"Banana" } ] } ``` ### 清單挑選器限制 如果您選擇從頭開始建置自己的 Lambda，下表列出了每個清單挑選器元素的限制。強制性參數會以粗體顯示。 如要傳送無限的選項，請在應用程式中實作動作按鈕。如需詳細資訊，請參閱[互動式訊息清單選擇器/面板中的動作按鈕實作](https://github.com/amazon-connect/amazon-connect-chat-interface/blob/master/.github/docs/InteractiveMessageActionButtonImplementation.md)。 **** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/interactive-messages.html) **注意** 如果您使用的是 `targetForLinks` 欄位和 Amazon Connect 通訊小工具，若要在相同的瀏覽器索引標籤中開啟連結，您必須將下列屬性新增至小工具程式碼片段，以允許目前的 iframe 在相同的索引標籤中開啟和導覽連結： ``` amazon_connect('updateSandboxAttributes', 'allow-scripts allow-same-origin allow-popups allow-downloads allow-top-navigation-by-user-activation') ``` ## 時間挑選器範本 時間挑選器範本對於讓客戶能夠安排預約非常實用。在聊天中您最多可以向客戶提供 40 個時段。 下列影像顯示時間挑選器範本如何在聊天中呈現資訊的兩個範例。 + 一個影像顯示一個日期，並在其下方顯示一個時段。 + 第二個影像顯示一個日期，而在其下方則顯示兩個時段。 ![\[在聊天中呈現資訊的時間挑選器範本。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/interactive-messages-timepicker.png) 下圖顯示具有影像的時間挑選器 **注意** 如果您將此訊息範本與 [Apple Messages for Business](apple-messages-for-business.md) 管道搭配使用，但未新增影像，Amazon Connect 會在回覆和回應訊息中新增預設影像。 ![\[具有影像的時間挑選器。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/interactive-messages-timepicker-with-image.png) 下列程式碼是您可以在 Lambda 中使用的時間挑選器範本。注意下列事項： + **粗體文字**表示強制性參數。 + 在某些情況下，如果父元素非強制性，但其中的欄位是強制性，則這些欄位是必要的。例如，請參閱下列範本中的 `data.replyMessage` 結構。如果結構存在，`title` 是強制性的。否則，可選擇是否完成 `replyMessage`。 ``` { "templateType":"TimePicker", "version":"1.0", "data":{ "replyMessage":{ "title":"Thanks for selecting", "subtitle":"Appointment selected", "imageType":"URL", "imageData":"https://interactive-msg.s3-us-west-2.amazonaws.com/booked.jpg", "imageDescription":"Appointment booked" }, "content":{ "title":"Schedule appointment", "subtitle":"Tap to select option", "imageType":"URL", "imageData":"https://interactive-msg.s3-us-west-2.amazonaws.com/calendar.jpg", "imageDescription":"Appointment booked", "timeZoneOffset":-450, "location":{ "latitude":47.616299, "longitude":-122.4311, "title":"Oscar", "radius":1, }, "timeslots":[ { "date" : "2020-10-31T17:00+00:00", "duration": 60, }, { "date" : "2020-11-15T13:00+00:00", "duration": 60, }, { "date" : "2020-11-15T16:00+00:00", "duration": 60, } ], } } } } ``` ### 時間挑選器限制 下表列出了每個時間挑選器元素的限制。如果您選擇從頭開始建置自己的 Lambda，請使用此資訊。強制性參數會以粗體顯示。 **** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/interactive-messages.html) ## 面板範本 透過使用面板範本，您可以在一個問題下向客戶提供多達 10 個選擇。但是，您只能包含一個影像，而不是每個選擇都可以有影像。 下列影像顯示面板範本如何在聊天中呈現資訊的範例。它會在訊息頂部顯示一個影像，並在影像下顯示一個提示，詢問*我該如何提供幫助？ 點選以選擇選項*。在提示下向客戶顯示三個選項：**查看自助式服務選項**、**與客服人員交談**，**結束聊天**。 ![\[在聊天中呈現資訊的面板範本。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/interactive-messages-panel1.png) 下列程式碼是您可以在 Lambda 中使用的面板範本。注意下列事項： + **粗體文字**表示強制性參數。 + 在某些情況下，如果父元素非強制性，但其中的欄位是強制性，則這些欄位是必要的。例如，請參閱下列範本中的 `data.replyMessage` 結構。如果結構存在，`title` 是強制性的。否則，可選擇是否完成 `replyMessage`。 ``` { "templateType":"Panel", "version":"1.0", "data":{ "replyMessage":{ "title":"Thanks for selecting!", "subtitle":"Option selected", }, "content":{ "title":"How can I help you?", "subtitle":"Tap to select option", "imageType":"URL", "imageData":"https://interactive-msg.s3-us-west-2.amazonaws.com/company.jpg", "imageDescription":"Select an option", "elements":[ { "title":"Check self-service options", }, { "title":"Talk to an agent", }, { "title":"End chat", } ] } } } ``` ### 面板限制 如果您選擇從頭開始建置自己的 Lambda，下表列出了每個面板元素的限制。強制性參數會以粗體顯示。 如要傳送無限的選項，請在應用程式中實作動作按鈕。如需詳細資訊，請參閱[互動式訊息清單選擇器/面板中的動作按鈕實作](https://github.com/amazon-connect/amazon-connect-chat-interface/blob/master/.github/docs/InteractiveMessageActionButtonImplementation.md)。 **** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/interactive-messages.html) ## 快速回覆範本 使用快速回覆訊息，以在內嵌清單中取得客戶及其對客戶的簡單回覆。快速回覆不支援影像。 下列影像顯示快速回覆範本如何在聊天中呈現資訊的範例。 ![\[在聊天中呈現資訊的面板範本。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/quick-reply-template.png) 下列程式碼是您可以在 Lambda 中使用的快速回覆範本。 ``` { "templateType": "QuickReply", "version": "1.0", "data": { "replyMessage": { "title": "Thanks for selecting!" }, "content": { "title": "Which department would you like?", "elements": [{ "title": "Billing" }, { "title": "Cancellation" }, { "title": "New Service" } ] } } } ``` ### 快速回覆限制 下表列出了每個快速回覆元素的限制。如果您選擇從頭開始建置自己的 Lambda，請使用此資訊。強制性參數會以粗體顯示。 **** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/interactive-messages.html) ## 浮動切換範本 使用浮動切換在一個訊息中向客戶顯示多達 5 個清單挑選器或面板。類似清單挑選器和時間挑選器，您可以透過使用 SHOW\$1MORE 功能新增更多的選項至浮動切換。 以下 GIF 顯示浮動切換範本如何在聊天中呈現資訊的範例。客戶可透過使用左、右箭頭捲動影像的浮動切換。 ![\[客戶聊天體驗中的浮動切換。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/carousel-interactive.gif) 下圖顯示了兩個**了解更多**超連結，這是浮動切換挑選器超連結元素的範例。 ![\[附超連結的浮動切換挑選器。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/carousel-interactive1.png) 以下程式碼是您可以在 Lambda 中使用的浮動切換範本。 ``` { "templateType": "Carousel", "version": "1.0", "data": { "content": { "title": "View our popular destinations", "elements": [ { "templateIdentifier": "template0", "templateType": "Panel", "version": "1.0", "data": { "content": { "title": "California", "subtitle": "Tap to select option", "elements": [ { "title": "Book flights" }, { "title": "Book hotels" }, { "title": "Talk to agent" } ] } } }, { "templateIdentifier": "template1", "templateType": "Panel", "version": "1.0", "data": { "content": { "title": "New York", "subtitle": "Tap to select option", "elements": [ { "title": "Book flights" }, { "title": "Book hotels" }, { "title": "Talk to agent" } ] } } } ] } } } ``` 對於託管的通訊小工具使用者： + 浮動切換範本上的選項會導致 JSON 字串回應結構如下列範例所示，傳回 Lambda (其他互動式訊息類型會傳回僅含 `selectionText` 值的一般字串回應)： ``` { templateIdentifier: "template0", listTitle: "California", selectionText: "Book hotels" } ``` + 在浮動切換中，您可以在清單挑選器/面板元素中提供超連結。若要建立超連結而非按鈕，請在應為超連結的元素包含下列其他欄位： ``` { title: "Book flights", ... type: "hyperlink", url: "https://www.example.com/Flights" } ``` ### 浮動切換限制 下表列出每個浮動切換元素的限制。如果您選擇從頭開始建置自己的 Lambda，請使用此資訊。強制性參數會以粗體顯示。 **** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/interactive-messages.html) ## Apple 表單範本 **注意** 此範本僅適用於 Apple Messages for Business 聯絡流程。 企業可以透過單一訊息將表單互動式訊息傳送給最終客戶，其中包含多頁請求的輸入。在最終客戶 Apple 裝置上收到訊息時，他們可以開啟表單並瀏覽頁面，為每個頁面提供回應，然後在表單結尾提交所有回應。 例如，企業可以將 Apple 表單用於各種用途，包括分類流程、客戶調查和帳戶建立/註冊。 **警告** 互動式訊息內容和最終客戶回應儲存在聯絡人記錄文字記錄中，其他聊天參與者和可存取文字記錄的聯絡分析師都可檢視。**在聯絡結束後**，為了防止 PII 在您的聯絡人記錄文字記錄中出現，您想要在逐步指南流程中[設定錄製和分析行為區塊](set-recording-behavior.md)、[啟用 Contact Lens](sensitive-data-redaction.md)，並啟用敏感日期的修訂。如需如何啟用 PII 修訂的完整詳細資訊，請參閱[啟用敏感資料的修訂](enable-analytics.md#enable-redaction)。 支援的頁面類型如下： + **ListPicker**：使用者必須透過影像支援從中選取的選項清單。 + **WheelPicker**：類似於 ListPicker，但會透過可捲動的選項滾輪進行選取。 + **DatePicker**：使用者可以挑選日期的行事曆檢視。 + **Input**：使用者必須填入的文字欄位。 下列程式碼是您可以在 Lambda 中使用的 Apple 表單範本範例。 **注意** **粗體文字**是強制性參數。 在某些情況下，如果父元素存在於請求中，並且不是強制/粗體，但其中的欄位是，則這些欄位是必要的。 簡單問卷表單範例： ``` {   "templateType": "AppleForm",   "version": "1.0",   "data": {     "content": {       "title": "Survey",       "pages": [         {           "pageType": "DatePicker",           "title": "Date you visited",           "subtitle": "When did you last visit?",           "minDate": "2024-01-02"         },         {           "pageType": "ListPicker",           "title": "Rating",           "subtitle": "How do you rate the experience?",           "items": [             {               "title": "Good",               "imageType": "URL",               "imageData": "https://mybucket.s3.us-west-2.amazonaws.com/good.jpg"             },             {               "title": "Okay",               "imageType": "URL",               "imageData": "https://mybucket.s3.us-west-2.amazonaws.com/okay.jpg"             },             {               "title": "Poor",               "imageType": "URL",               "imageData": "https://mybucket.s3.us-west-2.amazonaws.com/poor.jpg"             }           ]         },         {           "pageType": "ListPicker",           "title": "Dine type",           "subtitle": "Select all dine types that apply",           "multiSelect": true,           "items": [             {               "title": "Pickup"             },             {               "title": "Dine-in"             },             {               "title": "Delivery"             }           ]         },         {           "pageType": "WheelPicker",           "title": "Visits",           "subtitle": "How often do you visit?",           "items": [             {               "title": "Often"             }             {               "title": "Sometimes"             },             {               "title": "Rarely"             }           ]         },         {           "pageType": "Input",           "title": "Additional notes",           "subtitle": "Anything else you'd like to mention about your visit?",           "multiLine": true         }       ]     }   } } ``` ### Apple 表單限制 #### InteractiveMessage | 欄位 | 類型 | 必要 | 描述/備註 | | --- | --- | --- | --- | | 版本 | string | 是 | 版本編號。允許的值："1.0" | | templateType | TemplateType | 是 | 互動式訊息範本類型。允許的值：["ListPicker"、"TimePicker"、"Panel"、"QuickReply"、"Carousel"、"ViewResource"、"AppleForm"] | | 資料 | InteractiveMessageData | 是 | 互動式訊息資料 | #### InteractiveMessageData | 欄位 | 類型 | 必要 | 描述/備註 | | --- | --- | --- | --- | | 內容 | InteractiveMessageContent | 是 | 主要互動式訊息內容 | | replyMessage | ReplyMessage | 否 | 傳送互動式訊息回應後的訊息顯示組態 | #### AppleFormContent | 欄位 | 類型 | 必要 | 描述/備註 | | --- | --- | --- | --- | | 標題 | String | 是 | 表單的最上層標題。在 Apple 中顯示接收訊息泡泡和文字記錄轉譯 | | 字幕 | String | 否 | 用作 ReceivedMessage 中的字幕 | | imageType | String | 否 | 有效值："URL" 用於 ReceivedMessage 中的影像 | | imageData | String | 否 | S3 影像 URL 用於 ReceivedMessage 中的影像 | | 頁面 | AppleFormPage[] | 是 | 表單頁面的清單 | | showSummary | Boolean | 否 | 是否要在提交前顯示要檢閱的回應摘要頁面。預設值：False (無確認/摘要頁面) | | splashPage | AppleFormSplashPage | 否 | 在實際頁面之前顯示的初始啟動頁面。預設值：無啟動頁面 | #### AppleFormSplashPage | 欄位 | 類型 | 必要 | 描述/備註 | | --- | --- | --- | --- | | 標題 | String | 是 | 啟動頁面的標題 | | 字幕 | String | 否 | 字幕/啟動頁面內文 | | imageType | ImageType | 否 | 在啟動頁面中顯示影像時出現。允許的值："URL"。預設值：未顯示影像 | | imageData | String | 否 | 對於 imageType="URL"，這是 URL 值。預設值：未顯示影像 | | buttonTitle | String | 是 | 繼續按鈕的文字。Apple 需要，不支援具有當地語系化的預設文字 | #### AppleFormPage + 表單頁面的基本模型。特定頁面類型延伸自此模型 | 欄位 | 類型 | 必要 | 描述/備註 | | --- | --- | --- | --- | | pageType | ApplePageType | 是 | 頁面類型的列舉。允許的值：["Input"、"DatePicker"、"WheelPicker"、"ListPicker"] | | 標題 | String | 是 | 頁面標題 | | 字幕 | String | 是 | 頁面字幕。用於確認頁面 | #### AppleFormDatePickerPage **AppleFormDatePickerPage** 延伸 [AppleFormPage](#apple-forms-limits-appleformpage) | 欄位 | 類型 | 必要 | 描述/備註 | | --- | --- | --- | --- | | pageType | ApplePageType | 是 | 值："DatePicker" | | labelText | String | 否 | 日期輸入旁顯示的文字。請參閱附錄中的範例螢幕擷取畫面 | | helperText | String | 否 | 在日期輸入下顯示的協助程式文字。請參閱附錄中的範例螢幕擷取畫面。預設值：無協助程式文字 | | dateFormat | String | 否 | ISO 8601 日期格式。預設值：MM/dd/yyyy | | startDate | String | 否 | 有效日期格式的初始/預設選取日期。預設值：傳送訊息時最終使用者的目前日期 | | minDate | String | 否 | 允許以有效日期格式選取的最小日期。預設值：無最小日期 | | maxDate | String | 否 | 允許以有效日期格式選取的最大日期。預設值：傳送訊息時最終使用者的目前日期 | #### AppleFormListPickerPage **AppleFormListPickerPage** 延伸 [AppleFormPage](#apple-forms-limits-appleformpage) | 欄位 | 類型 | 必要 | 描述/備註 | | --- | --- | --- | --- | | pageType | ApplePageType | 是 | 值："ListPicker" | | multiSelect | Boolean | 否 | 啟用選取多個項目。預設值：false (單一選取) | | items | AppleFormListPickerPageItem[] | 是 | 清單頁面項目的清單 | #### AppleFormListPickerPageItem **AppleFormListPickerPageItem** 延伸 [AppleFormPage](#apple-forms-limits-appleformpage) | 欄位 | 類型 | 必要 | 描述/備註 | | --- | --- | --- | --- | | 標題 | String | 是 | 項目的顯示文字 | | imageType | ImageType | 否 | 在項目中顯示影像時出現。允許的值："URL"。預設值：未顯示影像 | | imageData | String | 否 | 對於 imageType="URL"，這是 URL 值。預設值：未顯示影像 | **注意** 與現有互動式訊息模型 (ListPicker) 類似的影像模型，但 `imageDescription` 不包含在內，用於聊天小工具/Web 聊天中的影像替代文字，並忽略 Apple 互動式訊息。 #### AppleFormWheelPickerPage **AppleFormWheelPickerPage** 延伸 [AppleFormPage](#apple-forms-limits-appleformpage) | 欄位 | 類型 | 必要 | 描述/備註 | | --- | --- | --- | --- | | pageType | ApplePageType | 是 | 值："WheelPicker" | | items | AppleFormWheelPickerPageItem[] | 是 | 滾輪挑選器項目的清單 | | labelText | String | 否 | 輸入旁顯示的文字。請參閱附錄中的範例螢幕擷取畫面 | #### AppleFormWheelPickerPageItem **AppleFormWheelPickerPageItem** 延伸 [AppleFormPage](#apple-forms-limits-appleformpage) | 欄位 | 類型 | 必要 | 描述/備註 | | --- | --- | --- | --- | | 標題 | String | 是 | 挑選器項目的顯示文字 | #### AppleFormInputPage **AppleFormInputPage** 延伸 [AppleFormPage](#apple-forms-limits-appleformpage) | 欄位 | 類型 | 必要 | 描述/備註 | | --- | --- | --- | --- | | pageType | ApplePageType | 是 | 值："Input" | | labelText | String | 否 | 輸入方塊旁顯示的文字。請參閱附錄中的範例螢幕擷取畫面 | | helperText | String | 否 | 輸入方塊下顯示的其他文字：預設值：無協助程式文字 | | placeholderText | String | 否 | 當沒有輸入時最初顯示的預留位置文字。預設值：「(選用)」或「(必要)」預留位置文字 | | prefixText | String | 否 | 要在輸入旁顯示的首碼文字。例如：輸入為貨幣值時的 '\$1'。預設值：無首碼文字 | | 必要 | Boolean | 否 | 最終使用者是否需要提供輸入。預設值：False | | multiLine | Boolean | 否 | 是否可以提供多行輸入。預設值：False (單行) | | maxCharCount | Number | 否 | 輸入的最大字元計數。在 Apple 用戶端強制執行。預設值：無限制 | | regex | String | 否 | 要對提供的輸入設定限制條件的 Regex 字串。預設值：無 regex 限制條件 | | keyboardType | String | 否 | 決定最終使用者提供輸入時顯示的鍵盤類型。允許的值：與 Apple 相同。請參閱[文件](https://register.apple.com/resources/messages/msp-rest-api/type-interactive#form-message)。一些允許的值：numberPad、phonePad、emailAddress | | textContentType | String | 否 | 協助在 Apple 裝置上自動填入建議。  允許的值：與 Apple 相同。請參閱[文件](https://register.apple.com/resources/messages/msp-rest-api/type-interactive#form-message)。一些允許的值：telephoneNumber、fullStreetAddress、familyName | ## Apple Pay 範本 **注意** 此範本僅適用於 Apple Messages for Business 聯絡流程。 使用 Apple Pay 範本為客戶提供一種簡單且安全的方式，透過 Apple Messages for Business 搭配 Apple Pay 購買商品和服務。 下列程式碼是您可以在 Lambda 中使用的 Apple Pay 範本： **注意** **粗體文字**是強制性參數。 在某些情況下，如果父元素存在於請求中，並且不是強制/粗體，但其中的欄位是，則這些欄位是必要的。 ``` {   "templateType":"ApplePay",   "version":"1.0",   "data":{     "content":{       "title":"Halibut",       "subtitle":"$63.99 at Sam's Fish",       "imageType":"URL",       "imageData":"https://interactive-msg.s3-us-west-2.amazonaws.com/fish.jpg",       "payment": {         "endpoints": {           "orderTrackingUrl": "https://sams.example.com/orderTrackingUrl/",           "paymentGatewayUrl": "https://sams.example.com/paymentGateway/",           "paymentMethodUpdateUrl": "https://sams.example.com/paymentMethodUpdate/",           "shippingContactUpdateUrl": "https://sams.example.com/shippingContactUpdate/",           "shippingMethodUpdateUrl": "https://sams.example.com/shippingMethodUpdate/",           "fallbackUrl": "https://sams.example.com/paymentGateway/"         },         "merchantSession": {           "epochTimestamp": 1525730094057,           "expiresAt": 1525730094057,           "merchantSessionIdentifier": "PSH40080EF4D6.........9NOE9FD",           "nonce": "fe72cd0f",           "merchantIdentifier": "merchant.com.sams.fish",           "displayName": "Sam's Fish",           "signature": "308006092a8.......09F0W8EGH00",           "initiative": "messaging",           "initiativeContext": "https://sams.example.com/paymentGateway/",           "signedFields": [             "merchantIdentifier",             "merchantSessionIdentifier",             "initiative",             "initiativeContext",             "displayName",             "nonce"           ],         },         "paymentRequest": {           "applePay": {             "merchantCapabilities": [               "supports3DS",               "supportsDebit",               "supportsCredit"             ],             "merchantIdentifier": "merchant.com.sams.fish",             "supportedNetworks": [               "amex",               "visa",               "discover",               "masterCard"             ]           },           "countryCode": "US",           "currencyCode": "USD",           "lineItems": [             {               "amount": "59.00",               "label": "Halibut",               "type": "final"             },             {               "amount": "4.99",               "label": "Shipping",               "type": "final"             }           ],           "requiredBillingContactFields": [             "postalAddress"           ],           "requiredShippingContactFields": [             "postalAddress",             "phone",             "email",             "name"           ],           "shippingMethods": [             {               "amount": "0.00",               "detail": "Available within an hour",               "identifier": "in_store_pickup",               "label": "In-Store Pickup"             },             {               "amount": "4.99",               "detail": "5-8 Business Days",               "identifier": "flat_rate_shipping_id_2",               "label": "UPS Ground"             },             {               "amount": "29.99",               "detail": "1-3 Business Days",               "identifier": "flat_rate_shipping_id_1",               "label": "FedEx Priority Mail"             }           ],           "total": {             "amount": "63.99",             "label": "Sam's Fish",             "type": "final"           },           "supportedCountries" : [             "US",             "CA",             "UK",             "JP",             "CN"           ]         }       },       "requestIdentifier" : "6b2ca008-1388-4261-a9df-fe04cd1c23a9"     }   } } ``` ### Apple Pay 限制 | 父項欄位 | 欄位 | 必要 | 最少字元 | 最多字元 | 其他要求 | | --- | --- | --- | --- | --- | --- | | | templateType | 是 | | | 有效範本類型 | | | 資料 | 是 | | | | | | 版本 | 是 | | | 必須為 "1.0" | | 資料 | 內容 | 是 | | | | | 內容 | 標題 | 是 | 1 | 512 | 已收到訊息泡泡的標題 | | | 字幕 | 否 | 0 | 512 | 要顯示在已收到訊息泡泡標題下的字幕 | | | imageData | 否 | 0 | 200 | 必須為有效的可公開存取網址 | | | imageType | 否 | 0 | 50 | 必須為 "URL" | | | 付款 | 是 | | | 字典，其中包含提供 Apple Pay 請求細節的欄位。 | | | requestIdentifier | 否 | | | 字串，ApplePay 請求的識別符。如果未指定，則會產生並使用 UUID。 | | 付款 | 端點 | 是 | | | 字典，其中包含用於付款處理、聯絡更新和訂單追蹤的端點。 | | | merchantSession | 是 | | | 字典，其中包含請求新的付款工作階段後 Apple Pay 提供的付款工作階段。 | | | paymentRequest | 是 | | | 包含付款請求相關資訊的字典 | | 端點 | paymentGatewayUrl | 是 | | | 字串. 由 Apple Pay 呼叫，透過付款供應商處理付款。URL 應該與商家工作階段的 initiativeContext 欄位中的 URL 相符 | | | fallbackUrl | 否 | | | 在 Web 瀏覽器中開啟的 URL，客戶的裝置無法使用 Apple Pay 付款時，客戶也可以完成購買。如果指定，fallbackUrl 需要符合 paymentGatewayUrl。 | | | orderTrackingUrl | 否 | | | 由 Messages for Business 在完成訂單後呼叫；可讓您有機會更新系統中的訂單資訊。 | | | paymentMethodUpdateUrl | 否 | | | 當客戶變更付款方式時，由 Apple Pay 呼叫。如果您未實作此端點，並在字典中包含此索引鍵，則客戶會看到錯誤訊息。 | | | shippingContactUpdateUrl | 否 | | | 當客戶變更其運送地址資訊時，由 Apple Pay 呼叫。如果您未實作此端點，並在字典中包含此索引鍵，則客戶會看到錯誤訊息 | | | shippingMethodUpdateUrl | 否 | | | 當客戶變更運送方式時，由 Apple Pay 呼叫。如果您未實作此端點，並在字典中包含此索引鍵，則客戶會看到錯誤訊息。 | | merchantSession | displayName | 是 | 1 | 64 | 字串. 您的存放區的正式名稱，適合顯示。請勿將名稱當地語系化。 | | | initiative | 是 | | | 字串. 必須為「訊息」 | | | initiativeContext | 是 | | | 字串. 傳遞您的付款閘道 URL。 | | | merchantIdentifier | 是 | | | 字串. 代表 Apple Pay 商家的唯一識別符。 | | | merchantSessionIdentifier | 是 | | | 字串. 代表商家的 Apple Pay 工作階段的唯一識別符。 | | | epochTimestamp | 是 | | | 字串。代表自 1970 年 1 月 1 日星期四 00:00:00 UTC 以來經過的秒數時間。 | | | expiresAt | 是 | | | 字串. 代表自 1970 年 1 月 1 日星期四 00:00:00 UTC 以來經過的秒數過期時間。 | | | nonce | 否 | | | 二進位。檢查互動完整性的單次使用字串。 | | | signature | 否 | | | 二進位。用來簽署互動的公有金鑰雜湊。 | | | signedFields | 否 | | | 字串清單，包含已簽署的屬性。 | | paymentRequest | applePay | 是 | | | 描述 Apple Pay 組態的字典。 | | | countryCode | 是 | | | 字串. 商家的兩個字母 ISO 3166 國家/地區代碼。 | | | currencyCode | 是 | | | 字串. 付款的三個字母 ISO 4217 貨幣代碼。 | | | lineItems | 否 | | | 說明付款和額外費用的明細項目陣列。不需要明細項目。不過，如果 lineItems 索引鍵存在，則陣列不能空白。 | | | total | 是 | | | 包含總計的字典。總數量必須大於零才能通過驗證。 | | | requiredBillingContactFields | 否 | | | 處理交易所需的客戶必要帳單資訊的清單。如需可能字串的清單，請參閱 [requiredBillingContactFields](https://developer.apple.com/documentation/apple_pay_on_the_web/applepaypaymentrequest/2216120-requiredbillingcontactfields)。只需要處理付款所需的聯絡欄位。請求不必要的欄位會增加交易的複雜性，這可能會增加客戶取消付款請求的機會。 | | | requiredShippingContactFields | 否 | | | 客戶履行訂單所需的運送或聯絡資訊的清單。例如，如果您需要客戶的電子郵件或電話號碼，請包含此索引鍵。如需可能字串的清單，請參閱 [requiredShippingContactFields](https://developer.apple.com/documentation/apple_pay_on_the_web/applepaypaymentrequest/2216121-requiredshippingcontactfields)。 | | | shippingMethods | 否 | | | 列出可用運送方法的陣列。Apple Pay 付款表會顯示陣列中的第一個運送方法，做為預設運送方法。 | | | supportedCountries | 否 | | | 要支援的國家/地區陣列。使用 ISO 3166 國家/地區代碼列出每個國家/地區。 | | applePay | merchantIdentifier | 是 | | | 代表 Apple Pay 商家的唯一識別符。 | | | merchantCapabilities | 是 | | | 商家支援的付款功能陣列。陣列必須包含 supports3DS，也可以選擇性地包含 supportsCredit、supportsDebit 和 supportsEMV。 | | | supportedNetworks | 是 | | | 商家支援的付款網路陣列。陣列必須包含下列一或多個值：amex、discover、jcb、masterCard、privateLabel 或 visa | | lineItem | amount | 是 | | | 明細項目的貨幣金額。 | | | 標籤 | 是 | | | 明細項目的簡短當地語系化描述。 | | | 類型 | 否 | | | 指出明細項目是最終還是待定的值。 | | total | amount | 是 | | | 付款的總金額。 | | | 標籤 | 是 | | | 付款的簡短當地語系化描述。 | | | 類型 | 否 | | | 指出付款是最終還是待定的值。 | | shippingMethods | amount | 是 | | | 字串. 與此運送方法相關聯的非負數成本。 | | | detail | 是 | | | 字串. 運送方法的其他描述。 | | | 標籤 | 是 | | | 字串. 運送方法的簡短描述。 | | | identifier | 是 | | | 字串. 用於識別此運送方法的用戶端定義值。 | ## iMessage 應用程式範本 **注意** 此範本僅適用於 Apple Messages for Business 聯絡流程。 使用 iMessage 應用程式範本，將自訂建置 iMessage 應用程式提供給客戶。 下列程式碼是您可以在 Lambda 函式中使用的範例 iMessage 應用程式範本。  ``` {    templateType: AppleCustomInteractiveMessage,    version: "1.0",    data: {        content: {            appIconUrl: "https://interactive-message-testing.s3-us-west-2.amazonaws.com/apple_4.2kb.jpg",            appId: "123456789",            appName: "Package Delivery",            title: "Bubble Title CIM",            bid: "com.apple.messages.MSMessageExtensionBalloonPlugin:{team-id}:{ext-bundle-id}",            dataUrl: "?deliveryDate=26-01-2024&destinationName=Home&street=1infiniteloop&state=CA&city=Cupertino&country=USA&postalCode=12345&latitude=37.331686&longitude=-122.030656&isMyLocation=false&isFinalDestination=true",            subtitle: "Bubble package",        },        replyMessage: {            title: "Custom reply message title",            subtitle: "Custom reply message subtitle",            imageType: "URL",            imageData: "https://interactive-msg.s3-us-west-2.amazonaws.com/fruit_34.3kb.jpg",        }    } } ``` ### iMessage 應用程式限制 | **父項欄位** | **欄位** | **必要** | **類型** | **其他備註** | | --- | --- | --- | --- | --- | | | templateType | 是 | TemplateType | 有效範本類型，"AppleCustomInteractiveMessage" | | | 資料 | 是 | InteractiveMessageData | 包含內容和 receivedMessage 字典 | | | version | 是 | string | 必須為 "1.0" | | 資料 | 內容 | 是 | InteractiveMessageContent | iMessage 應用程式的互動式內容 | | | replyMessage | 是 | ReplyMessage | 傳送互動式訊息回應後的訊息顯示組態 | | 內容 | appIconUrl | 是 | string | AWS S3 URL | | | appId | 是 | string | 商業 iMessage 應用程式 ID | | | appName | 是 | string | 商業 iMessage 應用程式名稱 | | | bid | 是 | string | 商業 iMessage 應用程式競價。模式：com.apple.messages.MSMessageExtensionBalloonPlugin:\$1team-id\$1:\$1ext-bundle-id\$1 | | | dataUrl | 是 | string | 傳遞至 iMessage 應用程式的資料 | | | useLiveLayout | 否 | boolean | 預設值為 True | | | 標題 | 是 | string | iMessage 應用程式泡泡的標題 | | | 字幕 | 否 | string | iMessage 應用程式泡泡的字幕 | | replyMessage | 標題 | 否 | string | | | | 字幕 | 否 | string | | | | imageType | 否 | string | 必須為有效的可公開存取網址 | | | imageData | 否 | string | 沒有影像則無法存在 | ## WhatsApp 清單 **注意** 您只能將此範本用於 WhatsApp 訊息流程。如需整合 WhatsApp 與 Amazon Connect 的詳細資訊，請參閱本指南稍早的 [設定 WhatsApp Business 傳訊](whatsapp-integration.md)。 您可以在 WhatsApp 聊天中使用 WhatsApp 清單範本，為客戶提供選項清單。 下列範例顯示銀行服務的選項清單。 ``` { "templateType": "WhatsAppInteractiveList", "version": "1.0", "data": { "content": { "title": "Which account do you need help with?", "body": { "text": "Which account do you need help with?" }, "action": { "button": "Options", "sections": [ { "title": "Your accounts", "rows": [ { "id": "11111111", "title": "11111111", "description": "PERSONAL CHECKING" }, { "id": "22223333", "title": "22223333", "description": "PERSONAL SAVINGS" } ] }, { "title": "Other", "rows": [ { "id": "other", "title": "I can't find my account" } ] } ] } } } } ``` 下圖顯示客戶開啟清單前後的典型畫面。 ![\[顯示選項清單的影像。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/whatsapp-options-results.png) ### WhatsApp 選項限制 | 父項欄位 | 欄位 | 必要 | 長度下限 | 長度上限 | 其他要求 | | --- | --- | --- | --- | --- | --- | | | templateType | 是 | | | 必須是 "WhatsAppInteractiveList" | | | 資料 | 是 | | | | | | version | 是 | | | 必須為 "1.0" | | 資料 | 內容 | 是 | | | | | 內容 | 標題 | 是 | | | | | | 標頭 | 否 | | | | | | 本文 | 是 | | | | | | 頁尾 | 否 | | | | | | 動作 | 是 | | | | | 標頭 | type | 是 | | | 必須是 "text" | | | 文字 | 是 | 1 | 60 | | | 本文 | 文字 | 是 | 1 | 4096 | | | footer | 文字 | 是 | 1 | 60 | | | 動作 | 區段 | 是 | 1 | 10 | | | | 按鈕 | 是 | 1 | 20 | | | 區段 | 標題 | 是 | 1 | 24 | | | | 資料列 | 是 | 1 | 10 | 所有區段最多 10 個資料列 | | 資料列 | id | 是 | 1 | 200 | 跨資料列必須是唯一的 | | | 標題 | 是 | 1 | 24 | | | | 說明 | 否 | 1 | 72 | | ## WhatsApp 回覆按鈕 **注意** 您只能將此範本用於 WhatsApp 訊息流程。 您可以使用 WhatsApp 回覆按鈕範本，為客戶呈現選項的內嵌清單。 ``` { "templateType": "WhatsAppInteractiveReplyButton", "version": "1.0", "data": { "content": { "title": "What would you like to do?", "body": { "text": "What would you like to do?" }, "action": { "buttons": [ { "type": "reply", "reply": { "id": "agent", "title": "Continue to agent" } }, { "type": "reply", "reply": { "id": "end_chat", "title": "End chat" } } ] } } } } ``` 下圖顯示典型的使用者體驗。 ![\[聊天工作階段中回覆的影像。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/whatsapp-reply-template.png) ### WhatsApp 回覆按鈕限制 WhatsApp 回覆範本有下列限制。 | 父項欄位 | 欄位 | 必要 | 長度下限 | 長度上限 | 其他要求 | | --- | --- | --- | --- | --- | --- | | | templateType | 是 | | | 必須是 "WhatsAppInteractiveReplyButton" | | | 資料 | 是 | | | | | | version | 是 | | | 必須為 "1.0" | | 資料 | 內容 | 是 | | | | | 內容 | 標題 | 是 | | | | | | 標頭 | 否 | | | | | | 本文 | 是 | | | | | | footer | 否 | | | | | | 動作 | 是 | | | | | 標頭 | type | 是 | | | 有效值："text"、"document"、"image"、"video" | | | 文字 | 否 | 1 | 60 | | | | 映像 | 否 | | | | | | 影片 | 否 | | | | | | 文件 | 否 | | | | | 映像 | 連結 | 是 | | | 必須是可公開存取的媒體 URL，開頭為 https/http | | 影片 | 連結 | 是 | | | 必須是可公開存取的媒體 URL，開頭為 https/http | | 文件 | 連結 | 是 | | | 必須是可公開存取的媒體 URL，開頭為 https/http | | 本文 | 文字 | 是 | 1 | 1024 | | | footer | 文字 | 是 | 1 | 60 | | | 動作 | 按鈕 | 是 | 1 | 3 | | | 按鈕 | type | 是 | | | 必須是 "reply" | | | reply.id | 是 | 1 | 256 | 跨按鈕必須是唯一的 | | | reply.title | 是 | 1 | 20 | | ## 標題和副標題的 RTF 格式 您可以為聊天訊息的標題和副標題新增 RTF 格式。例如，您可以新增連結、斜體、粗體、編號清單和項目符號清單。您可以使用 [markdown]( https://commonmark.org/help/) 將文字格式化。 以下的聊天方塊影像顯示在標題和副標題使用 RTF 格式的範例清單挑選器。 + 標題**我們如何提供幫助？ aws.amazon.com** 是粗體的，並包含一個連結。 + 副標題包含斜體和粗體文字、項目符號清單和編號清單。它也會顯示純連結、文字連結和範例程式碼。 + 聊天方塊的底部顯示三個清單挑選器元素。 ![\[聊天方塊、附連結的標題、附清單和連結的副標題。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/rich-link-formatting-example1a.png) ### 如何使用 markdown 格式化文字 您可以用多行格式寫入標題和副標題字串，也可以在單行中使用 ``\r\n`` 換行符號來寫入標題和副標題字串。 + **多行格式**：以下程式碼範例顯示如何以多行格式編寫 markdown 清單。 ``` const MultiLinePickerSubtitle = `This is some *emphasized text* and some **strongly emphasized text** This is a bulleted list (multiline): * item 1 * item 2 * item 3 This is a numbered list: 1. item 1 2. item 2 3. item 3 Questions? Visit https://plainlink.com/faq [This is a link](https://aws.amazon.com) This is \`\` ` const PickerTemplate = { templateType: "ListPicker|Panel", version: "1.0", data: { content: { title: "How can we help?", subtitle: MultiLinePickerSubtitle, elements: [ /* ... */ ] } } } ``` + **單行格式**：下列範例顯示如何使用 ``\r\n`` 換行符號在單行中編寫副標題。 ``` const SingleLinePickerSubtitle = "This is some *emphasized text* and some **strongly emphasized text**\r\nThis is a bulleted list:\n* item 1\n* item 2\n* item 3\n\nThis is a numbered list:\n1. item 1\n2. item 2\n3. item 3\n\nQuestions? Visit https://plainlink.com/faq\r\n[This is a link](https://aws.amazon.com)\r\nThis is ``"; const PickerTemplate = { templateType: "ListPicker|Panel", version: "1.0", data: { content: { title: "How can we help?", subtitle: SingleLinePickerSubtitle, elements: [ /* ... */ ] } } } ``` 下列範例顯示如何使用 markdown 設定斜體與粗體文字格式： `This is some *emphasized text* and some **strongly emphasized text**` 下列範例顯示如何使用 markdown 將文字格式化為程式碼： `This is ``` ### 如何使用 markdown 格式化連結 若要建立連結，請使用下列語法： `[aws](https://aws.amazon.com)` 以下範例顯示兩種可以用 markdown 新增連結的方法： `Questions? Visit https://plainlink.com/faq ` `[This is a link](https://aws.amazon.com)` **注意** 對於清單挑選器，如果您想要對連結開啟的位置進行精細控制，則可以將 `targetForLinks` 欄位新增為 `content` 的子欄位。通訊小工具預設會在新的瀏覽器索引標籤中開啟連結。如需詳細資訊，請參閱[清單挑選器範本](#list-picker)。