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

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

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

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

呼叫方管理 API

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

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

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

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

监视列表管理 API

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

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

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

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

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

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

欺诈者管理 API

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

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

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

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

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

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