View a markdown version of this page

Hubungkan acara kontak Pelanggan - Pelanggan Amazon Connect

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

Hubungkan acara kontak Pelanggan

Dengan Connect Customer, Anda dapat berlangganan aliran acara kontak (panggilan suara, obrolan, tugas, dan email) yang hampir real-time (misalnya, panggilan dalam antrean) di pusat kontak Connect Customer Anda.

Anda dapat menggunakan acara kontak untuk membuat dasbor analitik untuk memantau dan melacak aktivitas kontak, mengintegrasikan ke dalam solusi manajemen tenaga kerja (WFM) untuk lebih memahami kinerja pusat kontak, atau untuk mengintegrasikan aplikasi yang bereaksi terhadap peristiwa (misalnya, panggilan terputus) secara real-time.

catatan

Saat kami menambahkan fitur dan jenis acara baru, kami memperbarui model data acara kontak dengan bidang baru. Semua perubahan model data mempertahankan kompatibilitas mundur.

Saat mengembangkan aplikasi, rancang untuk menangani bidang baru dan jenis acara dengan anggun. Aplikasi Anda harus:

  • Abaikan bidang yang baru ditambahkan yang tidak dirancang untuk diproses.

  • Terus berfungsi saat jenis acara baru diperkenalkan.

Pendekatan ini membantu memastikan aplikasi Anda tetap stabil saat layanan berkembang.

Model data acara kontak

Peristiwa kontak dihasilkan dalam JSON. Untuk setiap jenis acara, blob JSON dikirim ke target pilihan Anda, seperti yang dikonfigurasi dalam aturan. Acara kontak berikut tersedia:

  • AMD_DISABLED - Deteksi mesin penjawab dinonaktifkan.

  • DIMULAI - Panggilan suara, obrolan, tugas, atau email dimulai atau ditransfer.

  • CONNECTED_TO_SYSTEM - Kontak telah menetapkan media (misalnya, dijawab oleh seseorang atau melalui pesan suara). Acara ini dihasilkan untuk salah satu AnsweringMachineDetectionStatus kode.

    catatan

    Acara ini dibuat untuk tugas panggilan keluar (termasuk kampanye keluar Hubun gkan Pelanggan), dan obrolan.

  • CONTACT_DATA_UPDATED - Satu atau lebih properti kontak berikut diperbarui pada panggilan suara, obrolan, tugas, atau email: stempel waktu terjadwal (hanya tugas), diterima oleh stempel waktu agen (kontak suara kampanye keluar hanya dalam mode panggilan pratinjau), atribut dan tag yang ditentukan pengguna, kriteria perutean diperbarui atau langkah kedaluwarsa, dan jika analitik percakapan diaktifkan untuk kontak tertentu.

  • ANTRIED - Panggilan suara, obrolan, tugas, atau email diantri untuk ditugaskan ke agen.

  • CONNECTED_TO_AGENT - Panggilan suara, obrolan, tugas, atau email terhubung ke agen.

  • SELESAI - Acara SELESAI menunjukkan kapan kontak telah sepenuhnya berakhir, termasuk After Contact Work (ACW) jika berlaku.

    • Untuk kontak dengan ACW:

      Saat agen menyelesaikan ACW untuk panggilan suara, obrolan, tugas, atau email, kolom berikut diisi:

      • AgentInfo.afterContactWorkStartTimestamp

      • agen Info.afterContactWorkEndTimestamp

      • agen Info.afterContactWorkDuration

    • Untuk kontak tanpa ACW:

      Bidang-bidang ini tidak diisi ketika:

      • Tidak ada agen yang hadir dalam kontak.

      • Agen tidak memasuki ACW.

      Dalam kasus ini, acara COMPLETED dipublikasikan segera setelah peristiwa DISCONNECT dengan data yang sama.

    catatan

    Untuk kontak obrolan, jika agen mengalihkan statusnya ke offline tanpa menghapus kontak dengan benar di Panel Kontrol Kontak (CCP), masalah berikut mungkin terjadi:

    • Acara SELESAI mungkin tidak dikirimkan.

    • Ini AfterContactWorkEndTimestamp mungkin menunjukkan perbedaan.

  • TERPUTUS - Panggilan suara, obrolan, tugas, atau email terputus. Untuk panggilan keluar, upaya panggilan tidak berhasil, upaya terhubung tetapi panggilan tidak diambil, atau upaya menghasilkan nada https://en.wikipedia.org/wiki/Special_information_tone SIT.

    Peristiwa pemutusan adalah ketika:

    • Panggilan suara berakhir ketika pelanggan menutup telepon, agen menutup telepon, atau panggilan terputus karena masalah telekomunikasi atau jaringan.

    • Obrolan, atau tugas terputus.

    • Tugas terputus sebagai akibat dari tindakan aliran.

    • Tugas berakhir. Tugas secara otomatis terputus ketika menyelesaikan timer kadaluwarsa. Defaultnya adalah 7 hari dan kedaluwarsa tugas dapat dikonfigurasi hingga 90 hari.

  • DIJEDA - Kontak tugas aktif dijeda.

  • DILANJUTKAN - Kontak tugas yang dijeda dilanjutkan.

  • WEBRTC_API - Kontak menggunakan widget komunikasi untuk melakukan panggilan dalam aplikasi ke agen voice/video .

AgentInfo

Ob AgentInfo jek mencakup properti berikut:

AgentArn

Nama Sumber Daya Amazon (ARN) untuk akun agen.

Tipe: ARN

AgentInitiatedHoldDuration

Total durasi penahanan dalam detik yang diprakarsai oleh agen.

Jenis: Integer

AfterContactWorkStartTimestamp

Tanggal dan waktu ketika agen mulai melakukan After Contact Work untuk kontak tersebut, dalam waktu UTC.

Jenis: String (yyyy- MM-dd 'T' HH:mm:ss.SSS 'Z')

AfterContactWorkEndTimestamp

Tanggal dan waktu ketika agen mengakhiri After Contact Work untuk kontak tersebut, dalam waktu UTC. Dalam kasus ketika agen selesai melakukan AfterContactWork untuk kontak obrolan dan mengalihkan status aktivitas mereka ke offline atau setara tanpa menghapus kontak di CCP, perbedaan mungkin terlihat. AfterContactWorkEndTimestamp

Jenis: String (yyyy- MM-dd 'T' HH:mm:ss.SSS 'Z')

AfterContactWorkDuration

Perbedaan waktu, dalam seluruh detik, antara AfterContactWorkStartTimestamp danAfterContactWorkEndTimestamp.

Jenis: Integer

AcceptedByAgentTimestamp

Tanggal dan waktu kontak suara kampanye keluar dalam mode panggilan pratinjau diterima oleh agen, dalam waktu UTC.

Jenis: String (yyy Thh:mm:ssZ y-mm-dd)

PreviewEndTimestamp

Tanggal dan waktu agen selesai melihat pratinjau kontak suara kampanye keluar dalam mode panggilan pratinjau, dalam waktu UTC.

Jenis: String (yyy Thh:mm:ssZ y-mm-dd)

HierarchyGroups

Grup hierarki agen untuk agen.

Tipe: ARN

AttributeCondition

Objek untuk menentukan kondisi atribut yang telah ditentukan sebelumnya.

Name

Nama atribut yang telah ditentukan.

Tipe: String

Panjang: 1-64

Value

Nilai atribut yang telah ditentukan.

Tipe: String

Panjangnya: 1-64

ComparisonOperator

Operator perbandingan kondisi.

Tipe: String

Nilai yang valid: NumberGreaterOrEqualTo, Cocokkan, Rentang

ProficiencyLevel

Tingkat kemahiran kondisi.

Tipe: Float

Nilai yang valid: 1.0, 2.0, 3.0, 4.0 dan 5.0

Range

Objek untuk menentukan tingkat kemahiran minimum dan maksimum.

Tipe: Range object

MatchCriteria

Objek untuk didefinisikan AgentsCriteria.

Tipe: Objek MatchCriteria

AgentsCriteria

Objek untuk mendefinisikan AgenTids.

Tipe: Objek AgentsCriteria

AgentIds

Objek untuk menentukan daftar agen, berdasarkan ID Agen.

Tipe: Array string

Batasan Panjang: Panjang maksimum 256

Kampanye

Informasi yang terkait dengan kampanye.

Jenis: Ob https://docs.aws.amazon.com/connect/latest/APIReference/API_Campaign.html jek kampanye

Kontak acara

Ob Contact jek mencakup properti berikut:

ContactId

Pengidentifikasi untuk kontak.

Tipe: String

Panjang: 1-256

InitialContactId

Pengidentifikasi kontak awal.

Tipe: String

Panjang: 1-256

RelatedContactId

ContactID yang https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_Item.html terkait dengan kontak ini.

Tipe: String

Panjang: Minimal 1. Maksimal 256.

PreviousContactId

Pengidentifikasi asli dari kontak yang ditransfer.

Tipe: String

Panjang: 1-256

Saluran

Jenis saluran.

Jenis:VOICE,CHAT,TASK, atau EMAIL

InstanceArn

Nama Sumber Daya Amazon (ARN) untuk instance Connect Customer tempat akun pengguna agen dibuat.

Tipe: ARN

InitiationMethod

Menunjukkan bagaimana kontak dimulai.

Nilai valid:

  • INBOUND: Pelanggan memulai kontak suara (telepon) atau email dengan pusat kontak Anda.

  • OUTBOUND: Merupakan panggilan suara atau email keluar yang diprakarsai agen dari Panel Kontrol Kontak (CCP).

  • TRANSFER: Kontak ditransfer oleh agen ke agen lain atau ke antrian, menggunakan koneksi cepat di CCP. Ini menghasilkan catatan kontak baru yang dibuat.

  • CALLBACK: Pelanggan dihubungi sebagai bagian dari aliran panggilan balik. Untuk informasi lebih lanjut tentang InitiationMethod skenario ini, lihatPanggilan balik yang diantri dalam metrik real-time di Connect Customer.

  • API: Kontak dimulai dengan Connect Customer by API. Ini bisa berupa kontak keluar yang Anda buat dan antri ke agen, menggunakan StartOutboundVoiceContact API, atau bisa berupa obrolan langsung yang diprakarsai oleh pelanggan dengan pusat kontak Anda, tempat Anda memanggil StartChatContact API, atau bisa berupa tugas yang diprakarsai oleh pelanggan dengan memanggil StartTaskContact API, atau bisa berupa email yang diprakarsai oleh pelanggan dengan memanggil API. StartEmailContact

  • QUEUE_TRANSFER: Sementara kontak adalah satu antrian, dan kemudian ditransfer ke antrian lain menggunakan blok aliran.

  • EXTERNAL_OUTBOUND: Agen memulai kontak suara (telepon) dengan peserta eksternal ke pusat kontak Anda menggunakan koneksi cepat di CCP atau blok aliran.

  • MONITOR: Seorang supervisor memulai monitor pada agen. Supervisor dapat secara diam-diam memantau agen dan pelanggan, atau menghentikan percakapan.

  • DISCONNECT: Ketika Atur aliran pemutusan blok dipicu, ini menentukan aliran mana yang akan dijalankan setelah peristiwa pemutusan.

    Peristiwa pemutusan adalah ketika:

    • Panggilan suara berakhir ketika pelanggan menutup telepon, agen menutup telepon, atau panggilan terputus karena masalah telekomunikasi atau jaringan.

    • Obrolan, atau tugas terputus.

    • Tugas terputus sebagai akibat dari tindakan aliran.

    • Tugas berakhir. Tugas secara otomatis terputus ketika menyelesaikan timer kadaluwarsa. Defaultnya adalah 7 hari dan kedaluwarsa tugas dapat dikonfigurasi hingga 90 hari.

    Ketika peristiwa pemutusan terjadi, aliran konten yang sesuai berjalan. Jika kontak baru dibuat saat menjalankan aliran pemutusan, maka metode inisiasi untuk kontak baru tersebut adalah DISCONNECT.

  • AGENT_REPLY: Merupakan kontak email balasan agen yang sesuai dengan kontak email masuk yang diterima oleh agen.

  • FLOW: Merupakan kontak email otomatis (yang diprakarsai alur).

  • CAMPAIGN_PREVIEW: Kontak diprakarsai oleh kampanye keluar menggunakan mode panggilan pratinjau. Agen melihat pratinjau informasi pelanggan sebelum panggilan dilakukan.

DisconnectReason kode

Menunjukkan bagaimana kontak dihentikan. Ini tersedia untuk kontak kampanye keluar di mana koneksi media gagal.

Nilai valid:

  • OUTBOUND_DESTINATION_ENDPOINT_ERROR: Konfigurasi saat ini tidak mengizinkan tujuan ini dipanggil (misalnya, memanggil tujuan titik akhir dari instance yang tidak memenuhi syarat).

  • OUTBOUND_RESOURCE_ERROR: Instans memiliki izin yang tidak mencukupi untuk melakukan panggilan keluar atau sumber daya yang diperlukan tidak ditemukan.

  • OUTBOUND_ATTEMPT_FAILED: Ada kesalahan yang tidak diketahui, parameter tidak valid, atau izin yang tidak mencukupi untuk memanggil API.

  • OUTBUND_PREVIEW_DISCARDED: Tidak ada kontak yang dibuat; penerima dihapus dari daftar; tidak ada upaya lebih lanjut yang akan dilakukan.

  • KEDALUWARSA: Tidak cukup agen yang tersedia, atau kapasitas telekomunikasi tidak cukup untuk panggilan tersebut.

  • DISCARDED: Merupakan bahwa agen membuang kontak email.

AnsweringMachineDetectionStatus

Menunjukkan bagaimana panggilan kampanye keluar sebenarnya dibuang jika kontak terhubung ke Connect Customer.

Tipe: String

Nilai valid:

  • HUMAN_ANSWERED: Nomor yang dihubungi dijawab oleh seseorang.

  • VOICEMAIL_BEEP: Nomor yang dipanggil dijawab oleh voicemail dengan bunyi bip.

  • VOICEMAIL_NO_BEEP: Nomor yang dipanggil dijawab oleh pesan suara tanpa bunyi bip.

  • AMD_UNANSWERED: Nomor yang dipanggil terus berdering, tetapi panggilan tidak diambil.

  • AMD_UNRESOLVED: Nomor yang dipanggil terhubung tetapi deteksi mesin penjawab tidak dapat menentukan apakah panggilan diambil oleh seseorang atau pesan suara.

  • AMD_UNRESOLVED_SILENCE: Nomor yang dipanggil terhubung tetapi deteksi mesin penjawab mengamati keheningan.

  • AMD_NOT_APPLICABLE: Panggilan terputus sebelum berdering, dan tidak ada media untuk mendeteksi.

  • SIT_TONE_BUSY: Nomor yang dipanggil sibuk.

  • SIT_TONE_INVALID_NUMBER: Nomor yang dipanggil bukan nomor yang valid.

  • SIT_TONE_DETECTED: Nada informasi khusus (SIT) terdeteksi.

  • FAX_MACHINE_DETECTED: Mesin faks terdeteksi.

  • AMD_ERROR: Nomor yang dipanggil terhubung, tetapi ada kesalahan dalam deteksi mesin penjawab.

EventType

Jenis acara yang dipublikasikan.

Tipe: String

Nilai yang valid: INITIED, CONNECTED_TO_SYSTEM, CONTACT_DATA_UPDATED, QUEUED, CONNECTED_TO_AGENT, TERPUTUS, DIJEDA, DILANJUTKAN, SELESAI

UpdatedProperties

Jenis properti diperbarui.

Tipe: String

Nilai yang valid: ScheduledTimestamp,, UserDefinedAttributes ContactLens.ConversationalAnalytics.Configuration, Atribut Segmen, Tag, GlobalResiliencyMetadata

AgentInfo

Agen yang ditugaskan untuk kontak.

Tipe: Objek AgentInfo

QueueInfo

Antrian tempat kontak ditempatkan.

Tipe: Objek QueueInfo

ContactLens

Informasi analitik percakapan jika analitik percakapan diaktifkan pada alur.

Jenis: Untuk informasi selengkapnya tentang ContactLens objek, lihatContactLens.

SegmentAttributes

Satu set pasangan nilai kunci yang ditentukan sistem yang disimpan pada segmen kontak individu menggunakan peta atribut. Atribut adalah Connect Customer atribut standar dan dapat diakses dalam aliran. Kunci atribut hanya dapat mencakup karakter alfanumerik, -, dan _.

Bidang ini dapat digunakan untuk menampilkan subtipe saluran. Misalnya, connect:Guide atau connect:SMS.

Tipe: SegmentAttributes

Anggota:SegmentAttributeName, SegmentAttributeValue

Tags

Tag yang terkait dengan kontak. Ini berisi tag AWS yang dihasilkan dan ditentukan pengguna.

Tipe: Peta string ke string

CustomerId

Nomor identifikasi pelanggan. Misalnya, CustomerId mungkin nomor pelanggan dari CRM Anda. Anda dapat membuat fungsi Lambda untuk menarik ID pelanggan unik penelepon dari sistem CRM Anda. Jika Anda mengaktifkan kemampuan Connect Customer Voice ID, atribut ini diisi dengan nama CustomerSpeakerId pemanggil.

Tipe: String

ChatMetrics

Informasi tentang bagaimana agen, bot, dan pelanggan berinteraksi dalam kontak obrolan.

ChatContactMetrics

Informasi tentang interaksi peserta secara keseluruhan di tingkat kontak.

Tipe: Objek ChatContactMetrics

CustomerMetrics

Informasi tentang interaksi pelanggan dalam kontak.

Tipe: Objek ParticipantMetrics

AgentMetrics

Informasi tentang interaksi agen dalam kontak.

Tipe: Objek ParticipantMetrics

GlobalResiliencyMetadata

Informasi tentang konfigurasi ketahanan global untuk kontak, termasuk detail distribusi lalu lintas.

Tipe: Objek GlobalResiliencyMetadata

CustomerVoiceActivity

Ob CustomerVoiceActivity jek mencakup properti berikut:

GreetingStartTimestamp

Tanggal dan waktu yang mengukur awal salam pelanggan dari panggilan suara keluar, dalam waktu UTC.

Jenis: String (yyyy- MM-dd 'T' HH:mm:ss.SSS 'Z')

GreetingEndTimestamp

Tanggal dan waktu yang mengukur akhir salam pelanggan dari panggilan suara keluar, dalam waktu UTC.

Jenis: String (yyyy- MM-dd 'T' HH:mm:ss.SSS 'Z')

Kedaluwarsa

Objek untuk menentukan kedaluwarsa langkah routing.

DurationInSeconds

Jumlah detik yang harus menunggu sebelum kedaluwarsa langkah routing.

Tipe: Integer

Nilai min: 1

ExpiryTimestamp

Stempel waktu yang menunjukkan kapan langkah routing berakhir.

Tipe: String (yyyy-mm-ddThh:mm:ssZ)

Ekspresi

Serikat yang ditandai untuk menentukan ekspresi untuk langkah routing.

AndExpression

Daftar ekspresi routing yang akan AND-ed bersama.

Tipe: Expression

Nilai min: 0

OrExpression

Daftar ekspresi routing yang akan OR-ed bersama.

Tipe: Expression

AttributeCondition

Objek untuk menentukan kondisi atribut yang telah ditentukan sebelumnya.

Tipe: AttributeCondition

NotAttributeCondition

Objek untuk menentukan kondisi atribut yang telah ditentukan untuk mengecualikan agen dengan kemahiran tertentu.

Tipe: AttributeCondition

GlobalResiliencyMetadata

Informasi tentang konfigurasi ketahanan global untuk kontak, termasuk detail distribusi lalu lintas.

ActiveRegion

Wilayah AWS saat ini tempat kontak aktif. Ini menunjukkan di mana kontak sedang diproses secara real-time.

Tipe: String

Batasan Panjang: Panjang minimum 0. Panjang maksimum 1024.

OriginRegion

Wilayah AWS tempat kontak awalnya dibuat dan dimulai. Ini mungkin berbeda dari ActiveRegion jika kontak telah ditransfer di seluruh Wilayah.

Tipe: String

Batasan Panjang: Panjang minimum 0. Panjang maksimum 1024.

TrafficDistributionGroupId

Pengidentifikasi grup distribusi lalu lintas.

Tipe: String

Pola: ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$

QueueInfo

Ob QueueInfo jek mencakup properti berikut:

QueueArn

Nama Sumber Daya Amazon (ARN) untuk antrian.

Tipe: String

QueueType

Jenis antrian.

Tipe: String

RoutingCriteria

Daftar kriteria routing. Setiap kali kriteria routing diperbarui pada kontak, itu akan ditambahkan ke daftar ini.

ActivationTimestamp

Stempel waktu yang menunjukkan kapan kriteria routing diatur ke aktif. Kriteria routing diaktifkan ketika kontak ditransfer ke antrian.

ActivationTimestamp akan ditetapkan pada kriteria routing untuk kontak dalam antrian agen meskipun kriteria Routing tidak pernah diaktifkan untuk kontak dalam antrian agen.

Tipe: String (yyyy-mm-ddThh:mm:ssZ)

Index

Informasi tentang indeks kriteria routing.

Tipe: Integer

Nilai min: 0

Steps

Daftar langkah routing.

Jenis: Daftar objek Step

Panjangnya: 1-5

Langkah-langkah

Ketika Amazon Connect tidak menemukan agen yang tersedia yang memenuhi persyaratan dalam satu langkah untuk durasi langkah tertentu, kriteria routing akan beralih ke langkah berikutnya secara berurutan hingga bergabung selesai dengan agen. Ketika semua langkah habis, kontak akan ditawarkan kepada agen mana pun dalam antrian.

Status

Merupakan status langkah Routing.

Tipe: String

Nilai Valid: EXPIRED, ACTIVE, JOINED, INACTIVE, DEACTIVATED, INTERRUPTED

Expression

Objek untuk menentukan ekspresi langkah routing..

Tipe: Expression

Expiry

Objek untuk menentukan kedaluwarsa langkah routing.

Tipe: Expiry

SystemEndpoint

Titik akhir sistem. Misalnya, untuk INBOUND, ini adalah nomor telepon yang dihubungi pelanggan atau alamat email tempat pelanggan menghubungi. Untuk OUTBOUND dan EXTERNAL_OUTBOUND, ini adalah nomor ID pemanggil keluar yang ditetapkan untuk antrian keluar yang digunakan untuk memanggil pelanggan atau alamat email keluar yang ditetapkan ke antrian keluar yang digunakan untuk menjangkau pelanggan.

catatan

Bidang ini saat ini tidak diisi untuk kontak dengan metode inisiasi kontak CALLBACK, MONITOR, QUEUE_TRANSFER.

Type

Titik akhir

Titik akhir

Informasi tentang titik akhir. Di Amazon Connect, titik akhir adalah tujuan kontak, seperti nomor telepon pelanggan, atau nomor telepon untuk pusat kontak Anda.

Address

Nilai untuk jenis titik akhir. Untuk TELEPHONE_NUMBER, nilainya adalah nomor telepon dalam format. E.164

Tipe: String

Panjang: 1-256

Type

Tipe tiitik akhir Saat ini, titik akhir hanya dapat berupa nomor telepon.

Nilai Valid: TELEPHONE_NUMBER | VOIP | CONTACT_FLOW | CONNECT_PHONENUMBER_ARN | EMAIL_ADDRESS

DisplayName

Menampilkan nama titik akhir.

Tipe: String

Panjang: 0-256

Rekaman

Jika perekaman diaktifkan, ini adalah informasi tentang rekaman.

Type

Array dari RecordingsInfo

RecordingsInfo

Informasi tentang rekaman suara, transkrip obrolan, atau rekaman layar.

DeletionReason

Jika dihapus, ini adalah alasan yang dimasukkan untuk penghapusan. recording/transcript

Tipe: String

FragmentStartNumber

Nomor yang mengidentifikasi fragmen Kinesis Video Streams tempat aliran audio pelanggan dimulai.

Tipe: String

FragmentStopNumber

Nomor yang mengidentifikasi fragmen Kinesis Video Streams tempat aliran audio pelanggan berhenti.

Tipe: String

Location

Lokasi, di Amazon S3, untuk recording/transcript.

Tipe: String

Panjang: 0-256

MediaStreamType

Informasi tentang aliran media yang digunakan selama percakapan.

Tipe: String

Nilai Valid: AUDIO, VIDEO, CHAT

ParticipantType

Informasi tentang peserta percakapan: apakah mereka agen atau kontak. Berikut ini adalah tipe peserta:

  • Semua

  • pengelola

  • Agen

  • Pelanggan

  • Pihak Ketiga

  • Pengawas

Tipe: String

StartTimestamp

Ketika percakapan dari leg terakhir rekaman dimulai dalam waktu UTC.

Tipe: String (yyyy-MM-dd'T'HH:mm:ss.SSS'Z')

Status

Status dari recording/transcript.

Nilai Valid: AVAILABLE | DELETED | NULL

StopTimestamp

Ketika percakapan dari leg terakhir rekaman berhenti dalam waktu UTC.

Tipe: String (yyyy-MM-dd'T'HH:mm:ss.SSS'Z')

StorageType

Dimana recording/transcript disimpan.

Tipe: String

Nilai Valid: Amazon S3 | KINESIS_VIDEO_STREAM

ContactDetails

Adalah Peta kunci string, pasangan nilai yang berisi atribut yang ditentukan pengguna yang diketik dengan ringan di dalam kontak. Objek ini hanya digunakan untuk kontak tugas.

Key

Tipe: String

Panjang: 1-128

Value

Tipe: String

Panjang: 0-1024

ContactEvaluations

Informasi tentang evaluasi kontak di mana kuncinya adalah FormId - pengidentifikasi unik untuk formulir.

Type

Peta String, ContactEvaluation

ContactEvaluation

EvaluationArn

Nama Sumber Daya Amazon untuk formulir evaluasi. Itu selalu hadir.

Tipe: String

Status

Status evaluasi.

Tipe: String

Nilai Valid: COMPLETE, IN_PROGRESS, DELETED

StartTimestamp

Tanggal dan waktu ketika evaluasi dimulai, dalam waktu UTC.

Tipe: String (yyyy-MM-dd'T'HH:mm:ss.SSS'Z')

EndTimestamp

Tanggal dan waktu ketika evaluasi diajukan, dalam waktu UTC.

Tipe: String (yyyy-MM-dd'T'HH:mm:ss.SSS'Z')

DeleteTimestamp

Tanggal dan waktu ketika evaluasi dihapus, dalam waktu UTC.

Tipe: String (yyyy-MM-dd'T'HH:mm:ss.SSS'Z')

ExportLocation

Jalur di mana evaluasi diekspor.

Tipe: String

Panjang: 0-256

StateTransitions

Daftar StateTransition untuk supervisor.

Type

StateTransition

StateTransition

Informasi tentang transisi negara seorang supervisor.

StateStartTimestamp

Tanggal dan waktu ketika negara bagian dimulai dalam waktu UTC.

Tipe: String (yyyy-MM-dd'T'HH:mm:ss.SSS'Z')

StateEndTimestamp

Tanggal dan waktu ketika negara bagian berakhir dalam waktu UTC.

Tipe: String (yyyy-MM-dd'T'HH:mm:ss.SSS'Z')

State

Nilai Valid: SILENT_MONITOR | BARGE

OutboundStrategy

Informasi tentang strategi outbound.

Tipe: Objek OutboundStrategy

Stempel waktu kontak

InitiationTimestamp

Tanggal dan waktu kontak ini dimulai, dalam waktu UTC. Jika kontak suara dimulai sebagai bagian dari kampanye keluar, kontak InitiationTimestamp akan ditampilkan kapan kontak dimulai untuk acara yang Diprakarsai, dan akan diperbarui saat panggilan dimulai di acara berikutnya.

Jenis: String (yyyy- MM-dd 'T' HH:mm:ss.SSS 'Z')

ConnectedToSystemTimestamp

Tanggal dan waktu titik akhir pelanggan terhubung ke Connect Customer, dalam waktu UTC. Untuk INBOUND, ini cocok InitiationTimestamp. Untuk OUTBOUND, CALLBACK, dan API, ini adalah saat titik akhir pelanggan menjawab.

EnqueueTimestamp

Tanggal dan waktu kontak ditambahkan ke antrian, dalam waktu UTC.

Jenis: String (yyyy- MM-dd 'T' HH:mm:ss.SSS 'Z')

ConnectedToAgentTimestamp

Tanggal dan waktu kontak terhubung ke agen, dalam waktu UTC.

Jenis: String (yyyy- MM-dd 'T' HH:mm:ss.SSS 'Z')

DisconnectTimestamp

Tanggal dan waktu titik akhir pelanggan terputus dari kontak saat ini, dalam waktu UTC. Dalam skenario transfer, kontak sebelumnya menunjukkan tanggal dan waktu ketika that kontak berakhir. DisconnectTimestamp

Jenis: String (yyyy- MM-dd 'T' HH:mm:ss.SSS 'Z')

ScheduledTimestamp

Tanggal dan waktu ketika kontak ini dijadwalkan untuk memicu aliran berjalan, dalam waktu UTC. Ini hanya didukung untuk saluran tugas.

Jenis: String (yyyy- MM-dd 'T' HH:mm:ss.SSS 'Z')

RingStartTimestamp

Tanggal dan waktu dering dimulai untuk panggilan kampanye, dalam waktu UTC. Hubungkan Pelanggan mengisi kolom ini hanya untuk panggilan kampanye keluar.

Jenis: String (yyyy- MM-dd 'T' HH:mm:ss.SSS 'Z')

GreetingStartTimestamp

Tanggal dan waktu yang mengukur awal salam pelanggan dari panggilan suara keluar, dalam waktu UTC.

Jenis: String (yyyy- MM-dd 'T' HH:mm:ss.SSS 'Z')

GreetingEndTimestamp

Tanggal dan waktu yang mengukur akhir salam pelanggan dari panggilan suara keluar, dalam waktu UTC.

Jenis: String (yyyy- MM-dd 'T' HH:mm:ss.SSS 'Z')

ChatContactMetrics

Informasi tentang interaksi peserta secara keseluruhan di tingkat kontak.

MultiParty

Bendera Boolean yang menunjukkan apakah obrolan multipihak atau tongkang supervisor diaktifkan pada kontak ini.

Jenis: Boolean

TotalMessages

Jumlah pesan obrolan pada kontak.

Jenis: Integer

Nilai min: 0

TotalBotMessages

Jumlah total bot dan pesan otomatis pada kontak obrolan.

Jenis: Integer

Nilai min: 0

TotalBotMessageLengthInChars

Jumlah total karakter dari bot dan pesan otomatis pada kontak obrolan.

Jenis: Integer

Nilai min: 0

ConversationCloseTimeInMillis

Waktu yang dibutuhkan untuk kontak berakhir setelah pesan pelanggan terakhir.

Tipe: Long

Nilai min: 0

ConversationTurnCount

Jumlah percakapan yang berubah dalam kontak obrolan, yang mewakili pertukaran bolak-balik antara pelanggan dan peserta lain

Jenis: Integer

Nilai min: 0

AgentFirstResponseTimestamp

Stempel waktu respons pertama agen untuk kontak obrolan.

Jenis: String (yyyy- MM-dd 'T' HH:mm:ss.SSS 'Z')

AgentFirstResponseTimeInMillis

Waktu bagi agen untuk merespons setelah mendapatkan kontak obrolan.

Tipe: Long

Nilai min: 0

ParticipantMetrics

Informasi tentang interaksi peserta dalam kontak.

ParticipantId

Id Peserta.

Tipe: String

Panjangnya: 1-256

ParticipantType

Informasi tentang peserta percakapan. Berikut ini adalah tipe peserta: [Agen, Pelanggan, Supervisor].

Tipe: String

ConversationAbandon

Bendera Boolean yang menunjukkan apakah percakapan obrolan ditinggalkan oleh Peserta.

Jenis: Boolean

MessagesSent

Jumlah pesan obrolan yang dikirim oleh Peserta.

Jenis: Integer

Nilai min: 0

NumResponses

Jumlah pesan obrolan yang dikirim oleh Peserta.

Jenis: Integer

Nilai min: 0

MessageLengthInChars

Jumlah karakter obrolan yang dikirim oleh Peserta.

Jenis: Integer

Nilai min: 0

TotalResponseTimeInMillis

Total waktu respons obrolan oleh Peserta.

Tipe: Long

Nilai min: 0

MaxResponseTimeInMillis

Waktu respons obrolan maksimum oleh Peserta.

Tipe: Long

Nilai min: 0

LastMessageTimestamp

Stempel waktu pesan obrolan terakhir oleh Peserta.

Jenis: String (yyyy- MM-dd 'T' HH:mm:ss.SSS 'Z')

Berlangganan acara kontak Connect Customer

Acara kontak Connect Customer dipublikasikan menggunakan Amazon EventBridge, dan dapat diaktifkan dalam beberapa langkah untuk instance Connect Customer Anda di EventBridge konsol Amazon dengan membuat aturan baru. Meskipun acara tidak diurutkan, mereka memiliki stempel waktu yang dapat Anda gunakan untuk mengkonsumsi data.

Peristiwa dipancarkan atas dasar upaya terbaik.

Untuk berlangganan acara kontak Connect Customer:

  1. Di EventBridge konsol Amazon, pilih Buat aturan.

  2. Pada halaman detail aturan default, tetapkan nama untuk aturan, pilih A turan dengan pola peristiwa, lalu pilih Ber ikutnya, seperti yang ditunjukkan pada gambar berikut.

    Halaman detail tetapkan aturan di EventBridge konsol.
  3. Pada halaman Build event pattern, di bawah Event source, verifikasi bahwa AWS acara atau acara EventBridge mitra dipilih.

  4. Di bawah Jenis acara sampel, pilih AWS acara, lalu pilih Connect Customer Kontak A cara dari kotak dropdown, seperti yang ditunjukkan pada gambar berikut.

    Bagian acara sampel, jenis acara sampel adalah peristiwa AWS.
  5. Untuk metode penciptaan pilih Gunakan bentuk pola. Di bagian Pola acara, pilih AWS layanan, Connect Customer, Hu Connect Customer bungi A cara, lalu pilih Berikutnya, seperti yang ditunjukkan pada gambar berikut.

    Metode pembuatan dan bagian pola peristiwa dari halaman detail aturan default.
  6. Pada halaman Pilih target, Anda kemudian dapat memilih target pilihan Anda, yang mencakup fungsi Lambda, antrian SQS, atau topik SNS. Untuk informasi tentang mengonfigurasi target, Amazon EventBridge menargetkan.

  7. Secara opsional mengkonfigurasi tag. Pada halaman Tinjau dan buat, pilih Buat aturan.

Untuk informasi selengkapnya tentang mengonfigurasi aturan, lihat EventBridge aturan Amazon di Panduan EventBridge Pengguna Amazon.

Contoh untuk menghentikan streaming jenis acara

Contoh berikut menunjukkan cara menghentikan streaming CONTACT_DATA_UPDATED acara dari Connect Customer ke EventBridge.

{ "source": [ "aws.connect" ], "detail-type": [ "Amazon Connect Contact Event" ], "detail": { "eventType": [ { "anything-but": [ "CONTACT_DATA_UPDATED" ] } ] } }

Contoh acara kontak saat panggilan suara terhubung ke agen

{ "version": "0", "id": "abcabcab-abca-abca-abca-abcabcabcabc", "detail-type": "Amazon Connect Contact Event", "source": "aws.connect", "account": "111122223333", "time": "2021-08-04T17:43:48Z", "region": "your-region", "resources": [ "arn:aws:...", "contactArn", "instanceArn" ], "detail": { "initiationTimestamp":"2021-08-04T17:17:53.000Z", "contactId":"11111111-1111-1111-1111-111111111111", "channel":"VOICE", "instanceArn":"arn:aws::connect:your-region:123456789012:instance/12345678-1234-1234-1234-123456789012", "initiationMethod":"INBOUND", "eventType":"CONNECTED_TO_AGENT", "agentInfo":{ "agentArn":"arn:aws::connect:your-region:123456789012:instance/12345678-1234-1234-1234-123456789012/agent/12345678-1234-1234-1234-123456789012", "connectedToAgentTimestamp":"2021-08-04T17:29:09.000Z", "hierarchyGroups": { "level1": { "arn": "arn:aws:connect:your-region:012345678901:instance/12345678-1234-1234-1234-123456789012/agent-group/abcdefgh-1234-1234-1234-12345678901a" }, "level2": { "arn": "arn:aws:connect:your-region:012345678901:instance/12345678-1234-1234-1234-123456789012/agent-group/abcdefgh-1234-1234-1234-12345678901b" }, "level3": { "arn": "arn:aws:connect:your-region:012345678901:instance/12345678-1234-1234-1234-123456789012/agent-group/abcdefgh-1234-1234-1234-12345678901c" }, "level4": { "arn": "arn:aws:connect:your-region:012345678901:instance/12345678-1234-1234-1234-123456789012/agent-group/abcdefgh-1234-1234-1234-12345678901d" }, "level5": { "arn": "arn:aws:connect:your-region:012345678901:instance/12345678-1234-1234-1234-123456789012/agent-group/abcdefgh-1234-1234-1234-12345678901e" } } } }, "queueInfo": { "queueType":"type", "queueArn":"arn:aws::connect:your-region:123456789012:instance/12345678-1234-1234-1234-123456789012/queue/12345678-1234-1234-1234-123456789012", "enqueueTimestamp":"2021-08-04T17:29:04.000Z" }, "tags": { "aws:connect:instanceId":"12345678-1234-1234-1234-123456789012", "aws:connect:systemEndpoint":"+11234567890" } } }

Contoh acara kontak saat panggilan suara terputus

Contoh peristiwa berikut menunjukkan kontak yang memiliki tag yang ditentukan pengguna dengan Dept sebagai kunci. Perhatikan bahwa queueInfo tidak termasuk dalam acara yang diterima oleh EventBridge when initiationMethod isOUTBOUND.

{ "version": "0", "id": "the event ID", "detail-type": "Connect Customer Contact Event", "source": "aws.connect", "account": "111122223333", "time": "2021-08-04T17:43:48Z", "region": "your-region", "resources": [ "arn:aws:...", "contactArn", "instanceArn" ], "detail": { "eventType": "DISCONNECTED", "contactId": "11111111-1111-1111-1111-111111111111", "initialContactId": "11111111-2222-3333-4444-555555555555", "previousContactId": "11111111-2222-3333-4444-555555555555", "channel": "Voice", "instanceArn": "arn:aws::connect:your-region:123456789012:instance/12345678-1234-1234-1234-123456789012", "initiationMethod": "OUTBOUND", "initiationTimestamp":"2021-08-04T17:17:53.000Z", "connectedToSystemTimestamp":"2021-08-04T17:17:55.000Z", "disconnectTimestamp":"2021-08-04T17:18:37.000Z", "agentInfo": { "agentArn": "arn", "connectedToAgentTimestamp":"2021-08-04T17:29:09.000Z", "hierarchyGroups": { "level1": { "arn": "arn:aws:connect:your-region:012345678901:instance/12345678-1234-1234-1234-123456789012/agent-group/abcdefgh-1234-1234-1234-12345678901a" }, "level2": { "arn": "arn:aws:connect:your-region:012345678901:instance/12345678-1234-1234-1234-123456789012/agent-group/abcdefgh-1234-1234-1234-12345678901b" }, "level3": { "arn": "arn:aws:connect:your-region:012345678901:instance/12345678-1234-1234-1234-123456789012/agent-group/abcdefgh-1234-1234-1234-12345678901c" }, "level4": { "arn": "arn:aws:connect:your-region:012345678901:instance/12345678-1234-1234-1234-123456789012/agent-group/abcdefgh-1234-1234-1234-12345678901d" }, "level5": { "arn": "arn:aws:connect:your-region:012345678901:instance/12345678-1234-1234-1234-123456789012/agent-group/abcdefgh-1234-1234-1234-12345678901e" } } }, "CustomerVoiceActivity": { "greetingStartTimestamp":"2021-08-04T17:29:20.000Z", "greetingEndTimestamp":"2021-08-04T17:29:22.000Z" }, "tags": { "aws:connect:instanceId":"12345678-1234-1234-1234-123456789012", "aws:connect:systemEndpoint":"+11234567890", "Dept":"Finance" } } }

Contoh acara saat properti kontak diperbarui

{ "version": "0", "id": "the event ID", "detail-type": "Amazon Connect Contact Event", "source": "aws.connect", "account": "the account ID", "time": "2021-08-04T17:43:48Z", "region": "your-region", "resources": [ "arn:aws:...", "contactArn", "instanceArn" ], "detail": { "eventType": "CONTACT_DATA_UPDATED", "contactId": "the contact ID", "channel": "CHAT", "instanceArn": "arn:aws:connect:us-west-2:the account ID:instance/the instance ID", "initiationMethod": "API", "queueInfo": { "queueArn": "arn:aws:connect:us-west-2:the account ID:instance/the instance ID/queue/the queue ID", "enqueueTimestamp": "2023-10-24T02:39:15.240Z", "queueType": "STANDARD" }, "agentInfo": { "agentArn": "arn:aws:connect:us-west-2:the account ID:instance/the instance ID/agent/the agent ID", "connectedToAgentTimestamp": "1970-01-01T00:00:00.001Z", "hierarchyGroups": { "level1": { "arn": "arn:aws:connect:us-west-2:the account ID:instance/the instance ID/agent-group/the agent group ID" }, "level2": { "arn": "arn:aws:connect:us-west-2:the account ID:instance/the instance ID/agent-group/the agent group ID" }, "level3": { "arn": "arn:aws:connect:us-west-2:the account ID:instance/the instance ID/agent-group/the agent group ID" }, "level4": { "arn": "arn:aws:connect:us-west-2:the account ID:instance/the instance ID/agent-group/the agent group ID" } } }, "updatedProperties": ["ContactLens.ConversationalAnalytics.Configuration"], "initiationTimestamp": "2023-10-24T02:39:15.154Z", "connectedToSystemTimestamp": "1970-01-01T00:00:00.001Z", "tags": { "aws:connect:instanceId": "the instance ID" }, "contactLens": { "conversationalAnalytics": { "configuration": { "enabled": true, "channelConfiguration": { "analyticsModes": ["PostContact"] }, "languageLocale": "en-US", "redactionConfiguration": { "behavior": "Enable", "policy": "RedactedAndOriginal", "entities": ["EMAIL"], "maskMode": "EntityType" } } } } } }

Contoh peristiwa kontak saat panggilan suara terhubung ke agen menggunakan kriteria routing

{ "version": "0", "id": "abcabcab-abca-abca-abca-abcabcabcabc", "detail-type": "Amazon Connect Contact Event", "source": "aws.connect", "account": "111122223333", "time": "2021-08-04T17:43:48Z", "region": "your-region", "resources": [ "arn:aws:...", "contactArn", "instanceArn" ], "detail": { "ContactId": "12345678-1234-1234-1234-123456789012", "Channel": "VOICE", "InstanceArn": "arn:aws::connect:us-west-2:123456789012:instance/12345678-1234-1234-1234-123456789012", "InitiationMethod": "INBOUND", "EventType": "CONNECTED_TO_AGENT", "AgentInfo": { "AgentArn": "arn:aws::connect:us-west-2:123456789012:instance/12345678-1234-1234-1234-123456789012/agent/12345678-1234-1234-1234-123456789012", "ConnectedToAgentTimestamp": "2021-08-04T17:29:09.000Z" }, "QueueInfo": { "QueueType": "type", "QueueArn": "arn:aws::connect:us-west-2:123456789012:instance/12345678-1234-1234-1234-123456789012/queue/12345678-1234-1234-1234-123456789012", "EnqueueTimestamp": "2021-08-04T17:29:04.000Z" }, "tags": { "aws:connect:instanceId":"12345678-1234-1234-1234-123456789012", "aws:connect:systemEndpoint":"+11234567890" }, "RoutingCriteria": [{ "ActivationTimestamp": "2021-08-04T17:29:04.000Z", "Index": 0, "Steps": [{ "Status": "JOINED", "Expiry": { "DurationInSeconds": 60, }, "Expression": { "OrExpression": [{ "AttributeCondition": { "Name": "Technology", "ComparisonOperator": "NumberGreaterOrEqualTo", "ProficiencyLevel": 2.0, "Value": "AWS Kinesis" } }, { "AttributeCondition": { "Name": "Language", "ComparisonOperator": "NumberGreaterOrEqualTo", "ProficiencyLevel": 4.0, "Value": "English" } }], "AndExpression": [{ "AttributeCondition": { "Name": "Language", "ComparisonOperator": "NumberGreaterOrEqualTo", "ProficiencyLevel": 2.0, "Value": "Spanish" } }] } }] }] } }

Contoh peristiwa saat langkah perutean berakhir pada kontak

{ "version": "0", "id": "the event ID", "detail-type": "Amazon Connect Contact Event", "source": "aws.connect", "account": "the account ID", "time": "2021-08-04T17:43:48Z", "region": "your-region", "resources": [ "arn:aws:...", "contactArn", "instanceArn" ], "detail": { "eventType":"CONTACT_DATA_UPDATED", "contactId":"12345678-1234-1234-1234-123456789012", "channel":"CHAT", "instanceArn":"arn:aws::connect:us-west-2:123456789012:instance/12345678-1234-1234-1234-123456789012", "initiationMethod":"API", "queueInfo":{ "queueArn":"arn:aws:connect:us-west-2:123456789012:instance/12345678-1234-1234-1234-123456789012/queue/12345678-1234-1234-1234-123456789012", "enqueueTimestamp":"2023-11-01T18:33:03.062Z", "queueType":"STANDARD" }, "updatedProperties":["RoutingCriteria.Step.Status"], "initiationTimestamp":"2023-11-01T18:33:00.716Z", "connectedToSystemTimestamp":"2023-11-01T18:33:01.736Z", "tags":{ "aws:connect:instanceId":"12345678-1234-1234-1234-123456789012" }, "routingCriteria":{ "steps":[{ "expiry":{ "durationInSeconds":50, "expiryTimestamp":"2023-11-01T18:34:54.275Z" }, "expression":{ "attributeCondition":{ "name":"Location", "value":"AZ", "proficiencyLevel":3.0, "comparisonOperator":"NumberGreaterOrEqualTo" } }, "status":"EXPIRED" }, { "expiry":{ "durationInSeconds":10 }, "expression":{ "attributeCondition":{ "name":"Language", "value":"Spanish", "proficiencyLevel":4.0, "comparisonOperator":"NumberGreaterOrEqualTo" } }, "status":"ACTIVE" }, { "expression":{ "attributeCondition":{ "name":"Language", "value":"Spanish", "proficiencyLevel":1.0, "comparisonOperator":"NumberGreaterOrEqualTo" } }, "status":"INACTIVE" }], "activationTimestamp":"2023-11-01T18:34:04.275Z", "index":1 } } }

Contoh acara kontak ketika panggilan suara terhubung ke agen yang disediakan oleh pelanggan menggunakan kriteria routing

{ "version": "0", "id": "abcabcab-abca-abca-abca-abcabcabcabc", "detail-type": "Amazon Connect Contact Event", "source": "aws.connect", "account": "111122223333", "time": "2021-08-04T17:43:48Z", "region": "your-region", "resources": [ "arn:aws:...", "contactArn", "instanceArn" ], "detail": { "ContactId": "12345678-1234-1234-1234-123456789012", "Channel": "VOICE", "InstanceArn": "arn:aws::connect:us-west-2:123456789012:instance/12345678-1234-1234-1234-123456789012", "InitiationMethod": "INBOUND", "EventType": "CONNECTED_TO_AGENT", "AgentInfo": { "AgentArn": "arn:aws::connect:us-west-2:123456789012:instance/12345678-1234-1234-1234-123456789012/agent/12345678-1234-1234-1234-123456789012", "ConnectedToAgentTimestamp": "2021-08-04T17:29:09.000Z" }, "QueueInfo": { "QueueType": "type", "QueueArn": "arn:aws::connect:us-west-2:123456789012:instance/12345678-1234-1234-1234-123456789012/queue/12345678-1234-1234-1234-123456789012", "EnqueueTimestamp": "2021-08-04T17:29:04.000Z" }, "tags": { "aws:connect:instanceId":"12345678-1234-1234-1234-123456789012", "aws:connect:systemEndpoint":"+11234567890" }, "RoutingCriteria": [{ "ActivationTimestamp": "2021-08-04T17:29:04.000Z", "Index": 0, "Steps": [{ "Status": "JOINED", "Expiry": { "DurationInSeconds": 60, }, "Expression": { "AttributeCondition": { "ComparisonOperator": "Match", "MatchCriteria": { "AgentsCriteria": { "AgentIds": ["AGENT_1"] } } } } }] }] } }