API de administración de altavoces, listas de vigilancia y estafadores de Amazon Connect Voice ID - Amazon Connect

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.

API de administración de altavoces, listas de vigilancia y estafadores 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.

Amazon Connect Voice ID incluye API para administrar los interlocutores inscritos en un dominio de Voice ID y los estafadores registrados en el dominio. Todas las API de interlocutores, excepto ListSpeakers, aceptan CustomerSpeakerId o GeneratedSpeakerId.

API de administración de interlocutores

  1. DescribeSpeaker: describir el estado de un interlocutor en un dominio (ENROLLED, OPTED_OUT o EXPIRED) y asignar GeneratedSpeakerId a CustomerSpeakerId, y viceversa.

  2. DeleteSpeaker: eliminar por completo todos los registros de un intermediario o interlocutor de un dominio 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.

  3. ListSpeakers: enumera todos los interlocutores 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.

  4. OptOutSpeaker: excluir a un intermediario de 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.

API de administración de listas de control

  1. CreateWatchlist: crear una lista de control de la que puedan formar parte los estafadores.

  2. DeleteWatchlist: eliminar una lista de control de estafadores 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. Puede utilizar las API DeleteFraudster o DisassociateFraudster para eliminar a todos los estafadores de una lista de control.

    No puede eliminar la lista de control predeterminada de un dominio de Voice ID.

  3. DescribeWatchlist: determinar si es una lista de control de estafadores predeterminada o si es una lista de control personalizada que usted ha creado, y obtener los detalles de la lista de control.

  4. ListWatchLists: mostrar todas las listas de control del dominio de Voice ID.

  5. UpdateWatchlist: actualizar el nombre y la descripción de una lista de control de estafadores personalizada. No puede modificar los detalles de la lista de control predeterminada porque la administra Voice ID.

API de administración de estafadores

  1. AssociateFraudster: asociar a un estafador a una lista de control del mismo dominio. Puede asociar a un estafador a varias listas de control de un dominio.

  2. DeleteFraudster: elimina a un estafador 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.

  3. DescribeFraudster: describir el estado de un estafador en el dominio de Voice ID.

  4. DisassociateFraudster: desasociar a un estafador de la lista de control 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.

  5. ListFraudsters: enumerar a todos los estafadores de un dominio o una lista de control 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.