本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

在聊天中為客戶新增 Amazon Lex 互動式訊息

互動式訊息是豐富的訊息，可提供提示和預先設定的顯示選項以供客戶選擇。這些訊息由 Amazon Lex 提供支援，並透過 Amazon Lex 使用 Lambda 進行設定。

驗證限制

字串欄位限制 (例如標題、副標題等) 預計將由用戶端 (即自訂建置介面或託管通炫小工具) 強制執行。只會SendMessageAPI檢查字串的總大小是否小於 20KB

必須遵循所有其他欄位限制，才能順利傳送訊息。

訊息顯示範本

Amazon Connect 提供下列訊息顯示範本，供您在聊天中將資訊呈現給客戶：

這些範本定義了資訊的呈現方式，以及在聊天介面中顯示的資訊。透過聊天傳送互動式訊息時，流程會驗證訊息格式是否遵循其中一個範本。

清單挑選器範本

使用清單挑選器範本，向客戶呈現最多六個選項的清單。每個選擇都可以有自己的圖片。

下列圖片顯示清單挑選器範本如何在聊天中呈現資訊的兩個範例。

下列程式碼是您可以在 Lambda 中使用的清單挑選器範本。注意下列事項：

{
   "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，下表列出了每個清單挑選器元素的限制。強制性參數會以粗體顯示。

如要傳送無限的選項，請在應用程式中實作動作按鈕。如需詳細資訊，請參閱互動式訊息清單選擇器/面板中的動作按鈕實作。

時間挑選器範本

時間挑選器範本對於讓客戶能夠安排預約非常實用。在聊天中您最多可以向客戶提供 40 個時段。

下列影像顯示時間挑選器範本如何在聊天中呈現資訊的兩個範例。

下圖顯示具有映像的時間選擇器

下列程式碼是您可以在 Lambda 中使用的時間挑選器範本。注意下列事項：

{
   "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，請使用此資訊。強制性參數會以粗體顯示。

面板範本

透過使用面板範本，您可以在一個問題下向客戶提供多達 10 個選擇。但是，您只能包含一個影像，而不是每個選擇都可以有影像。

下列影像顯示面板範本如何在聊天中呈現資訊的範例。它會在訊息頂部顯示一個影像，並在影像下顯示一個提示，詢問我該如何提供幫助？ 點選以選擇選項。在提示下向客戶顯示三個選項：查看自助式服務選項、與客服人員交談，結束聊天。

下列程式碼是您可以在 Lambda 中使用的面板範本。注意下列事項：

{
   "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，下表列出了每個面板元素的限制。強制性參數會以粗體顯示。

如要傳送無限的選項，請在應用程式中實作動作按鈕。如需詳細資訊，請參閱互動式訊息清單選擇器/面板中的動作按鈕實作。

快速回覆範本

使用快速回覆訊息，以在內嵌清單中取得客戶及其對客戶的簡單回覆。您可以在一個快速回覆訊息中向客戶提供多達 5 個選項。快速回覆不支援影像。

下列影像顯示快速回覆範本如何在聊天中呈現資訊的範例。

下列程式碼是您可以在 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，請使用此資訊。強制性參數會以粗體顯示。

浮動切換範本

使用浮動切換在一個訊息中向客戶顯示多達 5 個清單挑選器或面板。與清單選擇器和時間選擇器類似，您可以使用 SHOW_MORE 功能將更多選項新增至輪跳功能。

下列GIF顯示輪跳功能範本如何在聊天中轉譯資訊的範例。客戶可透過使用左、右箭頭捲動影像的浮動切換。

下圖顯示了兩個了解更多超連結，這是浮動切換挑選器超連結元素的範例。

以下程式碼是您可以在 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"
                }
              ]
            }
          }
        }
      ]
    }
  }
}

對於託管的通訊小工具使用者：

浮動切換限制

下表列出每個浮動切換元素的限制。如果您選擇從頭開始建置自己的 Lambda，請使用此資訊。強制性參數會以粗體顯示。

Apple 表單範本

企業可以透過單一訊息將表單互動式訊息傳送給其終端客戶，其中包含多頁請求的輸入。在終端客戶的 Apple 裝置上收到訊息時，他們可以開啟表單並瀏覽頁面，為每個頁面提供回應，然後在表單結尾提交所有回應。

例如，企業可以將 Apple 表單用於各種用途，包括分類流程、客戶調查和帳戶建立/註冊。

支援的頁面類型為：

下列程式碼是您可以在 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

InteractiveMessageData

AppleFormContent

AppleFormSplashPage

AppleFormPage

AppleFormDatePickerPage

AppleFormDatePickerPage延伸 AppleFormPage

AppleFormListPickerPage

AppleFormListPickerPage 延伸 AppleFormPage

AppleFormListPickerPageItem

AppleFormListPickerPageItem 延伸 AppleFormPage

AppleFormWheelPickerPage

AppleFormWheelPickerPage 延伸 AppleFormPage

AppleFormWheelPickerPageItem

AppleFormWheelPickerPageItem 延伸 AppleFormPage

AppleFormInputPage

AppleFormInputPage 延伸 AppleFormPage

Apple Pay 範本

使用 Apple Pay 範本，為客戶透過 Apple Messages for Business with 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 限制

iMessage 應用程式範本

使用 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 應用程式限制

標題和副標題的 RTF 格式

您可以為聊天訊息的標題和副標題新增 RTF 格式。例如，您可以新增連結、斜體、粗體、編號清單和項目符號清單。您可以使用 markdown 將文字格式化。

以下的聊天方塊影像顯示在標題和副標題使用 RTF 格式的範例清單挑選器。

如何使用 markdown 格式化文字

您可以用多行格式寫入標題和副標題字串，也可以在單行中使用 `\r\n` 換行符號來寫入標題和副標題字串。

下列範例顯示如何使用 markdown 設定斜體與粗體文字格式：

This is some *emphasized text* and some **strongly emphasized text**

下列範例顯示如何使用 markdown 將文字格式化為程式碼：

This is `<code />`

如何使用 markdown 格式化連結

若要建立連結，請使用下列語法：

[aws](https://aws.amazon.com)

以下範例顯示兩種可以用 markdown 新增連結的方法：

Questions? Visit https://plainlink.com/faq

[This is a link](https://aws.amazon.com)