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á. # Integração com o Adobe Marketing Agent Com o conector de ação do Adobe Marketing Agent, você pode trabalhar com dados de marketing e AI-powered recursos de marketing da Adobe Experience Platform diretamente no Amazon Quick por meio de linguagem natural. O Amazon Quick oferece suporte a vários métodos de autenticação para o Adobe Marketing Agent. Escolha o método mais adequado aos requisitos de segurança da sua organização. + Aplicativo **OAuth padrão — usa um aplicativo** OAuth AWS gerenciado. Nenhuma credencial adicional é necessária. Os usuários se autenticam diretamente com sua conta da Adobe. + Aplicativo **OAuth personalizado — usa um aplicativo** gerenciado pelo cliente registrado no Adobe Developer Console. Essa opção dá à sua organização controle total sobre a configuração do OAuth. + **Service-to-Service OAuth** — usa credenciais do cliente para autenticação de servidor a servidor sem interação com o usuário. Adequado para fluxos de trabalho automatizados. + **Chave de API** — usa uma chave de API para autenticação. Adequado para padrões de acesso à conta de serviço. Para obter mais informações sobre os métodos de autenticação compatíveis com o Amazon Quick, consulte[Métodos de autenticação](quick-action-auth.md). ## Antes de começar Verifique se você tem o seguinte antes de configurar a integração. + Uma conta ativa da Adobe com acesso ao Adobe Marketing Agent. + Para **aplicativo OAuth personalizado** ou **Service-to-Service OAuth**: acesso ao [Adobe Developer Console no site da Adobe](https://developer.adobe.com/console) para criar um aplicativo e obter as credenciais do cliente. + Para **chave de API**: uma chave de Adobe-issued API com os escopos de acesso aos dados de marketing necessários. + Para obter os requisitos de assinatura do Amazon Quick, consulte[Configurar integrações no console](integration-console-setup-process.md). ## Configurando a Adobe Se você estiver usando a autenticação **padrão do aplicativo OAuth**, pule esta seção e continue até. [Configurando o conector no Amazon Quick](#adobe-quicksuite-setup) Para um aplicativo OAuth personalizado ou autenticação Service-to-Service OAuth, registre um aplicativo no [Adobe Developer Console no site da Adobe](https://developer.adobe.com/console) e adicione o URL `https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback` de retorno de chamada do Amazon Quick como um URI de redirecionamento. {{{region}}}Substitua pela sua AWS região (por exemplo,`us-east-1`). Registre o ID do cliente e o segredo do cliente — você precisa deles ao configurar o Amazon Quick. Para a autenticação da chave de API, gere uma chave de API da sua conta da Adobe. ## Configurando o conector no Amazon Quick ### Conecte-se a partir da guia Disponível Se quiser usar a autenticação padrão do aplicativo OAuth, você pode se conectar diretamente da guia **Disponível** sem configuração adicional. 1. No console do Amazon Quick, escolha **Conectores**. 1. Na guia **Disponível**, localize o **Adobe Marketing Agent** e escolha **Connect**. 1. Conclua o fluxo de login da Adobe e conceda as permissões solicitadas. Para configurar um conector com um dos outros métodos de autenticação, use a guia **Criar para sua equipe**, conforme descrito abaixo. ### Crie a partir da guia Criar para sua equipe 1. No console do Amazon Quick, escolha **Conectores**. 1. Escolha a guia **Criar para sua equipe**. 1. Encontre e escolha o **Adobe Marketing Agent**. 1. Insira um **nome** para seu conector. Opcionalmente, escolha **\+ Adicionar descrição** para adicionar uma descrição. 1. Em **Tipo de conexão**, escolha **Rede pública**. 1. Para **Configuração do OAuth**, escolha um dos métodos de autenticação a seguir e configure os campos obrigatórios. 1. Para o **aplicativo OAuth padrão**: Nenhuma credencial adicional é necessária. Escolha **Próximo** para continuar. 1. Para o **aplicativo OAuth personalizado**, configure os seguintes campos: + **ID do cliente** — A ID do cliente do seu aplicativo Adobe Developer Console. + **Cliente OAuth público** (opcional) — Selecione essa opção se o aplicativo Adobe Developer Console estiver configurado como um cliente público (sem segredo do cliente). + **Segredo do cliente** — O segredo do cliente do seu aplicativo Adobe Developer Console. + **URL do token** — O endpoint do token. Padrão: `https://aep-ai-ama.adobe.io/token` + **URL de autorização** — O endpoint de autorização. Padrão: `https://aep-ai-ama.adobe.io/authorize` + URL de **redirecionamento — Pre-filled com o URL** de retorno de chamada do Amazon Quick. 1. Para **Service-to-ServiceOAuth**, configure os seguintes campos: + **ID do cliente** — A ID do cliente da sua Server-to-Server credencial do Adobe Developer Console. + **Segredo do cliente** — O segredo do cliente da sua Server-to-Server credencial do Adobe Developer Console. + **URL do token** — O endpoint do token. Padrão: `https://aep-ai-ama.adobe.io/token` 1. Para a **chave de API**, configure os seguintes campos: + **Chave de API** — A chave de API da Adobe. + **E-mail** (opcional) — O endereço de e-mail associado à chave de API. 1. Escolha **Próximo**. 1. Se você escolher o aplicativo **OAuth padrão ou o aplicativo** **OAuth personalizado**, uma janela de autorização da Adobe será aberta. Revise as permissões solicitadas e escolha **Permitir**. 1. Na página **Revisar**, revise as ações disponíveis para o conector. Escolha **Próximo**. 1. Na página **Publicar**, escolha quem pode acessar o conector. Você pode habilitar o acesso para todos em sua organização ou pesquisar equipes ou grupos específicos. 1. Selecione **Publish**. ## Ações disponíveis Depois de configurar o conector, as ações expostas pelo Adobe Marketing Agent estarão disponíveis. Para ver o conjunto atual de ações do seu conector, acesse a visualização de **ações disponíveis** do conector no console do Amazon Quick. ## Gerenciamento e solução de problemas Para editar, compartilhar ou excluir seu conector, consulte[Gerenciando integrações existentes](integration-workflows.md#managing-existing-integrations). ### Problemas de autenticação + **Sign-in falha (aplicativo OAuth padrão ou aplicativo OAuth personalizado)** — Verifique se sua conta da Adobe está ativa e se você pode entrar diretamente na Adobe. Para o aplicativo OAuth personalizado, confirme se o URI de redirecionamento em seu aplicativo Adobe Developer Console corresponde ao URL de retorno de chamada do Amazon Quick. + **Credenciais de cliente inválidas (aplicativo OAuth personalizado ou Service-to-Service OAuth)** — Verifique se a ID do cliente e o segredo do cliente correspondem aos valores em seu aplicativo Adobe Developer Console. + **Falha na autenticação da chave** de API — verifique se a chave de API não foi revogada e se ela tem os escopos necessários para as operações que você deseja realizar.