コンテンツにスキップ
PynPyn

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。
The Connect to HiBob dialog with the Connect with HiBob button and the Use a service user instead option.
Connect to HiBob offers a HiBob sign-in or a service user ID and token.
  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のフィールドマッピングを、マトリクスはHRISフィールドを参照してください。

InstalledでHiBobのタイルを開き、Historyで更新の成功を確認してから、従業員を開いて入社日、役職、マネージャーを確認します。

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

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の公開済みオートメーションも発火させます。トリガーカタログを参照してください。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で更新の完了を確認してください。