

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 Zapier
<a name="zapier-integration"></a>

Com o conector de ação Zapier, você pode acionar fluxos de trabalho em milhares de aplicativos aos quais o Zapier se conecta, diretamente no Amazon Quick por meio de linguagem natural. Use esse conector para estender os recursos de ação do Amazon Quick para qualquer aplicativo que você já tenha configurado em sua conta do Zapier.

O Amazon Quick oferece suporte a vários métodos de autenticação para o Zapier. Escolha o método que melhor se adapta 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 do Zapier.
+ Aplicativo **OAuth personalizado — usa um aplicativo** OAuth gerenciado pelo cliente configurado na sua conta Zapier. 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.

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
<a name="zapier-integration-prerequisites"></a>

Verifique se você tem o seguinte antes de configurar a integração.
+ Uma conta ativa do Zapier com as ações ou Zaps que você deseja expor configurados.
+ A integração com o Amazon Quick exige que o Zapier MCP **Agentic Mode** funcione corretamente. O Modo Gerenciado não é suportado.
+ Para **aplicativo OAuth personalizado ou OAuth**: credenciais **Service-to-Service OAuth** da sua configuração Zapier MCP.
+ Para **chave de API**: uma chave de Zapier-issued API.
+ Para obter os requisitos de assinatura do Amazon Quick, consulte[Configurar integrações no console](integration-console-setup-process.md).

## Configurando o Zapier
<a name="zapier-source-setup"></a>

Se você estiver usando a autenticação **padrão do aplicativo OAuth**, pule esta seção e prossiga para. [Configurando o conector no Amazon Quick](#zapier-quicksuite-setup)

Para um aplicativo OAuth personalizado ou autenticação Service-to-Service OAuth, defina suas configurações de [MCP do Zapier no site do Zapier](https://mcp.zapier.com/) e adicione o URL de retorno de chamada do Amazon Quick como um URI de redirecionamento. `https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback` {{{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 do Zapier.

## Configurando o conector no Amazon Quick
<a name="zapier-quicksuite-setup"></a>

### Conecte-se a partir da guia Disponível
<a name="zapier-quick-connect"></a>

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**, encontre o **Zapier e escolha** Connect.**

1. Conclua o fluxo de login do Zapier 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
<a name="zapier-full-setup"></a>

1. No console do Amazon Quick, escolha **Conectores**.

1. Escolha a guia **Criar para sua equipe**.

1. Encontre e escolha o **Zapier**.

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** — O ID do cliente do seu aplicativo Zapier OAuth.
      + **Cliente OAuth público** (opcional) — Selecione essa opção se seu aplicativo Zapier OAuth estiver configurado como um cliente público (sem segredo do cliente).
      + **Segredo do cliente** — O segredo do cliente do seu aplicativo Zapier OAuth.
      + **URL do token** — O endpoint do token. Padrão: `https://mcp.zapier.com/token`
      + **URL de autorização** — O endpoint de autorização. Padrão: `https://mcp.zapier.com/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** — O ID do cliente do seu aplicativo Zapier OAuth.
      + **Segredo do cliente** — O segredo do cliente do seu aplicativo Zapier OAuth.
      + **URL do token** — O endpoint do token. Padrão: `https://mcp.zapier.com/token`

   1. Para a **chave de API**, configure os seguintes campos:
      + **Chave de API** — A chave de API do Zapier.
      + **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 do** Zapier será aberta. Revise as permissões solicitadas e escolha **Permitir**.

1. Na página **Revisar**, revise as ações disponíveis para o conector. As ações disponíveis dependem dos Zaps que você configurou na sua conta do Zapier. 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
<a name="zapier-integration-actions"></a>

Depois de configurar o conector, as ações que você expôs na sua conta do Zapier ficam disponíveis. Cada Zap ou ação que você autorizou no Zapier se registra como uma ferramenta chamável no Amazon Quick. 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
<a name="zapier-integration-troubleshooting"></a>

Para editar, compartilhar ou excluir seu conector, consulte[Gerenciando integrações existentes](integration-workflows.md#managing-existing-integrations).

### Problemas de autenticação
<a name="zapier-troubleshooting-auth"></a>
+ **Sign-in falha (aplicativo OAuth padrão ou aplicativo OAuth personalizado)** — Verifique se sua conta do Zapier está ativa e se você pode entrar diretamente no Zapier. Para o aplicativo OAuth personalizado, confirme se o URI de redirecionamento em seu aplicativo Zapier OAuth 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 o ID do cliente e o segredo do cliente correspondem aos valores em seu aplicativo Zapier OAuth.
+ **Falha na autenticação da chave de API** — verifique se a chave de API não foi revogada.
+ **Ações esperadas estão ausentes** — Verifique se os Zaps ou ações que você deseja usar estão configurados e habilitados na sua conta do Zapier.