Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Tambahkan antarmuka pengguna obrolan ke situs web Anda yang dihosting oleh Connect Customer
Untuk mendukung pelanggan Anda melalui obrolan, Anda dapat menambahkan widget komunikasi ke situs web Anda yang dihosting oleh Connect Customer. Anda dapat mengkonfigurasi widget komunikasi di situs web Connect Customer admin. Anda dapat menyesuaikan font dan warna, dan mengamankan widget sehingga dapat diluncurkan hanya dari situs web Anda. Setelah selesai, Anda akan memiliki cuplikan kode pendek yang Anda tambahkan ke situs web Anda.
Karena Connect Customer menghosting widget, itu memastikan bahwa versi terbaru selalu aktif di situs web Anda.
Tip
Penggunaan widget komunikasi tunduk pada kuota layanan default, seperti jumlah karakter yang diperlukan untuk setiap pesan. Sebelum meluncurkan widget komunikasi Anda ke produksi, pastikan kuota layanan Anda ditetapkan untuk kebutuhan organisasi Anda. Untuk informasi selengkapnya, lihat Connect Customer service quotas.
Daftar Isi
Langkah 2: Tentukan domain situs web tempat Anda berharap untuk menampilkan widget komunikasi
Langkah 3: Konfirmasikan dan salin kode widget komunikasi dan kunci keamanan
Mulai obrolan di aplikasi Anda dengan menggunakan Connect Customer API
Kirim notifikasi browser kepada pelanggan saat pesan obrolan tiba
Luluskan properti khusus untuk mengganti default di widget komunikasi
Targetkan tombol widget dan bingkai Anda dengan CSS/JavaScript
Peramban yang didukung
Widget komunikasi pra-bangun mendukung versi browser berikut dan yang lebih tinggi:
-
Google Chrome 85.0
-
Safari 13.1
-
Microsoft Edge versi 85
-
Mozilla Firefox 81.0
Widget komunikasi mendukung notifikasi browser untuk perangkat desktop. Untuk informasi selengkapnya, lihat Kirim notifikasi browser kepada pelanggan saat pesan obrolan tiba.
Langkah 1: Sesuaikan widget komunikasi Anda
Pada langkah ini, Anda menyesuaikan pengalaman widget komunikasi untuk pelanggan Anda.
-
Masuk ke situs web Connect Customer admin di https://
instance name.my.connect.aws/. Pilih Sesuaikan widget komunikasi.
-
Pada halaman widget Komunikasi, pilih Tambahkan widget komunikasi untuk mulai menyesuaikan pengalaman widget komunikasi baru. Untuk mengedit, menghapus, atau menduplikasi widget komunikasi yang ada, pilih dari opsi di bawah kolom Tindakan, seperti yang ditunjukkan pada gambar berikut.
-
Masukkan Nama dan Deskripsi untuk widget komunikasi.
catatan
Nama harus unik untuk setiap widget komunikasi yang dibuat dalam instance Connect Customer.
-
Di bagian Opsi komunikasi, pilih cara pelanggan Anda dapat berinteraksi dengan widget Anda, lalu pilih S impan dan lanjutkan.
catatan
Anda hanya dapat mengaktifkan tugas atau formulir pra-kontak melalui email jika obrolan dan suara tidak diaktifkan.
Gambar berikut menunjukkan opsi untuk mengizinkan obrolan, penerimaan pesan, dan membuat formulir pra-obrolan untuk pelanggan. Untuk mengaktifkan formulir pra obrolan, Anda harus terlebih dahulu membuat tampilan dengan tombol aksi sambungkan dan memilih
StartChatContacttindakan. Untuk informasi selengkapnya tentang formulir pra-obrolan dan pra-kontak, lihat. Tambahkan widget Connect Customer ke situs web Anda
-
Pada halaman Buat widget komunikasi, pilih gaya tombol widget, dan tampilkan nama dan gaya.
Saat Anda memilih opsi ini, pratinjau widget diperbarui secara otomatis sehingga Anda dapat melihat seperti apa pengalaman bagi pelanggan Anda.
Gaya tombol
-
Pilih warna untuk latar belakang tombol dengan memasukkan nilai hex (kode warna HTML
). -
Pilih Putih atau Hit am untuk warna ikon. Warna ikon tidak dapat disesuaikan.
Header widget
-
Berikan nilai untuk pesan header dan warna, dan warna latar belakang widget.
-
URL Logo: Masukkan URL ke spanduk logo Anda dari bucket Amazon S3 atau sumber online lainnya.
catatan
Pratinjau widget komunikasi di halaman kustomisasi tidak akan menampilkan logo jika berasal dari sumber online selain bucket Amazon S3. Namun, logo akan ditampilkan ketika widget komunikasi yang disesuaikan diimplementasikan ke halaman Anda.
Spanduk harus dalam format.svg, .jpg atau.png. Gambar bisa 280px (lebar) dengan 60px (tinggi). Setiap gambar yang lebih besar dari dimensi tersebut akan diskalakan agar sesuai dengan ruang komponen logo 280x60.
-
Untuk petunjuk tentang cara mengunggah file seperti spanduk logo Anda ke S3, lihat Meng unggah objek di Panduan Pengguna Layanan Penyimpanan Sederhana Amazon.
-
Pastikan izin gambar diatur dengan benar sehingga widget komunikasi memiliki izin untuk mengakses gambar. Untuk informasi tentang cara membuat objek S3 dapat diakses publik, lihat Langkah 2: Menambahkan kebijakan bucket di topik Menyet el izin untuk akses situs web.
-
Tampilan obrolan
-
Jenis huruf: Gunakan dropdown untuk memilih font untuk teks di widget komunikasi.
-
-
Nama Tampilan Pesan Sistem: Ketik nama tampilan baru untuk mengganti default. Defaultnya adalah SYSTEM_MESSAGE.
-
Nama Tampilan Pesan Bot: Ketik nama tampilan baru untuk mengganti default. Defaultnya adalah BOT.
-
Placeholder Input Teks: Ketik teks placeholder baru menggantikan default. Defaultnya adalah K etik pesan.
-
Teks Tombol Akhiri Obrolan: Ketik teks baru untuk menggantikan default. Defaultnya adalah Akhiri obrolan.
-
-
Warna gelembung obrolan agen: Pilih warna untuk gelembung pesan agen dengan memasukkan nilai hex (kode warna HTML
). -
Warna gelembung obrolan pelanggan: Pilih warna untuk gelembung pesan pelanggan dengan memasukkan nilai hex (kode warna HTML
). -
Jangan pilih Save and continue (Simpan dan lanjutkan).
Langkah 2: Tentukan domain situs web tempat Anda berharap untuk menampilkan widget komunikasi
-
Masukkan domain situs web tempat Anda ingin menempatkan widget komunikasi. Obrolan dimuat hanya di situs web yang Anda pilih pada langkah ini.
Pilih Tambahkan domain untuk menambahkan hingga 50 domain.
Perilaku daftar izin domain:
-
Subdomain secara otomatis disertakan. Misalnya, jika Anda mengizinkan example.com, semua subdomainnya (seperti sub.example.com) juga diizinkan.
-
Protokol http://atau https://harus sama persis dengan konfigurasi Anda. Tentukan protokol yang tepat saat menyiapkan domain yang diizinkan.
-
Semua jalur URL diizinkan secara otomatis. Misalnya, jika example.com diizinkan, semua halaman di bawahnya (seperti contoh. com/cart atau contoh. com/checkout) dapat diakses. Anda tidak dapat mengizinkan atau memblokir subdirektori tertentu.
penting
-
Double-check bahwa URL situs web Anda valid dan tidak mengandung kesalahan. Sertakan URL lengkap dimulai dengan https://.
-
Sebaiknya gunakan https://untuk situs web dan aplikasi produksi Anda.
-
-
Di bawah Tam bah keamanan untuk widget komunikasi Anda, sebaiknya pilih Ya, dan bekerja sama dengan administrator situs web Anda untuk mengatur server web Anda untuk mengeluarkan Token Web JSON (JWT) untuk permintaan obrolan baru. Ini memberi Anda lebih banyak kontrol saat memulai obrolan baru, termasuk kemampuan untuk memverifikasi bahwa permintaan obrolan yang dikirim ke Connect Customer berasal dari pengguna yang diautentikasi.
Memilih Ya menghasilkan hal berikut:
-
Connect Customer menyediakan kunci keamanan 44 karakter di halaman berikutnya yang dapat Anda gunakan untuk membuat Token Web JSON (JWT).
-
Connect Customer menambahkan fungsi callback dalam skrip embed widget komunikasi yang memeriksa Token Web JSON (JWT) saat obrolan dimulai.
Anda harus mengimplementasikan fungsi callback dalam cuplikan tertanam, seperti yang ditunjukkan pada contoh berikut.
amazon_connect('authenticate', function(callback) { window.fetch('/token').then(res => { res.json().then(data => { callback(data.data); }); }); });
Jika Anda memilih opsi ini, pada langkah berikutnya Anda akan mendapatkan kunci keamanan untuk semua permintaan obrolan yang dimulai di situs web Anda. Minta administrator situs web Anda untuk mengatur server web Anda untuk mengeluarkan JWT menggunakan kunci keamanan ini.
-
-
Pilih Simpan.
Langkah 3: Konfirmasikan dan salin kode widget komunikasi dan kunci keamanan
Pada langkah ini, Anda mengonfirmasi pilihan Anda dan menyalin kode untuk widget komunikasi dan menyematkannya di situs web Anda. Jika Anda memilih untuk menggunakan JWT di Langkah 2, Anda juga dapat menyalin kunci rahasia untuk membuatnya.
Kunci keamanan
Gunakan kunci keamanan 44 karakter ini untuk menghasilkan token web JSON dari server web Anda. Anda juga dapat memperbarui, atau memutar, tombol jika Anda perlu mengubahnya. Ketika Anda melakukan ini, Connect Customer memberi Anda kunci baru dan mempertahankan kunci sebelumnya sampai Anda memiliki kesempatan untuk menggantinya. Setelah Anda menerapkan kunci baru, Anda dapat kembali ke Connect Customer dan menghapus kunci sebelumnya.
Ketika pelanggan Anda berinteraksi dengan ikon Mulai obrolan di situs web Anda, widget komunikasi meminta server web Anda untuk JWT. Ketika JWT ini disediakan, widget kemudian akan memasukkannya sebagai bagian dari permintaan obrolan pelanggan akhir ke Connect Customer. Connect Customer kemudian menggunakan kunci rahasia untuk mendekripsi token. Jika berhasil, ini mengonfirmasi bahwa JWT dikeluarkan oleh server web Anda dan Connect Customer merutekan permintaan obrolan ke agen pusat kontak Anda.
Spesifikasi Token Web JSON
-
Algoritma: HS256
-
Klaim:
-
sub:
widgetIdGanti
widgetIddengan widgetID Anda sendiri. Untuk menemukan widgetID Anda, lihat contoh di. Skrip widget komunikasi -
iat: *Diterbitkan Pada Waktu.
-
exp: *Kedaluwarsa (maksimum 10 menit).
-
SegmentAttributes (opsional): Satu set pasangan kunci-nilai yang ditentukan sistem yang disimpan pada segmen kontak individu menggunakan peta atribut. Untuk informasi lebih lanjut, periksa SegmentAttributes di StartChatContact API.
-
atribut (opsional): Objek dengan pasangan nilai-kunci string-ke-string. Atribut kontak harus mengikuti batasan yang ditetapkan oleh StartChatContact API.
-
terkait ContactId (opsional): String dengan id kontak yang valid. Yang terkait ContactId harus mengikuti batasan yang ditetapkan oleh StartChatContact API.
-
CustomerID (opsional): Ini bisa berupa ID Profil Pelanggan Hubungkan atau pengenal khusus dari sistem eksternal, seperti CRM.
* Untuk informasi tentang format tanggal, lihat dokumen Internet Engineering Task Force (IETF) berikut: JSON Web Token (JWT)
, halaman 5. -
Cuplikan kode berikut menunjukkan contoh cara menghasilkan JWT di Python:
import jwt import datetime CONNECT_SECRET = "your-securely-stored-jwt-secret" WIDGET_ID = "widget-id" JWT_EXP_DELTA_SECONDS = 500 payload = { 'sub': WIDGET_ID, 'iat': datetime.datetime.utcnow(), 'exp': datetime.datetime.utcnow() + datetime.timedelta(seconds=JWT_EXP_DELTA_SECONDS), 'customerId': "your-customer-id", 'relatedContactId':'your-relatedContactId', 'segmentAttributes': {"connect:Subtype": {"ValueString" : "connect:Guide"}}, 'attributes': {"name": "Jane", "memberID": "123456789", "email": "Jane@example.com", "isPremiumUser": "true", "age": "45"} } header = { 'typ': "JWT", 'alg': 'HS256' } encoded_token = jwt.encode((payload), CONNECT_SECRET, algorithm="HS256", headers=header) // CONNECT_SECRET is the security key provided by Amazon Connect
Skrip widget komunikasi
Gambar berikut menunjukkan contoh JavaScript yang Anda sematkan di situs web tempat Anda ingin pelanggan mengobrol dengan agen. Skrip ini menampilkan widget di sudut kanan bawah situs web Anda.
Saat situs web Anda dimuat, pelanggan pertama kali melihat ikon Mulai. Ketika mereka memilih ikon ini, widget komunikasi terbuka dan pelanggan dapat mengirim pesan ke agen Anda.
Untuk membuat perubahan pada widget komunikasi kapan saja, pilih Edit.
catatan
Perubahan yang disimpan memperbarui pengalaman pelanggan dalam beberapa menit. Konfirmasikan konfigurasi widget Anda sebelum menyimpannya.
Untuk membuat perubahan pada ikon widget di situs web, Anda akan menerima cuplikan kode baru untuk memperbarui situs web Anda secara langsung.
Mendapat pesan kesalahan?
Jika Anda menemukan pesan kesalahan, lihatMemecahkan masalah dengan widget komunikasi Connect Customer.