Bullhorn wil dat elke koppeling een eigen API-gebruiker, client ID, client secret en goedgekeurde redirect URI heeft. De redirect URI kan alleen Bullhorn Support instellen. Met één verzoek aan Bullhorn regel je alles in één keer.
Voordat je begint
Je bent admin in Bullhorn, of je hebt iemand die dat is.
In Hyre heet de kaart Bullhorn / CONEXYS. CONEXYS is volledig overgegaan naar Bullhorn, dus dit artikel geldt ook als je vroeger CONEXYS had.
Iedereen in Hyre mag de koppeling maken. De write target kiezen doet een owner of admin.
Stap voor stap
1. Vraag Bullhorn Support om een API-gebruiker en de redirect URI
Maak een ticket bij Bullhorn Support. Een ticket werkt beter dan bellen. Noem het een intern project, geen koppeling van een externe leverancier. Je kunt deze tekst gebruiken:
``` Hello Bullhorn Support,
For an internal project we need REST API access to our Bullhorn environment.
Could you please: 1. Create a dedicated API user for this integration, with a Client ID and a Client Secret. 2. Set the redirect URI for this API user to: https://api.unified.to/oauth/code
Please send the credentials through a secure channel.
Thank you! ```
Heb je al een API-gebruiker? Vraag dan alleen om de redirect URI:
Please update the redirect URI for our Bullhorn API user to the following redirect URI: https://api.unified.to/oauth/code
2. Wacht op de bevestiging van Bullhorn
Bullhorn voert de wijziging zelf door. Dat kunnen wij en jij niet instellen. Je krijgt van Bullhorn de Client ID, het Client Secret en de gegevens van de API-gebruiker, en een bevestiging dat de redirect URI is aangepast.
3. Koppel Bullhorn in Hyre
Ga naar Settings › Integrations, zoek Bullhorn / CONEXYS en klik op Connect.
Vul de gegevens van Bullhorn in en ga verder.
Log in bij Bullhorn met de API-gebruiker en klik op Authorize. Zorg dat je in dezelfde browser bij Bullhorn bent ingelogd.
Owner of admin: maak Bullhorn de write target via ⋯ › Make ATS write target. Bullhorn is ATS én CRM, dus kies ook Make CRM write target.
Maak in Bullhorn een lang tekstveld Hyre profile op kandidaten en contacten, en klik in Hyre bij Settings › Fields op Refresh. Zie Velden instellen.
Lukt stap 3 niet? Stuur ons een bericht via Helpdesk. Stuur het client secret nooit per mail of chat: we plannen dan een kort moment om het samen af te ronden.
Wat Hyre in Bullhorn schrijft
Per gesprek één Note die bij elke kandidaat en elk contact uit dat gesprek zichtbaar is. De actie van de notitie is de actie uit jullie eigen lijst die past bij het soort gesprek, nooit een pipelinestap zoals CV sent of placement.
Een meeting of intake met een begin- en eindtijd wordt ook een Appointment met alle deelnemers. Daar gaat geen uitnodiging mee naar buiten.
Velden zoals salaris, beschikbaarheid en opzegtermijn, als ze in Hyre aanstaan.
Goed om te weten
Dit doe je één keer per API-gebruiker. Maak je later een nieuwe API-gebruiker aan, dan doorloop je dit stappenplan opnieuw.
Hoe snel komt Bullhorn-data in Hyre? Een nieuwe kandidaat of contact staat er binnen ongeveer een uur. Een wijziging in een bestaande kandidaat of contact kan tot een week duren. Vacatures en sollicitaties worden elk uur bijgewerkt. Dat komt door het maandelijkse API-quotum dat Bullhorn per klant hanteert.
Bestanden (zoals cv's) haalt Hyre op als iemand ze opent, om datzelfde quotum te sparen.
Contact aanmaken mislukt? Vaak staat er in Bullhorn een verplicht veld dat Hyre niet kan invullen. Check welke velden verplicht zijn, of zet ze aan onder Settings › Fields.
Notities komen op naam van de recruiter als het e-mailadres in Bullhorn gelijk is aan het Hyre-login. Zie Eigenaar van records en de default owner.
Bekijk de les
Video: Integratie in de Hyre Academy, hoofdstuk Admin setup.
Gerelateerd