---
title: "HiBob"
description: "サインインまたはサービスユーザーでBobから従業員を同期します。マネージャー、HRBP、バディ、試用期間終了日、そしてあなたがマッピングしたカスタムフィールドも含みます。"
sidebar:
  label: 概要
  order: 0
area: integrations
feature: hibob
appPath: /settings/integrations/available
lastVerified: 2026-11-15
version: "2026-11-06"
audience: admin
related:
  - integrations
  - integrations/hibob/field-mapping
  - integrations/hris-fields
  - integrations/sync-and-matching
  - directory/employees
intercom:
  - id: "16838927"
    title: Connect to HiBob (Pyn 2)
    url: https://intercom.help/pyn/en/articles/16838927-connect-to-hibob-pyn-2
    note: replaces
  - id: "16814957"
    title: Connect to HiBob (Pyn 2)
    url: https://intercom.help/pyn/en/articles/16814957-connect-to-hibob-pyn-2
    note: replaces
translation:
  source: integrations/hibob/index.mdx
  sourceSha: e0f0fbcfd3f208c9088f4b02b10dabc115c1a0e2
---

HiBob連携はBobのAPIから人を読み取り、Directoryを最新に保ちます。対象は名前、勤務先と私用のメールアドレス、入社日と退職日、試用期間終了日、部署、役職、拠点、マネージャー、HRBP、そしてカスタムフィールドがあればバディです。Pynは読み取るだけで、Bobに書き込むことはありません。

## 始める前に

- あなたがPynの管理者またはオーナーであること。
- 接続方法を選ぶこと。**Connect with HiBob**はBobにサインインしてPynを承認します。**Use a service user instead**は、Bobの管理者が**Settings > Integrations > Service Users**で作成するBobの**Service User ID**と**API Token**を使います。
- 入社予定者と退職者を含む従業員について、サービスユーザーまたはあなた自身のアカウントに、Pynが読み取るフィールドを持つBobのカテゴリーへの閲覧アクセスを付与すること：About、Address（city、country、postal code）、Basic Info、Employment、Home（private email）、Jobs、Lifecycle、Payroll > Employment（contract）、Personal（short birth date）、Personal Contact Details。

![Connect to HiBob offers a HiBob sign-in or a service user ID and token.](https://support.pyn.ai/media/integrations/hibob/integrations-hibob-connect.png)

## 接続する

1. Pynで左のナビゲーションの**Settings**を開き、**Integrations**の下の**Available**を開きます。

2. **HiBob**のタイルを選びます。**Connect to HiBob**ダイアログが開きます。「You will be redirected to HiBob to authorize Pyn to access your company's employee data.」

3. サインインするには**Connect with HiBob**を選び、BobでPynを承認して戻ります。

4. 代わりにサービスユーザーを使うには、**Use a service user instead**を選び、**Service User ID**と**API Token**を貼り付けて**Connect**を選びます。ダイアログには「Validating those credentials...」と表示されます。

5. 成功すると「Your HiBob integration has been added to Pyn. It will take a minute or two for employee data to be pulled from HiBob.」という通知が表示されます。

ダイアログが表示しうるエラー：「Could not verify the credentials — the service user ID or token appears to be invalid.」／「The credentials are valid but the service user lacks the permissions needed to read employees. Grant the service user people-read access in Bob.」／「An unexpected error occurred. Please check the credentials and try again. If the error persists, contact support.」最後のメッセージは、Pynがサインインを開始できないときに**Connect with HiBob**が表示するメッセージでもあります。

## 同期されるもの

PynはBobから約1時間に1回更新し、各実行を**History**に記録します。**Advanced**タブには**Fields in Report**が表示されます。あなたのテナントが返したBobのフィールドidと何人分かで、フィールドが利用できないと結論づける前に見るべき場所です。

| Pynのプロパティ | Bobでの元 |
| --- | --- |
| 表示名、正式名 | Display name、またはfirst nameとsurname |
| 勤務先メールアドレス、個人メールアドレス | Emailとprivate email |
| 入社日、在籍起算日 | Start date。在籍起算日はOriginal start date、なければStart dateから |
| 退職日、試用期間終了日 | Internalのtermination dateとprobation end date |
| 部署、役職、勤務地 | Workのdepartment、title、site（addressのcityにフォールバック） |
| マネージャー | Reports-to。Bobのidまたは社内の従業員idで照合 |
| HRBP | `employee.hrbp`フィールド |
| バディ | 連携でバディ用フィールドとして指定したカスタムフィールド。Pynサポートと設定します |
| 誕生日、国、郵便番号、タイムゾーン | Short birth dateと住所。タイムゾーンは国と郵便番号から |
| 契約の種類、勤務オフィス、その他のカスタム列 | Bobのフィールドidにマッピングされたワークスペース拡張 |

各プロパティの背後にあるBobのフィールドidと、ないときに確認することは[HiBobのフィールドマッピング](https://support.pyn.ai/ja/integrations/hibob/field-mapping/)を、マトリクスは[HRISフィールド](https://support.pyn.ai/ja/integrations/hris-fields/)を参照してください。

## テストする

**Installed**でHiBobのタイルを開き、**History**で更新の成功を確認してから、[従業員](https://support.pyn.ai/ja/directory/employees/)を開いて入社日、役職、マネージャーを確認します。

## 再接続または切断する

- **Reconnect**は同じ2つの選択肢を持つ**Reconnect to HiBob**を開きます。Bobでサービスユーザーのトークンをローテーションした後は、新しい**API Token**をここに貼り付けます。「Your HiBob integration has been updated.」なら成功です。
- **Deactivate**は同期を止め、**Activate**で再開します。

## Webhook

HiBobのWebhookが有効なワークスペースでは、インストール済みのHiBobパネルに**Webhook**タブがあり、Bobが従業員の変更をその場でPynに伝えられます。Pynが示すアドレスを使ってBobでWebhookを作成し、Bobの署名シークレットをPynに貼り付けます。

1. **Installed**でHiBobのタイルを開き、**Webhook**タブを選びます。コールアウトには「Have HiBob tell Pyn about employee changes as they happen, rather than waiting for the next sync.」とあります。**Set Up Webhook**を選びます。

2. タブに送信先のアドレスが**Copy URL**とともに表示されます。BobのWebhook設定で、そのURLに送信するWebhookを作成します。

3. v2ペイロードで、従業員のイベント（created、updated、joined、left）を購読させます。

4. BobがそのWebhookについて表示する署名シークレットを**Signing Secret**に貼り付け、**Save**を選びます。それまでコールアウトには「This webhook accepts nothing until it has HiBob's signing secret.」と表示されます。

シークレットを保存すると、コールアウトには「Pyn holds this webhook's signing secret, and accepts what HiBob signs with it.」に続いて**Last received**と最新の配信時刻、または**Nothing received yet**が表示されます。シークレットは二度と表示されません。ローテーションするには、新しいものを**Replace Signing Secret**に貼り付けて**Save**を選びます。Pynは受け付けた各配信を、**History**に一度だけ**Webhook Processed**（たとえば「Received employee.updated for employee 123」）または**Invalid Webhook Payload**として記録します。Directoryに届く内容は引き続き、更新から来ます。すでにDirectoryにいる従業員を指す配信は、そのイベントの種類についてトリガーが**HiBob Webhook**の公開済みオートメーションも発火させます。[トリガーカタログ](https://support.pyn.ai/ja/flows/automations/trigger-catalogue/#hibob-webhook)を参照してください。Pynは、検証に失敗した配信と、連携が無効化されている間に届いた配信を受け付けません。**Last received**が変わると期待する前に、接続後の最初の更新が終わるのを待ってください。

## トラブルシューティング

| 表示されるもの | 意味 |
| --- | --- |
| History：「Error: Authentication failed, please reconnect」 | トークンがローテーションされたか、サインインが取り消されました。再接続してください。 |
| History：「Error: Insufficient HiBob permissions」 | サービスユーザーがpeople-readのアクセスまたはフィールドグループを失いました。Bobで権限を広げてください。 |
| 人やフィールドがない | Advancedの**Fields in Report**を確認します。そこにないフィールドはサービスユーザーに見えないか、テナントにありません。 |
| 退職者がまだアクティブ | 退職日が同期されるように、元従業員へのlifecycleアクセスを付与してください。 |
| History：**Invalid Webhook Payload** | BobがPynに読めない配信を送信しました。BobのWebhookがv2ペイロードで従業員のイベントを購読しているか確認してください。 |
| Webhookの**Last received**が**Nothing received yet**のまま | 署名シークレットがないか間違っているか、BobのWebhookが別のURLに送信しているか、接続後にまだ更新が実行されていません。Bobが表示するシークレットを保存し、URLを確認し、**History**で更新の完了を確認してください。 |

## 関連ページ

- [連携](https://support.pyn.ai/ja/integrations/)：カタログについてです。
- [HiBobのフィールドマッピング](https://support.pyn.ai/ja/integrations/hibob/field-mapping/)：Pynの各フィールドの背後にあるBobのフィールドについてです。
- [HRISフィールド](https://support.pyn.ai/ja/integrations/hris-fields/)：フィールドのマトリクスについてです。
- [同期の頻度とマッチング](https://support.pyn.ai/ja/integrations/sync-and-matching/)：スケジュールと照合についてです。
- [従業員](https://support.pyn.ai/ja/directory/employees/)：同期されたレコードを確認するにはこちらです。
