> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alforse.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 整合

> 啟用官方連接器，將一家 Alforse 公司與會計、CAD、專案管理、估價、支出、付款、電子郵件及 Slack 連結起來。

整合是 Alforse 為其他企業應用程式所建置並維護的連接器。公司管理員在**設定 → 整合**下，一次為一家公司啟用每個整合並輸入其連線資訊。

## 方案可用性

| 整合 | 方案 |
| - | - |
| **電子郵件** | 所有方案 |
| 所有其他整合 | **Business** 或**合作夥伴**（功能 `INTEGRATIONS`） |

## 定義與啟用

每個連線背後有兩種記錄：

| 記錄 | 範圍 | 內容 |
| - | - | - |
| **定義（Definition）** | 整個系統 | 該整合所需的欄位，例如 API 金鑰、OAuth 權杖與對應選項。 |
| **啟用（Activation）** | 一家公司 | 一筆 `companyIntegration` 記錄：一個 `active` 旗標，加上包含該公司憑證與設定的 `metadata` 物件。 |

在整合啟用之前，Alforse 會依定義檢查 `metadata`。未通過此檢查的設定會使啟用中止。

## 尋找整合

**設定 → 整合**每個整合顯示一張卡片。可用**搜尋**縮小清單，或在**全部**、**已安裝**與**可用**之間切換篩選。

每張卡片顯示該整合的狀態：

| 卡片顯示 | 意義 |
| - | - |
| **已安裝**徽章 | 該整合已為這家公司連線。**詳細資料**會開啟其設定；**解除安裝**會中斷連線。 |
| **未設定**徽章 | 該整合尚未在此部署中設定，因此無法**安裝**。 |
| **安裝**按鈕 | 該整合已可連線。 |
| **升級**按鈕 | 你的方案不含此整合。它會連結到帳單。 |
| "Uninstall … first"（請先解除安裝……） | 已安裝一個衝突的整合。請先移除該整合，再安裝這個。 |

## 連接應用程式

在卡片上選取**安裝**，然後完成連線。方式視應用程式而定：

| 方式 | 應用程式 | 你要做的事 |
| - | - | - |
| 提供者設定 | 電子郵件 | 選擇提供者並填寫其欄位。 |
| API 金鑰 | Linear、Paperless Parts、Rillet | 貼上另一個應用程式的金鑰，以及它要求的任何選項。 |
| OAuth | Xero、QuickBooks Online、Jira、Onshape、Slack | 在提供者的登入視窗中核准 Alforse。Alforse 會儲存取得的權杖。 |

Mount、Sage Intacct、Ramp 與 Stripe Connect 則透過各整合自己頁面上的連線設定來設定。

## 中斷連線

在整合的卡片上選取**解除安裝**。Alforse 會以 "Disconnected … integration"（已中斷……整合）確認，並帶你回到清單。

中斷連線只會設定 `active = false`。Alforse 會保留已儲存的憑證。

HEADS UP

**中斷連線前先移除憑證**

若也要刪除憑證，請先清除該整合的設定，再中斷連線。

## 疑難排解

| 症狀 | 原因 | 解決方法 |
| - | - | - |
| 卡片顯示**升級**而不是**安裝** | 公司的方案不含 `INTEGRATIONS` 功能。 | 升級到 **Business** 或**合作夥伴**方案。 |
| **安裝**呈灰色並顯示 "Uninstall … first"（請先解除安裝……） | 已安裝另一個與此整合衝突的整合。 | 解除安裝所指名的整合，再安裝此整合。 |
| Onshape 回報 "Another Onshape integration is already connected. Uninstall it before connecting this one."（已連線另一個 Onshape 整合。請先解除安裝，再連線此整合。） | 同一時間只能有一個 Onshape 連線處於啟用狀態。 | 先解除安裝現有的 Onshape 整合。 |
| "Failed to disconnect integration"（無法中斷整合連線） | 中斷連線無法儲存。 | 再試一次**解除安裝**；在成功之前，該整合仍保持連線。 |

## 依類別查看整合

**會計**

Xero、QuickBooks Online、Sage Intacct 與 Rillet。

[Open](https://docs.alforse.com/zh-Hant/docs/integrations/accounting.md)

**專案管理**

將品質問題送到 Linear 或 Jira。

[Open](https://docs.alforse.com/zh-Hant/docs/integrations/project-management.md)

**CAD**

從 Onshape 帶入 CAD 資料。

[Open](https://docs.alforse.com/zh-Hant/docs/integrations/cad.md)

**估價與報價**

從 Paperless Parts 匯入報價與 BOM。

[Open](https://docs.alforse.com/zh-Hant/docs/integrations/estimating.md)

**電子郵件**

透過 Resend 或你自己的 SMTP 伺服器寄送外寄郵件。

[Open](https://docs.alforse.com/zh-Hant/docs/integrations/email.md)

**助理**

在 Slack 中使用 Alforse 助理。

[Open](https://docs.alforse.com/zh-Hant/docs/integrations/assistant.md)

## 相關內容

**Webhook**

需要沒有任何連接器涵蓋的功能？把記錄變更送到你自己的端點。

[Open](https://docs.alforse.com/zh-Hant/docs/building/webhooks.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.