---
title: "Ashby"
description: "把已录用的 Ashby 候选人作为即将入职的员工带入 Pyn，让入职前流程可以在第一天之前启动。"
sidebar:
  label: 概览
  order: 0
area: integrations
feature: ashby
appPath: /settings/integrations/available
lastVerified: 2026-11-15
version: "2026-11-03"
audience: admin
related:
  - integrations
  - integrations/greenhouse
  - integrations/sync-and-matching
  - flows/automations
translation:
  source: integrations/ashby/index.mdx
  sourceSha: d7b66f45596ed73fca1ddce214dfa31498448362
---

Ashby 集成读取申请状态为已录用、且有带入职日期的有效 offer（优先采用已接受的 offer）的候选人，并把他们创建为即将入职的员工，带有入职日期、职位、部门、地点和招聘经理。以入职日期触发的入职前流程就可以在他们的工作账户存在之前，通过个人地址联系到他们。

## 开始之前

- 你是 Pyn 中的管理员或所有者。
- Ashby 管理员在 **Admin > API Keys** 下创建一个 API 密钥，对 **Candidates**、**Offers** 和 **Organization** 有读取权限。对 **Jobs** 的读取权限是可选的，它会读取职位上设置的招聘经理，而不是申请上的。要包含保密职位的录用，还要允许访问保密职位和项目。

![Connect to Ashby asks for an API Key.](https://support.pyn.ai/media/integrations/ashby/integrations-ashby-connect.png)

## 连接

1. 在 Pyn 中，打开左侧导航中的 **Settings**，然后打开 **Integrations** 下的 **Available**。

2. 选择 **Ashby** 磁贴。**Connect to Ashby** 对话框打开。

3. 粘贴 **API Key**。

4. 选择 **Connect**。Pyn 检查时，对话框显示 "Validating that API key..."。

5. 成功后，通知显示 "Your Ashby integration has been added to Pyn. It will take a minute or two for candidate data to be pulled from Ashby."。

对话框可能显示的错误："Could not verify that API key — it appears to be invalid or deactivated." / "The API key is valid but lacks the permissions needed. Grant it read access to Candidates, Offers and Organization and try again." / "Enter an Ashby API key." / "An unexpected error occurred. Please check the API key and try again. If the error persists, contact support."

## 同步的内容

Pyn 大约每小时从 Ashby 刷新一次。对每个已录用的申请，它读取：

| Pyn 属性 | 来自 Ashby |
| --- | --- |
| 显示名称、法定姓名 | 候选人的姓名 |
| 工作邮箱、个人邮箱 | 候选人的工作和个人联系邮箱 |
| 入职日期 | 最新 offer 版本的入职日期 |
| 职位 | 申请的职位 |
| 部门、地点 | 职位的部门和地点名称 |
| 经理 | 职位的招聘经理（一位 Ashby 用户） |
| 时区 | 候选人的时区 |
| 自定义字段 | 映射到 Ashby 自定义字段的任何工作区扩展字段，依次从 offer、申请、候选人读取 |

录用者在 Directory 中显示为 **Upcoming**，直到入职日期。关于他们如何与之后到达的 HRIS 记录匹配，见[同步频率与匹配](https://support.pyn.ai/zh-cn/integrations/sync-and-matching/)。

## 测试

第一次刷新之后，打开[员工](https://support.pyn.ai/zh-cn/directory/employees/)并选择 **Upcoming** 视图：最近的录用者应该连同入职日期一起列出。集成的 **History** 标签页显示每次刷新。

## 重新连接或断开连接

- **...** 菜单中的 **Reconnect** 打开 **Reconnect to Ashby**，用于粘贴新密钥。"Your Ashby integration has been updated." 表示成功。
- **Deactivate** 暂停同步；**Activate** 恢复同步。

## 故障排除

| 你看到的 | 含义 |
| --- | --- |
| History："Error: Authentication failed, please reconnect" | 密钥在 Ashby 中被停用。创建一个新密钥并重新连接。 |
| History："Error: Insufficient Ashby permissions" | 密钥缺少某个读取权限范围。授予 Candidates、Offers 和 Organization。 |
| 缺少某位录用者 | offer 被拒绝、取消或撤回，没有入职日期，或者职位是保密的而密钥看不到它。 |
| 招聘经理为空 | 授予对 Jobs 的读取权限，或在申请上设置招聘经理。 |

## 相关

- [集成](https://support.pyn.ai/zh-cn/integrations/)，查看目录。
- [Greenhouse](https://support.pyn.ai/zh-cn/integrations/greenhouse/)，了解另一个 ATS 集成。
- [同步频率与匹配](https://support.pyn.ai/zh-cn/integrations/sync-and-matching/)，了解 ATS 和 HRIS 记录如何合并。
- [自动化流程](https://support.pyn.ai/zh-cn/flows/automations/)，构建以入职日期触发的入职前流程。
