在 Amazon Connect 座席工作区中集成第三方应用程序（第三方应用程序） - Amazon Connect
要求如何与第三方应用程序集成删除第三方应用程序

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

在 Amazon Connect 座席工作区中集成第三方应用程序（第三方应用程序）

Amazon Connect 座席工作区是一个单一、直观的应用程序，可为您的客服提供所需的工具和 step-by-step指导，帮助他们高效地解决问题、改善客户体验和加快入职速度。除了在座席工作区使用第一方应用程序（例如 Customer Profiles、Cases 和 Amazon Q 的 Connect）外，您还可以集成第三方应用程序。

注意

此功能仅在默认代理工作区中受支持；使用自定义 CCP 时不支持此功能。

例如，您可以将专有的预订系统或供应商提供的指标控制面板集成到客服工作区中 Amazon Connect 。

如果您是有意构建第三方应用程序的开发人员，请参阅《座席工作区开发人员指南》。

内容

要求

如果您使用自定义 IAM 策略来管理对第三方应用程序的访问权限，则您的用户需要以下 IAM 权限才能使用集成第三方应用程序 AWS Management Console。除了 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:<aws-region>:<aws-account-Id>:application/*",
            "Effect": "Allow"
        }
    ]
}

如何与第三方应用程序集成

注意

要将第三方应用程序集成到实例中，请确保您的实例使用的是服务相关角色 (SLR)。如果您的实例目前没有使用 SLR，但您希望集成第三方应用程序，则需要迁移到 SLR。只能在使用 SLR 的实例中集成和使用第三方应用程序。有关更多信息，请参阅 适用于 2018 年 10 月之前创建的实例。

  1. 打开 Amazon Connect 控制台 (https://console.aws.amazon.com/connect/)。

  2. 在左侧导航窗格中，选择第三方应用程序。如果您没有看到此菜单，那是因为该菜单在您所在的地区不可用。要查看此功能可用的地区，请参阅按地区划分的 Amazon Connect 功能可用性。

  3. 在第三方应用程序页面上，选择添加应用程序。

    “设置联系人属性”数据块的属性页面。

  4. 在添加应用程序页面上，输入：

    1. 基本信息

      1. 显示名称：应用程序的友好名称。此名称将显示在安全配置文件上，并在 Agent Workspace 内的选项卡上显示给您的座席。您可以回来更改此名称。

      2. 命名空间：您的应用程序的唯一正式名称。如果每个访问 URL 只有一个应用程序，建议您使用该访问 URL 的来源。您不能更改此名称。

      3. 描述（可选）：您可以选择为此应用程序提供任何描述。此描述不会向座席显示。

    2. 访问

      1. 访问 URL：这是托管应用程序的 URL。除非是本地主机，否则网址必须是安全的，以 https 开头。

        注意

        并非所有人都 URLs 可使用内嵌框架。以下是两种检查 URL 是否可以使用内嵌框架的方法：

        1. 有一种名为 Iframe Tester 的第三方工具可以帮助检查 URL 是否可以使用内嵌框架。

          1. 如果 URL 可以使用内嵌框架，它将在此页面的预览中呈现。

          2. 如果 URL 不能使用内嵌框架，它将在此页面的预览中显示错误。

            • 此网站可能显示错误，并且该应用程序仍可以在 Agent Workspace 中使用内嵌框架。这是因为应用程序开发者可以锁定他们的应用程序，使其只能嵌入到 Workspace 中，而不能嵌入到其他任何地方。如果您从应用程序开发者那里收到此应用程序，建议您仍然尝试将此应用程序集成到 Agent Workspace 中。

        2. 对于技术用户：请检查您正在尝试集成的应用程序的安全策略内容。

          1. Firefox：汉堡菜单 > 更多工具 > Web 开发人员工具 > 网络

          2. Chrome：3 点菜单 > 更多工具 > 开发人员工具 > 网络

          3. 其他浏览器：在开发人员工具中查找网络设置。

          4. Content-Security-Policy帧祖先指令应该是。https://your-instance.my.connect.aws

            1. 如果指令为same origin或deny，则 Connect 无法对此 URL 进行内建框架 AWS/Amazon

        如果应用程序无法使用 iframed，您可以执行以下操作：

      2. 已批准的来源（可选）：如果与访问网址不同，则应允许的允许名单 URLs 。除非是本地主机，否则网址必须是安全的，以 https 开头。

    3. 为事件和请求添加权限。

      以下是如何使用载入新应用程序并为其分配权限的示例 AWS Management Console。在此示例中，系统为应用程序分配了六种不同的权限。

      提供基本信息和访问详细信息

    4. 实例关联

      1. 您可以授予该账户区域内的任何实例访问此应用程序的权限。

      2. 虽然将应用程序与实例关联是可选的，但在将其与实例关联之前，您将无法使用该应用程序。

    提供基本信息和访问详细信息。

    向应用程序授予工作区数据集成权限

    向应用程序授予工作区数据集成权限。

  5. 选择保存。

  6. 如果应用程序已成功创建，您将返回到第三方应用程序页面，您将看到成功横幅，并且您应该会在列表中看到该应用程序。

    向应用程序授予工作区数据集成权限。

    您可以编辑现有应用程序的某些属性，例如其显示名称、访问网址和权限。

    1. 如果在创建应用程序或将应用程序与实例关联时出错，则会看到一条错误消息，您可以采取相应的措施来纠正问题。

删除第三方应用程序

如果您在可预见的将来不想再使用第三方应用程序，则可以将其删除。如果您想暂时停止使用它，但在可预见的将来可能会再次使用它，建议您将其与实例解除关联，以避免再次添加它。要删除第三方应用程序，请导航到 AWS Management Console，选择一个应用程序，然后选择删除。

故障排除

  • 如果应用程序与任何实例关联，则操作将失败。您必须首先解除应用程序与任何实例的关联。然后再删除它。

提示

如果您在 2023 年 12 月 15 日之前创建了应用程序，则在更新应用程序与实例的关联时可能会遇到问题。这是因为您需要更新您的 IAM 策略。

由于权限不足而尝试删除第三方应用程序时出现 IAM 错误

需要更新您的 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:<aws-region>:<aws-account-Id>:application/*",
            "Effect": "Allow"
        },
        {
            "Action": [
                "app-integrations:CreateApplicationAssociation",
                "app-integrations:DeleteApplicationAssociation"
            ],
            "Resource": "arn:aws:app-integrations:<aws-region>:<aws-account-Id>:application-association/*",
            "Effect": "Allow"
        },
        {
            "Action": [
                "iam:GetRolePolicy",
                "iam:PutRolePolicy",
                "iam:DeleteRolePolicy"
            ],
            "Resource": "arn:aws:iam::<aws-account-Id>:role/aws-service-role/connect.amazonaws.com/AWSServiceRoleForAmazonConnect_*",
            "Effect": "Allow"
        }
    ]
}