Schema degli eventi di Amazon Connect Voice ID - Amazon Connect
Campi comuni dell'eventoStart Session ActionUpdate Session ActionEvaluate Session ActionSpeaker ActionFraudster ActionEnrollBySessionStartSpeakerEnrollmentJobStartFraudsterRegistrationJob

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Schema degli eventi di Amazon Connect Voice ID

Nota

Avviso di fine del supporto: il 20 maggio 2026, AWS terminerà il supporto per Amazon Connect Voice ID. Dopo il 20 maggio 2026 non sarà più possibile accedere a Voice ID nella console di Amazon Connect, accedere alle funzionalità Voice ID sul sito web di amministrazione di Amazon Connect o su Contact Control Panel, né accedere alle risorse Voice ID. Per ulteriori informazioni, consulta Fine del supporto di Amazon Connect Voice ID.

Voice ID genera eventi per ogni transazione: registrazione, autenticazione o rilevamento di truffatori in una lista di controllo. Gli eventi vengono inviati al router di eventi EventBridge predefinito.

È possibile creare una pipeline di analisi per i risultati dell'autenticazione di Voice ID e il rilevamento dei truffatori in una lista di controllo usando EventBridge per monitorare gli eventi di Voice ID. Utilizzando lo schema disponibile in questo argomento, è possibile configurare le regole di EventBridge per ascoltare e filtrare gli eventi di Voice ID pertinenti e quindi elaborarli tramite Amazon Data Firehose per archiviarli in un data warehouse desiderato.

È ad esempio possibile tracciare quasi in tempo reale l'analisi di Voice ID. A tale scopo, è necessario eseguire il pull di tutti gli eventi Evaluate-Session e ottenere authenticationResult e fraudDetectionResult.

Gli eventi vengono emessi secondo il principio del massimo sforzo.

Campi comuni dell'evento

  • version: versione dei dati dell'evento.

  • id: identificatore univoco generato da EventBridge per l'evento.

  • detail-type: identificatore dei dettagli dell'evento.

  • source: origine dell'evento. Il valore è sempre aws.voiceid.

  • account: ID account AWS.

  • timestamp: data e ora in cui l'evento è stato pubblicato nel fuso UTC.

  • region: regione AWS in cui è stata effettuata la chiamata API.

  • resources: risorse usate dalla chiamata API.

  • detail: dettagli sull'evento:

    • detail.sourceId: ID univoco generato da Voice ID che è possibile usare per la deduplicazione.

    • detail.action: analogo all'API richiamata.

    • detail.status: specifica lo stato dell'azione: riuscita o non riuscita.

    • detail.errorInfo: popolato quando l'azione specificata genera un errore in Voice ID.

Di seguito sono riportati gli schemi relativi agli eventi emessi.

Start Session Action

Vengono emessi eventi all'inizio del flusso (dopo la configurazione), alla fine del flusso e in caso di errori.

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

Update Session Action

Vengono emessi eventi quando l'aggiornamento della sessione interna ha esito positivo o negativo.

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

Evaluate Session Action

Vengono emessi eventi quando la valutazione della sessione ha esito positivo o negativo. I motivi possono essere KNOWN_FRAUDSTER o 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
    }
}
}

Speaker Action

Vengono emessi eventi in base all'esito positivo o negativo dell'operazione di opt-out, eliminazione o registrazione di un parlante.

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

Fraudster Action

Vengono emessi eventi quando un truffatore viene registrato o eliminato.

Gli eventi non vengono inviati in caso di associazione o annullamento dell'associazione di un truffatore a una lista di controllo.

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

Questo evento viene emesso quando viene inviata una richiesta di registrazione. Viene emesso un evento Speaker quando la registrazione effettiva ha esito positivo o negativo.

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

Questo evento viene emesso quando una richiesta di registrazione in batch viene inviata, ha esito positivo o ha esito negativo. Viene emesso un evento Speaker per ciascuno dei singoli parlanti per indicare se la registrazione corrispondente ha esito positivo o negativo.

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

Questo evento viene emesso quando una richiesta di registrazione in batch viene inviata, ha esito positivo o ha esito negativo. Viene emesso un evento Fraudster per ciascuno dei singoli truffatori per indicare se la registrazione corrispondente ha esito positivo o negativo.

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