View a markdown version of this page

Hubungkan skema acara ID Suara Pelanggan - Pelanggan Amazon Connect
Bidang umum dalam acaraMulai Tindakan SesiPerbarui Tindakan SesiEvaluasi Tindakan SesiAksi PembicaraTindakan PenipuEnrollBySessionStartSpeakerEnrollmentJobStartFraudsterRegistrationJob

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

Hubungkan skema acara ID Suara Pelanggan

catatan

Pemberitahuan akhir dukungan: Pada 20 Mei 2026, dukungan untuk ID Amazon Connect Customer Suara AWS akan berakhir. Setelah 20 Mei 2026, Anda tidak akan lagi dapat mengakses ID Suara di Amazon Connect Customer konsol, mengakses fitur ID Suara di situs web Connect Customer admin atau Panel Kontrol Kontak, atau mengakses sumber daya ID Suara. Untuk informasi selengkapnya, kunjungi Amazon Connect Customer Voice ID akhir dukungan.

Voice ID menghasilkan peristiwa untuk setiap transaksi: pendaftaran, otentikasi, atau deteksi penipu dalam daftar pantauan. Acara dikirim ke bus acara EventBridge default.

Anda dapat membuat pipeline analitik untuk hasil otentikasi ID Suara dan deteksi penipu dalam daftar pantauan dengan menggunakan EventBridge untuk memantau peristiwa ID Suara. Menggunakan skema yang tersedia dalam topik ini, Anda dapat mengonfigurasi EventBridge aturan untuk mendengarkan dan memfilter peristiwa ID Suara yang relevan, lalu memprosesnya melalui Amazon Data Firehose untuk disimpan di gudang data pilihan Anda.

Misalnya, Anda mungkin ingin pelacakan analisis ID Suara yang mendekati waktu nyata. Untuk melakukan itu, Anda dapat menarik semua Evaluate-Session acara, dan mendapatkan authenticationResult danfraudDetectionResult.

Peristiwa dipancarkan atas dasar upaya terbaik.

Bidang umum dalam acara

  • version- Versi data acara.

  • id- Pengidentifikasi unik dari acara yang dihasilkan oleh EventBridge

  • detail-type- Pengidentifikasi untuk detail acara.

  • source- Sumber acara. Ini selaluaws.voiceid.

  • account- ID AWS akun.

  • timestamp- Tanggal dan waktu acara dipublikasikan di UTC.

  • region- Wil AWS ayah tempat panggilan API dilakukan.

  • resources- Sumber daya yang digunakan oleh panggilan API.

  • detail- Rincian tentang acara:

    • detail.sourceId- ID unik yang dihasilkan oleh ID Suara yang dapat Anda gunakan untuk de-duplikasi.

    • detail.action- Analog dengan API yang dipanggil.

    • detail.status- Menentukan status tindakan: sukses atau gagal.

    • detail.errorInfo- Terisi ketika kesalahan tindakan yang ditentukan keluar di Voice ID.

Berikut ini adalah skema untuk peristiwa yang dipancarkan.

Mulai Tindakan Sesi

Memancarkan peristiwa pada awal aliran (setelah penyiapan), akhir aliran, dan pada kegagalan.

{...commonfields
    "detail-type": "VoiceId Start Session Action",
    "detail": {
        "sourceId": String,
        "action": "START_SESSION",
        "status": String,
        "domainId": String,
        "session": {
            "sessionId": String,
            "sessionName": String,
            "authenticationConfiguration": {
                "acceptanceThreshold":Integer
            },
            "fraudDetectionConfiguration": {
                "riskThreshold":Integer,
                "watchlistId": String
            },
            "streamingConfiguration": {
                "authenticationMinimumSpeechInSeconds": Integer
            },
            "enrollmentAudioProgress": {
                "audioAggregationStatus": String,
                "audioAggregationStartedAt": "Timestamp",
                "audioAggregationEndedAt": "Timestamp"
            },
            "authenticationAudioProgress": {
                "audioAggregationStartedAt": "Timestamp",
                "audioAggregationEndedAt": "Timestamp"
            },
            "fraudDetectionAudioProgress": {
                "audioAggregationStartedAt": "Timestamp",
                "audioAggregationEndedAt": "Timestamp"
            },
            "generatedSpeakerId": String
        },
        "errorInfo": {
            "errorMessage": String,
            "errorType": String,
            "errorCode": Integer
       }
    }
}

Perbarui Tindakan Sesi

Memancarkan peristiwa saat pembaruan sesi internal berhasil atau gagal.

{...commonfields
"detail-type": "VoiceId Update Session Action",
"detail": {
    "sourceId": String,
    "action": "UPDATE_SESSION",
    "status": String,
    "domainId": String,
    "session": {
        "sessionId": String,
        "sessionName": String,
        "authenticationConfiguration": {
            "acceptanceThreshold": Integer
        },
        "fraudDetectionConfiguration": {
            "riskThreshold": Integer,
            "watchlistId": String
        },
        "streamingConfiguration": {
            "authenticationMinimumSpeechInSeconds": Integer
        },
        "generatedSpeakerId": String
    },
    "errorInfo": {
        "errorMessage": String,
        "errorType": String,
        "errorCode": Integer
    }
}
}

Evaluasi Tindakan Sesi

Memancarkan peristiwa saat evaluasi sesi berhasil atau gagal. Alasannya bisa KNOWN_FRAUDSTER atau VOICE_SPOOFING.

{...commonfields
"detail-type": "VoiceId Evaluate Session Action",
"detail": {
    "sourceId": String,
    "action": "EVALUATE_SESSION",
    "status": String,
    "domainId": String,
    "session": {
        "sessionId": String,
        "sessionName": String,
        "generatedSpeakerId": String,
        "streamingStatus": String,
        "authenticationResult": {
            "authenticationResultId": String,
            "decision": String,
            "score": Integer,
            "audioAggregationStartedAt": "Timestamp",
            "audioAggregationEndedAt": "Timestamp",
            "configuration": {
                "acceptanceThreshold": Integer
            }
        },
        "fraudDetectionResult": {
            "fraudDetectionResultId": String,
            "decision": String,
            "reasons": [String],
            "audioAggregationStartedAt": "Timestamp",
            "audioAggregationEndedAt": "Timestamp",
            "configuration": {
                   "riskThreshold": Integer
            },
            "riskDetails": {
                 "knownFraudsterRisk": {
                         "generatedFraudsterId": String,
                         "riskScore": Integer,
                         "watchlistId": String
                  },
                  "voiceSpoofingRisk": {
                        "riskScore": Integer
                  } 
            }
         }
     },
     "errorInfo": {
        "errorMessage": String,
        "errorType": String,
        "errorCode": Integer
    }
}
}

Aksi Pembicara

Memancarkan peristiwa tentang keberhasilan atau kegagalan untuk memilih keluar pembicara, menghapus pembicara, atau mendaftarkan pembicara.

{...commonfields
"detail-type": "VoiceId Speaker Action",
"detail": {
    "sourceId": String,
    "domainID": String,
    "action": String,
    "status": String,
    "generatedSpeakerId": String,
    "data": {
        "enrollmentSource": String,
        "enrollmentSourceId": String,
        "enrollmentStatus": String
        },
    "errorInfo": {
        "errorMessage": String,
        "errorType": String,
        "errorCode": Integer
     }
}
}

Tindakan Penipu

Memancarkan peristiwa ketika penipu berhasil terdaftar atau dihapus.

Acara tidak dikirim ketika penipu dikaitkan atau dipisahkan dengan daftar pantauan.

{...commonfields
"detail-type": "VoiceId Fraudster Action",
"detail": {
    "sourceId": String,
    "domainID": String,
    "action": String,
    "status": String,
    "generatedFraudsterId": String,
    "watchlistIds": [String],
    "data": {
        "registrationSource": String,
        "registrationSourceId": String,
        "registrationStatus": String
    },
    "errorInfo": {
        "errorMessage": String,
        "errorType": String,
        "errorCode": Integer
    }
}
}

EnrollBySession

Memancarkan acara ini saat permintaan pendaftaran dikirimkan. Per Speaker istiwa dipancarkan ketika pendaftaran aktual berhasil atau gagal.

{...commonfields
"detail-type": "VoiceId Session Speaker Enrollment Action",
"detail": {
    "sourceId": String,
    "domainId": String,
    "action": "SESSION_ENROLLMENT_REQUEST",
    "status": String,
    "sessionId": String,
    "sessionName": String,
    "errorInfo": {
        "errorMessage": String,
        "errorType": String,
        "errorCode": Integer
    }
}
}

StartSpeakerEnrollmentJob

Memancarkan peristiwa ini saat permintaan pendaftaran batch dikirimkan, berhasil, atau gagal. Sebuah Speaker acara dipancarkan untuk masing-masing pembicara individu untuk menunjukkan apakah pendaftaran yang sesuai berhasil atau gagal.

{...commonfields
"detail-type": "VoiceID Batch Speaker Enrollment Action",
"detail": {
    "sourceId": String,
    "domainId": String,
    "action": "BATCH_ENROLLMENT_REQUEST",
    "status": String,
    "batchJobId": String,
    "data": {
        "dataAccessRoleArn": String,
        "enrollmentConfig": {
            "existingEnrollmentAction": String,
            "fraudDetectionConfig": {
            "fraudDetectionAction": String,
            "riskThreshold": Integer,
            "watchlistIds": [String],
            }
        },
        "inputDataConfig": {
            "s3Uri": String
         },
        "outputDataConfig": {
            "s3Uri": String,
            "kmsKeyId": String
        }
    },
    "errorInfo": {
        "errorMessage": String,
        "errorType": String,
        "errorCode": Integer
    }
}
}

StartFraudsterRegistrationJob

Memancarkan peristiwa ini ketika permintaan pendaftaran batch dikirimkan, berhasil, atau gagal. Sebuah Fraudster peristiwa dipancarkan untuk masing-masing penipu individu untuk menunjukkan apakah pendaftaran yang sesuai berhasil atau gagal.

{...commonfields
"detail-type": "VoiceId Batch Fraudster Registration Action",
"detail": {
    "sourceId": String,
    "domainId": String,
    "action": "BATCH_REGISTRATION_REQUEST",
    "status": String,
    "batchJobId": String,
    "data": {
        "dataAccessRoleArn": String,
        "registrationConfig": {
            "duplicateRegistrationAction": String,
            "fraudsterSimilarityThreshold": Integer,
            "watchlistIds": [String],
        }
        "inputDataConfig": {
            "s3Uri": String
        },
        "outputDataConfig": {
            "s3Uri": String,
            "kmsKeyId": String
        }
    },                                                      
    "errorInfo": {
        "errorMessage": String,
        "errorType": String,
        "errorCode": Integer
    }
}
}