> ## 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** 或 **Partner**（功能 `INTEGRATIONS`） |

## 定义与激活

每个连接背后有两类记录：

| 记录 | 范围 | 包含内容 |
| - | - | - |
| **定义** | 整个系统 | 该集成所需的字段，例如 API 密钥、OAuth 令牌和映射选项。 |
| **激活** | 一个公司 | 一条 `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** 或 **Partner** 套餐。 |
| **安装** 呈灰色，并提示“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/docs/integrations/accounting.md)

**项目管理**

将质量问题发送到 Linear 或 Jira。

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

**CAD**

从 Onshape 导入 CAD 数据。

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

**估价与报价**

从 Paperless Parts 导入报价和物料清单。

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

**电子邮件**

通过 Resend 或你自己的 SMTP 服务器发送外发邮件。

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

**助手**

在 Slack 中使用 Alforse 助手。

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

## 相关内容

**Webhooks**

需要连接器未覆盖的功能？将记录变更发送到你自己的端点。

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


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