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

# Zapier 集成
<a name="zapier-integration"></a>

借助 Zapier 操作连接器，您可以通过自然语言直接在 Amazon Quick 中触发 Zapier 连接的数千个应用程序的工作流程。使用此连接器将 Amazon Quick 的操作功能扩展到您已在 Zapier 账户中配置的任何应用程序。

Amazon Quick 支持 Zapier 的多种身份验证方法。选择最适合您组织安全要求的方法。
+ **默认 OAuth 应用程序**-使用 AWS由托管的 OAuth 应用程序。无需其他凭证。用户直接使用他们的 Zapier 账户进行身份验证。
+ **自定义 OAuth 应用程序** — 使用在您的 Zapier 账户中配置的客户管理的 OAuth 应用程序。此选项可让您的组织完全控制 OAuth 配置。
+ **Service-to-Service OAuth** — 使用客户端凭据进行服务器到服务器的身份验证，无需用户交互。适用于自动化工作流程。
+ **API 密钥**-使用 API 密钥进行身份验证。

有关 Amazon Quick 支持的身份验证方法的更多信息，请参阅[身份验证方法](quick-action-auth.md)。

## 开始前的准备工作
<a name="zapier-integration-prerequisites"></a>

在设置集成之前，请确保您具备以下条件。
+ 一个活跃的 Zapier 账户，其中配置了你要公开的操作或 Zaps。
+ Amazon Quick 集成需要 Zapier MCP **代理模式才能正常工作**。不支持托管模式。
+ 对于**自定义 OAuth 应用程序或 Service-to-Service OAuth****：来自 Zapier** MCP 配置的 OAuth 凭据。
+ 对于 **API 密钥**： Zapier-issued API 密钥。
+ 有关 Amazon Quick 订阅要求，请参阅[在控制台中设置集成](integration-console-setup-process.md)。

## 配置 Zapier
<a name="zapier-source-setup"></a>

如果您使用的是**默认 OAuth 应用程序**身份验证，请跳过本节并继续。[在 Amazon Quick 中设置连接器](#zapier-quicksuite-setup)

对于自定义 OAuth 应用程序或 Service-to-Service OAuth 身份验证，请在 Zapier 网站上配置 [Zapier MCP](https://mcp.zapier.com/) 设置，然后将 Amazon Quick 回传网址添加为重定向 URI。`https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback`{{{region}}}替换为您 AWS 所在的地区（例如，`us-east-1`）。记录客户端 ID 和客户密钥 — 您在配置 Amazon Quick 时需要它们。要进行 API 密钥身份验证，请使用您的 Zapier 账户生成 API 密钥。

## 在 Amazon Quick 中设置连接器
<a name="zapier-quicksuite-setup"></a>

### 从 “可用” 选项卡连接
<a name="zapier-quick-connect"></a>

如果要使用默认 OAuth 应用程序身份验证，则无需额外配置即可直接从 “**可用**” 选项卡进行连接。

1. 在 Amazon Quick 控制台中，选择**连接器**。

1. 在 “**可用**” 选项卡上，找到 **Zapier**，然后选择 **Connect**。

1. 完成 Zapier 登录流程并授予所请求的权限。

要使用其他身份验证方法之一配置连接器，请使用**为团队创建**选项卡，如下所述。

### 从 “为你的团队创建” 选项卡创建
<a name="zapier-full-setup"></a>

1. 在 Amazon Quick 控制台中，选择**连接器**。

1. 选择 “**为你的团队创建**” 选项卡。

1. 找到并选择 **Zapier**。

1. 输入连接器的**名称**。（可选）选择 **\+ 添加描述**以添加描述。

1. 对于**连接类型**，选择**公共网络**。

1. 对于 **OAuth 配置**，请选择以下身份验证方法之一并配置必填字段。

   1. 对于**默认 OAuth 应用程序：**

      无需其他凭证。选择**下一步**以继续。

   1. 对于**自定义 OAuth 应用程序**，请配置以下字段：
      + **客户端 ID** — 来自 Zapier OAuth 应用程序的客户端 ID。
      + **公共 OAuth 客户端**（可选）— 如果您的 Zapier OAuth 应用程序配置为公共客户端（无客户端密钥），请选择此选项。
      + **客户密钥** — 来自 Zapier OAuth 应用程序的客户端密钥。
      + **令牌网址**-令牌端点。默认值：`https://mcp.zapier.com/token`
      + **授权 URL**-授权端点。默认值：`https://mcp.zapier.com/authorize`
      + **重定向 URL** — Pre-filled 使用 Amazon 快速回传网址。

   1. 对于 **Service-to-ServiceOAuth**，请配置以下字段：
      + **客户端 ID** — 来自 Zapier OAuth 应用程序的客户端 ID。
      + **客户密钥** — 来自 Zapier OAuth 应用程序的客户端密钥。
      + **令牌网址**-令牌端点。默认值：`https://mcp.zapier.com/token`

   1. 对于 **API 密钥**，请配置以下字段：
      + **API 密钥** — Zapier API 密钥。
      + **电子邮件**（可选）-与 API 密钥关联的电子邮件地址。

1. 选择**下一步**。

1. 如果您选择**默认 OAuth 应用程序或自定义 OAuth 应用程序****，则会打开 Zapi** er 授权窗口。查看请求的权限并选择 “**允许**”。

1. 在 “**查看**” 页面上，查看连接器的可用操作。可用操作取决于您在Zapier账户中配置的Zaps。选择**下一步**。

1. 在 “**发布**” 页面上，选择谁可以访问连接器。您可以为组织中的所有人启用访问权限，也可以搜索特定的团队或群组。

1. 选择**发布**。

## 可用操作
<a name="zapier-integration-actions"></a>

设置连接器后，您在 Zapier 账户中公开的操作即可使用。你在 Zapier 中授权的每个 Zap 或操作都会在 Amazon Quick 中注册为可调用的工具。要查看连接器的当前操作集，请转至 Amazon Quick 控制台中连接器的**可用操作**视图。

## 管理和故障排除
<a name="zapier-integration-troubleshooting"></a>

要编辑、共享或删除您的连接器，请参阅[管理现有集成](integration-workflows.md#managing-existing-integrations)。

### 身份验证问题
<a name="zapier-troubleshooting-auth"></a>
+ **Sign-in 失败（默认 OAuth 应用程序或自定义 OAuth 应用程序）**— 验证您的 Zapier 账户是否处于活动状态并且可以直接登录 Zapier。对于自定义 OAuth 应用程序，请确认您的 Zapier OAuth 应用程序中的重定向 URI 是否与 Amazon Quick 回传网址相匹配。
+ **无效的客户端凭证（自定义 OAuth 应用程序或 Service-to-Service OAuth）**-验证客户端 ID 和客户端密钥是否与 Zapier OAuth 应用程序中的值相匹配。
+ **API 密钥身份验证失败** — 确认 API 密钥未被撤销。
+ **缺少预期的操作** — 确认您的 Zapier 账户中已配置并启用了您要使用的 Zaps 或操作。