Esquema de eventos do Amazon Connect Voice ID - Amazon Connect
Campos comuns no eventoAção Iniciar sessãoAção Atualizar sessãoAção Avaliar sessãoAção do locutorAção do fraudadorEnrollBySessionStartSpeakerEnrollmentJobStartFraudsterRegistrationJob

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Esquema de eventos do Amazon Connect Voice ID

O Voice ID gera eventos para cada transação: inscrição, autenticação ou detecção de fraudadores em uma lista de observação. Os eventos são enviados para o barramento de eventos EventBridge padrão.

Você pode criar um pipeline de análise para os resultados da autenticação do Voice ID e a detecção de fraudadores em uma lista de observação usando EventBridge para monitorar eventos do Voice ID. Usando o esquema disponível neste tópico, você pode configurar EventBridge regras para ouvir e filtrar eventos de Voice ID que sejam relevantes e, em seguida, processá-los por meio do Amazon Data Firehose para armazená-los em um data warehouse de sua escolha.

Por exemplo, você pode querer um rastreamento quase em tempo real da análise do Voice ID. Para fazer isso, você pode pegar todos os eventos Evaluate-Session e obter authenticationResult e fraudDetectionResult.

Os eventos são emitidos com base no melhor esforço.

Campos comuns no evento

  • version: a versão dos dados do evento.

  • id- Um identificador exclusivo do evento gerado por EventBridge

  • detail-type: um identificador dos detalhes do evento.

  • source: a origem do evento. Isso é sempre aws.voiceid.

  • account- ID AWS da conta.

  • timestamp: a data e a hora em que o evento foi publicado em UTC.

  • region- A AWS região em que a chamada da API foi feita.

  • resources: os recursos usados pela chamada da API.

  • detail: os detalhes sobre o evento.

    • detail.sourceId: um ID exclusivo gerado pelo Voice ID que você pode usar para desduplicação.

    • detail.action: análogo à API que está sendo invocada.

    • detail.status: especifica o status da ação: sucesso ou falha.

    • detail.errorInfo: é preenchido quando a ação especificada apresenta um erro no Voice ID.

A seguir estão os esquemas dos eventos emitidos.

Ação Iniciar sessão

Emite eventos no início do fluxo (após a configuração), no final do fluxo e em caso de falhas.

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

Ação Atualizar sessão

Emite eventos quando a atualização interna da sessão é bem-sucedida ou malsucedida.

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

Ação Avaliar sessão

Emite eventos quando a atualização da sessão é bem-sucedida ou malsucedida. Os motivos podem ser KNOWN_FRAUDSTER ou 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
    }
}
}

Ação do locutor

Emite eventos sobre sucesso ou insucesso ao cancelar, excluir ou inscrever um palestrante.

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

Ação do fraudador

Emite eventos quando um fraudador é registrado ou excluído com sucesso.

Os eventos não são enviados quando um fraudador é associado ou desassociado de uma lista de observação.

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

Emite esse evento quando uma solicitação de inscrição é enviada. Um evento Speaker é emitido quando a inscrição real é bem-sucedida ou malsucedida.

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

Emite esse evento quando uma solicitação de inscrição em lote é enviada, bem-sucedida ou malsucedida. Um evento Speaker é emitido para cada um dos locutores para indicar se a inscrição correspondente foi bem-sucedida ou não.

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

Emite esse evento quando uma solicitação de registro em lote é enviada, bem-sucedida ou malsucedida. Um evento Fraudster é emitido para cada um dos fraudadores para indicar se o registro correspondente foi bem-sucedido ou malsucedido.

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