Esquema de eventos de Amazon Connect Voice ID - Amazon Connect
Campos comunes del eventoAcción de inicio de sesiónAcción de actualización de sesiónAcción de evaluación de sesiónAcción de interlocutorAcción de estafadorEnrollBySessionStartSpeakerEnrollmentJobStartFraudsterRegistrationJob

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Esquema de eventos de Amazon Connect Voice ID

Voice ID genera eventos para cada transacción: inscripción, autenticación o detección de estafadores en una lista de control. Los eventos se envían al bus de eventos EventBridge predeterminado.

Para supervisar los eventos de Voice ID, puede crear un canal de análisis para los resultados de la autenticación mediante EventBridge Voice ID y la detección de los defraudadores incluidos en una lista de seguimiento. Con el esquema disponible en este tema, puede configurar EventBridge reglas para escuchar y filtrar los eventos de Voice ID que sean relevantes y, a continuación, procesarlos a través de Amazon Data Firehose para almacenarlos en el almacén de datos que elija.

Por ejemplo, es posible que desee realizar un seguimiento casi en tiempo real del análisis de Voice ID. Para ello, puede extraer todos los eventos Evaluate-Session y obtener authenticationResult y fraudDetectionResult.

Los eventos se emiten en la medida de lo posible.

Campos comunes del evento

  • version: versión de los datos del evento.

  • id- Un identificador único del evento generado por EventBridge

  • detail-type: identificador de los detalles del evento.

  • source: origen del evento. Siempre es el aws.voiceid.

  • account- ID AWS de cuenta.

  • timestamp: fecha y hora en que se publicó el evento en formato UTC.

  • region- La AWS región en la que se realizó la llamada a la API.

  • resources: recursos utilizados por la llamada a la API.

  • detail: detalles sobre el evento:

    • detail.sourceId: un identificador único generado por Voice ID que puede utilizar para la desduplicación.

    • detail.action: es similar a la API que se invoca.

    • detail.status: especifica el estado de la acción: correcto o error.

    • detail.errorInfo: se rellena cuando la acción especificada genera un error en Voice ID.

A continuación, se presentan los esquemas de los eventos que se emiten.

Acción de inicio de sesión

Emite eventos al inicio del flujo (después de la configuración), al final del flujo y en caso de errores.

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

Acción de actualización de sesión

Emite eventos cuando la actualización de la sesión interna se realiza correctamente o no.

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

Acción de evaluación de sesión

Emite eventos cuando la evaluación de la sesión se realiza correctamente o no. Los motivos pueden ser 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
    }
}
}

Acción de interlocutor

Emite eventos si se selecciona o no a un interlocutor, se elimina o se inscribe a un interlocutor.

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

Acción de estafador

Emite eventos cuando un estafador se registra o elimina correctamente.

Los eventos no se envían cuando un estafador está asociado o desasociado de una lista de control.

{...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 este evento cuando se envía una solicitud de inscripción. Se emite un evento Speaker cuando la inscripción real se realiza correctamente o no.

{...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 este evento cuando una solicitud de inscripción por lotes se envía, se ejecuta correctamente o se produce un error. Se emite un evento Speaker para cada uno de los interlocutores individuales para indicar si la inscripción correspondiente se ha realizado correctamente o no.

{...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 este evento cuando una solicitud de registro por lotes se envía, se ejecuta correctamente o se produce un error. Se emite un evento Fraudster para cada uno de los estafadores individuales para indicar si el registro correspondiente se ha realizado correctamente o no.

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