BambooHR
Die BambooHR-Integration liest dein Mitarbeitendenverzeichnis und einen eigenen Report über die BambooHR-API, sodass Startdaten, Abteilungen, Führungskräfte und ausscheidende Personen deine Flows ohne Tabelle steuern. In Workspaces, in denen der BambooHR-Webhook aktiviert ist, benachrichtigt BambooHR Pyn außerdem über Änderungen zwischen den Aktualisierungen.
Bevor du beginnst
Abschnitt betitelt „Bevor du beginnst“- Du bist Admin oder Owner in Pyn.
- Du kennst deine BambooHR-Firmendomain: den Teil vor
.bamboohr.comin deiner BambooHR-Adresse. - Du kannst dich bei BambooHR mit einem Konto anmelden, das API-Zugriff hat und die Felder sehen kann, die du synchronisieren willst. Ein Servicekonto ohne Person dahinter ist besser als der Login einer Person, der nicht mehr funktioniert, sobald diese Person geht.

Verbinden
Abschnitt betitelt „Verbinden“-
Öffne in Pyn Settings in der linken Navigation, dann Available unter Integrations.
-
Wähle die Kachel BambooHR. Der Dialog Connect to BambooHR öffnet sich.
-
Gib deine Company Domain ein. Du kannst die ganze Adresse einfügen, etwa
https://acme.bamboohr.com; Pyn behältacme. „This is not a valid company domain.“ heißt, sie sieht nicht wie eine BambooHR-Subdomain aus. -
Wähle Connect. BambooHR öffnet sich; melde dich an und wähle Allow Access.
-
BambooHR bringt dich zurück zu Pyn. Das Panel zeigt „You’re connected. Syncing can take a few minutes. Check the journey map then!“ Lehnst du den Zugriff bei BambooHR stattdessen ab oder dauert es dort zu lange, landest du auf Installed mit einem Toast mit dem Titel BambooHR wasn’t connected, der den Grund nennt: „You didn’t grant access, so nothing was connected.“ oder „The sign-in took too long, so nothing was connected. Try again.“
Was synchronisiert wird
Abschnitt betitelt „Was synchronisiert wird“Pyn aktualisiert etwa einmal pro Stunde; ein Lauf, in dem sich der Report nicht geändert hat, wird als „Successfully integrated to BambooHR. No employee changes found“ protokolliert. In Workspaces mit aktiviertem Webhook werden BambooHRs eigene Änderungsbenachrichtigungen unter History protokolliert, sobald sie eintreffen. Der Tab Details zeigt Subdomain, Primary Source (Custom Report oder Directory), Last Refresh und Last Successful Refresh; der Tab Advanced listet Fields in Report mit einer Anzahl pro Feld.
| Pyn-Eigenschaft | Aus BambooHR |
|---|---|
| Anzeigename, rechtlicher Name, Rufname | Anzeigename, vollständiger Name und Rufname |
| Geschäftliche E-Mail, private E-Mail | Geschäftliche E-Mail und private E-Mail |
| Startdatum | Einstellungsdatum; ein früheres ursprüngliches Einstellungsdatum markiert eine zurückkehrende Person |
| Austrittsdatum, Status | Austrittsdatum; ein Beschäftigungsstatus außer Active wird inaktiv |
| Abteilung, Division, Standort, Jobtitel | Die passenden BambooHR-Felder |
| Beschäftigungsart | Status der Beschäftigungshistorie |
| Führungskraft | Mitarbeitenden-ID der vorgesetzten Person |
| Geburtstag, Land, Postleitzahl, Zeitzone | Geburtstag und Adresse; Zeitzone aus Land und Postleitzahl |
Kann das Konto, mit dem Pyn verbunden wurde, nur das Verzeichnis lesen, warnt das Panel: „This integration is pulling limited employee data from the BambooHR directory. To get a complete employee profile, have a BambooHR administrator reconnect this integration, or ask for expanded permissions.“ Siehe HRIS-Felder für die Feldmatrix.
Öffne die Kachel BambooHR unter Installed, öffne das Menü … und wähle Test Connection. „Successfully tested the connection to BambooHR.“ bestätigt es; „An error occurred connecting to BambooHR. Please Reconnect or contact support if the issue persists.“ heißt, die Anmeldung funktioniert nicht mehr. Prüfe dann Employees.
Neu verbinden oder trennen
Abschnitt betitelt „Neu verbinden oder trennen“- Reconnect wiederholt die BambooHR-Anmeldung für dieselbe Firmendomain. Nutze es, nachdem sich das Passwort des verbundenen Kontos geändert hat oder seine Berechtigungen erweitert wurden.
- Deactivate stoppt die Synchronisierung; Activate setzt sie fort. Archive entfernt die Integration aus Installed; synchronisierte Mitarbeitende bleiben. Schlägt eines davon fehl, zeigt ein Toast Could not deactivate the integration oder Could not archive the integration, und nichts ändert sich.
Fehlerbehebung
Abschnitt betitelt „Fehlerbehebung“| Was du siehst | Was es bedeutet |
|---|---|
| History: „Error: Insufficient permissions to access BambooHR“ | Die Zugriffsstufe des verbundenen Kontos hat API- oder Feldberechtigungen verloren. Öffne in BambooHR Access Levels > Custom Levels, wähle die Stufe und erlaube unter Access Level Settings Settings > Company Field Settings, dann verbinde neu. |
| History: „Error: Authentication failed, please reconnect“ | Die Anmeldung ist abgelaufen oder wurde widerrufen. Verbinde neu. |
| History: „Could not connect to BambooHR, please reconnect“ | BambooHR hat die Verbindung verweigert. Verbinde neu; wiederholt es sich, kontaktiere den Support. |
| History: „BambooHR returned data in an unexpected format“ (gelb) | Eine Aktualisierung bekam eine Antwort, die Pyn nicht lesen konnte, meist ein Einzelfall, die Integration bleibt also aktiv und die nächste Aktualisierung versucht es erneut. Wiederholt es sich bei jedem Lauf, kontaktiere den Support. |
| Mitarbeitende werden nicht mehr aktualisiert, nachdem jemand gegangen ist | Die Integration wurde mit dem Login dieser Person verbunden. Verbinde mit einem Konto ohne Person dahinter neu. |
| Felder wie das Startdatum sind leer | Sie sind in BambooHR leer, oder das Konto kann sie nicht sehen. Prüfe die Feldanzahl unter Advanced. |
Verwandte Seiten
Abschnitt betitelt „Verwandte Seiten“- Integrations für den Katalog.
- HRIS-Felder für die Feldmatrix.
- Synchronisierungsrhythmus und Abgleich für Zeitpläne und Abgleich.