Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Tambahkan pesan interaktif ke obrolan
Pesan interaktif adalah pesan kaya yang menyajikan opsi tampilan yang cepat dan telah dikonfigurasi sebelumnya untuk dipilih pelanggan. Pesan-pesan ini didukung oleh Amazon Lex dan dikonfigurasi melalui Amazon Lex menggunakan Lambda.
Tip
Jika Anda telah terintegrasi dengan Apple Messages for Business, lihat Jenis Pesan Interaktif
Batas validasi
Batas bidang string (misalnya, judul, subtitle, dll.) Diharapkan akan diberlakukan oleh klien (yaitu, antarmuka yang dibuat khusus atau widget komunikasi yang dihosting). SendMessageAPICek hanya bahwa ukuran total string kurang dari 20KB.
-
Bila Anda menggunakan widget komunikasi yang di-host tanpa menyesuaikannya, jika string melebihi batas bidang, itu terpotong pada antarmuka pengguna dan elipsis (...) ditambahkan. Anda dapat menentukan cara menerapkan batas bidang dengan menyesuaikan widget.
-
Jika Anda berintegrasi dengan platform lain (seperti Apple Messages for Business), tinjau batasan dalam topik ini untuk Amazon Connect, dan tinjau batasan dalam dokumentasi untuk platform lain. Misalnya, balasan cepat tidak didukung pada versi iOS yang lebih lama.
Semua batas bidang lainnya harus diikuti agar pesan berhasil dikirim.
Template tampilan pesan
Amazon Connect menyediakan templat tampilan pesan berikut yang dapat Anda gunakan untuk merender informasi kepada pelanggan dalam obrolan:
Template ini menentukan bagaimana informasi akan dirender, dan informasi apa yang muncul di antarmuka obrolan. Saat pesan interaktif dikirim melalui obrolan, alur memvalidasi bahwa format pesan mengikuti salah satu templat ini.
Templat pemilih daftar
Gunakan template pemilih daftar untuk menyajikan pelanggan dengan daftar hingga enam pilihan. Setiap pilihan dapat memiliki gambar sendiri.
Gambar berikut menunjukkan dua contoh bagaimana template pemilih daftar merender informasi dalam obrolan.
-
Satu gambar menunjukkan tiga tombol, masing-masing dengan nama buah dalam teks: apel, jeruk, pisang.
-
Gambar kedua menunjukkan gambar toko dan kemudian di bawahnya, tiga tombol, masing-masing dengan nama, gambar, dan harga buah.
Kode berikut adalah template pemilih daftar yang dapat Anda gunakan di Lambda Anda. Perhatikan hal berikut:
-
Teks tebal adalah parameter wajib.
-
Dalam beberapa kasus, jika elemen induk ada dalam permintaan dan tidak wajib/tebal, tetapi bidang di dalamnya, maka bidang tersebut wajib. Misalnya, lihat
data.replyMessage
struktur dalam template berikut. Jika struktur ada, judul adalah wajib. Jika tidak, lengkapreplyMessage
adalah opsional.
{ "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 di picker/panel daftar pesan interaktif
Bidang induk | Bidang | Diperlukan | Karakter minimum | Karakter maksimum | Persyaratan lainnya |
---|---|---|---|---|---|
templateType |
Ya |
Jenis template yang valid |
|||
data |
Ya |
||||
versi |
Ya |
Harus “1.0" |
|||
data |
konten | Ya | |||
replyMessage | Tidak | ||||
konten |
judul | Ya | 1 |
400 |
Harus menjadi deskripsi untuk templat yang tidak cepat |
elemen | Ya | 1 barang |
10 item |
Ini adalah array elemen. Maksimal 10 elemen dalam array. Untuk mengirim elemen tak terbatas, gunakan fitur tombol tindakan. |
|
subjudul | Tidak | 0 |
400 |
||
imageType | Tidak | 0 |
50 |
Harus "URL” |
|
imageData | Tidak | 0 |
200 |
Harus dapat diakses publik yang valid URL |
|
imageDescription | Tidak | 0 |
50 |
||
referenceId | Tidak |
|
String. Hanya diperlukan untuk fitur tombol tindakan. |
||
listId | Tidak |
|
String. Hanya diperlukan untuk fitur tombol tindakan. |
||
preIndex | Tidak |
|
Nomor. Hanya diperlukan untuk fitur tombol tindakan. |
||
nextIndex | Tidak |
|
Nomor. Hanya diperlukan untuk fitur tombol tindakan. |
||
templateIdentifier | Tidak |
|
Nomor. Harus menjadi sebuahUUID. Bidang ini diperlukan jika List Picker/Panel digunakan dalam Carousel. |
||
elemen |
judul | Ya | 1 |
400 |
|
subjudul | Tidak | 0 |
400 |
||
imageType | Tidak | 0 |
50 |
Harus "URL” |
|
imageData | Tidak | 0 |
200 |
Harus dapat diakses publik yang valid URL |
|
imageDescription | Tidak | 0 |
50 |
Tidak bisa ada tanpa gambar |
|
actionDetail | Tidak |
|
|
Hanya diperlukan untuk fitur tombol tindakan. Harus "PREVIOUS_OPTIONS" atau "SHOW_MORE”. |
|
replyMessage |
judul | Ya | 1 |
400 |
|
subjudul | Tidak | 0 |
400 |
||
imageType | Tidak | 0 |
50 |
Harus "URL” |
|
imageData | Tidak | 0 |
200 |
Harus dapat diakses publik yang valid URL |
|
imageDescription | Tidak | 0 |
50 |
Tidak bisa ada tanpa gambar |
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.
-
Satu gambar menunjukkan satu tanggal, dan di bawahnya, satu slot waktu.
-
Gambar kedua menunjukkan satu tanggal, dan di bawahnya, dua slot waktu.
Gambar berikut menunjukkan pemilih waktu dengan gambar
catatan
Jika Anda menggunakan templat pesan ini dengan saluran Apple Messages for Business dan tidak menambahkan gambar, Amazon Connect akan menambahkan gambar default di pesan balasan dan respons.
Kode berikut adalah template pemilih waktu yang dapat Anda gunakan di Lambda Anda. Perhatikan hal berikut:
-
Teks tebal adalah parameter wajib.
-
Dalam beberapa kasus, jika elemen induk ada dalam permintaan dan tidak wajib/tebal, tetapi bidang di dalamnya, maka bidang tersebut wajib. Misalnya, lihat
data.replyMessage
struktur dalam template berikut. Jika struktur ada, judul adalah wajib. Jika tidak, lengkapreplyMessage
adalah opsional.
{ "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 membuat Lambda Anda sendiri dari awal. Parameter wajib dicetak tebal.
Bidang induk | Bidang | Diperlukan | Karakter minimum | Karakter maksimum | Persyaratan lainnya |
---|---|---|---|---|---|
templateType |
Ya |
Jenis template yang valid |
|||
data |
Ya |
||||
versi |
Ya |
Harus “1.0" |
|||
data |
replyMessage | Tidak | |||
konten | Ya | ||||
replyMessage |
judul |
Ya | 1 |
400 |
Harus menjadi deskripsi untuk templat yang tidak cepat |
subjudul | Tidak | 0 |
400 |
||
imageType | Tidak | 0 |
50 |
Harus "URL” | |
imageData | Tidak | 0 |
200 |
Harus dapat diakses publik yang valid URL | |
imageDescription | Tidak | 0 |
50 |
Tidak bisa ada tanpa gambar | |
konten |
judul |
Ya | 1 |
400 |
Harus menjadi deskripsi untuk templat yang tidak cepat |
subjudul | Tidak | 0 |
200 |
||
imageType | Tidak | 0 |
50 |
Harus "URL” | |
imageData | Tidak | 0 |
200 |
Harus dapat diakses publik yang valid URL | |
imageDescription | Tidak | 0 |
50 |
Tidak bisa ada tanpa gambar | |
offset zona waktu | Tidak | -720 |
840 |
Ini adalah bidang opsional bila tidak disetel. Klien sampel kami default ke zona waktu pengguna. Jika diatur, ini akan ditampilkan per zona waktu yang dimasukkan. Bidang harus berupa bilangan bulat yang mewakili jumlah menit dariGMT, menentukan zona waktu lokasi acara. |
|
lokasi | Tidak | ||||
slot waktu | Ya | 1 |
40 |
Ini adalah array dari timeslots. Maksimal 40 elemen dalam array. |
|
lokasi |
bujur | Ya | -180 |
180 |
Harus ganda |
garis lintang | Ya | -90 |
90 |
Harus ganda |
|
judul | Ya | 1 |
400 |
||
radius |
Tidak | 0 |
200 |
||
slot waktu |
tanggal | Ya |
|
Harus dalam format waktu ISO -8601: YYYY -MM- .MM+00.00 DDTHH Sebagai contoh: “2020-08-14T 21:21 +00.00" |
|
durasi | Ya | 1 |
3600 |
Template panel
Dengan menggunakan template panel, Anda dapat menyajikan pelanggan dengan 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 bertanya Bagaimana saya bisa membantu? Ketuk untuk memilih opsi. Di bawah prompt tiga opsi ditampilkan kepada pelanggan: Periksa opsi layanan mandiri, Bicara dengan agen, Akhiri obrolan.
Kode berikut adalah template panel yang dapat Anda gunakan di Lambda Anda. Perhatikan hal berikut:
-
Teks tebal adalah parameter wajib.
-
Dalam beberapa kasus, jika elemen induk ada dalam permintaan dan tidak wajib/tebal, tetapi bidang di dalamnya, maka bidang tersebut wajib. Misalnya, lihat
data.replyMessage
struktur dalam template berikut. Jika struktur ada, judul adalah wajib. Jika tidak, lengkapreplyMessage
adalah opsional.
{ "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 di picker/panel daftar pesan interaktif
Bidang induk | Bidang | Diperlukan | Karakter minimum | Karakter maksimum | Persyaratan lainnya |
---|---|---|---|---|---|
templateType |
Ya |
Jenis template yang valid |
|||
data |
Ya |
||||
versi |
Ya |
Harus “1.0" |
|||
data |
replyMessage | Tidak | |||
konten | Ya | ||||
konten |
judul | Ya | 1 |
400 |
Harus menjadi deskripsi untuk templat yang tidak cepat |
subjudul | Tidak | 0 |
400 |
||
elemen | Ya | 1 barang |
10 item |
Ini adalah array elemen. Maksimal 10 elemen dalam array. |
|
imageType | Tidak | 0 |
50 |
Harus "URL” |
|
imageData | Tidak | 0 |
200 |
Harus dapat diakses publik yang valid URL |
|
imageDescription | Tidak | 0 |
50 |
Tidak bisa ada tanpa gambar |
|
referenceId | Tidak |
|
String. Hanya diperlukan untuk fitur tombol tindakan. |
||
listId | Tidak |
|
String. Hanya diperlukan untuk fitur tombol tindakan. |
||
preIndex | Tidak |
|
Nomor. Hanya diperlukan untuk fitur tombol tindakan. |
||
nextIndex | Tidak |
|
Nomor. Hanya diperlukan untuk fitur tombol tindakan. |
||
templateIdentifier | Tidak |
|
Nomor. Harus menjadi sebuahUUID. Bidang ini diperlukan jika List Picker/Panel digunakan dalam Carousel. |
||
elemen |
judul | Ya | 1 |
400 |
|
actionDetail | Tidak |
|
|
Hanya diperlukan untuk fitur tombol tindakan. Harus "PREVIOUS_OPTIONS" atau "SHOW_MORE”. |
|
replyMessage |
judul | Ya | 1 |
400 |
|
subjudul | Tidak | 0 |
400 |
Template balasan cepat
Gunakan pesan balasan cepat untuk mendapatkan tanggapan sederhana dari pelanggan dan mereka kepada pelanggan dalam daftar in-line. Anda dapat memberi pelanggan hingga 5 opsi dalam satu pesan balasan cepat. 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 membuat Lambda Anda sendiri dari awal. Parameter wajib dicetak tebal.
Bidang | Diperlukan | Karakter minimum | Karakter maksimum | Persyaratan lainnya |
---|---|---|---|---|
templateType |
Jenis template yang valid |
|||
data |
Ya |
|||
versi |
Ya |
Harus “1.0" |
||
konten |
Ya | |||
judul | Ya | 1 |
400 |
Harus menjadi deskripsi untuk templat yang tidak cepat |
elemen | Ya | 2 barang |
10 item |
Ini adalah array elemen. Minimal 2 elemen dan maksimum 10 elemen dalam array. |
judul | Ya | 1 |
200 |
Templat korsel
Gunakan komidi putar 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 korsel dengan menggunakan fitur _. SHOW MORE
Berikut ini GIF 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 Pelajari 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 di-host:
-
Pilihan pada template carousel menghasilkan respons JSON string yang terstruktur seperti contoh berikut, untuk dikirim kembali ke Lambda (jenis pesan interaktif lainnya mengembalikan respons string reguler dengan hanya nilai):
selectionText
{ templateIdentifier: "template0", listTitle: "California", selectionText: "Book hotels" }
-
Dalam carousels, Anda dapat memberikan hyperlink dalam daftar elemen picker/panel. Untuk membuat hyperlink alih-alih tombol, sertakan bidang tambahan berikut untuk elemen yang seharusnya berupa hyperlink:
{ title: "Book flights", ... type: "hyperlink", url: "https://www.example.com/Flights" }
Batas korsel
Tabel berikut mencantumkan batas untuk masing-masing elemen korsel. Gunakan informasi ini jika Anda memilih untuk membuat Lambda Anda sendiri dari awal. Parameter wajib dicetak tebal.
Bidang induk | Bidang | Diperlukan | Karakter minimum | Karakter maksimum | Persyaratan lainnya |
---|---|---|---|---|---|
templateType |
Ya |
Jenis template yang valid |
|||
data |
Ya |
||||
versi |
Ya |
Harus “1.0" |
|||
data |
konten | Ya | |||
konten |
judul | Ya | 1 |
400 |
Harus menjadi deskripsi untuk templat yang tidak cepat |
elemen | Ya | 2 barang |
5 item |
Ini adalah array dari pemilih daftar atau template panel. Hanya satu jenis pesan interaktif yang diterima per carousel. Setiap elemen harus menyertakan bidang templateIdentifiertingkat atas. Minimal 2 template dan maksimal 5 template dalam array. catatanUntuk pengalaman pelanggan terbaik, kami merekomendasikan bahwa setiap template memiliki penggunaan gambar/jumlah elemen yang konsisten. |
|
omitTitleFromCarouselResponse | Tidak |
Boolean - Tanggapi secara opsional dengan” |
|||
carouselIsVertical | Tidak |
Boolean - Opsional membuat |
Templat formulir Apple
catatan
Template ini hanya berlaku untuk alur kontak Apple Messages for Business.
Sebuah bisnis dapat mengirim pesan interaktif formulir ke 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 respons 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.
Awas
Konten pesan interaktif dan tanggapan pelanggan akhir disimpan dalam transkrip catatan kontak dan dapat dilihat oleh peserta obrolan lain dan analis kontak dengan akses ke transkrip. Untuk PII mencegah agar tidak muncul dalam transkrip catatan kontak Anda setelah kontak berakhir, Anda akan ingin menggunakan blok Setel perekaman dan perilaku analitik dalam alur kontak step-by-step panduan Anda, aktifkan Lensa Kontak, dan aktifkan redaksi tanggal sensitif. Untuk detail selengkapnya tentang cara mengaktifkan PII redaksi, lihat Mengaktifkan redaksi data sensitif.
Jenis halaman yang didukung adalah:
-
ListPicker: daftar opsi yang harus dipilih pengguna dengan dukungan gambar.
-
WheelPicker: mirip dengan ListPicker tetapi pemilihan dilakukan melalui roda opsi yang dapat digulir.
-
DatePicker: tampilan kalender tempat pengguna dapat memilih tanggal.
-
Input: bidang teks yang harus diisi pengguna.
Kode berikut adalah contoh template formulir Apple yang dapat Anda gunakan di Lambda Anda.
catatan
-
Teks tebal adalah parameter wajib.
-
Dalam beberapa kasus, jika elemen induk ada dalam permintaan dan tidak wajib/tebal, tetapi bidang di dalamnya, maka bidang tersebut wajib.
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 formulir Apple
InteractiveMessage
Bidang | Tipe | Diperlukan | Deskripsi/Catatan |
---|---|---|---|
versi | string | Ya | Nomor versi. Nilai yang diizinkan: “1.0" |
templateType | TemplateType | Ya | Jenis template pesan interaktif. Nilai yang diizinkan: [” ListPicker “," TimePicker “, “Panel”, "QuickReply“, “Korsel”, "ViewResource“," AppleForm“] |
data | InteractiveMessageData | Ya | Data pesan interaktif |
InteractiveMessageData
Bidang | Tipe | Diperlukan | Deskripsi/Catatan |
---|---|---|---|
content | InteractiveMessageContent | Ya | Konten pesan interaktif utama |
replyMessage | ReplyMessage | Tidak | Konfigurasi tampilan pesan untuk setelah respons terhadap pesan interaktif dikirim |
AppleFormContent
Bidang | Tipe | Diperlukan | Deskripsi/Catatan |
---|---|---|---|
title | Tali | Ya | Judul formulir tingkat atas. Ditampilkan di Apple menerima gelembung pesan dan rendering transkrip |
subjudul | String | Tidak | Digunakan sebagai subtitle di ReceivedMessage |
imageType | String | Tidak | Nilai yang valid: "URL" Digunakan untuk gambar di ReceivedMessage |
imageData | String | Tidak | S3 url gambar Digunakan untuk gambar di ReceivedMessage |
halaman | AppleFormPage[] | Ya | Daftar halaman formulir |
showSummary | Boolean | Tidak | Apakah akan menampilkan halaman ringkasan tanggapan untuk ditinjau sebelum pengiriman Default: False (tidak ada konfirmasi/halaman ringkasan) |
splashPage | AppleFormSplashPage | Tidak | Halaman splash awal untuk ditampilkan sebelum halaman sebenarnya Default: Tidak ada halaman splash |
AppleFormSplashPage
Bidang | Tipe | Diperlukan | Deskripsi/Catatan |
---|---|---|---|
title | Tali | Ya | Judul halaman splash |
subjudul | String | Tidak | Subtitle/badan halaman splash |
imageType | ImageType | Tidak | Hadir saat menampilkan gambar dalam halaman splash Nilai yang diizinkan: "URL" Default: Tidak ada gambar yang ditampilkan |
imageData | String | Tidak | Untuk imageType =” URL “, ini adalah URL nilai Default: Tidak ada gambar yang ditampilkan |
buttonTitle | Tali | Ya | Teks tombol Lanjutkan. Diperlukan oleh Apple, teks default dengan pelokalan tidak didukung |
AppleFormPage
-
Model dasar untuk halaman formulir. Jenis halaman tertentu diperluas dari model ini
Bidang | Tipe | Diperlukan | Deskripsi/Catatan |
---|---|---|---|
pageType | ApplePageType | Ya | Enum untuk jenis halaman. Nilai yang diizinkan: ["Masukan”, "DatePicker“," WheelPicker “," ListPicker “] |
title | Tali | Ya | Judul halaman |
subjudul | Tali | Ya | Subtitle halaman. Digunakan di halaman konfirmasi |
AppleFormDatePickerPage
AppleFormDatePickerPagemeluas AppleFormPage
Bidang | Tipe | Diperlukan | Deskripsi/Catatan |
---|---|---|---|
pageType | ApplePageType | Ya | Nilai: "DatePicker” |
labelText | String | Tidak | Teks ditampilkan di sebelah input tanggal. Lihat contoh tangkapan layar di Lampiran |
helperText | String | Tidak | Teks pembantu ditampilkan di bawah input tanggal. Lihat contoh tangkapan layar di Lampiran Default: Tidak ada teks pembantu |
dateFormat | String | Tidak | ISOFormat tanggal 8601. Default: YYYY-MM-DD |
startDate | String | Tidak | Tanggal awal/default yang dipilih dalam format tanggal yang valid Default: Tanggal saat ini untuk pengguna akhir saat pesan dikirim |
minDate | String | Tidak | Tanggal min diizinkan untuk dipilih dalam format tanggal yang valid Default: No min |
maxDate | String | Tidak | Tanggal maksimum diizinkan untuk dipilih dalam format tanggal yang valid Default: Tanggal saat ini untuk pengguna akhir saat pesan dikirim |
AppleFormListPickerPage
AppleFormListPickerPagemeluas AppleFormPage
Bidang | Tipe | Diperlukan | Deskripsi/Catatan |
---|---|---|---|
pageType | ApplePageType | Ya | Nilai: "ListPicker” |
multiSelect | Boolean | Tidak | Memungkinkan memilih beberapa item Default: false (pilihan tunggal) |
item | AppleFormListPickerPageItem[] | Ya | Daftar item halaman daftar |
AppleFormListPickerPageItem
AppleFormListPickerPageItemmeluas AppleFormPage
Bidang | Tipe | Diperlukan | Deskripsi/Catatan |
---|---|---|---|
title | Tali | Ya | Menampilkan teks item |
imageType | ImageType | Tidak | Hadir saat menampilkan gambar dalam item Nilai yang diizinkan: "URL" Default: Tidak ada gambar yang ditampilkan |
imageData | String | Tidak | Untuk imageType =” URL “, ini adalah URL nilai Default: Tidak ada gambar yang ditampilkan |
catatan
Model gambar serupa dengan model pesan interaktif yang ada (ListPicker), kecuali imageDescription
tidak disertakan, yang digunakan untuk teks alt gambar di widget obrolan/obrolan web dan diabaikan untuk pesan interaktif Apple.
AppleFormWheelPickerPage
AppleFormWheelPickerPagemeluas AppleFormPage
Bidang | Tipe | Diperlukan | Deskripsi/Catatan |
---|---|---|---|
pageType | ApplePageType | Ya | Nilai: "WheelPicker” |
item | AppleFormWheelPickerPageItem[] | Ya | Daftar item pemetik roda |
labelText | String | Tidak | Teks ditampilkan di sebelah input. Lihat contoh tangkapan layar di Lampiran |
AppleFormWheelPickerPageItem
AppleFormWheelPickerPageItemmeluas AppleFormPage
Bidang | Tipe | Diperlukan | Deskripsi/Catatan |
---|---|---|---|
title | Tali | Ya | Menampilkan teks item pemilih |
AppleFormInputPage
AppleFormInputPagemeluas AppleFormPage
Bidang | Tipe | Diperlukan | Deskripsi/Catatan |
---|---|---|---|
pageType | ApplePageType | Ya | Nilai: “Masukan” |
labelText | String | Tidak | Teks ditampilkan di sebelah kotak input. Lihat contoh tangkapan layar di Lampiran |
helperText | String | Tidak | Teks tambahan ditampilkan di bawah kotak input Default: Tidak ada teks pembantu |
placeholderText | String | Tidak | Teks placeholder untuk ditampilkan pada awalnya ketika tidak ada input Default: “(Opsional)” atau “(Diperlukan)” teks placeholder |
prefixText | String | Tidak | Awalan teks untuk ditampilkan di sebelah input. Contoh: '$' ketika input adalah nilai moneter Default: Tidak ada teks awalan |
wajib | Boolean | Tidak | Apakah pengguna akhir diminta untuk memberikan masukan Default: false |
multiLine | Boolean | Tidak | Apakah input multi-baris dapat diberikan Default: false (baris tunggal) |
maxCharCount | Jumlah | Tidak | Jumlah arang maksimum masukan. Ditegakkan pada klien Apple Default: Tidak ada batasan |
regex | String | Tidak | String regex untuk menempatkan batasan pada input yang disediakan Default: Tidak ada kendala regex |
keyboardType | String | Tidak | Menentukan jenis keyboard apa yang ditampilkan saat pengguna akhir memberikan input Nilai yang diizinkan: Sama seperti Apple. Lihat dokumen. |
textContentType | String | Tidak | Membantu dengan saran pengisian otomatis di perangkat Apple. Nilai yang diizinkan: Sama seperti Apple. Lihat dokumen. |
Templat Apple Pay
catatan
Template ini hanya berlaku untuk alur kontak Apple Messages for Business.
Gunakan template Apple Pay untuk menyediakan cara yang mudah dan aman bagi pelanggan untuk membeli barang dan jasa melalui Apple Messages for Business dengan Apple Pay.
Kode berikut adalah template Apple Pay yang dapat Anda gunakan di Lambda Anda:
catatan
-
Teks tebal adalah parameter wajib.
-
Dalam beberapa kasus, jika elemen induk ada dalam permintaan dan tidak wajib/tebal, tetapi bidang di dalamnya, maka bidang tersebut wajib.
{ "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
Bidang induk | Bidang | Diperlukan | Karakter minimum | Karakter maksimum | Persyaratan lainnya |
---|---|---|---|---|---|
templateType | Ya | Jenis template yang valid | |||
data | Ya | ||||
versi | Ya | Harus “1.0" | |||
data | content | Ya | |||
content | title | Ya | 1 | 512 | Judul gelembung pesan yang diterima |
subjudul | Tidak | 0 | 512 | Subtitle yang akan ditampilkan di bawah judul gelembung pesan yang diterima | |
imageData | Tidak | 0 | 200 | Harus dapat diakses publik yang valid URL | |
imageType | Tidak | 0 | 50 | Harus "URL” | |
pembayaran | Ya | Kamus yang berisi bidang yang memberikan spesifikasi permintaan Apple Pay. | |||
requestIdentifier | Tidak | String, Identifier untuk ApplePay permintaan. Jika tidak ditentukan, UUID akan digenreasi dan digunakan. | |||
pembayaran | titik akhir | Ya | Kamus yang berisi titik akhir untuk pemrosesan pembayaran, pembaruan kontak, dan pelacakan pesanan. | ||
merchantSession | Ya | Kamus yang berisi sesi pembayaran yang disediakan oleh Apple Pay setelah meminta sesi pembayaran baru. | |||
paymentRequest | Ya | Kamus dengan informasi tentang permintaan pembayaran | |||
titik akhir | paymentGatewayUrl | Ya | String. Dipanggil oleh Apple Pay untuk memproses pembayaran melalui penyedia pembayaran. URLHarus cocok dengan URL di initiativeContext bidang sesi pedagang | ||
fallbackUrl | Tidak | A URL yang terbuka di browser web sehingga pelanggan dapat menyelesaikan pembelian jika perangkat mereka tidak dapat melakukan pembayaran menggunakan Apple Pay. Jika ditentukan, fallbackUrl harus cocok paymentGatewayUrl. | |||
orderTrackingUrl | Tidak | Dipanggil oleh Pesan untuk Bisnis setelah menyelesaikan pesanan; memberi Anda kesempatan untuk memperbarui informasi pesanan di sistem Anda. | |||
paymentMethodUpdateUrl | Tidak | Dipanggil oleh Apple Pay saat pelanggan mengubah metode pembayaran. Jika Anda tidak menerapkan titik akhir ini dan Anda menyertakan kunci ini dalam kamus, pelanggan akan melihat pesan kesalahan. | |||
shippingContactUpdateUrl | Tidak | Dipanggil oleh Apple Pay ketika pelanggan mengubah informasi alamat pengiriman mereka. Jika Anda tidak menerapkan titik akhir ini dan Anda menyertakan kunci ini dalam kamus, pelanggan akan melihat pesan kesalahan | |||
shippingMethodUpdateUrl | Tidak | Dipanggil oleh Apple Pay saat pelanggan mengubah metode pengiriman. Jika Anda tidak menerapkan titik akhir ini dan Anda menyertakan kunci ini dalam kamus, pelanggan akan melihat pesan kesalahan. | |||
merchantSession | displayName | Ya | 1 | 64 | String. Nama kanonik untuk toko Anda, cocok untuk dipajang. Jangan melokalkan nama. |
prakarsa | Ya | String. Harus “pesan” | |||
initiativeContext | Ya | String. Lewati gateway pembayaran AndaURL. | |||
merchantIdentifier | Ya | String. Pengenal unik yang mewakili pedagang untuk Apple Pay. | |||
merchantSessionIdentifier | Ya | String. Pengenal unik yang mewakili sesi merchant untuk Apple Pay. | |||
epochTimestamp | Ya | String.Representasi waktu dalam jumlah detik yang telah berlalu sejak 00:00:00UTC, Kamis, 1 Januari 1970. | |||
expiresAt | Ya | String. Representasi waktu eksipirasi dalam jumlah detik yang telah berlalu sejak 00:00:00UTC, Kamis, 1 Januari 1970. | |||
nonce | Tidak | Biner. String sekali pakai yang memeriksa integritas interaksi. | |||
tanda tangan | Tidak | Biner. Sebuah hash dari kunci publik digunakan untuk menandatangani interaksi. | |||
signedFields | Tidak | Daftar string berisi properti yang ditandatangani. | |||
paymentRequest | applePay | Ya | Kamus yang menjelaskan konfigurasi Apple Pay. | ||
countryCode | Ya | String. Kode negara dua huruf ISO 3166 pedagang. | |||
currencyCode | Ya | String. Kode mata uang ISO 4217 tiga huruf untuk pembayaran. | |||
lineItems | Tidak | Berbagai item baris yang menjelaskan pembayaran dan biaya tambahan. Item baris tidak diperlukan. Namun, array tidak bisa kosong jika lineItems kuncinya ada. | |||
total | Ya | Kamus yang berisi total. Jumlah total harus lebih besar dari nol untuk lulus validasi. | |||
requiredBillingContactBidang | Tidak | Daftar informasi penagihan yang diperlukan pelanggan yang diperlukan untuk memproses transaksi. Untuk daftar kemungkinan string, lihat requiredBillingContactBidang |
|||
requiredShippingContactBidang | Tidak | Daftar pengiriman atau informasi kontak yang diperlukan dari pelanggan untuk memenuhi pesanan. Misalnya, jika Anda memerlukan email atau nomor telepon pelanggan, sertakan kunci ini. Untuk daftar kemungkinan string, lihat requiredShippingContactBidang |
|||
shippingMethods | Tidak | Array yang mencantumkan metode pengiriman yang tersedia. Lembar pembayaran Apple Pay menampilkan metode pengiriman pertama dari array sebagai metode pengiriman default. | |||
supportedCountries | Tidak | Berbagai negara untuk mendukung. Buat daftar setiap negara dengan kode ISO 3166 negara mereka. | |||
applePay | merchantIdentifier | Ya | Pengenal unik yang mewakili pedagang untuk Apple Pay. | ||
merchantCapabilities | Ya | Berbagai kemampuan pembayaran yang didukung oleh pedagang. Array harus menyertakan supports3DS, dan secara opsional dapat menyertakansupportsCredit,, dan mendukung. supportsDebit EMV | |||
supportedNetworks | Ya | Berbagai jaringan pembayaran yang didukung oleh pedagang. Array harus menyertakan satu atau lebih dari nilai-nilai berikut: amex, discover, jcb,,masterCard, privateLabel atau visa | |||
lineItem | jumlah | Ya | Jumlah moneter dari item baris. | ||
label | Ya | Deskripsi singkat dan terlokalisasi dari item baris. | |||
jenis | Tidak | Nilai yang menunjukkan apakah item baris final atau tertunda. | |||
total | jumlah | Ya | Jumlah total pembayaran. | ||
label | Ya | Deskripsi pembayaran yang singkat dan terlokalisasi. | |||
jenis | Tidak | Nilai yang menunjukkan apakah pembayaran final atau tertunda. | |||
shippingMethods | jumlah | Ya | String. Biaya nonnegatif yang terkait dengan metode pengiriman ini. | ||
detail | Ya | String. Deskripsi tambahan tentang metode pengiriman. | |||
label | Ya | String. Deskripsi singkat tentang metode pengiriman. | |||
pengenal | Ya | String. Nilai yang ditentukan klien yang digunakan untuk mengidentifikasi metode pengiriman ini. |
iMessage Template aplikasi
catatan
Template ini hanya berlaku untuk alur kontak Apple Messages for Business.
Gunakan template iMessage Apps untuk menyajikan aplikasi yang dibuat iMessage khusus kepada pelanggan.
Kode berikut adalah contoh Template iMessage aplikasi yang dapat Anda gunakan di 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", } } }
iMessage Batas aplikasi
Bidang Induk | Bidang | Diperlukan | Jenis | Catatan Lainnya |
---|---|---|---|---|
templateType | Ya | TemplateType | Jenis template yang valid, "AppleCustomInteractiveMessage” | |
data | Ya | InteractiveMessageData | Berisi konten dan receivedMessage kamus | |
versi | Ya | string | Harus “1.0" | |
data | konten | Ya | InteractiveMessageContent | Konten Interaktif iMessage Aplikasi |
replyMessage | Ya | ReplyMessage | Konfigurasi tampilan pesan untuk setelah respons terhadap pesan interaktif dikirim | |
konten | appIconUrl | Ya | string | AWSS3 URL |
appId | Ya | string | Id IMessage Aplikasi Bisnis | |
appName | Ya | string | Nama IMessage Aplikasi Bisnis | |
tawaran | Ya | string | Tawaran IMessage Aplikasi Bisnis. Pola: com.apple.messages. MSMessageExtensionBalloonPlugin: {tim-id}: {} ext-bundle-id | |
dataUrl | Ya | string | Data yang diteruskan ke iMessage Aplikasi | |
useLiveLayout | Tidak | boolean | Default Benar | |
judul | Ya | string | judul gelembung Aplikasi IMessage | |
subjudul | Tidak | string | subtitle dari gelembung Aplikasi IMessage | |
replyMessage | judul | Tidak | string | |
subjudul | Tidak | string | ||
imageType | Tidak | string | Harus dapat diakses publik yang valid URL | |
imageData | Tidak | string | Tidak bisa ada tanpa gambar |
Pemformatan yang kaya dalam judul dan subtitle
Anda dapat menambahkan format kaya ke judul dan subtitle pesan obrolan Anda. Misalnya, Anda dapat menambahkan tautan, miring, tebal, daftar bernomor, dan daftar berpoin. Anda menggunakan penurunan harga untuk memformat
Gambar berikut dari kotak obrolan menunjukkan contoh pemilih daftar dengan format kaya dalam judul dan subtitle.
-
Judul Bagaimana kami bisa membantu? aws.amazon.com tebal dan berisi tautan.
-
Subtitle berisi huruf miring dan teks tebal, daftar berpoin, dan daftar bernomor. Ini juga menunjukkan tautan biasa, tautan teks, dan kode sampel.
-
Bagian bawah kotak obrolan menunjukkan tiga elemen pemilih daftar.
Cara memformat teks dengan penurunan harga
Anda dapat menulis string judul dan subtitle dalam format multi-baris, atau dalam satu baris dengan karakter pemisah `\r\n`
baris.
-
Format multi-baris: Contoh kode berikut menunjukkan cara membuat daftar dalam penurunan harga dalam format multi-baris.
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: [ /* ... */ ] } } }
-
Format baris tunggal: Contoh berikut menunjukkan cara membuat subtitle dalam satu baris dengan menggunakan karakter jeda
`\r\n`
baris.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 `<code/>`"; const PickerTemplate = { templateType: "ListPicker|Panel", version: "1.0", data: { content: { title: "How can we help?", subtitle: SingleLinePickerSubtitle, elements: [ /* ... */ ] } } }
Contoh berikut menunjukkan bagaimana format miring dan teks 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 link, 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)