HiBob
Die HiBob-Integration liest Personen aus Bobs API und hält das Directory aktuell: Namen, geschäftliche und private E-Mail, Start- und Austrittsdaten, Ende der Probezeit, Abteilung, Titel, Site, Führungskraft, HRBP und, wenn du ein eigenes Feld dafür hast, Buddy. Pyn liest nur; es schreibt nie nach Bob.
Bevor du beginnst
Abschnitt betitelt „Bevor du beginnst“- Du bist Admin oder Owner in Pyn.
- Wähle, wie du verbindest. Connect with HiBob meldet dich bei Bob an und autorisiert Pyn. Use a service user instead erwartet eine Bob-Service User ID und ein API Token, die ein Bob-Admin unter Settings > Integrations > Service Users anlegt.
- Gib dem Service User oder deinem eigenen Konto Lesezugriff auf die Bob-Kategorien, die die Felder enthalten, die Pyn liest: About, Address (Stadt, Land und Postleitzahl), Basic Info, Employment, Home (private E-Mail), Jobs, Lifecycle, Payroll > Employment (Vertrag), Personal (kurzes Geburtsdatum) und Personal Contact Details, für Mitarbeitende einschließlich Pre-Hires und ausscheidender Personen.

Verbinden
Abschnitt betitelt „Verbinden“-
Öffne in Pyn Settings in der linken Navigation, dann Available unter Integrations.
-
Wähle die Kachel HiBob. Der Dialog Connect to HiBob öffnet sich: „You will be redirected to HiBob to authorize Pyn to access your company’s employee data.“
-
Zum Anmelden wähle Connect with HiBob, autorisiere Pyn in Bob und kehre zurück.
-
Um stattdessen einen Service User zu nutzen, wähle Use a service user instead, füge Service User ID und API Token ein und wähle Connect. Der Dialog zeigt „Validating those credentials…“
-
Bei Erfolg lautet die Meldung „Your HiBob integration has been added to Pyn. It will take a minute or two for employee data to be pulled from HiBob.“
Fehler, die der Dialog zeigen kann: „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.“ Die letzte ist auch das, was Connect with HiBob zeigt, wenn Pyn die Anmeldung nicht starten kann.
Was synchronisiert wird
Abschnitt betitelt „Was synchronisiert wird“Pyn aktualisiert etwa einmal pro Stunde aus Bob und hält jeden Lauf unter History fest. Der Tab Advanced listet Fields in Report: die Bob-Feld-IDs, die dein Tenant zurückgegeben hat, und für wie viele Personen; sieh dort nach, bevor du ein Feld für nicht verfügbar hältst.
| Pyn-Eigenschaft | Aus Bob |
|---|---|
| Anzeigename, rechtlicher Name | Anzeigename oder Vorname und Nachname |
| Geschäftliche E-Mail, private E-Mail | E-Mail und private E-Mail |
| Startdatum, Betriebszugehörigkeitsdatum | Startdatum; Betriebszugehörigkeit aus dem ursprünglichen Startdatum, sonst dem Startdatum |
| Austrittsdatum, Ende der Probezeit | Internes Austrittsdatum und internes Ende der Probezeit |
| Abteilung, Jobtitel, Standort | Abteilung, Titel und Site aus Work (ersatzweise die Stadt der Adresse) |
| Führungskraft | Reports-to, abgeglichen über Bob-ID oder Mitarbeitenden-ID im Unternehmen |
| HRBP | Das Feld employee.hrbp |
| Buddy | Das eigene Feld, das bei der Integration als Buddy-Feld benannt ist, eingerichtet mit dem Pyn-Support |
| Geburtstag, Land, Postleitzahl, Zeitzone | Kurzes Geburtsdatum und Adresse; Zeitzone aus Land und Postleitzahl |
| Vertragsart, Arbeitsort und weitere eigene Spalten | Workspace-Erweiterungen, die auf eine Bob-Feld-ID abgebildet sind |
Siehe HiBob-Feldzuordnung für die Bob-Feld-ID hinter jeder Eigenschaft und was du prüfst, wenn eine fehlt, und HRIS-Felder für die Matrix.
Öffne die Kachel HiBob unter Installed und prüfe History auf eine erfolgreiche Aktualisierung, dann öffne Employees und bestätige Startdaten, Titel und Führungskräfte.
Neu verbinden oder trennen
Abschnitt betitelt „Neu verbinden oder trennen“- Reconnect öffnet Reconnect to HiBob mit denselben zwei Optionen. Nachdem du in Bob ein Service-User-Token rotiert hast, fügst du hier das neue API Token ein. „Your HiBob integration has been updated.“ bestätigt es.
- Deactivate stoppt die Synchronisierung; Activate setzt sie fort.
Webhook
Abschnitt betitelt „Webhook“In Workspaces, in denen der HiBob-Webhook aktiviert ist, hat das installierte HiBob-Panel einen Tab Webhook, sodass Bob Pyn über Änderungen an Mitarbeitenden informieren kann, sobald sie passieren. Du legst den Webhook in Bob mit einer Adresse an, die Pyn dir gibt, und fügst Bobs Signing Secret anschließend in Pyn ein.
-
Öffne die Kachel HiBob unter Installed und wähle den Tab Webhook. Der Hinweis lautet „Have HiBob tell Pyn about employee changes as they happen, rather than waiting for the next sync.“ Wähle Set Up Webhook.
-
Der Tab zeigt jetzt die Adresse, an die gepostet wird, mit Copy URL. Lege in Bobs Webhook-Einstellungen einen Webhook an, der an diese URL postet.
-
Abonniere für ihn die Mitarbeitenden-Ereignisse (created, updated, joined und left) mit dem v2-Payload.
-
Füge das Signing Secret, das Bob für den Webhook zeigt, in Signing Secret ein und wähle Save. Bis dahin lautet der Hinweis „This webhook accepts nothing until it has HiBob’s signing secret.“
Mit gespeichertem Secret lautet der Hinweis „Pyn holds this webhook’s signing secret, and accepts what HiBob signs with it.“, gefolgt von Last received und der Zeit der letzten Zustellung, oder Nothing received yet. Das Secret wird nie wieder angezeigt; zum Rotieren fügst du das neue in Replace Signing Secret ein und wählst Save. Pyn hält jede Zustellung, die es annimmt, einmal unter History als Webhook Processed fest (etwa „Received employee.updated for employee 123“) oder als Invalid Webhook Payload. Was das Directory erreicht, kommt weiterhin aus der Aktualisierung. Eine Zustellung, die eine Person nennt, die schon im Directory ist, löst außerdem jede veröffentlichte Automation aus, deren Trigger HiBob Webhook für diesen Ereignistyp ist; siehe den Trigger-Katalog. Pyn weist eine Zustellung ab, die die Prüfung nicht besteht oder bei deaktivierter Integration ankommt. Lass die erste Aktualisierung nach dem Verbinden abschließen, bevor du erwartest, dass sich Last received ändert.
Fehlerbehebung
Abschnitt betitelt „Fehlerbehebung“| Was du siehst | Was es bedeutet |
|---|---|
| History: „Error: Authentication failed, please reconnect“ | Das Token wurde rotiert oder die Anmeldung widerrufen. Verbinde neu. |
| History: „Error: Insufficient HiBob permissions“ | Der Service User hat den People-Lesezugriff oder eine Feldgruppe verloren. Erweitere seine Berechtigungen in Bob. |
| Personen oder Felder fehlen | Prüfe Fields in Report unter Advanced; ein Feld, das dort fehlt, ist für den Service User nicht sichtbar, oder dein Tenant hat es nicht. |
| Ausscheidende Personen bleiben aktiv | Gewähre Lifecycle-Zugriff auf ehemalige Mitarbeitende, damit Austrittsdaten synchronisiert werden. |
| History: Invalid Webhook Payload | Bob hat eine Zustellung gepostet, die Pyn nicht lesen konnte. Prüfe, ob der Webhook in Bob die Mitarbeitenden-Ereignisse mit dem v2-Payload abonniert hat. |
| Webhook Last received bleibt bei Nothing received yet | Das Signing Secret fehlt oder ist falsch, der Webhook in Bob postet an eine andere URL, oder seit dem Verbinden ist keine Aktualisierung gelaufen. Speichere das Secret, das Bob zeigt, prüfe die URL und prüfe History auf eine abgeschlossene Aktualisierung. |
Verwandte Seiten
Abschnitt betitelt „Verwandte Seiten“- Integrations für den Katalog.
- HiBob-Feldzuordnung für das Bob-Feld hinter jedem Pyn-Feld.
- HRIS-Felder für die Feldmatrix.
- Synchronisierungsrhythmus und Abgleich für Zeitpläne und Abgleich.
- Employees, um die synchronisierten Datensätze zu prüfen.