View a markdown version of this page

Berikan atribut kontak ke agen di Panel Kontrol Kontak (CCP) saat obrolan dimulai - Pelanggan Amazon Connect
Cara meneruskan atribut kontak ke widget komunikasiMetode alternatif: Lewati atribut kontak langsung dari kode cuplikanHal-hal yang perlu Anda ketahui

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Berikan atribut kontak ke agen di Panel Kontrol Kontak (CCP) saat obrolan dimulai

Anda dapat menggunakan atribut kontak untuk menangkap informasi tentang kontak yang menggunakan widget komunikasi. Kemudian, Anda dapat menampilkan informasi tersebut kepada agen melalui Panel Kontrol Kontak (CCP), atau menggunakannya di tempat lain dalam alur.

Misalnya, Anda dapat menyesuaikan alur Anda untuk menyebut nama pelanggan di pesan selamat datang Anda. Atau, Anda dapat menggunakan atribut khusus untuk bisnis Anda, seperti account/member ID, pengenal pelanggan seperti nama dan email, atau metadata lain yang terkait dengan kontak.

Cara meneruskan atribut kontak ke widget komunikasi

  1. Aktifkan keamanan di widget komunikasi seperti yang dijelaskan dalamTambahkan antarmuka pengguna obrolan ke situs web Anda yang dihosting oleh Connect Customer, jika Anda belum melakukannya:

    1. Di Langkah 2, di bawah Tambah keamanan untuk widget obrolan Anda, pilih Ya.

    2. Pada Langkah 3, gunakan kunci keamanan untuk menghasilkan token web JSON.

  2. Tambahkan atribut kontak ke payload JWT Anda sebagai attributes klaim.

    Berikut ini adalah contoh bagaimana Anda dapat menghasilkan JWT dengan atribut kontak di Python:

    catatan

    JWT harus dipasang sebagai prasyarat. Untuk menginstalnya, jalankan pip install PyJWT di terminal Anda.

    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), 
'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

    Dalam payload, Anda harus membuat kunci string attributes (sebagaimana adanya, semua huruf kecil), dengan objek sebagai nilainya. Objek itu harus memiliki pasangan nilai-kunci string-ke-string. Jika sesuatu selain string diteruskan di salah satu atribut, obrolan akan gagal dimulai.

    Atribut kontak harus mengikuti batasan yang ditetapkan oleh StartChatContact API:

    • Kunci harus memiliki panjang minimal 1

    • Nilai dapat memiliki panjang minimum 0

Secara opsional, Anda dapat menambahkan string SegmentAttributes ke peta SegmentAttributeValue objek, di payload. Atribut adalah Connect Customer atribut standar. Mereka dapat diakses dalam aliran. Atribut kontak harus mengikuti batasan yang ditetapkan oleh StartChatContact API.

Metode alternatif: Lewati atribut kontak langsung dari kode cuplikan

catatan

  • Kode cuplikan ditambahkan HostedWidget- ke semua kunci atribut kontak yang dilewatkannya. Dalam contoh berikut, sisi agen akan melihat pasangan nilai kunciHostedWidget-foo: 'bar'.

  • Meskipun atribut ini dicakup dengan HostedWidget- awalan, mereka masih merupakan situs-klien yang dapat berubah. Gunakan pengaturan JWT jika Anda memerlukan PII atau data yang tidak dapat diubah dalam aliran Anda.

Contoh berikut menunjukkan cara meneruskan atribut kontak langsung dari kode cuplikan tanpa mengaktifkan keamanan widget. 

<script type="text/javascript">
  (function(w, d, x, id){ /* ... */ })(window, document, 'amazon_connect', 'widgetId');
  amazon_connect('snippetId', 'snippetId');
  amazon_connect('styles', /* ... */);
  // ...

  amazon_connect('contactAttributes', {
   foo: 'bar'
  })
<script/>

Menggunakan atribut dalam aliran

Blok Blok aliran di Hubungkan Pelanggan: Periksa atribut kontak aliran atribut kontak Periksa menyediakan akses ke atribut ini dengan menggunakan namespace yang ditentukan pengguna, seperti yang ditunjukkan pada gambar berikut. Anda dapat menggunakan blok aliran untuk menambahkan logika percabangan. Jalan lengkapnya adalah$.Attributes.HostedWidget-attributeName.

Gambar yang menunjukkan blok aliran yang bercabang ke prompt Valid dan Tidak Valid.

Hal-hal yang perlu Anda ketahui

  • Widget komunikasi memiliki batas 6144 byte untuk seluruh token yang dikodekan. Karena JavaScript menggunakan UTF-16 encoding, 2 byte digunakan per karakter, sehingga ukuran maksimum encoded_token harus sekitar 3000 karakter.

  • Encoded_token harus diteruskan ke. callback(data) Cup authenticate likan tidak memerlukan perubahan tambahan. Contoh:

    amazon_connect('authenticate', function(callback) {
  window.fetch('/token').then(res => {
    res.json().then(data => {
      callback(data.data);
    });
  });
});

  • Menggunakan JWT untuk meneruskan atribut kontak memastikan integritas data. Jika Anda melindungi rahasia bersama dan mengikuti praktik keamanan yang sesuai, Anda dapat membantu memastikan bahwa data tidak dapat dimanipulasi oleh aktor jahat.

  • Atribut kontak hanya dikodekan dalam JWT, tidak dienkripsi, sehingga dimungkinkan untuk memecahkan kode dan membaca atribut.

  • Jika Anda ingin menguji pengalaman obrolan dengan pengalaman obro lan simulasi dan menyertakan atribut kontak, pastikan untuk melampirkan kunci dan nilai dalam tanda kutip, seperti yang ditunjukkan pada gambar berikut.

    Halaman pengaturan pengujian, kunci atribut kontak dalam tanda kutip, nilai dalam tanda kutip.