翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# サードパーティーアプリケーションに 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)」を参照してください。


| アクセス許可 | 説明 | リクエスト | イベント | 
| --- | --- | --- | --- | 
|  User.Details.View  |  フルネームやユーザー ARN などのエージェントに関する詳細  |  agent/getName agent/getARN  |    | 
|  User.Configuration.View  |  エージェントに関連するルーティングプロファイルなどの、エージェントに関する設定情報  |  agent/getRoutingProfile agent/getChannelConcurrency agent/getExtension getLanguage agent/listAvailabilityStates agent/listQuickConnects voice/getOutboundCallPermission voice/listDialableCountries  |  onLanguageChanged  | 
|  User.Status.View  |  エージェントのステータスに関する詳細  |  agent/getState  |  agent/onStateChanged  | 
|  Contact.Details.View  |  ワークスペースで提供されるコンタクトに関する詳細  |  contact/getInitialContactId contact/getChannelType contact/getStateDuration contact/getQueue contact/getQueueTimestamp  |  contact/onCleared contact/onMissed contact/onStartingAcw contact/onConnected  | 
|  Contact.CustomerDetails.View  |  電話をかけている電話番号などの顧客に関する詳細 (音声のみ)  |  voice/getInitialCustomerPhoneNumber  |    | 
|  Contact.Attributes.View  |  コンタクトのメタデータ  |  contact/getAttribute contact/getAttributes  |    | 
|  User.Status.Edit  |  エージェントのステータスを変更する  |  agent/setAvailabilityState agent/setAvailabilityStateByName agent/setOffline  |    | 
|  Contact.Details.Edit  |  発信通話や通話の転送などの問い合わせ編集機能。  |  voice/createOutboundCall contact/transfer contact/addParticipant contact/accept contact/clear  |    | 
|  \$1  |  すべてのリクエストとイベントへのアクセスを提供します。  |    |    |