Amazon Connect 语音 ID 扬声器、关注列表和欺诈者管理 APIs - Amazon Connect
扬声器管理 APIs监视列表管理 APIs欺诈者管理 APIs

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

Amazon Connect 语音 ID 扬声器、关注列表和欺诈者管理 APIs

注意

终止支持通知：2026年5月20日， AWS 将终止对Amazon Connect语音识别的支持。2026 年 5 月 20 日之后，您将无法再访问 Amazon Connect 控制台上的语音 ID、访问 Amazon Connect 管理网站或联系人控制面板上的语音识别功能，也无法访问语音 ID 资源。如需了解更多信息，请访问 Amazon Connect 语音识别终止支持。

Amazon Connect 语音 ID 包括 APIs 管理注册到语音 ID 域的演讲者和在该域中注册的欺诈者。除外 APIsListSpeakers，所有发言者均接受CustomerSpeakerId或GeneratedSpeakerId。

扬声器管理 APIs

  1. DescribeSpeaker：描述演讲者在域中的状态（已注册、OPTED_OUT、EXPIRED），然后将 a 映射GeneratedSpeakerId到 aCustomerSpeakerId，反之亦然。

  2. DeleteSpeaker： caller/speaker 从语音 ID 域中完全移除所有记录。所有声纹和注册状态将立即删除，关联的录音将在 24 小时内删除。

  3. ListSpeakers：列出其条目出现在语音识别域中的所有发言者。此 API 会同时返回呼叫方的 CustomerSpeakerId 和 GeneratedSpeakerId。它会按照 API 请求中规定的页面大小返回分页输出。

  4. OptOutSpeaker：从语音 ID 域中退出来电者。此 API 不要求呼叫方出现在 Voice ID 中。使用此 API 可以选择退出不存在的呼叫方，Voice ID 会保持选择退出状态，并拒绝未来对该呼叫方的注册请求。选择退出还会删除该呼叫方的声纹和所有存储的录音。

监视列表管理 APIs

  1. CreateWatchlist: 创建欺诈者可以参与的监视名单。

  2. DeleteWatchlist: 从 Voice ID 域中移除自定义欺诈者监视列表。要删除监视列表，该列表必须为空。也就是说，它不得有任何与之相关的欺诈者。您可以使用DeleteFraudster或DisassociateFraudster APIs 将所有欺诈者从监视列表中删除。

    您不能从 Voice ID 域中删除默认监视列表。

  3. DescribeWatchlist：确定它是默认的欺诈者监视列表，还是您创建的自定义监视列表，并获取监视列表详细信息。

  4. ListWatchlists: 列出语音 ID 域中的所有关注列表。

  5. UpdateWatchlist：更新自定义欺诈者监视列表的名称和描述。您无法修改默认监视列表的详细信息，因为它由 Voice ID 管理。

欺诈者管理 APIs

  1. AssociateFraudster: 将欺诈者关联到同一域中的监视列表。您可以将欺诈者关联到一个域中的多个监视列表。

  2. DeleteFraudster: 从语音 ID 域中删除欺诈者。删除欺诈者会将该欺诈者从其所属的所有监视列表中删除。还会在 24 小时内删除所有声纹和相关的录音。

  3. DescribeFraudster: 描述欺诈者在语音 ID 域中的状态。

  4. DisassociateFraudster: 取消欺诈者与指定监视名单的关联。请注意，欺诈者必须至少与一个欺诈者监视列表相关联；如果您尝试取消欺诈者与其唯一监视列表的关联，则会引发异常。

    要完全移除欺诈者，请使用 DeleteFraudster。

  5. ListFraudsters: 列出某个域名或特定监视列表中的所有欺诈者。此 API 还会返回欺诈者所属的监视名单。它会按照 API 请求中规定的页面大小返回分页输出。