Ashby
De Ashby-integratie leest kandidaten met een aangenomen sollicitatie en een actueel aanbod met een startdatum (een geaccepteerd aanbod heeft de voorkeur) en maakt ze aan als aankomende medewerkers, met hun startdatum, functietitel, afdeling, locatie en hiring manager. Een pre-boardingflow met de startdatum als trigger kan hen dan op een persoonlijk adres bereiken voordat hun werkaccount bestaat.
Voordat je begint
Section titled “Voordat je begint”- Je bent admin of owner in Pyn.
- Een Ashby-beheerder maakt een API-sleutel aan onder Admin > API Keys met leesrechten op Candidates, Offers en Organization. Leesrechten op Jobs zijn optioneel en halen de hiring manager op die op de vacature staat in plaats van op de sollicitatie. Om ook aangenomen kandidaten voor vertrouwelijke vacatures mee te nemen, geef je ook toegang tot vertrouwelijke vacatures en projecten.

Koppelen
Section titled “Koppelen”-
Open in Pyn Settings in de linkernavigatie, en dan Available onder Integrations.
-
Selecteer de tegel Ashby. Het dialoogvenster Connect to Ashby opent.
-
Plak de API Key.
-
Selecteer Connect. Het dialoogvenster toont “Validating that API key…” terwijl Pyn hem controleert.
-
Bij succes leest een melding “Your Ashby integration has been added to Pyn. It will take a minute or two for candidate data to be pulled from Ashby.”
Fouten die het dialoogvenster kan tonen: “Could not verify that API key — it appears to be invalid or deactivated.” / “The API key is valid but lacks the permissions needed. Grant it read access to Candidates, Offers and Organization and try again.” / “Enter an Ashby API key.” / “An unexpected error occurred. Please check the API key and try again. If the error persists, contact support.”
Wat er wordt gesynchroniseerd
Section titled “Wat er wordt gesynchroniseerd”Pyn ververst ongeveer één keer per uur vanuit Ashby. Voor elke aangenomen sollicitatie leest het:
| Eigenschap in Pyn | Uit Ashby |
|---|---|
| Weergavenaam, officiële naam | De naam van de kandidaat |
| Zakelijk e-mailadres, persoonlijk e-mailadres | Het zakelijke en persoonlijke contactadres van de kandidaat |
| Startdatum | De startdatum van de laatste versie van het aanbod |
| Functietitel | De vacature van de sollicitatie |
| Afdeling, locatie | De namen van afdeling en locatie van de vacature |
| Manager | De hiring manager van de vacature (een Ashby-gebruiker) |
| Tijdzone | De tijdzone van de kandidaat |
| Aangepaste velden | Elke workspace-extensie die aan een aangepast Ashby-veld is gekoppeld, gelezen uit het aanbod, dan de sollicitatie, dan de kandidaat |
Aangenomen kandidaten verschijnen in de Directory als Upcoming tot hun startdatum. Zie Synchronisatiefrequentie en matching voor hoe ze worden gematcht met het HRIS-record dat later aankomt.
Testen
Section titled “Testen”Open na de eerste verversing Employees en selecteer de weergave Upcoming: recent aangenomen kandidaten horen er met hun startdatum te staan. Het tabblad History van de integratie toont elke verversing.
Opnieuw koppelen of ontkoppelen
Section titled “Opnieuw koppelen of ontkoppelen”- Reconnect in het menu … opent Reconnect to Ashby om een nieuwe sleutel te plakken. “Your Ashby integration has been updated.” bevestigt het.
- Deactivate pauzeert het synchroniseren; Activate hervat het.
Problemen oplossen
Section titled “Problemen oplossen”| Wat je ziet | Wat het betekent |
|---|---|
| History: “Error: Authentication failed, please reconnect” | De sleutel is in Ashby gedeactiveerd. Maak een nieuwe aan en koppel opnieuw. |
| History: “Error: Insufficient Ashby permissions” | De sleutel mist een leesrecht. Geef leesrechten op Candidates, Offers en Organization. |
| Een aangenomen kandidaat ontbreekt | Het aanbod is afgewezen, geannuleerd of ingetrokken, heeft geen startdatum, of de vacature is vertrouwelijk en de sleutel kan haar niet zien. |
| Hiring manager leeg | Geef leesrechten op Jobs, of stel de hiring manager in op de sollicitatie. |
Gerelateerd
Section titled “Gerelateerd”- Integrations voor de catalogus.
- Greenhouse voor de andere ATS-integratie.
- Synchronisatiefrequentie en matching voor hoe ATS- en HRIS-records samenkomen.
- Automations om een pre-boardingflow op de startdatum te bouwen.