View a markdown version of this page

Integre aplicativos de terceiros no espaço de trabalho do agente - Amazon Connect Customer

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Integre aplicativos de terceiros no espaço de trabalho do agente

O espaço de trabalho do agente Connect Customer oferece aos seus agentes as ferramentas e a orientação passo a passo para resolver problemas rapidamente e proporcionar melhores experiências ao cliente com menos treinamento necessário. O espaço de trabalho do agente inclui aplicativos nativos e primários, como perfis de clientes, casos e assistência do agente. Você também pode integrar aplicativos de terceiros.

nota

Third-party os aplicativos são suportados somente no espaço de trabalho do agente Connect Customer; eles não são suportados em desktops de agentes personalizados.

Por exemplo, você pode integrar um sistema de reservas proprietário ou um painel do sistema de gerenciamento de reclamações de terceiros no espaço de trabalho do agente.

Se você é um desenvolvedor interessado em criar uma aplicação de terceiros, consulte o Agent Workspace Developer Guide.

Tipos de integração

Uma integração conecta algo externo ao Connect Customer à sua instância. Você cria uma integração uma vez para uma AWS conta e uma região, associa-a a uma ou mais instâncias e concede permissões. Você escolhe um tipo de integração na página Adicionar integração. O tipo determina o que você configura e como o Connect Customer alcança a integração.

  • Aplicativo padrão: um aplicativo web que o Connect Customer renderiza em um iframe no espaço de trabalho do agente. Os agentes o abrem no inicializador de aplicativos. Você fornece um URL de acesso, permissões de iframe e um escopo de contato que define quando o aplicativo é atualizado. Use esse tipo para um aplicativo em que seus agentes trabalham, como uma ferramenta de pesquisa de pedidos ou um aplicativo de agendamento.

  • Serviço: um aplicativo sem interface que você cria e é executado em segundo plano no espaço de trabalho do agente. Um serviço começa quando o espaço de trabalho do agente é carregado e permanece ativo pelo resto da sessão. Ele não tem interface para um agente abrir. Use esse tipo para trabalhos executados sozinhos, como reagir a eventos de contato, como conectar, desconectar e, após o contato, abrir um aplicativo quando uma condição for atendida ou concluir um fluxo de autenticação assim que a sessão for iniciada. Para obter mais informações, consulte Criação de serviços de terceiros no Guia do desenvolvedor do Agent Workspace.

  • Servidor MCP: um servidor Model Context Protocol que fornece aos agentes de IA no Connect Customer um conjunto de ferramentas para ligar. Você o conecta por meio de um AgentCore gateway Bedrock em vez de um URL de acesso, e cada gateway atende a um servidor MCP. Para saber o procedimento completo, consulte Integre um servidor MCP com o Connect Customer.

As etapas a seguir descrevem como adicionar um aplicativo padrão.

Permissões obrigatórias do IAM

Se você usa políticas personalizadas do IAM para gerenciar o acesso a aplicativos de terceiros, seus usuários precisam de permissões adicionais do IAM. Além dissoAmazonConnect_FullAccess, os usuários precisam do seguinte:

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" } ] }

Adicionar um aplicativo de terceiros

nota

Para adicionar uma integração às suas instâncias, certifique-se de que sua instância esteja usando uma Service-Linked função (SLR). Se sua instância atualmente não usa uma SLR, mas você deseja adicionar uma integração, você precisará migrar para uma SLR. A integração só pode ser adicionada às instâncias que estão usando uma SLR. Para obter mais informações, consulte Para instâncias criadas antes de outubro de 2018.

  1. Abra o console Connect Customer (https://console.aws.amazon.com/connect/).

  2. No painel de navegação, selecione Integrações. Se você não vê esse menu, então os aplicativos 3P não estão disponíveis na sua AWS região. Para verificar onde os aplicativos 3P estão disponíveis, consulteDisponibilidade de Connect Customer características por região.

  3. Na página Integrações, escolha Adicionar integração.

    A página de integrações no console Connect Customer.
  4. Na página Adicionar integração, preencha os campos de informações de integração:

    • Nome de exibição: um nome amigável para o aplicativo 3P. O nome aparece nos perfis de segurança e na guia no espaço de trabalho do agente. Você pode alterá-lo mais tarde.

    • Descrição (opcional): uma descrição do aplicativo 3P. Os agentes não veem a descrição.

    • Tipo de integração: indica se a integração é um aplicativo web padrão (aplicativo 3P), serviço (serviço 3P) ou servidor MCP. O tipo determina como os agentes interagem com a integração.

    • Identificador de integração: um nome exclusivo para integrações do tipo aplicativo ou serviço padrão. Se você tiver apenas uma aplicação por URL de acesso, recomendamos usar a origem do URL de acesso. Não é possível alterar esse nome.

    Preencha os campos de detalhes da integração:

    • Escopo do contato: indica se o aplicativo web é atualizado para cada contato ou somente para cada nova sessão do navegador. Essa configuração afeta a frequência com que a aplicação atualiza seus dados.

    • Tempo limite de inicialização: o tempo máximo, em milissegundos, para estabelecer uma conexão com o espaço de trabalho. Essa configuração ajuda a gerenciar problemas de conexão e garante a inicialização oportuna da aplicação.

    Preencha os campos de acesso:

    • URL de acesso: a URL em que seu aplicativo está hospedado. O URL deve começar comhttps, a menos que seja um host local. Nem todos os URLs podem ser iframes. Para obter mais informações, consulte Verifique se um URL pode ser enquadrado.

    • Origens aprovadas (opcional): URLs adicionais a serem permitidos, caso sejam diferentes do URL de acesso. Cada URL deve começar comhttps, a menos que seja um host local.

    Adicione permissões a eventos e solicitações e defina a configuração do Iframe. Ambos são opcionais.

    Em Associação de instâncias, escolha as instâncias que podem usar o aplicativo:

    • Você pode conceder acesso ao aplicativo a qualquer instância dessa AWS conta e região.

    • Associar a integração a uma instância é opcional, mas você não pode usar o aplicativo até fazer isso.

      nota

      Para servidores MCP, você pode escolher somente a instância configurada com a URL de descoberta do gateway selecionado.

  5. Escolha Adicionar integração.

  6. Se a integração for criada com sucesso, a página de detalhes da integração aparecerá com um banner de sucesso.

    A página de detalhes da integração com um banner de sucesso.

    Você pode editar alguns atributos de uma integração existente, como nome de exibição, URL de acesso e permissões.

    Se ocorrer um erro ao criar a integração ou associá-la a uma instância, uma mensagem de erro será exibida. Siga a mensagem para corrigir o problema.

Verifique se um URL pode ser enquadrado

Nem todos os URLs podem ser iframes. Há duas maneiras de verificar se uma URL pode ser enquadrada:

  • Use a ferramenta de terceiros Iframe Tester para verificar se uma URL pode ser enquadrada.

    • Se um URL puder ser enquadrado, a página renderizará uma visualização prévia.

    • Se uma URL não puder ser enquadrada, a página exibirá um erro na visualização. O site pode mostrar um erro, mesmo que o aplicativo ainda possa ser enquadrado no espaço de trabalho do agente. Um desenvolvedor de aplicativos pode restringir seu aplicativo para que ele só possa ser incorporado ao espaço de trabalho do agente. Se você recebeu o aplicativo de um desenvolvedor de aplicativos, ainda tente integrá-lo ao espaço de trabalho do agente.

  • Para usuários técnicos: verifique o conteúdo da política de segurança do aplicativo que você deseja integrar.

    • Firefox: Abra o menu de hambúrguer e escolha Mais ferramentas, Ferramentas para desenvolvedores da Web, Rede.

    • Chrome: abra o menu de três pontos e escolha Mais ferramentas, Ferramentas para desenvolvedores, Rede.

    • Outros navegadores: encontre as configurações de rede nas ferramentas do desenvolvedor.

    A Content-Security-Policy frame-ancestors diretiva deveria serhttps://your-instance.my.connect.aws. Se a diretiva for same origin oudeny, o Connect Customer não poderá iframe do URL.

Veja o que você pode fazer se o aplicativo não puder ser enquadrado:

  • Se você controla o aplicativo ou o URL, atualize a política de segurança de conteúdo do aplicativo. Para obter orientação, consulte Recomendações e melhores práticas no Guia do desenvolvedor do Agent Workspace.

  • Se você não controla o aplicativo ou o URL, peça ao desenvolvedor do aplicativo que atualize a política de segurança de conteúdo do aplicativo.

Exemplo: adicionar um aplicativo e atribuir permissões

O exemplo a seguir mostra como integrar um novo aplicativo e atribuir permissões a ele no Console de gerenciamento da AWS. Neste exemplo, você atribui seis permissões ao aplicativo.

Informações básicas e detalhes de acesso

A página Adicionar integração mostrando informações básicas e campos de acesso.

Permissões para integração de dados do espaço de trabalho

A seção de permissões da página Adicionar integração.

Configuração de iframe

A seção de configuração do iframe da página Adicionar integração.

Excluir integrações

Se você não precisar mais de uma integração, poderá excluí-la. Para parar de usar uma integração temporariamente, desassocie-a da instância. A dissociação evita a necessidade de adicionar a integração novamente. Para excluir uma integração, abra o Console de gerenciamento da AWS, escolha a integração e escolha Excluir.

Solução de problemas

  • A exclusão falhará se a integração ainda estiver associada a uma instância. Desassocie a integração de cada instância e, em seguida, exclua-a.

dica

Se você criou uma integração antes de 15 de dezembro de 2023, talvez tenha problemas para atualizar sua associação com instâncias. Você precisa atualizar sua política de IAM primeiro.

Erro do IAM ao tentar excluir uma integração devido a permissões insuficientes.

Atualize sua política do IAM para incluir as seguintes permissões:

  • 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" } ] }