本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 在 Amazon Connect 客服人員工作區中整合第三方應用程式 (3p 應用程式)
Amazon Connect 客服人員工作區是單一的直覺式應用程式，可為您的客服人員提供所需的工具和step-by-step指引，以有效率地解決問題、改善客戶體驗，以及更快速地加入。除了在客服人員工作區中使用客戶設定檔、案例和 Connect AI 客服人員等第一方應用程式之外，您還可以整合第三方應用程式。
**注意**
僅預設客服人員工作區支援此功能；使用自訂 CCP 時不支援此功能。
例如，您可以將您的專屬保留系統或廠商提供的指標儀表板整合到 Amazon Connect 客服人員工作區。
如果您是想建置第三方應用程式的開發人員，請參閱[客服人員工作區開發人員指南](https://docs.aws.amazon.com/agentworkspace/latest/devguide/getting-started.html)。
**Topics**
+ [要求](#onboard-3p-apps-requirements)
+ [如何新增整合](#onboard-3p-apps-how-to-integrate)
+ [刪除整合](#delete-3p-apps)
+ [指派許可](assign-security-profile-3p-apps.md)
+ [授予第三方應用程式存取權限時的 Iframe 權限](3p-apps-iframe-permissions.md)
+ [整合 MCP 伺服器](3p-apps-mcp-server.md)
+ [事件和請求](3p-apps-events-requests.md)
+ [在客服人員工作區中存取第三方應用程式](3p-apps-agent-workspace.md)
+ [存取工作清單應用程式](worklist-app.md)
+ [第三方應用程式 SSO 聯合設定](3p-apps-sso.md)
+ [在 Amazon Connect 客服人員工作區中，使用第三方應用程式的螢幕彈出功能](no-code-ui-builder-app-integration.md)
+ [建置第三方應用程式的研討會](https://catalog.workshops.aws/amazon-connect-agent-empowerment/en-US/third-party-applications/test)
## 要求
如果您使用自訂 IAM 政策來管理第三方應用程式的存取，則使用者需要以下 IAM 權限，才能使用 AWS 管理主控台整合第三方應用程式。除 `AmazonConnect_FullAccess` 之外，使用者還需要：
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Action": [
"app-integrations:CreateApplication",
"app-integrations:GetApplication",
"iam:GetRolePolicy",
"iam:PutRolePolicy",
"iam:DeleteRolePolicy"
],
"Resource": "arn:aws:app-integrations:us-east-1:111122223333:application/*",
"Effect": "Allow"
}
]
}
```
------
## 整合
**注意**
若要將 整合新增至執行個體，請確定您的執行個體使用服務連結角色 (SLR)。如果您的執行個體目前不使用 SLR，但您想要新增整合，則需要遷移至 SLR。整合只能新增至使用 SLR 的執行個體。如需詳細資訊，請參閱[對於 2018 年 10 月之前建立的執行個體](connect-slr.md#migrate-slr)。
1. 開啟 Amazon Connect [主控台](https://console.aws.amazon.com/connect/) (https://console.aws.amazon.com/connect/)。
1. 在左側導覽窗格中，選擇**整合**。如果您沒有看到此功能表，那是因為您所在的地區不適用。若要檢查可用此功能的區域，請參閱 [依區域的 Amazon Connect 功能可用性](regions.md)。
1. 在**整合**頁面上，選擇**新增整合**。
![\[設定聯絡屬性區塊的屬性頁面。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/integrations-list.png)
1. 在**新增整合**頁面上，輸入：
1. **基本資訊**
1. **顯示名稱**：整合的易記名稱。此名稱會顯示在安全性設定檔上，並在客服人員工作區上顯示給客服人員。您可以返回並更改此名稱。
1. **描述 （選用）**：您可以選擇性地為此整合提供任何描述。此說明不會顯示給客服人員。
1. **整合類型**：指出整合是標準 Web 應用程式、服務或 MCP 伺服器。這會決定如何在系統內存取整合。
1. **整合識別符**：對於標準應用程式或服務類型的整合而言是唯一的官方名稱。如果每個存取 URL 只有一個應用程式，我們建議您使用存取 URL 的來源。您不得變更此名稱。
1. **初始化逾時**：能與工作區建立連線的時間上限。允許時間以毫秒為單位計算。此設定有助於管理連線問題，並確保及時啟動應用程式。
1. **應用程式詳細資訊**
1. **聯絡範圍**：指出 Web 應用程式是針對每個聯絡重新整理，還是只針對每個新的瀏覽器工作階段重新整理。此設定會影響應用程式更新其資料的頻率。
1. **初始化逾時**：能與工作區建立連線的時間上限。允許時間以毫秒為單位計算。此設定有助於管理連線問題，並確保及時啟動應用程式。
1. **存取**
1. **存取 URL**：這是託管應用程式的 URL。URL 必須安全並以 https 開頭，除非是本地主機則例外。
**注意**
並非所有 URL 都可以進行 iframed。有兩種方法來檢查 URL 是否可以 iframed：
有一個第三方工具可用於檢查是否可以對 URL 進行 iframed，稱為 [Iframe Tester](http://iframetester.com/)。
如果 URL 可以 iframed，將在此頁面中呈現預覽。
如果 URL 不能被 iframed，將在此頁面上的預覽中顯示錯誤。
該網站有可能顯示錯誤，並且仍可以在客服人員工作區中對 URL 進行 iframed。這是因為應用程式開發人員可以將其應用程式鎖定為僅能嵌入到工作區中，而無法嵌入其他地方。如果您從應用程式開發人員收到此應用程式，我們建議您仍然嘗試將此應用程式整合至客服人員工作區。
對技術人員使用者：檢查您嘗試整合之應用程式的安全性原則內容。
Firefox：Hamburger 功能表 > 更多工具 > 網頁開發者工具>網路
Chrome：自訂及管理功能表 > 更多工具 > 開發人員工具 > 網路
其他瀏覽器：在開發人員工具中找到網路設置。
內容安全策略框架祖先指令應該是 `https://your-instance.my.connect.aws`。
如果指令是 `same origin` 或 `deny`，則此 URL 無法透過 AWS/Amazon Connect 進行 iframed
如果應用程式無法 iframed，您可以執行以下操作：
+ 如果您控制應用程式/URL，您可以更新應用程式的內容安全性政策。請遵循應用程式開發人員的最佳實務/確保應用程式僅能嵌入[此處](https://docs.aws.amazon.com/agentworkspace/latest/devguide/recommendations-and-best-practices.html)的 Amazon Connect 客服人員工作區。
+ 如果您無法控制應用程式/URL，您可以嘗試聯絡應用程式開發人員，並要求他們更新應用程式的內容安全性政策。
1. **已核准的來源 (選用)**：允許清單允許的 URL (如果與存取 URL 不同)。URL 必須安全並以 https 開頭，除非是本地主機則例外。
1. 為[事件和請求](3p-apps-events-requests.md)新增權限。
以下範例說明如何啟動新應用程式，並透過使用 AWS 管理主控台指定權限。在此範例中，會將六個不同的權限指定給應用程式。
**提供基本資訊和存取詳細資訊**
1. **執行個體關聯**
1. 您可以授予此帳戶區域內的任何執行個體存取此應用程式。
1. 雖然將整合與執行個體建立關聯是選用的，但除非您將此應用程式與執行個體建立關聯 (instance)，否則您將無法使用此應用程式。
**注意**
對於 MCP 伺服器，您只能選取使用所選閘道的探索 URL 設定的執行個體。
![\[供基本資訊和存取詳細資訊。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/integrations-add-basic-info.png)
**授與應用程式進行工作區資料整合的權限**
![\[授與應用程式進行工作區資料整合的權限。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/integrations-add-permissions.png)
**Iframe 組態**
![\[Iframe 組態。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/integrations-add-iframe-config.png)
1. 選擇**新增整合作業**。
1. 如果已成功建立整合，您會收到**整合詳細資訊**頁面，而且您會看到成功橫幅。
![\[授與應用程式進行工作區資料整合的權限。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/integrations-view.png)
您可以編輯現有應用程式的特定屬性，例如顯示名稱、存取 URL 和權限。
1. 如果建立應用程式或將應用程式與執行個體關聯時發生錯誤，您將會看到錯誤訊息，而且您可以採取對應的動作來修正問題。
## 刪除整合
如果您不再想要在可預見的未來使用 整合，則可以將其刪除。如果您暫時想停止使用，但是在可預見的未來可能想要再次使用，建議您與執行個體取消關聯，以避免再次新增。若要刪除整合，請導覽至 AWS 管理主控台，選取整合，然後選擇**刪除**。
**疑難排解**
+ 如果整合與任何執行個體相關聯，則操作將會失敗。您必須先取消整合與任何執行個體的關聯。然後，您可以返回並刪除它。
**提示**
如果您在 2023 年 12 月 15 日之前建立整合，則更新整合與執行個體 (instance) 的關聯時可能會遇到問題。這是因為您需要更新 IAM 政策。
![\[由於許可不足，嘗試刪除整合時發生 IAM 錯誤\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/delete-3p-apps.png)
您的 IAM 政策必須更新以包含下列權限：
+ `app-integrations:CreateApplicationAssociation`
+ `app-integrations:DeleteApplicationAssociation`
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Action": [
"app-integrations:CreateApplication",
"app-integrations:GetApplication"
],
"Resource": "arn:aws:app-integrations:us-east-1:111122223333:application/*",
"Effect": "Allow"
},
{
"Action": [
"app-integrations:CreateApplicationAssociation",
"app-integrations:DeleteApplicationAssociation"
],
"Resource": "arn:aws:app-integrations:us-east-1:111122223333:application-association/*",
"Effect": "Allow"
},
{
"Action": [
"iam:GetRolePolicy",
"iam:PutRolePolicy",
"iam:DeleteRolePolicy"
],
"Resource": "arn:aws:iam::111122223333:role/aws-service-role/connect.amazonaws.com/AWSServiceRoleForAmazonConnect_*",
"Effect": "Allow"
}
]
}
```
------
# 在 Amazon Connect 中使用第三方應用程式的安全性設定檔權限
本主題說明存取已登入和已關聯之第三方應用程式所需的安全性設定檔權限。如需第三方應用程式權限及其 API 名稱的清單，請參閱 [Amazon Connect 中安全性設定檔許可的清單](security-profile-list.md)。
## 第三方應用程式權限
**注意**
將應用程式與執行個體建立關聯後，您可能需要等待 10 分鐘，才能看到應用程式出現在**安全性設定檔**頁面的**客服人員應用程式**區段。
您加入執行個體 AWS 並與 Amazon Connect 執行個體相關聯的任何應用程式都會顯示在**安全性設定檔**頁面的**客服人員應用程式**區段中，如下圖所示。
![\[安全性設定檔頁面的客服人員應用程式區段。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/assign-security-profile-3p-apps-displayed.png)
您還需要授予對 CCP 的存取權限，以便顯示應用程式啟動器功能表。
![\[已套用 CCP 存取連絡控制面板的存取權限。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/assign-security-profile-3p-apps-ccp-permissions.png)
指派授權後，請參閱如何 [在 Amazon Connect 客服人員工作區中存取第三方應用程式](3p-apps-agent-workspace.md)。
# 授予第三方應用程式 Amazon Connect 存取權限時的 Iframe 權限
透過 AWS 主控台的 `onboarding` UI 或 API 設定第三方應用程式時，您可以指定 `iframe` 權限設定。即使已設定應用程式，也可以修改這些權限。
根據預設，所有第三方應用程式都會獲得四個基本 `iframe` 權限：`allow-forms`、`allow-popups`、`allow-same-origin` 和 `allow-scripts`。部分應用程式可能需要增強功能，因此可以在應用程式註冊期間要求其他 `iframe` 權限。
**注意**
下列權限的瀏覽器相容性可能因不同瀏覽器實作而有所不同。
| 權限 | Description |
| --- | --- |
| Allow | |
| clipboard-read | 控制是否允許應用程式從剪貼簿讀取資料。Chrome 目前支援此功能，但 Firefox 和 Safari 不支援。 |
| clipboard-write | 控制是否允許應用程式在剪貼簿寫入資料。Chrome 目前支援此功能，但 Firefox 和 Safari 不支援。 |
| 麥克風 | 控制是否允許應用程式使用音訊輸入裝置。 |
| 攝影機 | 控制是否允許應用程式使用影片輸入裝置。 |
| 沙盒 | |
| allow-forms | 允許頁面提交表單。根據預設支援此功能。 |
| allow-popups | 允許應用程式開啟彈出視窗。根據預設支援此功能。 |
| allow-same-origin | 如果未使用此字符，系統會將資源視為來自一律不符合 same-origin 政策的特殊來源 (可能會阻止存取資料儲存/Cookie 和部分 JavaScript API)。根據預設支援此功能。 |
| allow-scripts | 允許頁面執行指令碼。根據預設支援此功能。 |
| allow-downloads | 允許透過具下載屬性的 或 元素，以及引導至檔案下載的導覽來下載檔案 |
| allow-modal | 允許頁面透過 Window.alert()、Window.confirm()、Window.print() 和 Window.prompt() 開啟模態視窗，同時允許開啟