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

nota

Aviso de fin de soporte: el 20 de mayo de 2026, AWS dejará de prestar soporte para Amazon Connect Voice ID. Después del 20 de mayo de 2026, ya no podrá acceder a Voice ID en la consola de Amazon Connect, acceder a las características de Voice ID en el sitio web de administración de Amazon Connect ni el panel de control de contacto ni acceder a los recursos de Voice ID. Para obtener más información, visite Fin del soporte 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 predeterminado de EventBridge.

Puede crear una canalización de análisis para los resultados de autenticación de Voice ID y la detección de estafadores en una lista de control mediante EventBridge para monitorear los eventos de Voice ID. Mediante el esquema disponible en este tema, puede configurar las reglas de EventBridge para escuchar y filtrar los eventos de Voice ID que sean pertinentes y, a continuación, procesarlos a través de Amazon Data Firehose para almacenarlos en un almacenamiento de datos de su elección.

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: 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 de la cuenta de AWS.

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

  • region: la región de AWS donde 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
    }
}
}