Ga naar inhoud
PynPyn

HiBob

De HiBob-integratie leest mensen via de API van Bob en houdt de Directory actueel: namen, zakelijk en privé-e-mailadres, startdatum en datum uit dienst, einddatum van de proeftijd, afdeling, functietitel, site, manager, HRBP en, als je er een aangepast veld voor hebt, buddy. Pyn leest alleen; er wordt nooit naar Bob geschreven.

  • Je bent admin of owner in Pyn.
  • Kies hoe je koppelt. Connect with HiBob logt je in bij Bob en autoriseert Pyn. Use a service user instead vraagt om een Service User ID en API Token van Bob die een Bob-beheerder aanmaakt onder Settings > Integrations > Service Users.
  • Geef de service user, of je eigen account, leestoegang tot de Bob-categorieën met de velden die Pyn leest: About, Address (woonplaats, land en postcode), Basic Info, Employment, Home (privé-e-mailadres), Jobs, Lifecycle, Payroll > Employment (contract), Personal (korte geboortedatum) en Personal Contact Details, voor medewerkers inclusief pre-hires en vertrekkers.
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. Open in Pyn Settings in de linkernavigatie, en dan Available onder Integrations.

  2. Selecteer de tegel HiBob. Het dialoogvenster Connect to HiBob opent: “You will be redirected to HiBob to authorize Pyn to access your company’s employee data.”

  3. Om in te loggen selecteer je Connect with HiBob, autoriseer je Pyn in Bob en keer je terug.

  4. Om in plaats daarvan een service user te gebruiken, selecteer je Use a service user instead, plak je de Service User ID en het API Token, en selecteer je Connect. Het dialoogvenster toont “Validating those credentials…”

  5. Bij succes leest een melding “Your HiBob integration has been added to Pyn. It will take a minute or two for employee data to be pulled from HiBob.”

Fouten die het dialoogvenster kan tonen: “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.” De laatste is ook wat Connect with HiBob toont wanneer Pyn het inloggen niet kan starten.

Pyn ververst ongeveer één keer per uur vanuit Bob en legt elke run vast onder History. Het tabblad Advanced toont Fields in Report: de Bob-veld-id’s die je tenant heeft teruggegeven en voor hoeveel mensen; kijk daar voordat je concludeert dat een veld niet beschikbaar is.

Eigenschap in Pyn Uit Bob
Weergavenaam, officiële naam Weergavenaam, of voornaam en achternaam
Zakelijk e-mailadres, persoonlijk e-mailadres E-mailadres en privé-e-mailadres
Startdatum, diensttijddatum Startdatum; de diensttijd uit de oorspronkelijke startdatum, anders de startdatum
Datum uit dienst, einddatum proeftijd Interne datum uit dienst en einddatum van de proeftijd
Afdeling, functietitel, locatie Afdeling, functietitel en site van het werk (valt terug op de woonplaats uit het adres)
Manager Reports-to, gematcht op Bob-id of medewerkers-id binnen het bedrijf
HRBP Het veld employee.hrbp
Buddy Het aangepaste veld dat op de integratie als buddyveld is ingesteld, samen met Pyn-support
Verjaardag, land, postcode, tijdzone Korte geboortedatum en adres; tijdzone uit land en postcode
Contracttype, werkplek en andere aangepaste kolommen Workspace-extensies gekoppeld aan een Bob-veld-id

Zie HiBob-veldmapping voor het Bob-veld-id achter elke eigenschap en wat je controleert wanneer er een ontbreekt, en HRIS-velden voor de matrix.

Open de tegel HiBob onder Installed en controleer History op een geslaagde verversing, open daarna Employees en controleer startdatums, functietitels en managers.

  • Reconnect opent Reconnect to HiBob met dezelfde twee keuzes. Heb je het token van een service user in Bob geroteerd, plak dan hier het nieuwe API Token. “Your HiBob integration has been updated.” bevestigt het.
  • Deactivate stopt het synchroniseren; Activate hervat het.

In workspaces waar de HiBob-webhook is ingeschakeld, heeft het geïnstalleerde HiBob-paneel een tabblad Webhook, zodat Bob wijzigingen in medewerkers aan Pyn kan melden zodra ze gebeuren. Je maakt de webhook in Bob aan met een adres dat Pyn je geeft en plakt het signing secret van Bob terug.

  1. Open de tegel HiBob onder Installed en selecteer het tabblad Webhook. De callout leest “Have HiBob tell Pyn about employee changes as they happen, rather than waiting for the next sync.” Selecteer Set Up Webhook.

  2. Het tabblad toont nu het adres om naar te posten, met Copy URL. Maak in de webhookinstellingen van Bob een webhook aan die naar die URL post.

  3. Abonneer hem op de medewerkersgebeurtenissen (created, updated, joined en left), met de v2-payload.

  4. Plak het signing secret dat Bob voor de webhook toont in Signing Secret en selecteer Save. Tot je dat doet, leest de callout “This webhook accepts nothing until it has HiBob’s signing secret.”

Met het secret opgeslagen leest de callout “Pyn holds this webhook’s signing secret, and accepts what HiBob signs with it.” gevolgd door Last received en het tijdstip van de laatste levering, of Nothing received yet. Het secret wordt nooit meer getoond; om het te roteren plak je het nieuwe in Replace Signing Secret en selecteer je Save. Pyn legt elke levering die het accepteert één keer vast onder History als Webhook Processed (bijvoorbeeld “Received employee.updated for employee 123”) of Invalid Webhook Payload. Wat de Directory bereikt komt nog steeds van de verversing. Een levering die een medewerker noemt die al in de Directory staat, laat ook elke gepubliceerde automation afgaan waarvan de trigger HiBob Webhook voor dat gebeurtenistype is; zie de Triggercatalogus. Pyn wijst een levering af die de verificatie niet doorstaat of binnenkomt terwijl de integratie is gedeactiveerd. Laat de eerste verversing na het koppelen afronden voordat je verwacht dat Last received verandert.

Wat je ziet Wat het betekent
History: “Error: Authentication failed, please reconnect” Het token is geroteerd of de login is ingetrokken. Koppel opnieuw.
History: “Error: Insufficient HiBob permissions” De service user is people-read-toegang of een veldgroep kwijtgeraakt. Verruim zijn rechten in Bob.
Mensen of velden ontbreken Controleer Fields in Report onder Advanced; een veld dat daar ontbreekt is niet zichtbaar voor de service user, of je tenant heeft het niet.
Vertrekkers blijven actief Geef lifecycle-toegang tot voormalige medewerkers zodat datums uit dienst synchroniseren.
History: Invalid Webhook Payload Bob heeft een levering gepost die Pyn niet kon lezen. Controleer of de webhook in Bob is geabonneerd op de medewerkersgebeurtenissen met de v2-payload.
Last received van de webhook blijft op Nothing received yet staan Het signing secret ontbreekt of is onjuist, de webhook in Bob post naar een andere URL, of er heeft sinds het koppelen geen verversing gedraaid. Sla het secret op dat Bob toont, controleer de URL en controleer History op een afgeronde verversing.