Tambahkan pesan interaktif Amazon Lex untuk pelanggan dalam obrolan

Pesan interaktif adalah pesan kaya yang menyajikan opsi tampilan prompt dan pra-konfigurasi untuk dipilih pelanggan. Pesan-pesan ini didukung oleh Amazon Lex dan dikonfigurasi melalui Amazon Lex menggunakan AWS Lambda fungsi.

Batas validasi

Batas bidang string (misalnya, judul, subtitle) diharapkan diberlakukan oleh klien (yaitu, antarmuka yang dibuat khusus atau widget komunikasi yang dihosting). SendMessageAPI hanya memeriksa bahwa ukuran total string kurang dari 20KB.

Semua batas bidang lainnya harus diikuti agar pesan berhasil dikirim.

Templat tampilan pesan

Connect Customer menyediakan templat tampilan pesan berikut. Gunakan mereka untuk merender informasi kepada pelanggan dalam obrolan:

Template ini menentukan bagaimana informasi dirender, dan informasi apa yang muncul di antarmuka obrolan. Ketika pesan interaktif dikirim melalui obrolan, alur memvalidasi bahwa format pesan mengikuti salah satu templat ini.

Templat pemilih daftar

Gunakan templat pemilih daftar untuk menyajikan daftar hingga enam pilihan kepada pelanggan. Setiap pilihan dapat memiliki citranya sendiri.

Gambar berikut menunjukkan dua contoh bagaimana template pemilih daftar merender informasi dalam obrolan.

Kode berikut adalah template pemilih daftar yang dapat Anda gunakan di Lambda Anda. Perhatikan hal-hal berikut:

{
   "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"
            }
         ]
      }

Batas pemilih daftar

Tabel berikut mencantumkan batas untuk setiap elemen pemilih daftar, jika Anda memilih untuk membuat Lambda Anda sendiri dari awal. Parameter wajib dicetak tebal.

Untuk mengirim opsi tak terbatas, terapkan tombol tindakan di aplikasi Anda. Untuk informasi selengkapnya, lihat Implementasi tombol tindakan dalam daftar pesan interaktif picker/panel.

amazon_connect('updateSandboxAttributes', 'allow-scripts allow-same-origin allow-popups allow-downloads allow-top-navigation-by-user-activation')                                       
                                    

Templat pemilih waktu

Template pemilih waktu berguna untuk memungkinkan pelanggan menjadwalkan janji temu. Anda dapat memberikan hingga 40 slot waktu kepada pelanggan dalam obrolan.

Gambar berikut menunjukkan dua contoh bagaimana template pemilih waktu merender informasi dalam obrolan.

Gambar berikut menunjukkan pemilih waktu dengan gambar

Kode berikut adalah template pemilih waktu yang dapat Anda gunakan di Lambda Anda. Perhatikan hal-hal berikut:

{
   "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,                              
               }
            ],           
         }
      }
   }
}     

Batas pemilih waktu

Tabel berikut mencantumkan batas untuk setiap elemen pemilih waktu. Gunakan informasi ini jika Anda memilih untuk membangun Lambda Anda sendiri dari awal. Parameter wajib dicetak tebal.

Template panel

Dengan menggunakan template panel, Anda dapat menyajikan pelanggan hingga 10 pilihan di bawah satu pertanyaan. Namun, Anda hanya dapat menyertakan satu gambar, bukan gambar dengan setiap pilihan.

Gambar berikut menunjukkan contoh bagaimana template panel merender informasi dalam obrolan. Ini menunjukkan gambar di bagian atas pesan, dan di bawah gambar itu menunjukkan prompt yang menanyakan Bagaimana saya bisa membantu? Ketuk untuk memilih opsi. Di bawah prompt tiga opsi ditampilkan kepada pelanggan: Periksa opsi layanan mandiri, Bicaralah dengan agen, Akhiri obro lan.

Kode berikut adalah template panel yang dapat Anda gunakan di Lambda Anda. Perhatikan hal-hal berikut:

{
   "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",                    
            }
         ]
      }
   }
} 

Batas panel

Tabel berikut mencantumkan batas untuk masing-masing elemen panel, jika Anda memilih untuk membangun Lambda Anda sendiri dari awal. Parameter wajib dicetak tebal.

Untuk mengirim opsi tak terbatas, terapkan tombol tindakan di aplikasi Anda. Untuk informasi selengkapnya, lihat Implementasi tombol tindakan dalam daftar pesan interaktif picker/panel.

Templat balasan cepat

Gunakan pesan balasan cepat untuk mendapatkan tanggapan sederhana dari pelanggan, dan kemudian ke pelanggan dalam daftar in-line. Gambar tidak didukung untuk balasan cepat.

Gambar berikut menunjukkan contoh bagaimana template balasan cepat merender informasi dalam obrolan.

Kode berikut adalah template balasan cepat yang dapat Anda gunakan di Lambda Anda.

{
    "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"
                }
            ]
        }
    }
}

Batas balasan cepat

Tabel berikut mencantumkan batas untuk masing-masing elemen balasan cepat. Gunakan informasi ini jika Anda memilih untuk membangun Lambda Anda sendiri dari awal. Parameter wajib dicetak tebal.

Templat korsel

Gunakan korsel untuk menampilkan hingga 5 pemilih daftar atau panel kepada pelanggan dalam satu pesan. Mirip dengan pemilih daftar dan pemilih waktu, Anda dapat menambahkan lebih banyak opsi ke carousel dengan menggunakan fitur SHOW_MORE.

GIF berikut menunjukkan contoh bagaimana template carousel merender informasi dalam obrolan. Pelanggan menggulir melalui korsel gambar dengan menggunakan panah kiri dan kanan.

Gambar berikut menunjukkan dua hyperlink Pel ajari Lebih Lanjut, yang merupakan contoh elemen hyperlink pemilih korsel.

Kode berikut adalah template carousel yang dapat Anda gunakan di Lambda Anda.

{
  "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"
                }
              ]
            }
          }
        }
      ]
    }
  }
}

Untuk pengguna widget komunikasi yang dihosting:

Batas korsel

Tabel berikut mencantumkan batas untuk masing-masing elemen carousel. Gunakan informasi ini jika Anda memilih untuk membangun Lambda Anda sendiri dari awal. Parameter wajib dicetak tebal.

Templat formulir Apple

Sebuah bisnis dapat mengirim formulir pesan interaktif kepada pelanggan akhir mereka melalui satu pesan, yang berisi beberapa halaman input yang diminta. Ketika pesan diterima di perangkat Apple pelanggan akhir, mereka dapat membuka formulir dan menavigasi halaman, memberikan tanggapan untuk setiap halaman, sebelum mengirimkan semua tanggapan di akhir formulir.

Misalnya, bisnis dapat menggunakan formulir Apple untuk berbagai tujuan, termasuk alur triaging, survei pelanggan, dan pembuatan/pendaftaran akun.

Jenis halaman yang didukung adalah:

Kode berikut adalah contoh template formulir Apple yang dapat Anda gunakan di Lambda Anda.

Contoh formulir survei sederhana:

{
  "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
        }
      ]
    }
  }
}
        

Batas bentuk Apple

InteractiveMessage

InteractiveMessageData

AppleFormContent

AppleFormSplashPage

AppleFormPage

AppleFormDatePickerPage

AppleFormDatePickerPagemeluas AppleFormPage

AppleFormListPickerPage

AppleFormListPickerPagemeluas AppleFormPage

AppleFormListPickerPageItem

AppleFormListPickerPageItemmeluas AppleFormPage

AppleFormWheelPickerPage

AppleFormWheelPickerPagemeluas AppleFormPage

AppleFormWheelPickerPageItem

AppleFormWheelPickerPageItemmeluas AppleFormPage

AppleFormInputPage

AppleFormInputPagemeluas AppleFormPage

Templat Apple Pay

Gunakan template Apple Pay untuk menyediakan cara yang mudah dan aman bagi pelanggan untuk membeli barang dan layanan melalui Apple Messages for Business dengan Apple Pay.

Kode berikut adalah template Apple Pay yang dapat Anda gunakan di Lambda Anda:

{
  "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"
    }
  }
}
        

Batas Apple Pay

Templat Aplikasi iMessage

Gunakan template Aplikasi iMessage untuk menyajikan kepada pelanggan Aplikasi iMessage yang dibuat khusus.

Kode berikut adalah contoh template Aplikasi iMessage yang dapat Anda gunakan dalam fungsi Lambda Anda. 

{
   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",
       }
   }
}

Batas Aplikasi iMessage

WhatsApp daftar

Anda menggunakan templat WhatsApp daftar dalam WhatsApp obrolan untuk menyediakan daftar opsi kepada pelanggan.

Contoh berikut menunjukkan daftar opsi untuk layanan perbankan.

{
  "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"
              }
            ]
          }
        ]
      }
    }
  }
}

Gambar berikut menunjukkan layar tipikal sebelum dan sesudah pelanggan membuka daftar.

WhatsApp batas opsi

WhatsApp tombol balas

Anda dapat menggunakan templ WhatsApp at tombol balas untuk menyajikan daftar opsi in-line untuk pelanggan.

{
  "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"
            }
          }
        ]
      }
    }
  }
}

Gambar berikut menunjukkan pengalaman pengguna yang khas.

WhatsApp batas tombol balas

Template bal WhatsApp asan memiliki batasan berikut.

Pemformatan yang kaya dalam judul dan subtitle

Anda dapat menambahkan format kaya ke judul dan subtitle pesan obrolan Anda. Misalnya, Anda dapat menambahkan tautan, huruf miring, tebal, daftar bernomor, dan daftar berpoin. Anda menggunakan markdown untuk memformat teks Anda.

Gambar kotak obrolan berikut menunjukkan contoh pemilih daftar dengan format kaya dalam judul dan subtitle.

Cara memformat teks dengan penurunan harga

Anda dapat menulis string judul dan subtitle dalam format multi-baris, atau dalam satu baris dengan karakter pemutusan `\r\n` baris.

Contoh berikut menunjukkan bagaimana memformat teks miring dan tebal dengan penurunan harga:

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

Contoh berikut menunjukkan cara memformat teks sebagai kode dengan penurunan harga:

This is `<code />`

Cara memformat tautan dengan penurunan harga

Untuk membuat tautan, gunakan sintaks berikut:

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

Contoh berikut menunjukkan dua cara Anda dapat menambahkan tautan dengan penurunan harga:

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

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