HiBob
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。

-
Pynで左のナビゲーションのSettingsを開き、Integrationsの下のAvailableを開きます。
-
HiBobのタイルを選びます。Connect to HiBobダイアログが開きます。「You will be redirected to HiBob to authorize Pyn to access your company’s employee data.」
-
サインインするにはConnect with HiBobを選び、BobでPynを承認して戻ります。
-
代わりにサービスユーザーを使うには、Use a service user insteadを選び、Service User IDとAPI Tokenを貼り付けてConnectを選びます。ダイアログには「Validating those credentials…」と表示されます。
-
成功すると「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が表示するメッセージでもあります。
同期されるもの
Section titled “同期されるもの”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のフィールドマッピングを、マトリクスはHRISフィールドを参照してください。
InstalledでHiBobのタイルを開き、Historyで更新の成功を確認してから、従業員を開いて入社日、役職、マネージャーを確認します。
再接続または切断する
Section titled “再接続または切断する”- Reconnectは同じ2つの選択肢を持つReconnect to HiBobを開きます。Bobでサービスユーザーのトークンをローテーションした後は、新しいAPI Tokenをここに貼り付けます。「Your HiBob integration has been updated.」なら成功です。
- Deactivateは同期を止め、Activateで再開します。
Webhook
Section titled “Webhook”HiBobのWebhookが有効なワークスペースでは、インストール済みのHiBobパネルにWebhookタブがあり、Bobが従業員の変更をその場でPynに伝えられます。Pynが示すアドレスを使ってBobでWebhookを作成し、Bobの署名シークレットをPynに貼り付けます。
-
InstalledでHiBobのタイルを開き、Webhookタブを選びます。コールアウトには「Have HiBob tell Pyn about employee changes as they happen, rather than waiting for the next sync.」とあります。Set Up Webhookを選びます。
-
タブに送信先のアドレスがCopy URLとともに表示されます。BobのWebhook設定で、そのURLに送信するWebhookを作成します。
-
v2ペイロードで、従業員のイベント(created、updated、joined、left)を購読させます。
-
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の公開済みオートメーションも発火させます。トリガーカタログを参照してください。Pynは、検証に失敗した配信と、連携が無効化されている間に届いた配信を受け付けません。Last receivedが変わると期待する前に、接続後の最初の更新が終わるのを待ってください。
トラブルシューティング
Section titled “トラブルシューティング”| 表示されるもの | 意味 |
|---|---|
| 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で更新の完了を確認してください。 |
- 連携:カタログについてです。
- HiBobのフィールドマッピング:Pynの各フィールドの背後にあるBobのフィールドについてです。
- HRISフィールド:フィールドのマトリクスについてです。
- 同期の頻度とマッチング:スケジュールと照合についてです。
- 従業員:同期されたレコードを確認するにはこちらです。