

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 授予第三方應用程式 Amazon Connect 存取權限時的事件和請求
<a name="3p-apps-events-requests"></a>

本主題列出您必須明確授予第三方應用程式才能存取 Amazon Connect 資料的權限。

**注意**  
如果您是開發人員，請參閱如何建立能回應事件的應用程式：[整合應用程式和 Amazon Connect 客服人員工作區客服人員資料](https://docs.aws.amazon.com/agentworkspace/latest/devguide/integrate-with-agent-data.html)。

當您使用 API 或 中的加入 UI 加入第三方應用程式時 AWS 管理主控台，您必須明確授予第三方應用程式 Amazon Connect 資料的許可。您還可以編輯現有應用程式的權限。

若要瞭解指定特定權限的影響，請檢閱下列權限、說明以及對應的請求和事件。

例如：如果您將 `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)。


| 權限 | Description | 要求 | 事件 | 
| --- | --- | --- | --- | 
| 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 | onLanguageChanged | 
| 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 |  | 
| \* | 提供所有請求和事件的存取權。 |  |  | 