---
title: "BambooHR"
description: "用你的公司域名连接 BambooHR，通过 BambooHR 登录让 Pyn 读取员工，并以每小时刷新和变更通知让 Directory 保持最新。"
sidebar:
  label: 概览
  order: 0
area: integrations
feature: bamboohr
appPath: /settings/integrations/available
lastVerified: 2026-11-15
version: "2026-11-02"
audience: admin
related:
  - integrations
  - integrations/hris-fields
  - integrations/sync-and-matching
intercom:
  - id: "11614355"
    title: Connect to BambooHR (Pyn 2)
    url: https://intercom.help/pyn/en/articles/11614355-connect-to-bamboohr-pyn-2
    note: replaces
  - id: "10100088"
    title: "BambooHR Error \"Insufficient Permissions\""
    url: https://intercom.help/pyn/en/articles/10100088-bamboohr-error-insufficient-permissions
    note: replaces
  - id: "6024101"
    title: Why is employee data from BambooHR not appearing in Pyn?
    url: https://intercom.help/pyn/en/articles/6024101-why-is-employee-data-from-bamboohr-not-appearing-in-pyn
    note: replaces
  - id: "6330100"
    title: Connect to BambooHR (Pyn 1)
    url: https://intercom.help/pyn/en/articles/6330100-connect-to-bamboohr-pyn-1
    note: "Pyn 1 article, kept for reference"
translation:
  source: integrations/bamboohr/index.mdx
  sourceSha: c75c1409d92ecf48831371f6ed3d872a20c0df1c
---

BambooHR 集成通过 BambooHR API 读取你的员工目录和一份自定义报表，所以入职日期、部门、经理和离职员工无需电子表格就能驱动你的流程。在启用了 BambooHR webhook 的工作区中，BambooHR 还会在两次刷新之间把变更通知 Pyn。

## 开始之前

- 你是 Pyn 中的管理员或所有者。
- 你知道你的 BambooHR 公司域名：BambooHR 地址中 `.bamboohr.com` 之前的部分。
- 你可以用一个有 API 访问权限、并能看到你想同步的字段的账户登录 BambooHR。非员工的服务账户比个人登录更好，因为个人登录会在那个人离职时失效。

![Connect to BambooHR asks for your Company Domain.](https://support.pyn.ai/media/integrations/bamboohr/integrations-bamboohr-connect.png)

## 连接

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

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

3. 输入你的 **Company Domain**。可以粘贴整个地址，例如 `https://acme.bamboohr.com`；Pyn 保留 `acme`。"This is not a valid company domain." 表示它看起来不像 BambooHR 子域名。

4. 选择 **Connect**。BambooHR 打开；登录并选择 **Allow Access**。

5. BambooHR 把你带回 Pyn。面板显示 "You're connected. Syncing can take a few minutes. Check the journey map then!" 如果你在 BambooHR 拒绝了访问，或在那里停留太久，你会回到 **Installed**，并看到一条标题为 **BambooHR wasn't connected** 的提示说明原因：“You didn't grant access, so nothing was connected.”或“The sign-in took too long, so nothing was connected. Try again.”

## 同步的内容

Pyn 大约每小时刷新一次；报表没有变化的运行会记录为 "Successfully integrated to BambooHR. No employee changes found"。在启用了 webhook 的工作区中，BambooHR 自己的变更通知到达时会记录在 **History** 下。**Details** 标签页显示 **Subdomain**、**Primary Source**（Custom Report 或 Directory）、**Last Refresh** 和 **Last Successful Refresh**；**Advanced** 标签页列出 **Fields in Report**，每个字段带有计数。

| Pyn 属性 | 来自 BambooHR |
| --- | --- |
| 显示名称、法定姓名、常用名 | 显示名称、全名和常用名 |
| 工作邮箱、个人邮箱 | 工作邮箱和家庭邮箱 |
| 入职日期 | 雇用日期；比它更早的原始雇用日期表示这是回聘员工 |
| 离职日期、状态 | 离职日期；Active 以外的雇用状态变为非在职 |
| 部门、分部、地点、职位 | 对应的 BambooHR 字段 |
| 雇用类型 | 雇用历史状态 |
| 经理 | 主管员工 id |
| 生日、国家、邮政编码、时区 | 生日和地址；时区来自国家和邮政编码 |

如果 Pyn 用来连接的账户只能读取目录，面板会警告："This integration is pulling limited employee data from the BambooHR directory. To get a complete employee profile, have a BambooHR administrator reconnect this integration, or ask for expanded permissions." 字段矩阵见 [HRIS 字段](https://support.pyn.ai/zh-cn/integrations/hris-fields/)。

## 测试

打开 **Installed** 下的 BambooHR 磁贴，打开 **...** 菜单并选择 **Test Connection**。"Successfully tested the connection to BambooHR." 表示成功；"An error occurred connecting to BambooHR. Please Reconnect or contact support if the issue persists." 表示登录已失效。然后检查[员工](https://support.pyn.ai/zh-cn/directory/employees/)。

## 重新连接或断开连接

- **Reconnect** 为同一个公司域名重复 BambooHR 登录。在所连接账户的密码更改或权限扩大之后使用它。
- **Deactivate** 停止同步；**Activate** 恢复同步。**Archive** 把集成从 Installed 中移除；已同步的员工保留。任一操作失败时，会弹出 **Could not deactivate the integration** 或 **Could not archive the integration**，并且什么都不会改变。

## 故障排除

| 你看到的 | 含义 |
| --- | --- |
| History："Error: Insufficient permissions to access BambooHR" | 所连接账户的访问级别失去了 API 或字段权限。在 BambooHR 中打开 **Access Levels > Custom Levels**，选择该级别，在 **Access Level Settings** 下允许 **Settings > Company Field Settings**，然后重新连接。 |
| History："Error: Authentication failed, please reconnect" | 登录已过期或被撤销。重新连接。 |
| History："Could not connect to BambooHR, please reconnect" | BambooHR 拒绝了连接。重新连接；如果重复出现，联系支持。 |
| History："BambooHR returned data in an unexpected format"（琥珀色） | 一次刷新收到了 Pyn 无法读取的回复，通常是偶发的，所以集成保持活跃，下次刷新会再试。如果每次运行都出现，联系支持。 |
| 某人离职后员工不再更新 | 集成是用那个人的登录连接的。用非员工账户重新连接。 |
| 入职日期等字段为空 | 它们在 BambooHR 中为空，或者该账户看不到它们。检查 Advanced 下的字段计数。 |

## 相关

- [集成](https://support.pyn.ai/zh-cn/integrations/)，查看目录。
- [HRIS 字段](https://support.pyn.ai/zh-cn/integrations/hris-fields/)，查看字段矩阵。
- [同步频率与匹配](https://support.pyn.ai/zh-cn/integrations/sync-and-matching/)，了解计划和匹配。
