Ga naar inhoud
PynPyn

BambooHR

De BambooHR-integratie leest je medewerkersdirectory en een aangepast rapport via de BambooHR-API, zodat startdatums, afdelingen, managers en vertrekkers je flows aansturen zonder spreadsheet. In workspaces waar de BambooHR-webhook is ingeschakeld, meldt BambooHR wijzigingen ook tussen verversingen door aan Pyn.

  • Je bent admin of owner in Pyn.
  • Je kent je BambooHR-bedrijfsdomein: het deel vóór .bamboohr.com in je BambooHR-adres.
  • Je kunt inloggen bij BambooHR met een account dat API-toegang heeft en de velden kan zien die je wilt synchroniseren. Een serviceaccount dat niet aan een medewerker hangt is beter dan de login van een persoon, die niet meer werkt wanneer die persoon vertrekt.
The Connect to BambooHR dialog with the Company Domain field.
Connect to BambooHR asks for your Company Domain.
  1. Open in Pyn Settings in de linkernavigatie, en dan Available onder Integrations.

  2. Selecteer de tegel BambooHR. Het dialoogvenster Connect to BambooHR opent.

  3. Voer je Company Domain in. Je kunt het hele adres plakken, zoals https://acme.bamboohr.com; Pyn houdt acme over. “This is not a valid company domain.” betekent dat het niet op een BambooHR-subdomein lijkt.

  4. Selecteer Connect. BambooHR opent; log in en selecteer Allow Access.

  5. BambooHR stuurt je terug naar Pyn. Het paneel toont “You’re connected. Syncing can take a few minutes. Check the journey map then!” Weiger je bij BambooHR in plaats daarvan de toegang, of duurt het daar te lang, dan beland je op Installed met een toast met de titel BambooHR wasn’t connected die zegt waarom: “You didn’t grant access, so nothing was connected.” of “The sign-in took too long, so nothing was connected. Try again.”

Pyn ververst ongeveer één keer per uur; een run waarin het rapport niet is veranderd, wordt vastgelegd als “Successfully integrated to BambooHR. No employee changes found”. In workspaces waar de webhook is ingeschakeld, worden de wijzigingsmeldingen van BambooHR zelf onder History vastgelegd zodra ze binnenkomen. Het tabblad Details toont het Subdomain, de Primary Source (Custom Report of Directory), Last Refresh en Last Successful Refresh; het tabblad Advanced toont onder Fields in Report een aantal per veld.

Eigenschap in Pyn Uit BambooHR
Weergavenaam, officiële naam, roepnaam Weergavenaam, volledige naam en voorkeursnaam
Zakelijk e-mailadres, persoonlijk e-mailadres Zakelijk e-mailadres en privé-e-mailadres
Startdatum Datum in dienst; een oorspronkelijke datum in dienst die eerder ligt markeert een terugkerende medewerker
Datum uit dienst, status Datum uit dienst; een andere arbeidsstatus dan Active wordt inactief
Afdeling, divisie, locatie, functietitel De overeenkomstige BambooHR-velden
Type dienstverband Status in de arbeidsgeschiedenis
Manager Medewerkers-id van de supervisor
Verjaardag, land, postcode, tijdzone Verjaardag en adres; tijdzone uit land en postcode

Kan het account waarmee Pyn is gekoppeld alleen de directory lezen, dan waarschuwt het paneel: “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.” Zie HRIS-velden voor de veldenmatrix.

Open de tegel BambooHR onder Installed, open het menu … en selecteer Test Connection. “Successfully tested the connection to BambooHR.” bevestigt het; “An error occurred connecting to BambooHR. Please Reconnect or contact support if the issue persists.” betekent dat de login niet meer werkt. Controleer daarna Employees.

  • Reconnect herhaalt de BambooHR-login voor hetzelfde bedrijfsdomein. Gebruik het nadat het wachtwoord van het gekoppelde account is gewijzigd of zijn rechten zijn verruimd.
  • Deactivate stopt het synchroniseren; Activate hervat het. Archive verwijdert de integratie uit Installed; gesynchroniseerde medewerkers blijven staan. Mislukt een van beide, dan meldt een toast Could not deactivate the integration of Could not archive the integration en verandert er niets.
Wat je ziet Wat het betekent
History: “Error: Insufficient permissions to access BambooHR” Het toegangsniveau van het gekoppelde account is API- of veldrechten kwijt. Open in BambooHR Access Levels > Custom Levels, selecteer het niveau, en sta onder Access Level Settings Settings > Company Field Settings toe; koppel daarna opnieuw.
History: “Error: Authentication failed, please reconnect” De login is verlopen of ingetrokken. Koppel opnieuw.
History: “Could not connect to BambooHR, please reconnect” BambooHR heeft de verbinding geweigerd. Koppel opnieuw; herhaalt het zich, neem dan contact op met support.
History: “BambooHR returned data in an unexpected format” (oranje) Een verversing kreeg een antwoord dat Pyn niet kon lezen, meestal eenmalig, dus de integratie blijft actief en de volgende verversing probeert het opnieuw. Herhaalt het zich bij elke run, neem dan contact op met support.
Medewerkers worden niet meer bijgewerkt nadat iemand is vertrokken De integratie was gekoppeld met de login van die persoon. Koppel opnieuw met een account dat niet aan een medewerker hangt.
Velden zoals de startdatum zijn leeg Ze zijn leeg in BambooHR, of het account kan ze niet zien. Controleer het aantal per veld onder Advanced.