本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# Zapier 整合
<a name="zapier-integration"></a>

使用 Zapier 動作連接器，您可以在 Zapier 透過自然語言直接在 Amazon Quick 中連接到的數千個應用程式中觸發工作流程。使用此連接器可將 Amazon Quick 的動作功能擴展至您已在 Zapier 帳戶中設定的任何應用程式。

Amazon Quick 支援 Zapier 的多種身分驗證方法。選擇最適合您組織安全需求的方法。
+ **預設 OAuth 應用程式** – 使用 AWS受管 OAuth 應用程式。不需要額外的登入資料。使用者直接使用其 Zapier 帳戶進行身分驗證。
+ **自訂 OAuth 應用程式** – 使用 Zapier 帳戶中設定的客戶受管 OAuth 應用程式。此選項可讓您的組織完全控制 OAuth 組態。
+ **Service-to-Service OAuth** – 使用用戶端憑證進行server-to-server身分驗證，無需使用者互動。適合自動化工作流程。
+ **API 金鑰** – 使用 API 金鑰進行身分驗證。

如需 Amazon Quick 支援的身分驗證方法的詳細資訊，請參閱 [身分驗證方法](quick-action-auth.md)。

## 開始之前
<a name="zapier-integration-prerequisites"></a>

在設定整合之前，請確定您有下列項目。
+ 作用中的 Zapier 帳戶，其中包含您要公開的動作或 Zap。
+ Amazon Quick 整合需要 Zapier MCP **代理程式模式**才能正常運作。不支援受管模式。
+ 對於**自訂 OAuth 應用程式**或**Service-to-Service OAuth**：來自 Zapier MCP 組態的 OAuth 憑證。
+ 對於 **API 金鑰**：Zapier 發行的 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 回呼 URL 新增`https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback`為重新導向 URI。將 {{{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** 並選擇**連線**。

1. 完成 Zapier 登入流程並授予請求的許可。

若要使用其他身分驗證方法之一設定連接器，請使用**為您的團隊建立**索引標籤，如下所述。

### 從為您的團隊建立索引標籤建立
<a name="zapier-full-setup"></a>

1. 在 Amazon Quick 主控台中，選擇**連接器**。

1. 選擇**為您的團隊建立**索引標籤。

1. 尋找並選擇 **Zapier**。

1. 輸入連接器**的名稱**。或者，選擇 **\+ 新增描述**以新增描述。

1. 針對**連線類型**，選擇**公有網路**。

1. 針對 **OAuth 組態**，選擇下列其中一種身分驗證方法，並設定必要欄位。

   1. 對於**預設 OAuth 應用程式**：

      不需要額外的登入資料。選擇 **Next** (下一步) 繼續。

   1. 對於**自訂 OAuth 應用程式**，請設定下列欄位：
      + **用戶端 ID** – 來自 Zapier OAuth 應用程式的用戶端 ID。
      + **Public OAuth 用戶端** （選用） – 如果您的 Zapier OAuth 應用程式設定為公有用戶端 （無用戶端秘密），請選取此選項。
      + **用戶端秘密** – 來自 Zapier OAuth 應用程式的用戶端秘密。
      + **權杖 URL** – 權杖端點。預設：`https://mcp.zapier.com/token`
      + **授權 URL** – 授權端點。預設：`https://mcp.zapier.com/authorize`
      + **重新導向 URL** – 預先填入 Amazon Quick 回呼 URL。

   1. 對於**Service-to-Service OAuth**，請設定下列欄位：
      + **用戶端 ID** – 來自 Zapier OAuth 應用程式的用戶端 ID。
      + **用戶端秘密** – 來自 Zapier OAuth 應用程式的用戶端秘密。
      + **權杖 URL** – 權杖端點。預設：`https://mcp.zapier.com/token`

   1. 對於 **API 金鑰**，請設定下列欄位：
      + **API 金鑰** – Zapier API 金鑰。
      + **Email** （選用） – 與 API 金鑰相關聯的電子郵件地址。

1. 選擇**下一步**。

1. 如果您選擇**預設 OAuth 應用程式**或**自訂 OAuth 應用程式**，則會開啟 Zapier 授權視窗。檢閱請求的許可，然後選擇**允許**。

1. 在**檢閱**頁面上，檢閱連接器的可用動作。可用的動作取決於您在 Zapier 帳戶中設定的 Zap。選擇**下一步**。

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>
+ **登入失敗 （預設 OAuth 應用程式或自訂 OAuth 應用程式）** – 確認您的 Zapier 帳戶已啟用，而且您可以直接登入 Zapier。對於自訂 OAuth 應用程式，請確認 Zapier OAuth 應用程式中的重新導向 URI 符合 Amazon Quick 回呼 URL。
+ **無效的用戶端登入資料 （自訂 OAuth 應用程式或服務Service-to-Service OAuth)** – 驗證用戶端 ID 和用戶端秘密是否符合 Zapier OAuth 應用程式中的值。
+ **API 金鑰驗證失敗** – 確認 API 金鑰尚未撤銷。
+ **缺少預期的動作** – 確認您的 Zapier 帳戶中已設定並啟用您要使用的 Zaps 或動作。