Voice ID speaker and fraudster management APIs - Amazon Connect

Voice ID speaker and fraudster management APIs

Amazon Connect Voice ID includes APIs to manage speakers enrolled into a Voice ID domain and fraudsters registered in the domain. All speaker APIs except ListSpeakers accept either the CustomerSpeakerId or GeneratedSpeakerId.

  1. DescribeSpeaker: Use this API to describe a speaker's status in a domain (ENROLLED, OPTED_OUT, EXPIRED), and to map a GeneratedSpeakerId to a CustomerSpeakerId, and vice versa.

  2. OptOutSpeaker: To opt out a caller from a Voice ID domain, you can use this API. This API doesn't require the speaker to be present in Voice ID. A non-existing speaker can be opted-out using this API and Voice ID persists the opted out status and rejects future enrollment requests for this speaker. Opting out also removes voiceprints and any stored audio recordings for this caller.

  3. DeleteSpeaker: To completely remove all records for a caller/speaker from a Voice ID domain, you can use this API. All voiceprints and enrollment status is deleted immediately, and associated audio recordings are removed within 24 hours.

  4. ListSpeakers: To list all the speakers whose entries are present in a Voice ID domain, you can use this API, which returns both the CustomerSpeakerId and GeneratedSpeakerId for a speaker. It returns a paginated output with the page size dictated in the API request.

  5. DescribeFraudster: You can use this API to describe a fraudster's status in the Voice ID domain.

  6. DeleteFraudster: To delete a fraudster from a Voice ID domain, you can use this API. It deletes all voiceprints and any stored audio recordings.