Ereignisschema von Amazon Connect Voice ID - Amazon Connect
Allgemeine Felder in der VeranstaltungSitzungsaktion startenAktion „Sitzung aktualisieren“Bewerten der SitzungsaktionAktion des SprechersAktion eines BetrügersMelden Sie sich nach Sitzung anStartSpeakerEnrollmentJobStarten Sie den FraudsterRegistrationJob

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Ereignisschema von Amazon Connect Voice ID

Anmerkung

Hinweis zum Ende des Supports: AWS stellt den Support für Amazon Connect Voice ID am 20. Mai 2026 ein. Nach dem 20. Mai 2026 können Sie nicht mehr über die Amazon-Connect-Konsole auf Voice ID zugreifen. Sie können auch nicht mehr über die Administrator-Website von Amazon Connect oder im Contact Control Panel auf Voice-ID-Features zugreifen und die Voice-ID-Ressourcen stehen ebenfalls nicht mehr zur Verfügung. Weitere Informationen finden Sie unter Ende des Supports für Amazon Connect Voice ID.

Sprach-ID generiert Ereignisse für jede Transaktion: Registrierung, Authentifizierung oder Erkennung von Betrügern auf einer Watchlist. Ereignisse werden an den EventBridge-Standard-Event-Bus gesendet.

Sie können eine Analysepipeline für die Ergebnisse der Sprach-ID-Authentifizierung und die Erkennung von Betrügern in einer Watchlist erstellen, indem Sie EventBridge zur Überwachung von Sprach-ID-Ereignissen verwenden. Mithilfe des in diesem Thema verfügbaren Schemas können Sie EventBridge-Regeln so konfigurieren, dass sie relevante Sprach-ID-Ereignisse abhören und filtern und sie dann über Amazon Data Firehose verarbeiten, um sie in einem Data Warehouse Ihrer Wahl zu speichern.

Möglicherweise möchten Sie beispielsweise die Sprach-ID-Analyse nahezu in Echtzeit verfolgen. Dazu können Sie alle Evaluate-Session-Ereignisse sowie authenticationResult und fraudDetectionResult abrufen.

Ereignisse werden auf bestmögliche Weise ausgegeben.

Allgemeine Felder in der Veranstaltung

  • version – Die Version der Ereignisdaten.

  • id – Eine eindeutige von für das Ereignis generierte Kennung.

  • detail-type – Ein Bezeichner für die Details des Ereignisses.

  • source – Die Quelle des Ereignisses. Dies ist immer aws.voiceid.

  • account- – AWS-Konto-ID

  • timestamp – Das Datum und die Uhrzeit der Veröffentlichung des Ereignisses in UTC.

  • region – Die AWS-Region, in der der API-Aufruf durchgeführt wurde.

  • resources – Vom API-Aufruf verwendete Ressourcen.

  • detail – Details zum Ereignis:

    • detail.sourceId – Eine von Sprach-ID generierte eindeutige ID, die Sie für die Deduplizierung verwenden können.

    • detail.action – Analog zur aufgerufenen API.

    • detail.status – Gibt den Status der Aktion an: Erfolg oder Fehlschlag.

    • detail.errorInfo – Wird aufgefüllt, wenn bei der angegebenen Aktion bei Sprach-ID ein Fehler auftritt.

Im Folgenden sind die Schemas für die ausgegebenen Ereignisse aufgeführt.

Sitzungsaktion starten

Gibt Ereignisse beim Start des Streams (nach der Einrichtung), beim Stream-Ende und bei Fehlern aus.

{...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
       }
    }
}

Aktion „Sitzung aktualisieren“

Gibt Ereignisse aus, wenn das interne Sitzungsupdate erfolgreich ist oder fehlschlägt.

{...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
    }
}
}

Bewerten der Sitzungsaktion

Gibt Ereignisse aus, wenn die Sitzungsauswertung erfolgreich ist oder fehlschlägt. Die Gründe können KNOWN_FRAUDSTER oder VOICE_SPOOFING sein.

{...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
    }
}
}

Aktion des Sprechers

Gibt Ereignisse aus, wenn ein Sprecher erfolgreich abbestellt, gelöscht oder angemeldet wurde.

{...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
     }
}
}

Aktion eines Betrügers

Gibt Ereignisse aus, wenn ein Betrüger erfolgreich registriert oder gelöscht wurde.

Es werden keine Ereignisse gesendet, wenn ein Betrüger mit einer Watchlist verknüpft oder deren Verknüpfung aufgehoben wird.

{...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
    }
}
}

Melden Sie sich nach Sitzung an

Gibt dieses Ereignis aus, wenn eine Registrierungsanfrage eingereicht wird. Ein Speaker-Ereignis wird ausgelöst, wenn die tatsächliche Registrierung erfolgreich ist oder fehlschlägt.

{...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

Gibt dieses Ereignis aus, wenn eine Batch-Registrierungsanfrage eingereicht wurde, erfolgreich ist oder fehlschlägt. Für jeden einzelnen Sprecher wird ein Speaker-Ereignis ausgelöst, das angibt, ob die entsprechende Registrierung erfolgreich war oder nicht.

{...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
    }
}
}

Starten Sie den FraudsterRegistrationJob

Gibt dieses Ereignis aus, wenn eine Batch-Registrierungsanfrage eingereicht wurde, erfolgreich ist oder fehlschlägt. Für jeden einzelnen Betrüger wird ein Fraudster-Ereignis ausgelöst, das anzeigt, ob die entsprechende Registrierung erfolgreich war oder fehlschlägt.

{...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
    }
}
}