

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

# Integrasikan Amazon Connect Contact Lens dengan sistem suara eksternal
<a name="contact-lens-integration"></a>

Migrasi pusat kontak dari sistem eksternal ke cloud bisa jadi rumit. Ini membutuhkan pemindahan banyak komponen yang berbeda seperti telepon, IVR, ACD, perekaman panggilan, analitik panggilan, dan banyak lagi. Namun, dengan mengintegrasikan sistem eksternal Anda dengan Contact Lens for analytics, Anda dapat mempercepat migrasi ke Amazon Connect. Inilah cara langkah pertama ini dapat menguntungkan bisnis Anda:
+ Contact Lensintegrasi meningkatkan kemampuan perekaman dan analitik pusat kontak eksternal yang ada.
+ Ini memberikan kesempatan untuk melatih administrator, manajer, dan agen pusat kontak Anda di Amazon Connect. 
+ Contact Lensmembantu mengungkap tren, masalah, dan tema utama dari interaksi pelanggan yang terjadi di beberapa sistem suara seperti pusat kontak eksternal atau solusi suara yang dihadapi pelanggan (misalnya, konsultasi telepon, penasihat keuangan, atau manajer hubungan perbankan).

Diagram berikut menunjukkan bagaimana audio panggilan suara mengalir antara sistem suara eksternal Anda danContact Lens. Anda menggunakan Contact Lens Konektor untuk mengirim replika audio pusat kontak Anda keContact Lens. Alur panggilan eksternal terus beroperasi seperti biasa untuk agen Anda, sambil Contact Lens menyediakan analitik real-time dan pasca-panggilan menggunakan audio panggilan yang direplikasi. 

![\[Diagram konseptual yang menunjukkan bagaimana audio panggilan suara mengalir antara sistem suara eksternal Anda danContact Lens.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/contactlens-connector-diagram.png)


1. Panggilan yang dikirim melalui PSTN mendarat di sistem suara eksternal Anda.

1. Salinan audio panggilan hanya-baca akan di-fork ke Amazon Connect.

1. Aliran dimulai untuk panggilan. Contact LensKonektor merutekan panggilan keAmazon Connect Contact Lens.

## Persyaratan
<a name="contact-lens-integration-requirements"></a>

Sebelum Anda mulai menyiapkan Contact Lens integrasi, periksa apakah Amazon Connect dan sistem eksternal memenuhi persyaratan berikut:
+ Verifikasi instans Amazon Connect Anda dibuat di [AWS Wilayah yang didukung](regions.md#contactlens_region). Pastikan sistem suara eksternal Anda dapat terhubung ke Wilayah.
+ Pastikan perangkat eksternal yang memulai sesi SIPREC dan sistem suara yang digunakan untuk panggilan didukung. Untuk daftar sistem yang didukung, lihat `ContactCenterSystemTypes` dan `SessionBorderControllerTypes` [PutVoiceConnectorExternalSystemsConfiguration](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_PutVoiceConnectorExternalSystemsConfiguration.html)di Amazon Chime API. Biasanya sesi SIPREC adalah Session Border Controller (SBC) dan sistem suara adalah pusat kontak Anda.
+ Pastikan Anda memiliki dukungan SIPREC atau kemampuan untuk menambahkan SIPREC ke sistem sumber yang akan mengirim audio panggilan replika SIPREC ke. Contact Lens 

## Siapkan langkah-langkah
<a name="contact-lens-integration-steps"></a>

Berikut ini adalah ringkasan langkah-langkah yang akan Anda ambil untuk mengatur Contact Lens integrasi dengan sistem suara eksternal Anda. Topik terkait memberikan detail lebih lanjut.
+ [Buat instans Amazon Connect](amazon-connect-instances.md) jika Anda belum memilikinya.
  + Anda tidak perlu mengklaim nomor telepon ke Amazon Connect untuk mengintegrasikan denganContact Lens. 
  + [Tambahkan agen](user-management.md) dan [atur hierarki agen](agent-hierarchy.md). Ini akan membantu Anda menghubungkan analitik yang dihasilkan oleh Contact Lens agen tertentu. 
**catatan**  
Jika tidak ada agen yang diidentifikasi untuk panggilan, panggilan replika akan Contact Lens berakhir. Tidak ada analisis rekaman dan percakapan yang diproduksi. Untuk informasi selengkapnya, lihat [Menyediakan metadata panggilan untuk integrasi Contact Lens](callmetadata-contactlens-integration.md).
+ [Kuota layanan permintaan meningkat](https://docs.aws.amazon.com/servicequotas/latest/userguide/request-quota-increase.html) untuk kuota berikut di akun Amazon Connect Anda: 
  + **Contact Lenskonektor per akun**
  + **Sesi perekaman aktif maksimum dari sistem suara eksternal per instans**
**penting**  
Setelah kuota layanan Anda diminta dan disetujui, Contact Lens integrasi akan terlihat di konsol Amazon Connect dan situs web Amazon Connect admin.
+ [Buat Contact Lens konektor](create-contact-lens-connector.md) di konsol Amazon Connect.
+ [Konfigurasikan SBC Anda](configure-external-voice-system.md) untuk mengirim audio SIPREC ke host konektor itu bersama dengan metadata panggilan.
+ [Aktifkan Contact Lens konektor di situs web Amazon Connect admin](enable-contactlens-integration.md). Anda melakukan ini dengan menetapkan izin profil keamanan berikut ke Admin dan pengguna lain yang perlu mengakses konektor: Contact Lens
  + **Analisis dan Optimasi - Contact Lens konektor - Lihat** dan **Edit**. Izin **Lihat** memungkinkan Anda melihat daftar Contact Lens konektor yang tersedia. Izin **Edit** memungkinkan Anda untuk mengaitkan alur dengan Contact Lens konektor.
  + **Channels and Flows - Flows - View**: Izin ini memungkinkan Anda melihat alur yang tersedia yang dapat Anda kaitkan dengan Contact Lens konektor.

  Hanya pengguna yang memiliki izin ini yang dapat mengakses Contact Lens konektor di situs web Amazon Connect admin.
+ Buat alur untuk menentukan cara memproses audio panggilan termasuk perekaman, analisis langsung atau posting panggilan, dan [kaitkan alur dengan Contact Lens konektor](associate-contactlens-integration.md). 
+ Secara opsional, buat Lambda yang dapat dipanggil saat alur Amazon Connect dipicu. Gunakan Lambda untuk mengurai permintaan SIPREC dan data meta panggilan tambahan, dan mengambil tindakan. Untuk informasi selengkapnya, lihat [Hubungi metadata untuk integrasi Contact Lens](callmetadata-contactlens-integration.md).

# Buat Contact Lens konektor untuk diintegrasikan dengan sistem suara eksternal Anda
<a name="create-contact-lens-connector"></a>

Topik ini menjelaskan cara membuat Contact Lens konektor untuk diintegrasikan dengan sistem suara eksternal Anda. Selesaikan langkah-langkah berikut:

1. Buka konsol Amazon Connect di [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).

1. Pada halaman instance, pilih alias instance. Alias instance juga merupakan **nama instans** Anda, yang muncul di URL Amazon Connect Anda. Gambar berikut menunjukkan halaman **instance pusat kontak virtual Amazon Connect**, dengan kotak di sekitar alias instance.  
![\[Halaman instans pusat kontak virtual Amazon Connect, alias instans.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/instance.png)

1. Di konsol Amazon Connect, di panel navigasi, pilih **Sistem suara eksternal**, **Contact Lensintegrasi**, lalu pilih **Buat Contact Lens konektor**, seperti yang ditunjukkan pada gambar berikut.  
![\[Halaman Contact Lens integrasi, tombol Buat Contact Lens konektor.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/contact-lens-create-connector.png)

1. Pada halaman **Contact Lenskonektor**, ketikkan nama ramah untuk konektor.

1. Di bawah **Jenis sumber konektor**, gunakan menu tarik-turun untuk memilih dari daftar jenis sumber konektor yang tersedia. Biasanya ini adalah Session Boarder Controller (SBC) eksternal yang akan memulai sesi SIPREC. Gambar berikut menunjukkan contoh daftar dropdown jenis sumber.  
![\[Halaman Contact Lens konektor, daftar tarik-turun tipe sumber Connect.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/contact-lens-connector-source-types.png)

1. Di bawah **Jenis sistem suara**, gunakan daftar tarik-turun untuk memilih sistem suara yang digunakan untuk panggilan. Biasanya ini adalah sistem pusat kontak eksternal Anda. Gambar berikut menunjukkan contoh daftar dropdown jenis sistem suara.  
![\[Halaman Contact Lens konektor, daftar dropdown tipe sistem suara.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/contact-lens-voice-system-types.png)

1. Aktifkan **Enkripsi** dan **Pencatatan** pesan metrik SIP dan Media. 
   + Amazon Chime SDK Voice Connector menggunakan sertifikat server TLS yang dikeluarkan oleh Amazon Trust Services. Sebagian besar sistem operasi modern mempercayai Amazon Trust Services secara default. Jika ini tidak berlaku untuk infrastruktur SIP Anda dan Anda mengaktifkan enkripsi, Anda mungkin perlu menambahkan sertifikat root CA Starfield dan Amazon Trust Services, tidak termasuk akar UE, ke toko kepercayaan Anda. Anda dapat menemukan sertifikat ini [di sini](https://www.amazontrust.com/repository/). 
   + Meskipun logging bersifat opsional, kami sarankan Anda mengaktifkannya untuk membantu Anda men-debug masalah integrasi.

1.  Di bagian **Alamat IP Sumber**, Anda dapat mengonfigurasi berbagai alamat IP Sumber yang diizinkan untuk mengirim suara ke konektor ini.

1. Di bagian **Kredensial - opsional**, kami sarankan Anda membuat kredensyal. Mereka dapat membantu mengotentikasi sesi SIPREC.
**catatan**  
Jika Anda melakukan ini, Anda harus memberikan kredensyal yang sama ketika Anda mengkonfigurasi sistem eksternal Anda.

1. Secara opsional, tambahkan tag untuk mengidentifikasi, mengatur, mencari, memfilter, dan mengontrol siapa yang dapat mengakses konektor ini. Untuk informasi selengkapnya, lihat [Tambahkan tag ke sumber daya di Amazon Connect](tagging.md).

1. Pilih **Buat Contact Lens konektor** untuk membuat konektor. Setelah konektor dibuat, pesan sukses ditampilkan.

1. Pada halaman **Contact Lensintegrasi** Anda akan melihat nama host pendek. Ini adalah host yang sistem suara eksternal Anda akan mengirim lalu lintas suara SIPREC ke. 

   Saat mengonfigurasi sistem suara eksternal, Anda akan menggunakan nama domain host yang sepenuhnya memenuhi syarat, bukan nama host pendek ini.   
![\[Halaman Contact Lens integrasi, nama host pendek konektor.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/contact-lens-connector-shorthostname.png)

1. Anda selesai membuat Contact Lens konektor. Lanjutkan ke langkah berikutnya: [Konfigurasikan sistem suara eksternal Anda untuk integrasi dengan Contact Lens](configure-external-voice-system.md).

# Konfigurasikan sistem suara eksternal Anda untuk integrasi dengan Contact Lens
<a name="configure-external-voice-system"></a>

Setelah Anda [membuat Contact Lens konektor](create-contact-lens-connector.md), Anda perlu mengkonfigurasi sistem suara eksternal Anda untuk menunjuk ke konektor. Selesaikan langkah-langkah berikut:

1. Di panel navigasi konsol Amazon Connect, pilih **Sistem suara eksternal**, **Contact Lensintegrasi**. Anda akan melihat nama Contact Lens konektor yang tersedia. Pilih salah satu yang ingin Anda gunakan. Gambar berikut menunjukkan Contact Lens konektor contoh bernama **MyTestConnector**.  
![\[Halaman Contact Lens integrasi, sebuah konektor contoh bernama MyTestConnector.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/contactlens-connector-name.png)

1. Pada halaman detail konektor, perhatikan nama host yang sepenuhnya memenuhi syarat. Ini adalah nama host di Amazon Connect yang akan menerima audio SIPREC. Gambar berikut menunjukkan contoh nama host yang sepenuhnya memenuhi syarat.  
![\[Halaman MyTestConnector detail, nama host yang sepenuhnya memenuhi syarat yang akan menerima audio SIPREC.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/contactlens-connector-detailspage.png)

1. **Untuk informasi tentang cara mengonfigurasi sistem sumber eksternal, buka halaman sumber [daya Amazon Chime SDK](https://aws.amazon.com/chime/chime-sdk/resources/?whats-new-chime-sdk.sort-by=item.additionalFields.postDateTime&whats-new-chime-sdk.sort-order=desc), dan pilih Panduan Konfigurasi.** Gulir ke bawah halaman ke **Panduan Konfigurasi SIPREC/NBR**, seperti yang ditunjukkan pada gambar berikut.  
![\[Panduan Konfigurasi di halaman sumber daya Amazon Chime SDK.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/configuration-guides.png)
**catatan**  
Jika Anda membuat kredensyal untuk konektor, Anda perlu menggunakan kredensyal yang sama untuk sistem eksternal Anda.

1. Setelah Anda mengonfigurasi sistem sumber eksternal Anda, lanjutkan ke langkah berikutnya: [aktifkan Contact Lens integrasi](enable-contactlens-integration.md).

# Transfer kontak model dan konferensi di Amazon Connect
<a name="model-contact-transfers-conferencing"></a>

Topik ini untuk pengembang yang telah mengintegrasikan sistem suara eksternal mereka dengan Amazon Connect Contact Lens. 

Sistem suara eksternal Anda dapat mendukung transfer kontak (dingin dan hangat) dan konferensi beberapa agen dalam satu panggilan. Anda dapat memberi sinyal kasus ini ke Amazon Connect dengan memanggil [CreateContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateContact.html)dan [StopContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StopContact.html) APIs. Ini APIs membuat rantai kontak yang mirip dengan kontak suara Amazon Connect asli. Setiap kaki panggilan akan mendapatkan rekaman, catatan kontak, dan analitiknya sendiri, seperti kontak suara Amazon Connect asli. 

Setiap interaksi agen-pelanggan dimodelkan oleh segmen kontak independen.
+ Untuk memodelkan penambahan agen ke panggilan yang sedang berlangsung, Anda membuat segmen kontak baru menggunakan [CreateContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateContact.html)API dengan metode `TRANSFER` inisiasi. Kontak transfer ditautkan ke kontak sebelumnya oleh mereka`previousContactId`. 
+ Jika diaktifkan, rekaman panggilan dibuat secara independen untuk setiap segmen kontak dan dikirim setelah menyelesaikan segmen tersebut.
+ Contact Lensanalitik real-time dan pasca-panggilan dibuat untuk setiap segmen kontak secara independen. 
+ Catatan kontak dihasilkan untuk setiap segmen kontak independen.
+ Untuk memodelkan agen yang meninggalkan panggilan, Anda dapat mengakhiri segmen kontak dengan memanggil [StopContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StopContact.html)API.

## Alur kerja untuk transfer hangat
<a name="workflow-warm-transfer"></a>

Transfer hangat melibatkan penundaan pelanggan saat agen membuat pengantar tentang penelepon ke pihak lain.

Untuk memodelkan transfer hangat menggunakan kontak APIs, terapkan alur kerja berikut:

1. Panggilan di sistem suara eksternal Anda membuat segmen kontak awal.

1. Saat agen baru bergabung dengan panggilan, panggil API. [CreateContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateContact.html) Gunakan segmen kontak awal `contactId` sebagai `PreviousContactId` parameter. Berikan ID agen baru di `UserInfo` parameter.

1. Biarkan agen awal memperkenalkan agen baru ke panggilan dan kemudian memutuskan sambungan dari panggilan.

1. Saat agen awal terputus dari panggilan, panggil API. [StopContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StopContact.html)

1. Ketika panggilan berakhir di sistem suara eksternal Anda (setelah SIP BYE), rantai kontak berakhir.

## Alur kerja untuk transfer dingin
<a name="workflow-cold-transfer"></a>

Transfer dingin melibatkan transfer langsung pelanggan dari satu agen ke agen lain tanpa pengenalan atau konteks yang dibagi di antara mereka.

Untuk memodelkan transfer dingin menggunakan kontak APIs, terapkan alur kerja berikut:

1. Panggilan di sistem suara eksternal Anda membuat segmen kontak awal.

1. Saat agen awal terputus dari panggilan, panggil API. [StopContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StopContact.html)

1. Saat agen baru bergabung dengan panggilan, panggil API. [CreateContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateContact.html) Gunakan segmen kontak awal `contactId` sebagai `PreviousContactId` parameter. Berikan ID agen baru di `UserInfo` parameter.

1. Ketika panggilan berakhir di sistem suara eksternal Anda (setelah SIP BYE), rantai kontak berakhir.

## Batas segmen kontak
<a name="contact-segment-limits"></a>

Anda dapat memiliki hingga dua segmen kontak bersamaan dan 10 segmen kontak total dalam sebuah rantai.

# Aktifkan Amazon Connect Contact Lens integrasi
<a name="enable-contactlens-integration"></a>

Setelah Anda membuat Contact Lens konektor, Anda perlu mengaktifkan integrasi dengan menetapkan izin profil keamanan pengguna sehingga mereka dapat mengaksesnya di situs web Amazon Connect admin.

1. Masuk ke situs web Amazon Connect admin di https://*nama instance* .my.connect.aws/ menggunakan akun Admin.

1. Pada bilah navigasi, pilih **Profil keamanan**. Pada halaman **Kelola profil keamanan**, pilih **Admin**, **Edit**. 

1. Pada halaman **Edit profil keamanan**, pilih **Saluran dan Aliran** - **AnalyticsConnectors**- **Lihat** dan **Edit** izin, lalu pilih **Simpan**. 
**penting**  
Jika Anda tidak melihat izin Contact Lens konektor di **Channels and Flows**, kuota layanan permintaan meningkat untuk kuota berikut di akun Amazon Connect Anda:  
Contact Lenskonektor per akun
Sesi perekaman aktif maksimum dari sistem suara eksternal per instans

1. Tetapkan izin ini ke profil keamanan untuk pengguna yang ingin Anda akses Contact Lens konektornya. 
**catatan**  
Anda hanya dapat menghapus Contact Lens konektor terakhir di instans Amazon Connect ketika akses ke Contact Lens konektor dihapus dari pengguna instance tersebut.  
Jika Anda mencoba menghapus Contact Lens konektor terakhir tanpa terlebih dahulu menghapus akses Contact Lens konektor dari pengguna contoh itu, pesan kesalahan berikut akan ditampilkan: **kesalahan - Gagal menghapus konektor \$1connector-name\$1 dengan kesalahan: Izin konektor analitik sedang digunakan dalam profil keamanan**.

1. Setelah Anda menerapkan izin, pengguna yang memilikinya akan dapat melihat opsi **Contact Lenskonektor** di menu navigasi kiri situs web Amazon Connect admin, seperti yang ditunjukkan pada gambar berikut.  
![\[Menu kiri di situs web Amazon Connect admin, Contact Lens opsi.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/contact-lens-connector-menuitem.png)

1. Anda selesai mengaktifkan Contact Lens konektor. Lanjutkan ke langkah berikutnya: [kaitkan Contact Lens konektor dengan aliran](associate-contactlens-integration.md).

# Kaitkan Contact Lens konektor dengan aliran
<a name="associate-contactlens-integration"></a>

Setelah Anda [mengonfigurasi](configure-external-voice-system.md) SBC eksternal Anda untuk menunjuk ke host konektor Contact Lens integrasi, Anda perlu mengonfigurasi bagaimana audio akan diproses saat mencapaiAmazon Connect Contact Lens. Untuk melakukan ini, Anda menentukan langkah pemrosesan audio dalam alur Amazon Connect. Ini menentukan langkah-langkah apa yang akan dilalui audio panggilan, termasuk menjalankan analisis Contact Lens percakapan.

Selesaikan langkah-langkah berikut untuk membuat aliran yang memungkinkanContact Lens, dan kemudian kaitkan aliran dengan Contact Lens konektor. Alur ini akan dipanggil saat Contact Lens konektor menerima audio panggilan.

1. Di situs web Amazon Connect admin, buat alur yang menggunakan file[Mengatur perilaku perekaman dan analitik](set-recording-behavior.md). Konfigurasikan blok untuk mengaktifkan **perekaman suara Agen dan pelanggan**, **analitik Contact Lens ucapan**, dan **perekaman panggilan interaksi otomatis**. Akhiri aliran dengan [Alur akhir/Lanjutkan](end-flow-resume.md) blok. Konfigurasi ini ditunjukkan pada gambar berikut. 

   Untuk daftar blok yang dapat Anda gunakan dalam Contact Lens integrasi, lihat[Blok aliran yang didukung untuk Contact Lens integrasi](contactlens-integration-supportedflowblocks.md).   
![\[Halaman properti dari blok Setel perilaku perekaman dan analitik.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/contactlens-connector-setblock.png)

   Untuk petunjuk mendetail, lihat [Aktifkan analisis percakapan](enable-analytics.md).

1. Pada menu navigasi, pilih **Saluran**, **Contact Lenskonektor**. Pilih konektor Contact Lens integrasi yang ingin Anda kaitkan dengan alur. Di bidang **Nama aliran**, mulailah mengetik nama alur Anda untuk menampilkan daftar, lalu pilih alirannya.   
![\[Halaman Konektor, daftar alur yang tersedia.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/contactlens-connector-flow.png)

# Menyediakan metadata panggilan untuk integrasi Contact Lens
<a name="callmetadata-contactlens-integration"></a>

Di Amazon Connect, setiap interaksi dengan pelanggan adalah kontak Amazon Connect. Setiap sesi suara yang datang melalui Contact Lens konektor membuat kontak Amazon Connect. Konektor membuat kontak Amazon Connect menggunakan bidang yang disediakan dalam metadata panggilan. Metadata panggilan menyertakan ID pengguna agen dan ID antrian agen untuk panggilan streaming dalam metadata panggilan. 

Anda dapat memberikan ID pengguna agen dan metadata panggilan lainnya ke Contact Lens konektor dengan menggunakan parameter metadata SIPREC yang didukung dalam SIP INVITE sesi streaming audio. Konektor mem-parsing bidang metadata panggilan berikut dan menambahkan informasi ini ke kontak Amazon Connect.


| Panggil Bidang Negara | Metadata SIPREC | Nilai | Jika tidak disediakan | 
| --- | --- | --- | --- | 
| ID pengguna agen | AmznConnectAgentUserId | ID pengguna agen Amazon Connect | Diperlukan | 
| Id antrian | AmznConnectQueueId | ID antrian Amazon Connect | Opsional. Jika tidak disediakan, antrean default instans Amazon Connect akan digunakan. | 
| Pesanan peserta | AmznConnectParticipantOrder | Nilai valid: asc, desc | Opsional. Jika tidak disediakan, urutan naik digunakan. Amazon Connect mengurutkan aliran SIPREC dengan menggunakan label. Aliran pertama dalam urutan label adalah agen dan yang kedua adalah penelepon. | 

Kontak harus memiliki ID pengguna agen Amazon Connect. Contact Lensmulai menangkap audio yang dialirkan, dan menghasilkan perekaman panggilan dan analisis panggilan, hanya ketika AgenTid disediakan. 

Jika agentid tidak ada maka sesi Contact Lens konektor Amazon Connect dihentikan. Jika metadata SIPREC Anda tidak diuraikan secara otomatis oleh Contact Lens konektor Amazon Connect dan ID pengguna agen tidak disetel, Anda dapat membuat lambda aliran dan mengakses semua metadata SIP dan SIPREC menggunakan bidang berikut:


| Atribut | Deskripsi | JSONPath Referensi | 
| --- | --- | --- | 
| Metadata SIPREC | Metadata SIPREC dari acara SIP | \$1. Media.Sip. SiprecMetadata | 
| Header SIP | Header SIP dari acara SIP. \$1SIP header name\$1 adalah nama header SIP yang disediakan dalam acara SIP. Misalnya, “Ke”, “Dari”, dan lainnya. | \$1.Media.Sip.Header. \$1Nama header SIP\$1 | 

Untuk informasi selengkapnya, lihat [Atribut metadata panggilan telepon (atribut panggilan)](connect-attrib-list.md#telephony-call-metadata-attributes).

## Cara menggunakan metadata acara
<a name="howto-correlate-eventscalls"></a>

Amazon Connect menerbitkan SIP, streaming, dan acara kontak. Peristiwa ini termasuk metadata yang dikumpulkan dari SIPREC SIP INVITE dari panggilan. Metadata mencakup Metadata SIPREC, header SIP, fromNumber, Tonumber, dan lainnya. Berikut adalah beberapa hal yang dapat Anda lakukan dengan metadata acara ini:

1. Anda dapat memproses metadata dalam peristiwa ini untuk menentukan pengenal unik Anda sendiri untuk panggilan dan menghubungkan panggilan dengan sistem Anda sendiri.

1.  Anda kemudian dapat menambahkan pengenal unik untuk panggilan ke atribut kontak panggilan dengan menggunakan [Tetapkan atribut kontak](set-contact-attributes.md) blok.

1.  Anda dapat mencari berdasarkan atribut kontak khusus di situs web Amazon Connect admin untuk menemukan kontak untuk panggilan pihak ketiga di dua instans Amazon Connect.

Untuk informasi tentang cara membuat fungsi Lambda Amazon Connect flow, lihat. [Berikan Amazon Connect akses ke AWS Lambda fungsi Anda](connect-lambda-functions.md) Untuk daftar semua atribut kontak yang didukung yang dapat Anda akses di Lambda alur, lihat. [Daftar atribut kontak yang tersedia di Amazon Connect dan JSONPath referensinya](connect-attrib-list.md)

# Blok aliran yang didukung untuk Contact Lens integrasi
<a name="contactlens-integration-supportedflowblocks"></a>

Tabel berikut mencantumkan blok alur yang dapat Anda gunakan untuk menentukan cara Amazon Connect memproses sesi streaming audio. 

**Atur blok**


| Blok aliran | Efek | Deskripsi | 
| --- | --- | --- | 
| Atur Antrian Kerja | Tidak Ada Efek | Set Antrian Kerja | 
| Tetapkan Atribut Kontak | Didukung | Menyimpan pasangan kunci-nilai sebagai atribut kontak. Anda menetapkan nilai yang kemudian direferensikan dalam aliran. | 
| Dapatkan Metrik Antrian | Tidak Ada Efek | Mendapat metrik antrian | 
| Ubah prioritas/usia perutean | Tidak Ada Efek | mengubah prioritas routing kontak | 
| Atur Aliran Tahan | Tidak Ada Efek | Menentukan alur untuk memanggil ketika pelanggan atau agen ditunda. | 
| Atur Aliran Bisikan | Tidak Ada Efek | Menentukan alur untuk memanggil ketika pelanggan atau agen bergabung dalam percakapan suara atau obrolan. | 
| Tetapkan Nomor callback | Tidak Ada Efek | Tentukan atribut untuk mengatur nomor callback. | 
| Setel Suara | Tidak Ada Efek | Mengatur bahasa dan suara text-to-speech (TTS) yang akan digunakan untuk alur kontak. | 
| Mengatur Antrian Pelanggan | Tidak Ada Efek | Menetapkan antrian pelanggan untuk aliran antrian pelanggan | 
| Atur Aliran Putus | Tidak Ada Efek | Mengatur aliran pemutusan untuk aliran antrian pemutusan | 
| Atur alur acara | Tidak Ada Efek | Menentukan aliran mana yang akan dijalankan selama acara kontak. | 
| Tetapkan kriteria perutean | Tidak Ada Efek | Menetapkan kriteria routing untuk kontak. | 

**Menganalisis blok**


| Blok aliran | Efek | Deskripsi | 
| --- | --- | --- | 
| Mengatur perilaku Perekaman dan Analisis | Didukung | Menetapkan opsi untuk merekam dan mengaktifkan fitur diContact Lens. | 
| Mengatur perilaku logging | Didukung | Mengaktifkan atau menonaktifkan log aliran | 

**Blok logika**


| Blok aliran | Efek | Deskripsi | 
| --- | --- | --- | 
| Distribusikan berdasarkan persentase | Didukung | Rutekan kontak secara acak berdasarkan persentase | 
| Loop | Didukung | Mengeksekusi cabang perulangan untuk jumlah waktu tertentu | 

**Blok cabang**


| Blok aliran | Efek | Deskripsi | 
| --- | --- | --- | 
| Periksa Status Antrian | Tidak Ada Efek | Memeriksa Status Antrian | 
| Periksa Kepegawaian | Tidak Ada Efek | Memeriksa kepegawaian dalam antrian | 
| Periksa jam operasi | Didukung | Cabang berdasarkan jam operasi yang ditentukan. | 
| Periksa Atribut Kontak | Didukung | Cabang berdasarkan perbandingan dengan nilai atribut kontak. | 

**Integrasikan blok**


| Blok aliran | Efek | Deskripsi | 
| --- | --- | --- | 
| Buat Tugas | Didukung | Membuat tugas baru secara manual atau dengan memanfaatkan template tugas. | 
| Profil pelanggan | Didukung | Memungkinkan Anda untuk mengambil, membuat, dan memperbarui profil pelanggan. | 
| Memanggil AWS Lambda | Didukung | Memanggil AWS Lambda, dan secara opsional mengembalikan pasangan nilai kunci. | 
| Invoke modul | Didukung | Memanggil modul yang diterbitkan, yang memungkinkan Anda membuat bagian alur kontak yang dapat digunakan kembali. | 

**Hentikan/Transfer blok**


| Blok aliran | Efek | Deskripsi | 
| --- | --- | --- | 
| Putuskan/Hangup | Didukung | Putuskan kontak dan akhiri sesi streaming audio. | 
| Aliran Akhir | Didukung | Mengakhiri aliran arus tanpa memutuskan kontak. | 

# Siapkan redundansi multi-wilayah untuk integrasi Contact Lens
<a name="contactlens-integration-multiregion"></a>

Redundansi multi-wilayah memungkinkan Anda untuk menskalakan sistem suara eksternal Anda untuk keandalan, kinerja, dan efisiensi tertinggi. Anda dapat mendukung redundansi multi-wilayah menggunakan instans replika Amazon Connect. 

## Konfigurasi redundansi aktif/pasif
<a name="contactlens-multiregion-ap"></a>

Anda dapat membuat satu instans Amazon Connect di satu Wilayah (misalnya, US East (Virginia N.)) dan instance replika di Wilayah lain (misalnya, US West (Oregon)). Anda kemudian dapat mengonfigurasi sistem suara eksternal Anda untuk mengirim SIPREC SIP INVITE ke Wilayah utama. Jika instans Amazon Connect di Wilayah utama gagal, Anda dapat memperbarui sistem suara eksternal ke failover ke replika instans Amazon Connect di Wilayah pasif.

## Konfigurasi redundansi aktif/aktif
<a name="contactlens-multiregion-aa"></a>

Anda dapat menerapkan strategi aktif-aktif dengan mengalirkan audio secara bersamaan ke kedua instans Amazon Connect. Untuk menerapkan strategi ini, konfigurasikan sistem suara eksternal Anda untuk mengalirkan audio secara bersamaan ke dua Wilayah terpisah. Di setiap Wilayah, Contact Lens integrasi akan melakukan hal berikut:

1. Buat kontak Amazon Connect sendiri.

1. Menangkap aliran audio untuk membuat rekaman panggilan

1. Lakukan Contact Lens analisis

Pendekatan ini mengharuskan Anda untuk mereplikasi semua konfigurasi pusat kontak Amazon Connect secara manual. Namun, Anda dapat menggunakan Amazon Connect Global Resiliency dan itu akan mereplikasi semua pengaturan instans Amazon Connect di seluruh Wilayah secara otomatis. Lihat informasi yang lebih lengkap di [Siapkan Ketahanan Global Amazon Connect](setup-connect-global-resiliency.md). 