Amazon Connect Voice ID 呼叫方、监视列表和欺诈者管理 API - Amazon Connect
呼叫方管理 API监视列表管理 API欺诈者管理 API

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

Amazon Connect Voice ID 呼叫方、监视列表和欺诈者管理 API

注意

支持终止通知：2026 年 5 月 20 日，AWS 将终止对 Amazon Connect Voice ID 的支持。2026 年 5 月 20 日之后，您将无法再通过 Amazon Connect 控制台访问 Voice ID，也无法在 Amazon Connect 管理员网站或联系人控制面板上访问 Voice ID 功能，或访问 Voice ID 资源。有关更多信息，请访问 Amazon Connect Voice ID 支持终止。

Amazon Connect Voice ID 包括用于管理注册到 Voice ID 域的呼叫方和在该域中注册的欺诈者的 API。除 ListSpeakers 外，所有呼叫方 API 都接受 CustomerSpeakerId 或 GeneratedSpeakerId。

呼叫方管理 API

  1. DescribeSpeaker：描述呼叫方在域中的状态（ENROLLED、OPTED_OUT、EXPIRED），然后将 GeneratedSpeakerId 映射到 CustomerSpeakerId，反之亦然。

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

  3. ListSpeakers：列出在 Voice ID 域中存在条目的所有呼叫方。此 API 会同时返回呼叫方的 CustomerSpeakerId 和 GeneratedSpeakerId。它会按照 API 请求中规定的页面大小返回分页输出。

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

监视列表管理 API

  1. CreateWatchlist：创建包含欺诈者的监视列表。

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

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

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

  4. ListWatchlists：列出 Voice ID 域中的所有监视列表。

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

欺诈者管理 API

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

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

  3. DescribeFraudster：描述欺诈者在 Voice ID 域中的状态。

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

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

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