---
title: 同步频率与匹配
description: 每个集成多久刷新一次、来自不同来源的记录如何匹配到同一位员工，以及如何决定收件人的时区。
sidebar:
  order: 3
area: integrations
feature: sync-and-matching
appPath: /settings/integrations/installed
lastVerified: 2026-11-15
version: "2026-10-27"
audience: admin
related:
  - integrations
  - integrations/hris-fields
  - directory/employees
  - settings/account
intercom:
  - id: "6024088"
    title: How often is data pulled from an HRIS integration?
    url: https://intercom.help/pyn/en/articles/6024088-how-often-is-data-pulled-from-an-hris-integration
    note: Pyn 1 article
  - id: "6024089"
    title: "How does Pyn determine a message recipient's time zone?"
    url: https://intercom.help/pyn/en/articles/6024089-how-does-pyn-determine-a-message-recipient-s-time-zone
    note: Pyn 1 article
translation:
  source: integrations/sync-and-matching.mdx
  sourceSha: 1cdc257de18fda066e297028598cb4098fc90fcf
---

每个集成按自己的计划刷新，并把每次运行记录在 **History** 下；Directory 按来源自己的 id 或邮箱把记录匹配到员工。这份参考列出各项计划和匹配规则，以及 Pyn 决定员工时区所用的顺序。

## 刷新计划

| 集成 | 刷新 | 另外 |
| --- | --- | --- |
| BambooHR | 大约每小时一次 | 在启用了 BambooHR webhook 的工作区中，两次刷新之间接收来自 BambooHR 的变更通知；没有变化的运行记录为已跳过 |
| HiBob | 大约每小时一次 | 在启用了 HiBob webhook 的工作区中，Bob webhook 接受的每条投递在 History 下记录一次；没有变化的运行记录为已跳过 |
| Rippling | 大约每小时一次 | |
| Workday | 大约每小时一次 | |
| ADP Workforce Now | 大约每小时一次 | |
| Greenhouse | 大约每小时一次 | |
| Ashby | 大约每小时一次 | |
| Google Workspace | 每个活跃日历大约每小时一次 | 定期日历事件；日历上的 **Refresh Events** 立即拉取 |
| Microsoft 365 | 每个活跃日历大约每小时一次 | 定期日历事件；**Refresh Events** 立即拉取 |
| Slack | 大约每小时一次 | 成员；在启用了频道刷新的工作区中还有频道，频道成员每天更新 |
| Jira | 每天两次 | 项目，以及向步骤开放的项目的问题类型 |
| Microsoft Teams | 没有计划刷新；由 Pyn 团队维护连接 | 团队成员和频道，由 Pyn 团队协助设置 |
| 电子邮件 | 每隔几分钟 | 投递事件 |
| Employee File、Sample Data | 每次上传或重新加载时 | |

来源处的更改会在大约一小时内到达 Pyn。停用集成或[暂停工作区](https://support.pyn.ai/zh-cn/settings/account/pause-your-workspace/)会停止它的刷新。每次运行都出现在集成面板的 **History** 标签页下，用绿色、琥珀色或红色圆点表示成功、暂时性错误或致命错误。**Last Refresh** 和 **Last Successful Refresh** 显示在 BambooHR、Rippling、Slack 和 Google Workspace 面板的 Details 标签页上；其他面板只在 **History** 下显示每次运行。凭据失败会把集成移到 **Needs Attention 🚨** 并发出通知。

## 记录如何成为员工

Pyn 把每条来源记录匹配到员工时，先按来源自己的 id，然后按工作邮箱，再按个人邮箱，所以只有个人地址的入职前记录仍然能匹配。没有匹配到任何人的记录会成为一位新员工。因此：

- 工作邮箱相同的一条 HRIS 记录和一位 Slack 成员会成为同一位员工，两个来源都附加在上面。员工的资料列出每个来源，并带有 **Disconnect** 以取消其中一个的关联："Disconnect this source? The employee will no longer take any of their details from it."
- 来自 Greenhouse 或 Ashby 的录用者显示为即将入职的员工；当工作邮箱相同的 HRIS 记录到达时，它会附加到同一位员工，而不是创建第二位。
- Employee File 先按 `employeeId` 匹配，再按工作邮箱和个人邮箱匹配，所以 id 变化的一行只要有一个邮箱匹配，仍然会附加到同一个人。id 和邮箱全部变化的一行会创建一位新员工。
- 仅凭 Slack 和 Teams 成员身份不会创建员工；这个人必须来自 HRIS、文件或 ATS。
- HRIS 字段在 Pyn 中是只读的，只在来源处更改。

在员工之后才到达 Pyn 的经理、HRBP、伙伴或导师会在下一次刷新时关联上。

## 生命周期阶段

入职日期、离职日期和在职标志决定阶段：入职日期之前为 **Joiner**，从入职日期起为 **Current**，从离职日期起或来源把此人标记为非在职后为 **Terminated**。来源的休假状态作为 **Active status: On Leave** 保留在记录上，不改变阶段。生命周期群组（**Upcoming Employees**、**Current Active Employees**、**Terminated Employees** 和 **Inactive Employees**）和每个触发器读取的都是这些阶段。

## 时区

按收件人时区排期的步骤需要一个时区。Pyn 按以下顺序从来源记录中决定它：

1. 来源提供的时区，形式为 IANA 名称（`Europe/London`）、常见缩写或 Windows 时区名称。
2. 国家加邮政编码，适用于美国、加拿大和澳大利亚。横跨多个时区的其他国家（包括巴西、墨西哥、俄罗斯和阿根廷）需要来源提供时区，否则落到第 4 步。
3. 国家，适用于只有一个时区的国家。
4. 否则使用[账户设置](https://support.pyn.ai/zh-cn/settings/account/)中的工作区 **Time Zone**："Employees without timezone data get messages in this default timezone."

Workday 是例外：Pyn 只读取 `Time_Zone` 列，形式为 IANA 名称或 Workday 自己的时区名称，例如 `GMT-05:00 Eastern Time (New York)`，不会从国家或邮政编码推导时区，所以没有时区的 Workday 员工会得到工作区默认值。

多时区国家的 Employee File 行如果没有 `timeZone` 或 `postalCode`，会被拒绝并提示 "Could not determine timezone from country ... Add a postal code or choose a time zone." 自定义电子邮件收件人有自己的 **Time Zone** 字段，回退规则相同。

## 相关

- [集成](https://support.pyn.ai/zh-cn/integrations/)，查看每个集成的指南。
- [HRIS 字段](https://support.pyn.ai/zh-cn/integrations/hris-fields/)，了解每个来源提供哪些属性。
- [员工](https://support.pyn.ai/zh-cn/directory/employees/)，在资料上查看来源和生命周期。
- [账户设置](https://support.pyn.ai/zh-cn/settings/account/)，设置工作区时区。
