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.
# Uso de la autenticación de intermediario en tiempo real con Voice ID en Amazon Connect
**nota**
Aviso de fin de soporte: el 20 de mayo de 2026, AWS finalizará el soporte para Amazon Connect Voice ID. Después del 20 de mayo de 2026, ya no podrás acceder a Voice ID en la consola Amazon Connect, acceder a las funciones de Voice ID en el sitio web de Amazon Connect administración o el Panel de control de contactos, ni acceder a los recursos de Voice ID. Para obtener más información, visite [Fin del soporte de Amazon Connect Voice ID](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
Amazon Connect Voice ID proporciona autenticación de intermediarios en tiempo real y detección del riesgo de fraude, lo que hace que las interacciones de voz en los centros de contacto sean más seguras y eficaces. Voice ID utiliza machine learning para verificar la identidad de los clientes auténticos mediante el análisis de las características únicas de la voz del intermediario. Esto permite a los centros de contacto utilizar una capa de seguridad adicional que no depende de que el intermediario responda a múltiples preguntas de seguridad y facilita la inscripción y verificación de los clientes sin cambiar el flujo natural de su conversación. Voice ID también permite detectar en tiempo real a los estafadores que atacan su centro de contacto con frecuencia, lo que reduce las pérdidas ocasionadas por el fraude.
Con Amazon Connect Voice ID, puede:
+ Inscribir pasivamente a los clientes para la autenticación por voz sin exigirles que repitan una palabra o frase en concreto.
+ Migrar a los clientes a Voice ID inscribiéndolos por lotes.
+ Verificar la identidad del cliente inscrito mediante el análisis de sus características de voz únicas.
+ Detectar a los estafadores a partir de una lista de seguimiento que haya creado.
+ Detectar la suplantación de voz.
## Cómo funciona Voice ID
### Inscripción de clientes
1. Cuando un cliente llama por primera vez, el agente confirma la identidad del intermediario mediante las medidas de seguridad existentes, como la solicitud del nombre de soltera de la madre o un código de acceso de un solo uso (OTP) enviado por SMS. Esto garantiza que solo los clientes auténticos estén inscritos en Voice ID.
1. Voice ID comienza a escuchar la voz del cliente cuando el contacto encuentra el bloque [Establecer ID de voz](set-voice-id.md), cuando Voice ID está habilitado. Voice ID escucha la llamada hasta que se produzca una de las siguientes situaciones:
+ Obtiene suficiente audio para evaluar la autenticidad o la estafa del interlocutor e inscribirlo (si se solicita). Se trata de 30 segundos de voz del cliente, sin incluir el silencio.
+ Finaliza la llamada.
1. A continuación, Voice ID crea la huella de voz de inscripción. Una huella de voz es una representación matemática que captura implícitamente aspectos únicos de la voz de una persona, como el ritmo del habla, el timbre, la entonación y el volumen.
El intermediario no necesita decir ni repetir ninguna frase específica para inscribirse en Voice ID.
### Autenticación del cliente
1. Cuando el cliente inscrito vuelve a llamar, se verifica su presencia mediante una interacción con un IVR o durante su interacción con un agente.
De forma predeterminada, Voice ID está configurado para requerir diez segundos del habla del intermediario para autenticarlo, lo que puede hacerse como parte de una interacción típica del cliente en el IVR o con el agente (como “¿cuál es su nombre y apellidos?” y “¿para qué llama?”). Puede ajustar la cantidad de voz requerida con la propiedad [Tiempo de respuesta de autenticación](set-voice-id.md#set-voice-id-properties-authentication-response-time) del bloque [Establecer ID de voz](set-voice-id.md).
1. Voice ID utiliza el audio para generar la huella vocal del intermediario y la compara con la huella vocal registrada correspondiente a la identidad solicitada y devuelve un resultado de autenticación.
Para obtener más información sobre la experiencia del agente, consulte [Inscripción de las personas que llaman en ID de voz en el Panel de control de contacto (CCP)](use-voiceid.md).
## Cuánta voz se necesita para la inscripción y la autenticación
+ Inscripción: 30 segundos de voz neta del cliente (voz sin incluir silencio) para crear una huella de voz e inscribir a un cliente.
+ Verificación: de forma predeterminada, 10 segundos de voz neta del cliente para comprobar que la voz pertenece a la identidad declarada. La voz puede provenir de una interacción con un IVR o un agente. Puede ajustar la cantidad de voz requerida con la propiedad [Tiempo de respuesta de autenticación](set-voice-id.md#set-voice-id-properties-authentication-response-time) del bloque [Establecer ID de voz](set-voice-id.md).
## Inscripción por lotes
Puede empezar a utilizar la biometría si inscribe por lotes a los clientes que ya han dado su consentimiento para la biometría. Con las grabaciones de audio almacenadas en tu bucket S3 y un archivo de entrada JSON que proporciona el identificador del altavoz y un enlace a las grabaciones de audio, puedes invocar el lote APIs de Voice ID.
Para obtener más información, consulte [Inscripción por lotes en Amazon Connect Voice ID utilizando datos de audio de llamadas anteriores](voiceid-batch-enrollment.md).
## Detección de estafadores conocidos
Existen algunos pasos para configurar la detección de estafadores en tiempo real:
1. [Cree una nueva lista de control](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_CreateWatchlist.html) para almacenar a los estafadores conocidos. O bien, utilice la lista de control predeterminada que se crea cuando Voice ID está habilitado.
1. [Registre a los estafadores](voiceid-fraudster-watchlist.md) en la nueva lista de control o en la lista de control predeterminada.
1. En el bloque [Establecer ID de voz](set-voice-id.md), especifica qué lista de control desea usar.
Cuando uno de los estafadores de la lista de control especificada en el flujo llama a su centro de contacto, Voice ID analiza el audio de la llamada para obtener una puntuación de riesgo y un resultado. Esta puntuación indica hasta qué punto la huella vocal del intermediario coincide con la del estafador en la lista de control. Voice ID requiere 10 segundos de audio para evaluar el audio de la llamada y determinar si existe riesgo de fraude por parte de estafadores conocidos.
### Lista de control predeterminada
Cuando se crea el dominio de Voice ID, crea una lista de control de estafadores predeterminada para ese dominio. El nombre y la descripción de la lista de control de estafadores predeterminada se cifran con la clave de KMS que se proporciona en el dominio y se guarda en Voice ID.
Si no proporciona el ID de la lista de control de estafadores para la detección de fraudes o el registro de estafadores, Voice ID utilizará la lista de control de estafadores predeterminada.
No puede actualizar los metadatos de la lista de control de estafadores predeterminada, pero puede asociar o desasociar estafadores de ella.
**nota**
Si su dominio de Voice ID se creó antes de marzo de 2023, cuando se lanzaron las listas de control de estafadores: se creó una lista de control predeterminada y se incluyó en ella a todos los estafadores existentes.
## Detección de suplantación de voz
1. Cuando un posible estafador intenta falsificar el audio del intermediario mediante la reproducción de audio o el habla sintetizada, Voice ID devuelve una puntuación de riesgo y un resultado para indicar la probabilidad de que la voz sea falsa.
1. La suplantación de voz solo se activa cuando se activa la característica de detección de fraude en el flujo de contactos. Las puntuaciones de suplantación de voz no se devuelven cuando solo está habilitada la autenticación del altavoz.
1. Voice ID requiere 10 segundos de audio para evaluar el audio de la llamada y determinar si existe riesgo de suplantación de voz.
## ¿Qué datos se almacenan?
Voice ID almacena los archivos de audio de la voz del interlocutor, las huellas de voz y los identificadores del interlocutor. Estos datos se cifran mediante una clave de KMS que usted proporciona.
Si habilita la detección de los estafadores en una lista de control, Voice ID también almacena el audio y las huellas de voz del estafador. Para obtener más información, consulte [Datos gestionados por Amazon Connect](data-handled-by-connect.md).
# Fin del soporte de Amazon Connect Voice ID
Tras pensarlo detenidamente, hemos decidido finalizar el soporte de Amazon Connect Voice ID con efecto a partir del 20 de mayo de 2026. A partir del 20 de mayo de 2025, Amazon Connect Voice ID dejará de aceptar nuevos clientes. Si tiene una cuenta registrada en el servicio desde antes del 20 de mayo de 2025, puede seguir utilizando las características de Amazon Connect Voice ID. Después del 20 de mayo de 2026, ya no podrá usar Amazon Connect Voice ID.
En esta página se dan instrucciones y se explican las prácticas recomendadas para que los administradores de TI y los usuarios de Amazon Connect puedan realizar la transición de Voice ID a soluciones alternativas que satisfagan sus necesidades empresariales. Esto puede incluir soluciones de AWS socios disponibles en AWS Marketplace, como [Pindrop®](https://aws.amazon.com/marketplace/pp/prodview-f7rqlwjby3er4), o do-it-yourself soluciones con AWS End User Messaging SMS.
## Do-it-yourself soluciones con AWS End User Messaging SMS
Puede mejorar la seguridad del centro de contacto habilitando la autenticación basada en OTP One-Time-Pin (OTP) para su centro de contacto con AWS End User Messaging SMS. Puede consultar un ejemplo de solución que le permita OTPs crear AWS End User Messaging SMS una para su centro de contacto. Para obtener más información sobre esta solución, consulte la siguiente entrada del blog: [Cree una arquitectura segura de contraseñas de un solo uso con AWS](https://aws.amazon.com/blogs/messaging-and-targeting/build-a-secure-one-time-password-architecture-with-aws/). Para obtener más información al respecto AWS End User Messaging SMS, consulte [¿Qué es AWS End User Messaging SMS?](https://docs.aws.amazon.com/sms-voice/latest/userguide/what-is-sms-mms.html)
## Administración de sus datos de Voice ID
Puedes obtener información sobre todos los dominios de Voice ID de tu AWS contabilidad mediante la `ListDomains` API de Voice ID junto con la `DescribeDomain` API. Para obtener más información sobre la administración de sus dominios de Amazon Connect Voice ID, consulte [Administración de dominios de Amazon Connect Voice ID](voiceid-domain-operations.md).
Para un dominio de Voice ID específico, puede descargar datos sobre los intermediarios inscritos que llaman con la API `ListSpeakers` y sobre los estafadores registrados con la API `ListFraudsters`. Para obtener más información sobre interlocutores y estafadores, consulte [Gestión de altavoces, listas de seguimiento y defraudadores de Amazon Connect Voice ID APIs](voiceid-speaker-fraudster-management-apis.md). Para asegurarse de que se eliminen todos los datos de sus clientes de Voice ID, puede usar la API de Voice ID `DeleteDomain`. Debes realizar esta operación para todos los dominios de Voice ID de cada AWS región y cada cuenta.
# Dominios de Voice ID en Amazon Connect Voice ID
**nota**
Aviso de fin de soporte: el 20 de mayo de 2026, AWS finalizará el soporte para Amazon Connect Voice ID. Después del 20 de mayo de 2026, ya no podrás acceder a Voice ID en la consola Amazon Connect, acceder a las funciones de Voice ID en el sitio web de Amazon Connect administración o el Panel de control de contactos, ni acceder a los recursos de Voice ID. Para obtener más información, visite [Fin del soporte de Amazon Connect Voice ID](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
Al habilitar Amazon Connect Voice ID, se crea un dominio de Voice ID: un contenedor para todos los datos de Voice ID, como los identificadores de interlocutor (que sirven como identificador del cliente), las huellas de voz, el audio del cliente que se utilizó para crear las huellas de voz de inscripción y los estados de inscripción (inscritos, excluidos, etc.) asociados a los identificadores de los interlocutores. Para detectar a los estafadores en una lista de control, el dominio de Voice ID almacena los identificadores de los estafadores, las huellas de voz y el audio utilizados para crear las huellas de voz.
A continuación, encontrará las directrices para crear dominios de Voice ID:
+ Cada instancia de Amazon Connect solo puede asociarse a un dominio de Voice ID.
+ Cada dominio de Voice ID se puede asociar a varias instancias de Amazon Connect. Esto le permite utilizar los mismos datos de clientes almacenados en varias instancias de Amazon Connect.
+ Puede crear varios dominios, pero no comparten los datos de clientes entre sí.
+ Recomendamos crear un nuevo dominio de Voice ID para asociarlo a una instancia de Amazon Connect cuando:
+ Habilite Voice ID por primera vez en su cuenta de una región de AWS .
+ Desea asegurarse de aislar los dominios de Voice ID que se utilizan en sus entornos de prueba y producción.
+ Recomendamos utilizar un dominio de Voice ID existente cuando:
+ Desea utilizar el mismo conjunto de intermediarios inscritos y estafadores en diferentes instancias de Amazon Connect (que pueden pertenecer a diferentes equipos de atención al cliente).
+ Desea utilizar el mismo entorno de prueba en distintas instancias de prueba de Amazon Connect.
**nota**
Solo los dominios de Voice ID existentes en la misma región de su cuenta de Amazon Connect se pueden compartir entre las instancias de Amazon Connect de esa región.
+ Puede cambiar la asociación de su instancia de Amazon Connect del dominio actual a un nuevo dominio en cualquier momento, seleccionando un dominio diferente.
+ Para eliminar un dominio de Voice ID, usa la API de [DeleteDomain](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DeleteDomain.html)Voice ID. `DeleteDomain`borra el dominio de forma gradual. Amazon Connect espera 30 días antes de borrar por completo los datos del dominio. Durante este período, Voice ID; estará deshabilitado en todas las instancias de Amazon Connect a las que esté asociado. Para restaurar un dominio durante este período, envíe un Soporte ticket y proporcione el ID del dominio. Puede encontrar el ID de dominio en la sección Voice ID de la consola de Amazon Connect, tal y como se muestra en el siguiente ejemplo:
![\[La sección Voice ID de la consola de Amazon Connect que muestra el campo de identificador de dominio necesario para restaurar el dominio.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/voiceid-domain.png)
Al eliminar un dominio de Voice ID, se eliminan todos los datos de clientes almacenados, como las grabaciones de audio, las huellas de voz y los identificadores de interlocutor, así como cualquier lista de control de estafadores que haya administrado.
## Estado de inscripción
Voice ID almacena tres estados de inscripción diferentes para un interlocutor: `ENROLLED`, ` OPTED_OUT` y `EXPIRED`. Puedes recordar el estado de estos altavoces mediante el [identificador de voz de Amazon Connect APIs](https://docs.aws.amazon.com/voiceid/latest/APIReference/) y los bloques de flujo de contactos para tomar las medidas adecuadas.
+ `ENROLLED`: cuando se inscribe a un nuevo interlocutor se inscribe en Voice ID, Voice ID crea una nueva huella vocal y establece el estado del interlocutor como `ENROLLED`. Aunque vuelva a inscribir al mismo intermediario en Voice ID, el estado se mantiene como `ENROLLED`.
+ `OPTED_OUT`: Si la persona que llama no da su consentimiento para utilizar la biometría, puedes excluirla (en el panel de control de contactos) o utilizarla. APIs Voice ID crea una nueva entrada para este intermediario y establece el estado del interlocutor `OPTED_OUT`. Voice ID no genera ninguna huella de voz ni almacena ninguna grabación de audio para el interlocutor. Las solicitudes de inscripción futuras para este interlocutor se rechazarán a menos que se elimine su entrada.
+ `EXPIRED`: si no se ha accedido a la huella vocal de un intermediario o no se ha actualizado durante tres años, Voice ID cambia el estado a `EXPIRED` y ya no podrá realizar autenticaciones para este intermediario. Puede volver a inscribir al intermediario o eliminarlo de Voice ID.
## Interlocutores caducados
Para el cumplimiento de la BIPA, Voice ID hace caducar automáticamente a los interlocutores a los que no se haya accedido para la inscripción, reinscripción o autenticación correcta durante tres años.
Para ver el último acceso de un altavoz, consulta el `lastAccessedAt` atributo que devuelve la tecla y. `DescribeSpeaker` `ListSpeakers` APIs
Si intenta utilizar la API `EvaluateSesssion` para autenticar a un interlocutor caducado, se mostrará una decisión de autenticación `SPEAKER_EXPIRED`.
Para volver a utilizar el interlocutor caducado, es necesario volver a inscribirlo.
## Identificadores de interlocutor y estafador
Voice ID utiliza los identificadores de interlocutor para consultar y recuperar las huellas de voz en un dominio de Voice ID. Le recomendamos que utilice identificadores que no contengan información de identificación personal (PII) en ellos.
Voice ID crea dos campos para referirse a un intermediario:
+ `CustomerSpeakerId`: un identificador proporcionado por el cliente. Puede tener entre 1 y 256 caracteres y solo puede contener: **a-z**, **A-Z**, **0-9**, **-** y **\$1**
+ `GeneratedSpeakerId`: una cadena alfanumérica única de 22 caracteres que Voice ID crea y devuelve en el momento de la inscripción del intermediario.
Los [altavoces Voice ID de Amazon Connect APIs](https://docs.aws.amazon.com/voiceid/latest/APIReference/Welcome.html) aceptan cualquier tipo de identificador de altavoz, pero solo emiten `GeneratedSpeakerId` en el Voice ID las transmisiones de eventos y los registros de contactos. Si desea volver a grabar al intermediario para rehacer la huella vocal, puede inscribirlo con el mismo `CustomerSpeakerId`.
Del mismo modo, Voice ID crea identificadores de estafadores únicos denominados `GeneratedFraudsterID` para cada estafador que agregue a una lista de control en el dominio. Voice ID devuelve el identificador de estafador si se detecta a un estafador en una llamada al detectar el riesgo de fraude.
# Activación de Voice ID en Amazon Connect
**nota**
Aviso de fin de soporte: el 20 de mayo de 2026, AWS finalizará el soporte para Amazon Connect Voice ID. Después del 20 de mayo de 2026, ya no podrás acceder a Voice ID en la consola Amazon Connect, acceder a las funciones de Voice ID en el sitio web de Amazon Connect administración o el Panel de control de contactos, ni acceder a los recursos de Voice ID. Para obtener más información, visite [Fin del soporte de Amazon Connect Voice ID](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
## Antes de empezar
Antes de comenzar, realice las siguientes tareas.
**Topics**
+ [Concesión de los permisos necesarios](#enable-voiceid-permissions)
+ [Decisión del nombre del dominio de Voice ID](#enable-voiceid-domains)
+ [Crea y cifra AWS KMS key los datos almacenados en el dominio](#enable-voiceid-awsmanagedkey)
### Concesión de los permisos necesarios
Debe conceder los permisos necesarios a usuarios, grupos o roles. Para obtener más información, consulta [AmazonConnectVoiceIDFullAcceso](security_iam_awsmanpol.md#amazonconnectvoiceidfullaccesspolicy).
El acceso al Voice ID APIs mediante el panel de control de contactos (CCP) está desactivado de forma predeterminada.
### Decisión del nombre del dominio de Voice ID
Cuando habilitas Voice ID, se te pedirá que proporciones un nombre de dominio descriptivo que sea significativo para ti, como el nombre de tu organización, por ejemplo, *Voice ID- ExampleCorp*.
### Crea y cifra AWS KMS key los datos almacenados en el dominio
Al habilitar Voice ID, se le solicitará que cree o proporcione una [AWS KMS key](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#kms_keys). Cifra los datos de clientes almacenados en Voice ID, como los archivos de audio, las huellas de voz y los identificadores de interlocutor.
Step-by-step las instrucciones para crear estas claves KMS se proporcionan en[Paso 2: crear un nuevo dominio de Voice ID y clave de cifrado](#enable-voiceid-step2).
Los datos en reposo (específicamente, los campos de formato libre que usted proporciona más los archivos de audio o las huellas de voz) se cifran con la clave de KMS que elija. Usted crea, posee y administra su clave administrada por el cliente. Usted tiene el control total sobre la clave KMS (de AWS KMS pago).
Al realizar llamadas a Voice ID para cualquier cosa que no sea `CreateDomain` o`UpdateDomain`, el usuario que realiza la llamada necesita permisos `kms:Decrypt` para la clave asociada al dominio. Al realizar llamadas a `CreateDomain` o `UpdateDomain`, el usuario también necesita permisos `kms:DescribeKey` y `kms:CreateGrant` para la clave. Al crear (o actualizar) un dominio de Voice ID, se crea una concesión sobre la clave de KMS para que los procesos asincrónicos de Voice ID (como la inscripción de interlocutores) y el rol vinculado al servicio de Amazon Connect puedan utilizarla durante sus flujos. Esta concesión incluye un contexto de cifrado que especifica el dominio al que está asociada la clave. Para obtener más información sobre las concesiones, consulte [Uso de concesiones](https://docs.aws.amazon.com/kms/latest/developerguide/grants.html) en la Guía para desarrolladores de AWS Key Management Service .
Si crea un dominio y lo asocia a una clave, almacena algunos datos y, a continuación, cambia la clave de KMS por otra clave, se iniciará un proceso asincrónico para volver a cifrar los datos antiguos con la nueva clave de KMS. Una vez finalizado este proceso, todos los datos de su dominio se cifrarán con la nueva clave de KMS y podrá retirar la antigua de forma segura. Para obtener más información, consulte [UpdateDomain](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_UpdateDomain).
**sugerencia**
Puede crear claves de KMS o proporcionar una clave de KMS existente mediante programación. Para obtener más información, consulta [Amazon Connect Voice ID APIs](https://docs.aws.amazon.com/voiceid/latest/APIReference/).
## Paso 1: leer la confirmación de consentimiento de BIPA
Para habilitar Voice ID es necesario leer la confirmación de consentimiento de la Ley de Privacidad Biométrica (BIPA). Debe hacerlo una vez por cuenta, en todas las regiones. No puede realizar este paso utilizando APIs. Para obtener más información sobre BIPA, consulte este artículo de Wikipedia: [Ley de privacidad de la información biométrica](https://en.wikipedia.org/wiki/Biometric_Information_Privacy_Act).
1. Abra la consola Amazon Connect en [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).
1. En la página de instancias, elija el alias de instancia. El alias de instancia también es su **nombre de instancia**, que aparece en su URL de Amazon Connect. En la siguiente imagen se muestra la página de **instancias del centro de contacto virtual de Amazon Connect**, con un recuadro alrededor del alias de instancia.
![\[Página de instancias del centro de contacto virtual de Amazon Connect, alias de instancia.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/instance.png)
1. En el panel de navegación, elija **Voice ID**. Lea la confirmación de consentimiento de BIPA y acéptela si está de acuerdo.
![\[La página Habilitación de Voice ID que muestra el botón de confirmación de consentimiento de la Ley de Privacidad Biométrica (BIPA) que los usuarios deben leer y aceptar antes de activar Voice ID.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/voiceid-bipa.png)
## Paso 2: crear un nuevo dominio de Voice ID y clave de cifrado
Puedes realizar este paso con la consola Amazon Connect o con Amazon Connect y Voice ID APIs.
------
#### [ Amazon Connect console instructions ]
1. En la sección **Configuración del dominio**, elija **Crear un nuevo dominio**.
![\[Interfaz de configuración de dominio con opciones para crear un nuevo dominio o elegir uno existente.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/voiceid-enable-domain.png)
1. En el cuadro **Nombre de dominio**, introduce un nombre descriptivo que sea significativo para ti, como el nombre de tu organización (por ejemplo, *VoiceID* -). ExampleCorp
1. En **Cifrado**, crea o introduce el tuyo propio AWS KMS key para cifrar tu dominio de Voice ID. Utilice los siguientes pasos para crear su clave de KMS:
1. Elija **Crear clave de KMS**.
![\[La sección de cifrado de la página de configuración del Voice ID muestra el botón “Crear clave de AWS KMS” para crear una nueva clave de cifrado.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/voiceid-create-kms-key.png)
1. Se abrirá una nueva pestaña en su navegador para la consola Key Management Service (KMS). En la página **Configurar clave**, elija **Simétrico** y, a continuación, elija **Siguiente**.
![\[Configure la página de claves con el tipo de clave simétrica seleccionado para el cifrado y el descifrado.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-create-kms-key-configure-key.png)
1. En la página **Agregar etiquetas**, escriba un nombre y una descripción para la clave de KMS y, a continuación, elija **Siguiente**.
1. En la página **Definir permisos de administración de claves**, elija **Siguiente**.
1. En la página **Definir permisos de uso de claves**, elija **Siguiente**.
1. En la página **Revisar y editar política de claves**, elija **Finalizar**.
1. Vuelva a la pestaña de su navegador correspondiente a la consola de Amazon Connect, página **Voice ID**. Pulse o haga clic en el cuadro **AWS KMS key** para que la clave que ha creado aparezca en una lista desplegable. Elija la clave que ha creado.
1. Elija **Habilitar ID de voz**.
------
#### [ API instructions ]
1. Llama a la [CreateDomain](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_CreateDomain.html)API para crear un nuevo dominio de Voice ID.
1. Llama a la [CreateIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateIntegrationAssociation.html)API para asociar el dominio de Voice ID a la instancia de Amazon Connect.
1. Pase el ARN del dominio de Voice ID que se acaba de crear al parámetro `IntegrationArn`. En `IntegrationType`, utilice `VOICE_ID`.
------
Ha habilitado Voice ID para su instancia. Se ha creado lo siguiente:
+ Su dominio de Voice ID y una lista de control de estafadores predeterminada en la que se alojarán los estafadores.
+ Una EventBridge regla de Amazon gestionada en tu cuenta. Esta regla se usa para la ingesta de eventos de Voice ID a fin de crear registros de contacto relacionados con Voice ID. Además, Amazon Connect agrega [permisos de Voice ID](connect-slr.md) al rol vinculado al servicio de Amazon Connect.
A continuación, en el paso 3, configure cómo desea que Voice ID funcione en su flujo.
## Paso 3: configurar Voice ID en el flujo de contacto
En este paso, agregue los bloques necesarios al flujo y configure cómo desea que funcione Voice ID.
+ [Reproducir pregunta](play.md): agregue este bloque antes del bloque [Establecer ID de voz](set-voice-id.md) para reproducir el audio correctamente. Puede editarlo para incluir un mensaje simple como “Bienvenido”.
+ [Establecer ID de voz](set-voice-id.md): después del bloque [Reproducir pregunta](play.md), agregue el bloque [Establecer ID de voz](set-voice-id.md). Debe estar al inicio de una llamada. Utilice este bloque para iniciar el streaming de audio a Amazon Connect Voice ID con el fin de verificar la identidad del intermediario, en cuanto la llamada se conecte a un flujo.
En el bloque **Establecer ID de voz** puede configurar el umbral de autenticación, el tiempo de respuesta, el umbral de fraude y la lista de control de estafadores para utilizarla en la detección de estafadores conocidos.
+ [Establecer atributos de contacto](set-contact-attributes.md): se utiliza para pasar el atributo `CustomerId` a Voice ID. `CustomerId` puede ser un número de cliente de su CRM, por ejemplo. Puede crear una función de Lambda para extraer el ID de cliente único del intermediario de su sistema CRM. Voice ID utiliza este atributo como el `CustomerSpeakerId` para el intermediario.
**nota**
`CustomerId` puede ser un valor alfanumérico. Solo admite los caracteres especiales \$1 y - (subrayado y guion). No es necesario que sea UUID. Dado que Voice ID almacena la información biométrica de cada hablante, te recomendamos encarecidamente que utilices un identificador que no contenga información personal identificable en el CustomerSpeakerId campo. Para obtener más información, consulte `CustomerSpeakerId` en el tipo de datos [Speaker](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_Speaker.html).
+ [Comprobación de ID de voz](check-voice-id.md): se utiliza para comprobar la respuesta de Voice ID para comprobar el estado de inscripción, la autenticación por voz y la detección de fraudes y, a continuación, hacer una ramificación en función de uno de los estados devueltos.
### Ejemplo de flujo de Voice ID
**Intermediario no inscrito**
1. Cuando un cliente llama por primera vez, se pasa `CustomerId` a Voice ID mediante el bloque [Establecer atributos de contacto](set-contact-attributes.md).
1. Voice ID busca `CustomerId` en su base de datos. Como no está, envía el mensaje de resultado **No inscrito**. El bloque [Comprobación de ID de voz](check-voice-id.md) se ramifica en función de este resultado y usted puede decidir cuál debe ser el siguiente paso. Por ejemplo, es posible que desee que los agentes inscriban al cliente en la autenticación de voz.
1. Voice ID comienza a escuchar la voz del cliente cuando el contacto encuentra el bloque [Establecer ID de voz](set-voice-id.md), cuando Voice ID está habilitado. Escucha hasta acumular 30 segundos de voz neta o hasta que finalice la llamada, lo que ocurra primero.
**Intermediario inscrito**
1. La próxima vez que el cliente llame, Voice ID lo encontrará su `CustomerId` en la base de datos.
1. Voice ID comienza a escuchar el audio para crear una huella de voz. La huella vocal que se crea esta vez se utiliza con fines de autenticación para que Voice ID pueda comparar si el intermediario se había inscrito anteriormente.
1. Compara la huella vocal actual del intermediario con la huella vocal almacenada asociada a la identidad solicitada. Devuelve un resultado basado en la propiedad **Umbral de autenticación** que configuró en el bloque [Establecer ID de voz](set-voice-id.md).
1. Tras evaluar la voz, devuelve el mensaje **Autenticado** si las huellas de voz son similares. O devuelve uno de los otros estados.
1. A continuación, el contacto se enruta por la ramificación correspondiente por el bloque [Comprobación de ID de voz](check-voice-id.md).
# Permisos de perfil de seguridad para Amazon Connect Voice ID
**nota**
Aviso de fin de soporte: el 20 de mayo de 2026, AWS finalizará el soporte para Amazon Connect Voice ID. Después del 20 de mayo de 2026, ya no podrás acceder a Voice ID en la consola Amazon Connect, acceder a las funciones de Voice ID en el sitio web de Amazon Connect administración o el Panel de control de contactos, ni acceder a los recursos de Voice ID. Para obtener más información, visite [Fin del soporte de Amazon Connect Voice ID](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
+ Para que los usuarios puedan buscar contactos por su estado de Voice ID, asigne los siguientes permisos de **Análisis y optimización** a su perfil de seguridad:
+ **ID de voz: atributos y búsqueda**: permite a los usuarios buscar y ver los resultados de Voice ID en la página **Datos de contacto**.
+ Para conceder a los agentes acceso a Voice ID en el Panel de control de contacto, asigne el siguiente permiso en el grupo **Panel de control de contacto**:
+ **ID de voz - Acceso**: habilita controles en el Panel de control de contacto para que los agentes puedan:
+ Ver los resultados de autenticación.
+ Excluir o volver a autenticar a un intermediario.
+ Actualizar `SpeakerID`.
+ Ver los resultados de la detección de fraude y volver a ejecutar el análisis de fraude (decisión de detección de fraude, tipo de fraude y puntuación).
**nota**
La funcionalidad para introducir o actualizar `SpeakerID` no está disponible en el widget Voice ID predeterminado del CCP. Para incluir la opción de actualización de `SpeakerID`, implemente la API `updateVoiceIdSpeakerId` de [Amazon Connect Streams](https://github.com/aws/amazon-connect-streams) en su CCP personalizado.
En la siguiente imagen se muestra un ejemplo de estos controles en el CCP:
![\[El panel de control de contacto (CCP) muestra los controles de Voice ID, incluidos el estado de la suscripción, el resultado de la autenticación y los botones para inscribir o cancelar la suscripción de clientes.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/voiceid-ccp-controls.png)
Para obtener información acerca de cómo agregar más permisos a un perfil de seguridad existente, consulte [Actualización de los perfiles de seguridad predeterminados en Amazon Connect](update-security-profiles.md).
De forma predeterminada, el perfil de seguridad **Administrador** ya tiene permisos para realizar todas las actividades de Voice ID.
# Búsqueda y revisión de los resultados de la autenticación de Voice ID
**nota**
Aviso de fin de soporte: el 20 de mayo de 2026, AWS finalizará el soporte para Amazon Connect Voice ID. Después del 20 de mayo de 2026, ya no podrás acceder a Voice ID en la consola Amazon Connect, acceder a las funciones de Voice ID en el sitio web de Amazon Connect administración o el Panel de control de contactos, ni acceder a los recursos de Voice ID. Para obtener más información, visite [Fin del soporte de Amazon Connect Voice ID](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
Utilice la página [Búsqueda de contactos](contact-search.md) para buscar y consultar los resultados del estado de inscripción, la autenticación por voz y la detección de estafadores en una lista de control. Con los [permisos de perfil de seguridad](contact-search.md#required-permissions-search-contacts) necesarios (**Análisis y optimización**, **ID de voz: atributos y búsqueda - Ver**), puede buscar los resultados de Voice ID mediante los siguientes filtros:
+ **Acciones del hablante**: utilice este filtro para buscar contactos en los que el intermediario estaba inscrito en Voice ID o eligió excluirse totalmente de Voice ID.
+ **Resultado de la autenticación**: utilice este filtro para buscar contactos en los que la autenticación por Voice ID ha devuelto los siguientes resultados:
+ Autenticado
+ No autenticado
+ Excluido
+ No concluyente
+ No inscrito
Por ejemplo, si desea buscar todos los contactos en los que se devolvió el estado de autenticación **No autenticado** o **Excluido**, seleccione ambas opciones y elija **Aplicar**.
+ **Resultado de la detección de fraude**: utilice este filtro para buscar contactos en los que el análisis de fraude con Voice ID ha devuelto los siguientes resultados:
+ Alto riesgo de fraude
+ Bajo riesgo de fraude
+ No concluyente
+ **Motivo de la detección de fraude**: utilice este filtro para buscar contactos en los que se hayan detectado mecanismos específicos de riesgo de fraude:
+ Estafador conocido: la voz del intermediario coincide con la de un estafador de la lista de control de estafadores que usted ha creado.
+ Suplantación de voz: el intermediario está modificando su voz o está utilizando la síntesis de voz para suplantar al agente.
## Resultados de Voice ID en un registro de contactos
Después de buscar un contacto, puede elegir un ID para ver su registro de contacto. En la siguiente imagen se muestra un ejemplo de los campos de la sección Voice ID del registro de contacto:
![\[La sección Voice ID de un campo de registro de contacto que muestra resultados de autenticación, estado de detección de estafadores, ID de estafador e ID de lista de control.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/voiceid-ctr-nospoofing.png)
# Administra el Voice ID de Amazon Connect con el Voice ID APIs
**nota**
Aviso de fin de soporte: el 20 de mayo de 2026, AWS finalizará el soporte para Amazon Connect Voice ID. Después del 20 de mayo de 2026, ya no podrás acceder a Voice ID en la consola Amazon Connect, acceder a las funciones de Voice ID en el sitio web de Amazon Connect administración o el Panel de control de contactos, ni acceder a los recursos de Voice ID. Para obtener más información, visite [Fin del soporte de Amazon Connect Voice ID](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
Para gestionar el Voice ID mediante programación, consulte [Amazon Connect Voice](https://docs.aws.amazon.com/voiceid/latest/APIReference/) ID. APIs
En esta sección se explica cómo realizar situaciones comunes con el Voice ID. APIs
**Topics**
+ [Administración de dominios de Amazon Connect Voice ID](voiceid-domain-operations.md)
+ [Asociación de integración de Amazon Connect APIs](voiceid-integration-association-apis.md)
+ [Gestión de oradores, listas de seguimiento y defraudadores APIs](voiceid-speaker-fraudster-management-apis.md)
+ [Inscripción por lotes en Amazon Connect Voice ID utilizando datos de audio de llamadas anteriores](voiceid-batch-enrollment.md)
+ [Esquema de archivos para el trabajo de inscripción de interlocutores](speaker-enrollment-job-schema.md)
+ [Creación y edición de una lista de control de estafadores en Amazon Connect Voice ID](voiceid-fraudster-watchlist.md)
+ [Esquema de archivos para el trabajo de registro de estafadores](fraudster-registration-schema.md)
+ [Amazon Connect Streams APIs integrará Voice ID](voiceid-streams-apis.md)
# Administración de dominios de Amazon Connect Voice ID
**nota**
Aviso de fin de soporte: el 20 de mayo de 2026, AWS finalizará el soporte para Amazon Connect Voice ID. Después del 20 de mayo de 2026, ya no podrás acceder a Voice ID en la consola Amazon Connect, acceder a las funciones de Voice ID en el sitio web de Amazon Connect administración o el Panel de control de contactos, ni acceder a los recursos de Voice ID. Para obtener más información, visite [Fin del soporte de Amazon Connect Voice ID](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
El Voice ID de Amazon Connect le permite APIs gestionar los dominios de Voice ID. Puedes encontrar los equivalentes para crear, describir, enumerar y actualizar en la AWS consola.
1. [CreateDomain](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_CreateDomain.html): Para crear un nuevo dominio de Voice ID, usa la API de `CreateDomain` Voice ID. Cuando se crea el dominio de Voice ID, se crea al mismo tiempo una lista de control de estafadores predeterminada para incluir a los estafadores.
Tenga en cuenta las siguientes directrices cuando utilice la API `CreateDomain`:
+ Solo puedes invocarlo para tu cuenta después de haber reconocido el consentimiento de la BIPA en la AWS consola.
+ También debe especificar la clave de KMS del dominio de Voice ID en el momento de la creación.
+ Tras crear un dominio de Voice ID, usa la [asociación Amazon Connect APIs](https://docs.aws.amazon.com/connect/latest/APIReference/) para asociarlo a una instancia de Amazon Connect.
1. [DeleteDomain](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DeleteDomain.html): Para eliminar un dominio de Voice ID, debes invocar la API de `DeleteDomain` Voice ID y proporcionar el ID de dominio. Si este dominio estaba asociado a una instancia de Amazon Connect, las llamadas a la API de Voice ID y los bloques de flujo de Voice ID devolverán un error de tiempo de ejecución. Al eliminar un dominio de Voice ID, se eliminan todos los datos de clientes almacenados, como las grabaciones de audio, las huellas de voz y los identificadores de interlocutor, así como las listas de estafadores que haya administrado.
1. [DescribeDomain](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DescribeDomain.html): Usa esta API para devolver el nombre, la descripción y la configuración de cifrado de un dominio existente identificado por su`DomainID`.
1. [ListDomains](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_ListDomains.html): Usa esta API para enumerar todos los dominios de Voice ID que son propiedad de tu cuenta en la región.
1. [UpdateDomain](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_UpdateDomain.html): Para actualizar el nombre y la configuración de cifrado de un dominio, puedes usar la API de `UpdateDomain` Voice ID. Esta API bloquea los atributos existentes y usted debe proporcionar ambos campos.
Al cambiar la clave de KMS asociada al dominio de Voice ID, tras la llamada a `UpdateDomain`, los datos existentes de su dominio se volverán a cifrar de forma asíncrona con la nueva clave de KMS. Puede comprobar el estado de este proceso desde el atributo `ServerSideEncryptionUpdateDetails` de su dominio mediante la API `DescribeDomain`. Mientras este proceso de actualización esté en curso, debe conservar su antigua clave de KMS en un estado accesible; de lo contrario, se puede producir un error en el proceso. Una vez finalizado este proceso, la antigua clave de KMS podrá retirarse de forma segura.
# Asociación de integración de Voice ID y Amazon Connect APIs
**nota**
Aviso de fin de soporte: el 20 de mayo de 2026, AWS finalizará el soporte para Amazon Connect Voice ID. Después del 20 de mayo de 2026, ya no podrás acceder a Voice ID en la consola Amazon Connect, acceder a las funciones de Voice ID en el sitio web de Amazon Connect administración o el Panel de control de contactos, ni acceder a los recursos de Voice ID. Para obtener más información, visite [Fin del soporte de Amazon Connect Voice ID](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
Puede utilizar lo siguiente APIs para gestionar las asociaciones con las instancias de Amazon Connect. También puede realizar estas operaciones en la AWS consola.
1. [CreateIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateIntegrationAssociation.html): Para habilitar Voice ID en una instancia de Amazon Connect, tendrás que asociar un dominio de Voice ID a una instancia de Amazon Connect mediante una `CreateIntegrationAssociation` solicitud. Solo puede asociar un dominio de Voice ID a una instancia de Amazon Connect. Si la instancia ya está asociada a un dominio, la API devuelve el siguiente error:
`DuplicateResourceException` (409): la solicitud intenta crear un recurso duplicado.
**nota**
Cuando habilitas Voice ID para una instancia de Amazon Connect (mediante la consola Amazon Connect o la [CreateIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateIntegrationAssociation.html)API), Amazon Connect crea una EventBridge regla de Amazon gestionada en tu cuenta. Esta regla se usa para la ingesta de eventos de Voice ID a fin de crear registros de contacto relacionados con Voice ID. Además, Amazon Connect agrega [permisos de Voice ID](connect-slr.md) al rol vinculado al servicio de Amazon Connect.
1. [DeleteIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_DeleteIntegrationAssociation.html): Para eliminar una asociación existente entre una instancia de Amazon Connect y un dominio de Voice ID, tendrás que llamar a la instancia `DeleteIntegrationAssociation` APIs junto con el InstanceID de Amazon Connect y `IntegrationAssociationID` el devuelto por. `CreateIntegrationAssociation` Este paso es obligatorio si desea asociar un dominio de Voice ID diferente a esta instancia de Amazon Connect. No recomendamos eliminar las asociaciones en una configuración de producción, ya que esto puede provocar un comportamiento impredecible en Voice ID de su instancia de Amazon Connect.
1. [ListIntegrationAssociations](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListIntegrationAssociations.html): Para enumerar todas las asociaciones entre los dominios de instancia de Amazon Connect y Voice ID de su cuenta en esta región, puede invocar la `ListIntegrationAssociations` API.
# Gestión de altavoces, listas de seguimiento y defraudadores de Amazon Connect Voice ID APIs
**nota**
Aviso de fin de soporte: el 20 de mayo de 2026, AWS finalizará el soporte para Amazon Connect Voice ID. Después del 20 de mayo de 2026, ya no podrás acceder a Voice ID en la consola Amazon Connect, acceder a las funciones de Voice ID en el sitio web de Amazon Connect administración o el Panel de control de contactos, ni acceder a los recursos de Voice ID. Para obtener más información, visite [Fin del soporte de Amazon Connect Voice ID](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
El identificador de voz de Amazon Connect APIs permite gestionar los altavoces inscritos en un dominio de Voice ID y los estafadores registrados en el dominio. Todos los altavoces APIs, excepto los altavoces`ListSpeakers`, aceptan la `CustomerSpeakerId` o. `GeneratedSpeakerId`
## Gestión de altavoces APIs
1. [DescribeSpeaker](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DescribeSpeaker.html): Describa el [estado de un orador en un dominio (ENROLLED, OPTED\$1OUT, EXPIRED)](voiceid-domain.md#voiceid-speaker-enrollments) y asigne a `GeneratedSpeakerId` a a y `CustomerSpeakerId` viceversa.
1. [DeleteSpeaker](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DeleteSpeaker.html): Elimina por completo todos los registros de a de un dominio caller/speaker de Voice ID. Todas las huellas de voz y el estado de inscripción se eliminan inmediatamente y las grabaciones de audio asociadas se eliminan en un plazo de 24 horas.
1. [ListSpeakers](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_ListSpeakers.html): Muestra todos los altavoces cuyas entradas están presentes en un dominio de Voice ID. Esta API devuelve tanto el interlocutor como `CustomerSpeakerId` y `GeneratedSpeakerId` correspondiente a un interlocutor. Devuelve un resultado paginado con el tamaño de página indicado en la solicitud de la API.
1. [OptOutSpeaker](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_OptOutSpeaker.html): excluya a una persona que llama desde un dominio de Voice ID. Esta API no requiere que el interlocutor esté presente en Voice ID. Se puede excluir a un interlocutor inexistente mediante esta API. Voice ID hace persistir el estado de exclusión y rechaza futuras solicitudes de inscripción para este interlocutor. La exclusión también elimina las huellas vocales y cualquier grabación de audio almacenada para este intermediario.
## Administración de listas de seguimiento APIs
1. [CreateWatchlist](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_CreateWatchlist.html): Cree una lista de seguimiento de la que puedan formar parte los estafadores.
1. [DeleteWatchlist](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DeleteWatchlist.html): Elimina una lista de seguimiento de defraudadores personalizada del dominio de Voice ID. Para eliminar una lista de control, debe estar vacía. Es decir, no debe tener ningún estafador asociado. Puedes usar la [DeleteFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DeleteFraudster.html)o para eliminar [DisassociateFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DisassociateFraudster.html) APIs a todos los defraudadores de una lista de seguimiento.
No puede eliminar la lista de control predeterminada de un dominio de Voice ID.
1. [DescribeWatchlist](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DescribeWatchlist.html): Determina si se trata de una lista de seguimiento de defraudadores predeterminada o de una lista de seguimiento personalizada que tú hayas creado, y obtén los detalles de la lista de seguimiento.
1. [ListWatchlists](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_ListWatchlists.html): Enumera todas las listas de seguimiento del dominio de Voice ID.
1. [UpdateWatchlist](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_UpdateWatchlist.html): actualiza el nombre y la descripción de una lista de seguimiento de defraudadores personalizada. No puede modificar los detalles de la lista de control predeterminada porque la administra Voice ID.
## Gestión de defraudadores APIs
1. [AssociateFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_AssociateFraudster.html): Asocie a un defraudador a una lista de seguimiento del mismo dominio. Puede asociar a un estafador a varias listas de control de un dominio.
1. [DeleteFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DeleteFraudster.html): elimina a un defraudador de un dominio de Voice ID. Al eliminar al estafador, se elimina de todas las listas de control de las que forma parte. También elimina todas las huellas de voz y las grabaciones de audio asociadas en un plazo de 24 horas.
1. [DescribeFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DescribeFraudster.html): describe el estado de un defraudador en el dominio de Voice ID.
1. [DisassociateFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DisassociateFraudster.html): disocia a un defraudador de la lista de seguimiento especificada. Tenga en cuenta que un estafador siempre tiene que estar asociado al menos a una lista de control de estafadores. Se generará una excepción si se intenta desasociar a un estafador de su única lista de control.
Para eliminar al estafador por completo, utilice `DeleteFraudster`.
1. [ListFraudsters](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_ListFraudsters.html): Enumere todos los estafadores de un dominio o una lista de seguimiento específica. Esta API también devuelve las listas de control de las que forma parte el estafador. Devuelve un resultado paginado con el tamaño de página indicado en la solicitud de la API.
# Inscripción por lotes en Amazon Connect Voice ID utilizando datos de audio de llamadas anteriores
**nota**
Aviso de fin de soporte: el 20 de mayo de 2026, AWS finalizará el soporte para Amazon Connect Voice ID. Después del 20 de mayo de 2026, ya no podrás acceder a Voice ID en la consola Amazon Connect, acceder a las funciones de Voice ID en el sitio web de Amazon Connect administración o el Panel de control de contactos, ni acceder a los recursos de Voice ID. Para obtener más información, visite [Fin del soporte de Amazon Connect Voice ID](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
Puede empezar a utilizar la biometría si inscribe por lotes a los clientes que ya han dado su consentimiento para la biometría. Con las grabaciones de audio almacenadas en tu bucket S3 y un archivo de entrada JSON que proporciona el identificador del altavoz y un enlace a las grabaciones de audio, puedes invocar el [lote APIs de Voice ID](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_StartSpeakerEnrollmentJob.html).
Para inscribir clientes mediante programación, pase los siguientes datos a la API:
1. El ID de dominio para especificar el dominio al que se van a asociar las grabaciones.
1. La ubicación del archivo de salida.
1. Un archivo de entrada que contiene una lista de interlocutores. Consulte [Esquema de archivos de entrada y salida para el trabajo de inscripción de interlocutores en Amazon Connect Voice ID](speaker-enrollment-job-schema.md).
Para cada interlocutor, el archivo debe incluir:
+ Un enlace a la grabación de audio de una llamada en un archivo.wav con una frecuencia de KHz muestreo del 8% y codificación PCM-16.
+ El `CustomerSpeakerId` correspondiente al cliente.
+ Un canal para el intermediario en la grabación de audio. Si el audio tiene varios canales, puede seleccionar solo uno.
1. Una clave de KMS que se utilizará al escribir el resultado.
1. Un rol que Voice ID puede asumir. Debe tener acceso al bucket de S3 donde se almacenan los archivos de audio. Este rol debe tener acceso a cualquier clave de KMS utilizada para cifrar los archivos. También debe poder escribir en la ubicación de salida especificada y utilizar la clave de KMS solicitada para escribir el resultado. Específicamente, debe tener los siguientes permisos:
+ `s3:GetObject` en el bucket de entrada.
+ `s3:PutObject` en el bucket de salida.
+ `kms:Decrypt` en la clave de KMS utilizada para el cifrado predeterminado del bucket de entrada.
+ `kms:Decrypt` y `kms:GenerateDataKey` en la clave de KMS proporcionada en la entrada, que se utilizará para escribir el archivo de salida en el bucket de salida.
Debe tener permisos `iam:PassRole` para realizar la llamada y proporcionar `dataAccessRole`. Para habilitar la protección de suplente confuso para `dataAccessRole`, consulte [Prevención de suplente confuso por servicios de Amazon Connect Voice ID](cross-service-confused-deputy-prevention.md#voiceid-cross-service).
1. Si lo desea, una marca de omisión de comprobación de fraude en caso de que desee omitir las comprobaciones de fraude y suplantación de voz en el audio de inscripción.
1. Si lo desea, especifique una lista de control de estafadores en la que desee realizar comprobaciones de fraude. Si no se especifica ninguna lista de control, Voice ID utiliza la lista de control de estafadores predeterminada para el dominio.
1. Si lo desea, el umbral de fraude en caso de que desee aumentar o reducir el riesgo.
1. Si lo desea, una marca para volver a inscribir a los clientes inscritos. Esto resulta útil si desea actualizar la grabación de audio, ya que la opción predeterminada es ignorar a los clientes inscritos previamente.
La inscripción por lotes devuelve el estado `CustomerSpeakerId`, `GeneratedSpeakerId` y asociado a cada entrada. Almacena estos datos en un archivo JSON en la ruta de salida que especifique en la API.
**nota**
Se le cobrará la inscripción de interlocutores. Para obtener más información, consulte [Precios de Amazon Connect Voice ID](https://aws.amazon.com/connect/pricing/).
# Esquema de archivos de entrada y salida para el trabajo de inscripción de interlocutores en Amazon Connect Voice ID
**nota**
Aviso de fin de soporte: el 20 de mayo de 2026, AWS finalizará el soporte para Amazon Connect Voice ID. Después del 20 de mayo de 2026, ya no podrás acceder a Voice ID en la consola Amazon Connect, acceder a las funciones de Voice ID en el sitio web de Amazon Connect administración o el Panel de control de contactos, ni acceder a los recursos de Voice ID. Para obtener más información, visite [Fin del soporte de Amazon Connect Voice ID](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
## Esquema de archivo de entrada
A continuación, se presenta el esquema del archivo de manifiesto de entrada para el trabajo de inscripción de interlocutores:
```
{
"Version": "string",
"SpeakerEnrollmentRequests": [
{
"RequestId": "string",
"SpeakerId": "string",
"AudioSpecifications": [
{
"S3Uri": "string",
"ChannelId": number
}
]
}
]
}
```
**nota**
Todos los campos del esquema son **obligatorios**.
A continuación, se describe cada atributo del esquema de entrada.
+ `Version`: versión del documento de esquema de entrada. En la actualidad tiene que ser `1.0`.
+ `SpeakerEnrollmentRequests`: lista de solicitudes de inscripción de interlocutores que deben procesarse como parte del trabajo.
+ `RequestId`: un identificador para esta solicitud de inscripción de interlocutores. Debe ser único en el archivo de entrada. Se utiliza para asignar e identificar las entradas del archivo de salida.
+ `SpeakerId`: el identificador proporcionado por el cliente del interlocutor que debe inscribirse. Debe pasar `CustomerSpeakerId` en este campo. Actualmente, no se admite la API `GeneratedSpeakerId`.
+ `AudioSpecifications`: la lista de archivos de audio que Voice ID puede utilizar para inscribir a este interlocutor. Voice ID utiliza estos archivos de audio juntos para recopilar la cantidad de voz necesaria para la inscripción. Actualmente, la cantidad máxima de archivos de audio permitida para una solicitud de inscripción es de **10**. Cada archivo puede ser un archivo.wav de hasta 20 MB y contener audio con una frecuencia de KHz muestreo del 8% y codificación PCM-16.
+ `S3URI`: la ubicación de Amazon S3 del archivo de audio en formato .wav que debe usarse para inscribir al interlocutor.
+ `ChannelId`: el canal de audio que se utilizará para inscribir al interlocutor en un archivo de audio multicanal. Voice ID admite archivos de audio de hasta dos canales, por lo que este valor se limita a **0** o **1**.
## Esquema de archivo de salida
A continuación, se presenta el esquema del archivo de salida para el trabajo de inscripción de interlocutores:
```
{
"Version": "string",
"Errors": [
{
"RequestId": "string",
"ErrorCode": number,
"ErrorMessage": "string"
}
],
"SuccessfulEnrollments": [
{
"RequestId": "string",
"GeneratedSpeakerId": "string",
"CustomerSpeakerId": "string",
"EnrollmentStatus": "DUPLICATE_SKIPPED" | "NEW_ENROLLMENT" | "ENROLLMENT_OVERWRITE"
}
]
}
```
A continuación, se describe cada atributo del esquema de salida.
+ `Version`: versión del documento de esquema de salida. En la actualidad tiene que ser `1.0`.
+ `Errors`: la lista de errores de las solicitudes de inscripción de interlocutores que han generado error en algún momento durante la inscripción.
+
+ `RequestId`: el identificador de solicitud asociado a esta solicitud. Es el mismo que el `RequestId` especificado en el archivo de entrada de esta solicitud.
+ `ErrorCode`: el código de error HTTP que representa el tipo de error. A continuación, se describen algunos ejemplos de escenarios de error.
**nota**
No es una lista exhaustiva.
+ 400 (excepción de solicitud incorrecta):
+ El archivo JSON de entrada tiene un formato incorrecto y no se puede analizar.
+ Los archivos de audio proporcionados no tienen suficiente voz para la inscripción.
+ Las comprobaciones de verificación de fraude no se realizaron correctamente para el interlocutor en cuestión.
+ 402 (): ServiceQuotaLimitExceededException
+ Límite de interlocutores superado.
+ 409 (excepción de conflicto):
+ Acción conflictiva: no puede solicitar la inscripción de un interlocutor excluido.
+ 500 (error interno):
+ Error interno del servidor (error inesperado en el servicio).
+ `ErrorMessage`: un mensaje que describe la causa del error de inscripción.
+ `SuccessfulEnrollments`: la lista de solicitudes de inscripción que se han realizado correctamente.
+ `RequestId`: el identificador de solicitud asociado a esta solicitud. Es el mismo que el `RequestId` especificado en el archivo de entrada de esta solicitud.
+ `CustomerSpeakerId`: el identificador proporcionado por el cliente del interlocutor que se ha inscrito.
+ `GeneratedSpeakerId`: el identificador generado por el servicio para el interlocutor que se ha inscrito.
+ `EnrollmentStatus`: el estado de inscripción correcta del interlocutor.
+ `DUPLICATE_SKIPPED`: el interlocutor ya está inscrito y se ha omitido la inscripción.
+ `NEW_ENROLLMENT`: el interlocutor se ha inscrito recientemente en el sistema.
+ `ENROLLMENT_OVERWRITE`: el interlocutor ya está inscrito, pero se volvió a inscribir o sobrescribió con el nuevo audio.
# Creación y edición de una lista de control de estafadores en Amazon Connect Voice ID
**nota**
Aviso de fin de soporte: el 20 de mayo de 2026, AWS finalizará el soporte para Amazon Connect Voice ID. Después del 20 de mayo de 2026, ya no podrás acceder a Voice ID en la consola Amazon Connect, acceder a las funciones de Voice ID en el sitio web de Amazon Connect administración o el Panel de control de contactos, ni acceder a los recursos de Voice ID. Para obtener más información, visite [Fin del soporte de Amazon Connect Voice ID](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
Usa lo siguiente APIs para crear una lista de vigilancia de defraudadores y registrarlos:
1. Utilice la [CreateWatchlist](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_CreateWatchlist.html)API para crear nuevas listas de vigilancia de defraudadores.
1. Utilice la [StartFraudsterRegistrationJob](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_StartFraudsterRegistrationJob.html)API para el registro de lotes. Puede registrar a nuevos estafadores en la nueva lista de control o registrarlos en la lista de control predeterminada que está asociada al dominio de Voice ID.
Al registrar un nuevo estafador, Voice ID compara la huella de voz con la de todos los estafadores registrados en su dominio de Voice ID para determinar si se trata de un duplicado de un estafador existente.
Para agregar a los estafadores a una lista de control específica, pase los siguientes datos a la API:
1. El ID de dominio para especificar el dominio al que se van a asociar las grabaciones.
1. Un archivo de entrada que contiene una lista de estafadores. Consulte [Esquema de archivos de entrada y salida para el trabajo de registro de estafadores en Amazon Connect Voice ID](fraudster-registration-schema.md).
1. La ubicación del archivo de salida.
1. Una clave de KMS que se utilizará al escribir el resultado.
1. Un rol que Voice ID puede asumir. Debe tener acceso al bucket de S3 donde se almacenan los archivos de audio. Este rol debe tener acceso a cualquier clave de KMS utilizada para cifrar los archivos. También debe poder escribir en la ubicación de salida especificada y utilizar la clave de KMS solicitada para escribir el resultado. Específicamente, debe tener los siguientes permisos:
+ `s3:GetObject` en el bucket de entrada.
+ `s3:PutObject` en el bucket de salida.
+ `kms:Decrypt` en la clave de KMS utilizada para el cifrado predeterminado del bucket de entrada.
+ `kms:Decrypt` y `kms:GenerateDataKey` en la clave de KMS proporcionada en la entrada, que se utilizará para escribir el archivo de salida en el bucket de salida.
Debe tener permisos `iam:PassRole` para realizar la llamada y proporcionar `dataAccessRole`. Para habilitar la protección de suplente confuso para `dataAccessRole`, consulte [Prevención de suplente confuso por servicios de Amazon Connect Voice ID](cross-service-confused-deputy-prevention.md#voiceid-cross-service).
1. Un identificador de lista de control en la que se registrará el estafador. Si no se especifica watchlistId, los estafadores se registran en la lista de control predeterminada para ese dominio de Voice ID.
1. El umbral para establecer el estado de duplicación de los estafadores.
1. Una marca para ignorar los duplicados de estafadores.
Voice ID actualiza la lista de estafadores con las incorporaciones correctas y devuelve un `GeneratedFraudsterID` asociada con la entrada a la misma ubicación de S3. Si se identifican duplicados, Voice ID devuelve el estado “duplicado” a la entrada y proporciona la coincidencia más próxima de `GeneratedFraudsterId`. Una vez que un defraudador se haya registrado correctamente, puede asociar al defraudador identificado por el `GeneratedFraudsterID` a una nueva lista de seguimiento mediante la API. [AssociateFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_AssociateFraudster.html)
Voice ID no es capaz de realizar la detección de estafadores en una lista de control antes de que se cree la lista de estafadores.
Para conocer las cuotas de la lista de estafadores, consulte [Amazon Connect cuotas de servicio](amazon-connect-service-limits.md).
**nota**
Se le cobrará por agregarlo a la lista de estafadores. Para obtener más información, consulte [Precios de Amazon Connect Voice ID](https://aws.amazon.com/connect/voice-id/).
# Esquema de archivos de entrada y salida para el trabajo de registro de estafadores en Amazon Connect Voice ID
**nota**
Aviso de fin de soporte: el 20 de mayo de 2026, AWS finalizará el soporte para Amazon Connect Voice ID. Después del 20 de mayo de 2026, ya no podrás acceder a Voice ID en la consola Amazon Connect, acceder a las funciones de Voice ID en el sitio web de Amazon Connect administración o el Panel de control de contactos, ni acceder a los recursos de Voice ID. Para obtener más información, visite [Fin del soporte de Amazon Connect Voice ID](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
## Esquema de archivo de entrada
A continuación, se muestra el esquema del archivo de manifiesto de entrada para los trabajos de registro de estafadores:
```
{
"Version": "string",
"FraudsterRegistrationRequests": [
{
"RequestId": "string",
"AudioSpecifications": [
{
"S3Uri": "string",
"ChannelId": number
}
]
}
]
}
```
**nota**
Todos los campos del esquema son **obligatorios**.
A continuación, se describe cada atributo del esquema de entrada.
+ `Version`: versión del documento de esquema. En la actualidad tiene que ser `1.0`.
+ `FraudsterRegistrationRequests`: lista de solicitudes de registro de estafadores que deben procesarse como parte del trabajo.
+ `RequestId`: un identificador para esta solicitud de registro de estafador. Debe ser único en el archivo de entrada. Se utiliza para asignar e identificar las entradas del archivo de salida.
+ `AudioSpecifications`: la lista de archivos de audio que Voice ID puede utilizar para registrar a este estafador. Voice ID utiliza estos archivos de audio juntos para recopilar la cantidad de voz necesaria para el registro. Actualmente, la cantidad máxima de archivos de audio permitida para una solicitud de registro es de **10**. Cada archivo puede ser un archivo.wav de hasta 20 MB y contener audio con una frecuencia de KHz muestreo del 8% y codificación PCM-16.
+ `S3URI`: la ubicación de Amazon S3 del archivo de audio en formato .wav que utilizarse usarse para registrar al estafador.
+ `ChannelId`: el canal de audio que se utilizará para registrar al estafador en un archivo de audio multicanal. Voice ID admite archivos de audio de hasta dos canales, por lo que este valor se limita a **0** o **1**.
## Esquema de archivo de salida
A continuación, se muestra el esquema del archivo de manifiesto de salida para los trabajos de registro de estafadores:
```
{
"Version": "string",
"Errors": [
{
"RequestId": "string",
"ErrorCode": number,
"ErrorMessage": "string"
}
],
"SuccessfulRegistrations": [
{
"RequestId": "string",
"GeneratedFraudsterId": "string",
"RegistrationStatus": "DUPLICATE_SKIPPED" | "NEW_REGISTRATION",
"FraudsterSimilarityScore": number
}
]
}
```
A continuación, se describe cada atributo del esquema de salida.
+ `Version`: versión del documento de esquema de salida. En la actualidad tiene que ser `1.0`.
+ `Errors`: la lista de errores de las solicitudes de registro de estafadores que han generado un error en algún momento del registro.
+
+ `RequestId`: el identificador de solicitud asociado a esta solicitud. Es el mismo que el `RequestId` especificado en el archivo de entrada de esta solicitud.
+ `ErrorCode`: el código de error HTTP que representa el tipo de error. A continuación, se describen algunos ejemplos de escenarios de error.
**nota**
No es una lista exhaustiva.
+ 400 (excepción de solicitud incorrecta):
+ El archivo JSON de entrada tiene un formato incorrecto y no se puede analizar.
+ Los archivos de audio proporcionados no tienen suficiente voz para el registro.
+ 402 (): ServiceQuotaLimitExceededException
+ Límite de estafadores superado.
+ 500 (error interno):
+ Error interno del servidor (error inesperado en el servicio).
+ `ErrorMessage`: mensaje en el que se describe la causa del error de registro del estafador.
+ `SuccessfulRegistrations`: lista de solicitudes de registro que se han realizado correctamente.
+ `RequestId`: el identificador de solicitud asociado a esta solicitud. Es el mismo que el `RequestId` especificado en el archivo de entrada de esta solicitud.
+ `RegistrationStatus`: estado en el que se ha registrado correctamente el estafador.
+ `DUPLICATE_SKIPPED`: se ha identificado al estafador como un duplicado y se ha omitido el registro.
+ `NEW_FRAUDSTER`: el estafador se ha registrado recientemente en el sistema.
+ `GeneratedFraudsterId`: el identificador generado por el servicio para el estafador que estaba registrado. En caso de que `RegistrationStatus` sea `DUPLICATE_SKIPPED`, se trata del identificador del estafador que ya se encuentra en el dominio más parecido al estafador en cuestión.
+ `FraudsterSimilarityScore`: campo opcional que se rellena cuando se omite el registro del estafador por tratarse de un duplicado. Esto representa la similitud del estafador en cuestión con el estafador más cercano que ya existe en el dominio.
# Amazon Connect Streams APIs integrará Voice ID
**nota**
Aviso de fin de soporte: el 20 de mayo de 2026, AWS finalizará el soporte para Amazon Connect Voice ID. Después del 20 de mayo de 2026, ya no podrás acceder a Voice ID en la consola Amazon Connect, acceder a las funciones de Voice ID en el sitio web de Amazon Connect administración o el Panel de control de contactos, ni acceder a los recursos de Voice ID. Para obtener más información, visite [Fin del soporte de Amazon Connect Voice ID](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
Utilice las siguientes [transmisiones de Amazon Connect](https://github.com/aws/amazon-connect-streams) APIs para integrar Voice ID en las aplicaciones web de sus agentes existentes.
+ `enrollSpeakerInVoiceId`: inscribir a un cliente en Voice ID tras obtener su consentimiento para la inscripción.
+ `evaluateSpeakerWithVoiceId`: comprobar el estado de autenticación de Voice ID del cliente y detectar a los estafadores.
+ `optOutVoiceIdSpeaker`: excluir a un cliente de Voice ID.
+ `getVoiceIdSpeakerStatus`: describir el estado de inscripción de un cliente.
+ `getVoiceIdSpeakerId`: obtener el `SpeakerID` para un cliente.
+ `updateVoiceIdSpeakerId`: actualizar el `SpeakerID` para un cliente.
También puede utilizar el widget Voice ID en el Panel de control de contacto (CCP) si no desea crear una interfaz de agente personalizada. Para obtener más información acerca de Voice ID en el CCP, consulte [Inscripción de las personas que llaman en ID de voz en el Panel de control de contacto (CCP)](use-voiceid.md).
# Esquema de eventos de Amazon Connect Voice ID
**nota**
Aviso de fin de soporte: el 20 de mayo de 2026, AWS finalizará el soporte para Amazon Connect Voice ID. Después del 20 de mayo de 2026, ya no podrás acceder a Voice ID en la consola Amazon Connect, acceder a las funciones de Voice ID en el sitio web de Amazon Connect administración o el Panel de control de contactos, ni acceder a los recursos de Voice ID. Para obtener más información, visite [Fin del soporte de Amazon Connect Voice ID](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
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](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html).
## 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\$1FRAUDSTER o VOICE\$1SPOOFING.
```
{...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
}
}
}
```