

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

# 向 Connect 客户授予第三方应用程序访问权限时发生的事件和请求
<a name="3p-apps-events-requests"></a>

本主题列出了您必须明确授予第三方应用程序访问Connect客户数据的权限。

**注意**  
如果您是开发人员，请查看如何创建可对事件做出反应的应用程序：[将应用程序与 Connect Customer Agent Workspace 代理数据集成](https://docs.aws.amazon.com/agentworkspace/latest/devguide/integrate-with-agent-data.html)。

当您使用中的 API 或入门用户界面加载第三方应用程序时 AWS 管理控制台，必须明确授予第三方应用程序访问 Connect Customer 数据的权限。您还可以编辑现有应用程序的权限。

要了解分配特定权限的效果，请查看以下权限、描述以及相应的请求和事件。

例如，如果您为应用程序分配了 `User.Details.View` 权限，则该应用程序将能够发出以下请求：`agent.getName` 和 `agent.getARN`。如果您的应用尝试订阅事件或请求其没有权限访问的数据，则该应用可能无法正常运行。

 要了解有关每个请求和事件的更多信息，请参阅 [API 参考](https://docs.aws.amazon.com/agentworkspace/latest/devguide/api-reference-3p-apps-events-and-requests.html.html)。


| 权限 | 说明 | 请求 | Events | 
| --- | --- | --- | --- | 
| User.Details.View | 有关座席的详细信息，例如他们的全名和用户 ARN | agent/getName<br />agent/getARN |  | 
| User.Configuration.View | 有关座席的配置信息，例如其关联的路由配置文件 | agent/getRoutingProfile<br />agent/getChannelConcurrency<br />agent/getExtension<br />getLanguage<br />agent/listAvailabilityStates<br />agent/listQuickConnects<br />voice/getOutboundCallPermission<br />voice/listDialableCountries | on LanguageChanged | 
| User.Status.View | 有关座席状态的详细信息 | agent/getState | agent/onStateChanged | 
| Contact.Details.View | 有关工作区中可用联系人的详细信息 | contact/getInitialContactId<br />contact/getChannelType<br />contact/getStateDuration<br />contact/getQueue<br />contact/getQueueTimestamp | contact/onCleared<br />contact/onMissed<br />contact/onStartingAcw<br />contact/onConnected | 
| Contact.CustomerDetails.View | 有关客户的详细信息，例如他们拨打的电话号码（仅限语音） | voice/getInitialCustomerPhoneNumber |  | 
| Contact.Attributes.View | 有关联系人的元数据 | contact/getAttribute<br />contact/getAttributes |  | 
| User.Status.Edit | 修改座席状态 | agent/setAvailabilityState<br />agent/setAvailabilityStateByName<br />agent/setOffline |  | 
| Contact.Details.Edit | 联系人编辑功能，例如外拨电话或转接电话。 | voice/createOutboundCall<br />contact/transfer<br />contact/addParticipant<br />contact/accept<br />contact/clear |  | 
| \* | 提供对所有请求和事件的访问权限。 |  |  | 