---
title: "集成"
description: "Settings 中的 Integrations 分组：Needs Attention、Installed 和 Available 视图，每个磁贴状态的含义，以及每个集成面板共有的操作。"
sidebar:
  label: 概览
  order: 0
area: settings
feature: integrations
appPath: /settings/integrations/installed
lastVerified: 2026-11-15
version: "2026-11-09"
audience: admin
related:
  - settings
  - integrations
  - integrations/needs-attention
intercom:
  - id: "16755703"
    title: Connect  to your HRIS (Pyn 2)
    url: https://intercom.help/pyn/en/articles/16755703-connect-to-your-hris-pyn-2
    note: draws on
  - id: "12062401"
    title: Manage Integrations or Senders That Need Attention (Pyn 2)
    url: https://intercom.help/pyn/en/articles/12062401-manage-integrations-or-senders-that-need-attention-pyn-2
    note: draws on
translation:
  source: settings/integrations/index.mdx
  sourceSha: 9607b6e1fde7106a91fe7b282c477c572665a1aa
---

Settings 中的 Integrations 分组列出已连接的、需要注意的以及可以添加的集成。每个集成在本站的[集成](https://support.pyn.ai/zh-cn/integrations/)下都有自己的指南；下面的部分介绍这些视图以及它们共有的操作。

![Settings > Integrations > Installed lists every connected integration with its status.](https://support.pyn.ai/media/integrations/overview/integrations-installed-list.png)

## 三个视图

| 视图 | 路由 | 显示的内容 |
| --- | --- | --- |
| **Needs Attention 🚨** | `/settings/integrations/attention` | 处于错误状态的集成，例如凭据被撤销的集成。一切正常时为空。 |
| **Installed** | `/settings/integrations/installed` | 每个已安装的集成，无论是活跃、出错还是已停用。 |
| **Available** | `/settings/integrations/available` | 你可以安装的集成，然后是位于磁贴库末尾的 **Early Access** 和 **Waitlist** 磁贴。 |

## 磁贴状态

| 状态 | 含义 |
| --- | --- |
| **Not Installed** / **Click to Install** | 显示在 Available 磁贴上；选择磁贴开始连接。 |
| **Ready to Connect** | 集成已存在于工作区中，但还没有凭据。打开它并选择 **Connect Now**。 |
| **Active** | 已连接并正常运行。 |
| **Error** | 有事情需要关注，通常是重新认证。该磁贴也出现在 Needs Attention 下。 |
| **Inactive** | 已安装但已停用。在你激活它之前，不会同步或发送任何内容。 |
| **Early Access** | 可按需申请。选择磁贴会打开 **Get started with Pyn today**；**Request Now** 会在新标签页中打开演示预约页面。 |
| **Waitlist** | 选择磁贴会打开同一个对话框。 |

## 每个面板共有的操作

选择一个已安装的磁贴打开它的面板。**...** 菜单包含 **Activate** 和 **Deactivate**，大多数集成还会加上 **Reconnect**、**Test Connection** 和 **Archive**。面板的标签页有 **Details**（连接的属性，例如 **Last Refresh**）、**History**（每次刷新的日志，最新的在前），以及对 BambooHR、HiBob、Workday、Employee File 和 Sample Data 而言的 **Advanced**，它列出 Pyn 从源头收到的字段（**Fields in Report**；上传则是 **Fields in Employee File**，示例数据则是 **Fields in Sample Data**）。ADP、Rippling、Ashby 和 Greenhouse 只有 Details 和 History。

停用会停止同步和发送，同时保留凭据；激活让它们重新开始。如果 Pyn 无法完成更改，会有一条提示显示 **Could not activate the integration** 或 **Could not deactivate the integration**，磁贴保持原样。归档会把集成从 Installed 中移除，并让它的磁贴重新出现在 Available 下。依赖已归档集成的发件人会停止工作，所以先归档发件人，否则它们的步骤会失败。

## 在应用中的位置

在 Pyn 中打开 `/settings/integrations/installed`，或打开主导航中的 **Settings**；它默认打开 Installed。选择 **Available** 添加集成。

## 相关

- [集成](https://support.pyn.ai/zh-cn/integrations/)，每个集成各有一份指南。
- [修复需要注意的发件人或集成](https://support.pyn.ai/zh-cn/integrations/needs-attention/)，适用于磁贴显示 Error 的情况。
- [设置](https://support.pyn.ai/zh-cn/settings/)，了解 General 分组。
