Naar hoofdinhoud

KoppelingenBullhorn

Bullhorn koppelen aan je website.

Bullhorn is het ATS en CRM waarin uitzenders, detacheerders en recruitmentbureaus wereldwijd hun vacatures en kandidaten beheren. Er zijn twee routes naar je eigen site: een publieke API die alleen gepubliceerde vacatures teruggeeft, en de volledige REST API. Wij bouwen allebei.

Vertrouwd door

200+ bedrijven en webshops

DuxDux
HappyBedHappyBed
Swim EssentialsSwim Essentials
Washin7Washin7
VouwwagenspecialistVouwwagenspecialist
Fit PrepsFit Preps
Verzijden ClinicsVerzijden Clinics
Fysio MoovFysio Moov
Rund & KipRund & Kip
MörgennMörgenn

Wat het oplevert

Wat een koppeling met Bullhorn je oplevert.

Alleen wat je hebt vrijgegeven. De publieke API geeft precies de vacatures terug die in Bullhorn op gepubliceerd staan.

Een eigen pagina per vacature. Op je eigen domein, geschikt voor Google for Jobs en om een advertentie naartoe te sturen.

Solliciteren met cv. Het cv gaat mee en Bullhorn leest hem uit, zodat de kandidaat niet alles hoeft over te typen.

Technisch

De koppeling in het kort.

Vorm van de koppeling
Twee routes: de public API met search/JobOrder en apply voor gepubliceerde vacatures, of de volledige REST API met JobOrder, Candidate en JobSubmission
Authenticatie
Public API: een clusternummer en een bedrijfstoken van Bullhorn Support, in het adres zelf. Volledige REST API: OAuth 2.0, daarna een login-aanroep die een BhRestToken en een basisadres teruggeeft
Richting
Beide kanten op
Verversing
Per aanroep; de sessie van de REST API verloopt en moet worden vernieuwd
Wij bouwen het op
WordPress, Next.js, Maatwerk

Waar het misgaat

  • Een vacature verschijnt pas als hij op “Published - Approved” staat. De publieke API geeft alleen die vacatures terug, en dat is precies zoals het hoort: wat nog niet af is hoort niet op je site. Het is wel de eerste vraag als een recruiter belt dat zijn vacature er niet op staat, en het antwoord ligt dan in Bullhorn en niet in de koppeling.
  • De sessie van de volledige REST API verloopt, en Bullhorn zegt er zelf bij dat je er nooit van uit moet gaan dat hij blijft staan. Een koppeling die dat niet opvangt werkt weken prima en valt daarna zonder aanleiding stil. Wij vangen een 401 op, vernieuwen het token en proberen het opnieuw, en controleren de sessie met de ping-aanroep.
  • Kies de route bewust. Gaat het om vacatures tonen en sollicitaties ontvangen, dan is de publieke API genoeg: minder rechten, minder om te onderhouden en een adres dat je van Bullhorn Support krijgt. Moet je site meer doen, zoals kandidaatgegevens bijwerken of statussen lezen, dan heb je de volledige REST API nodig, met OAuth eromheen.
  • Er zitten gebruikslimieten op, maar Bullhorn publiceert er geen getallen bij; ze nemen contact op als een koppeling eroverheen gaat. Dat is een reden om vacatures aan je eigen kant te bewaren en op een vast ritme te verversen, in plaats van bij elke bezoeker opnieuw op te halen. Dat is sowieso sneller voor de bezoeker.

Bron: documentatie van Bullhorn, Boston

Wat is Bullhorn?

Bullhorn is een ATS en CRM voor de staffingbranche, opgericht in Boston en in gebruik bij bureaus over de hele wereld. Vacatures, kandidaten, plaatsingen en de commerciële kant zitten in hetzelfde systeem.

Het is gebouwd voor volume. Waar een systeem als Homerun past bij een bedrijf dat een paar keer per jaar iemand zoekt, is Bullhorn gemaakt voor bureaus met honderden openstaande opdrachten en een kandidatenbestand dat in de tienduizenden loopt. Dat zie je terug in de API: veel entiteiten, veel velden, en een strikte scheiding tussen wat publiek is en wat niet.

Twee routes naar je website

De eerste is de publieke API. Die is alleen-lezen en geeft een beperkte set velden terug van de vacatures die je in Bullhorn op gepubliceerd en goedgekeurd hebt gezet: titel, plaats, dienstverband, omschrijving, salarisindicatie. Daarnaast kan er via die route worden gesolliciteerd. Je meldt je aan met een clusternummer en een bedrijfstoken die je bij Bullhorn Support opvraagt.

De tweede is de volledige REST API. Daar werk je met de entiteiten zelf: JobOrder voor de vacature, Candidate voor de kandidaat en JobSubmission voor de sollicitatie die de twee aan elkaar knoopt. Aanmelden gaat met OAuth 2.0, en daarna haal je met een login-aanroep een BhRestToken en het basisadres op waarmee je verder werkt.

Voor een vacaturesite is de eerste route meestal genoeg, en dat is ook de veiligere keuze: wat de sleutel niet mag, kan er niet misgaan.

Solliciteren vanaf je eigen site

Een sollicitatie is bij Bullhorn meer dan een formulier dat binnenkomt. Het cv gaat als bestand mee en wordt uitgelezen, zodat de gegevens van de kandidaat al ingevuld in het systeem staan. Bij de volledige REST API hang je bestanden aan een entiteit met een aparte aanroep, als base64 of als gewone bestandsupload.

Wat je daarbij wilt afspreken is wat er gebeurt als het uitlezen niet lukt, bijvoorbeeld bij een cv dat als afbeelding is opgeslagen. De sollicitatie hoort dan gewoon binnen te komen, met het bestand eraan, en niet stilletjes te verdwijnen.

Wij bouwen het formulier in je eigen ontwerp en laten de aanroepen vanaf de server lopen, zodat de sleutels niet in de paginabron staan.

Career Portal, of je eigen site

Bullhorn levert met Career Portal zelf een vacaturesite die je kunt downloaden, instellen en zelf hosten; de broncode staat open, dus je kunt hem ook overnemen en aanpassen.

Dat is een prima startpunt als je snel iets wilt. Het verschil met een vacaturepagina op je eigen site is waar hij staat en wat eromheen zit: je eigen domein, je eigen ontwerp, je eigen verhaal, en de rest van je site één klik weg.

Voor een bureau is dat geen detail. Een kandidaat die op je vacature binnenkomt, kijkt daarna wie je bent en welke opdrachten je nog meer hebt. Dat kan alleen als hij op jouw site staat.

Bijgewerkt op

Specialist voor koppelingen

Jos van der PluijmJosDesign & Development085 83 30 533jos@klubb.nl

Veelgestelde vragen

Kan ik mijn vacatures uit Bullhorn op mijn eigen website zetten?

Ja. Met de publieke API haal je de vacatures op die in Bullhorn op gepubliceerd en goedgekeurd staan. Ze krijgen bij ons een eigen pagina op je eigen domein, met gestructureerde data zodat ze in Google for Jobs kunnen verschijnen.

Waarom staat mijn vacature niet op de site?

Meestal omdat hij in Bullhorn niet op “Published - Approved” staat. De publieke API geeft alleen die vacatures terug. Dat is een instelling in Bullhorn en niet iets wat de koppeling kan overrulen.

Kan iemand op mijn eigen site solliciteren?

Ja, inclusief het cv. Bullhorn leest dat cv uit, zodat de kandidaatgegevens al gevuld in het systeem staan. Wij bouwen het formulier in je eigen opmaak en laten de aanroep vanaf de server lopen.

Wat heb ik nodig om te beginnen?

Voor de publieke route een clusternummer en een bedrijfstoken, op te vragen bij Bullhorn Support. Voor de volledige REST API een OAuth-client met een id en een secret. Wij zeggen bij de start welke van de twee we nodig hebben.

Hoeveel aanvragen mag mijn site doen?

Bullhorn hanteert gebruikslimieten maar publiceert er geen getallen bij; ze nemen contact op als een koppeling eroverheen gaat. Wij bewaren de vacatures daarom aan onze kant en verversen op een vast ritme.

Werkt een Bullhorn-koppeling ook op WordPress?

Ja. De vacatures slaan we op als eigen berichttype, zodat overzicht, filters en losse pagina’s werken zoals de rest van je site. Het sollicitatieformulier bouwen we in je eigen opmaak.

Let’s work together.

Je vacatures op je eigen domein, sollicitaties in Bullhorn.