Naar hoofdinhoud

KoppelingenHomerun

Homerun koppelen aan je website.

Homerun is het wervingssysteem voor kleinere teams die hun eigen gezicht willen laten zien. De Public API is netjes gedocumenteerd en fijnmazig: je kunt een sollicitatie op je eigen site opbouwen tot en met het cv, de antwoorden en de bevestigingsmail.

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 Homerun je oplevert.

Een eigen pagina per vacature. Op je eigen domein, met je eigen tekst eromheen en een adres om naartoe te linken.

Solliciteren met cv en antwoorden. Bestanden, foto en de antwoorden op je sollicitatievragen gaan mee in de sollicitatie.

Sleutels met alleen de rechten die je nodig hebt. 13 losse rechten, tot 10 sleutels tegelijk, elk met een eigen vervaldatum.

Technisch

De koppeling in het kort.

Vorm van de koppeling
De Public API versie 2 op api.homerun.co/v2, met vacatures, sollicitaties, notities, bestanden, antwoorden, e-mails en labels. Daarnaast een XML-feed voor vacaturebanken
Authenticatie
Een bearer-sleutel met scopes, aan te maken op de integratiepagina in Homerun. De scopes zet je bij het aanmaken en zijn daarna niet meer te wijzigen
Richting
Beide kanten op
Verversing
Per aanroep; maximaal 60 aanvragen per minuut
Wij bouwen het op
WordPress, Next.js, Maatwerk

Waar het misgaat

  • De bevestigingsmail aan de sollicitant verstuurt zichzelf niet. Er is een apart endpoint voor, en dat is precies het soort ding dat bij een eigen formulier wordt vergeten: de sollicitatie staat keurig in Homerun, de sollicitant hoort niets en belt na drie dagen. Neem die aanroep mee in het formulier en controleer hem in de test.
  • Een sollicitatie is meer dan één aanroep. Je maakt de sollicitatie aan, stuurt daarna de antwoorden op de vragen mee, uploadt het cv als bestand en verstuurt de bevestigingsmail. Dat betekent dat er iets kan misgaan halverwege, en dat de afhandeling daarop ingericht moet zijn: een sollicitatie zonder cv is erger dan geen sollicitatie, want je ziet niet dat er iets ontbreekt.
  • De rechten van een sleutel zet je één keer. Homerun kent 13 losse rechten en die wijs je toe bij het aanmaken van de sleutel; daarna zijn ze niet meer aan te passen. Heb je er één vergeten, dan maak je een nieuwe sleutel. Dat is geen probleem, want je kunt er tien tegelijk hebben, met elk een eigen vervaldatum.
  • Haal je alleen een lijst met vacatures op, kijk dan eerst naar de feed. Homerun adviseert dat zelf: is je hele werkwijze het ophalen van vacatures, gebruik dan de XML-feed in plaats van de API. Dat scheelt een sleutel, het scheelt aanvragen binnen de grens van zestig per minuut, en het is minder om te onderhouden.

Bron: documentatie van Homerun

Wat is Homerun?

Homerun is wervingssoftware voor teams die niet uit een corporate mal willen komen. Je bouwt er vacaturepagina’s die eruitzien alsof ze van jou zijn, houdt sollicitanten bij in een overzicht, en werkt met je team aan de selectie.

Het onderscheidt zich van de grote systemen door de nadruk op vorm en eenvoud. Waar een uitzendorganisatie een systeem nodig heeft dat duizenden kandidaten aankan, is Homerun gebouwd voor een bedrijf dat een paar keer per jaar iemand zoekt en dat goed wil doen.

Dat maakt de koppeling met je eigen site ook logischer dan elders: als je toch al waarde hecht aan hoe je overkomt, hoort je vacature op je eigen site te staan en niet op een careers site die je van een leverancier hebt gekregen.

Hoe de koppeling met je website werkt

De Public API staat op versie 2 en is openbaar gedocumenteerd. Aanmelden gaat met een bearer-sleutel die je aanmaakt op de integratiepagina in Homerun.

Wat die sleutel mag, bepaal je met scopes. Er zijn er dertien, van het lezen van vacatures tot het schrijven van sollicitaties, notities, bestanden, antwoorden, e-mails en labels. Homerun raadt aan alleen te geven wat nodig is en voor verschillende werkwijzen aparte sleutels te maken in plaats van één sleutel overal te hergebruiken. Dat is goed advies en wij houden ons eraan.

De grens ligt op 60 aanvragen per minuut. Ruim voor een vacaturesite, zolang je niet bij elke bezoeker de hele lijst opnieuw ophaalt. Wij slaan de vacatures aan onze kant op en verversen op een vast ritme.

Het sollicitatieformulier, stap voor stap

Dit is waar Homerun fijnmaziger is dan de meeste systemen, en dat is een voordeel én iets om zorgvuldig in te bouwen.

Eerst haal je de vragen van het sollicitatieformulier op bij de vacature. Die tekenen wij uit in je eigen ontwerp, zodat het formulier bij je site past en niet bij dat van de leverancier. Dan maakt de bezoeker de sollicitatie aan. Daarna gaan de antwoorden mee in een aparte aanroep, en het cv als bestand in nog een. Voor een vraag waarin om een bestand wordt gevraagd is er een tijdelijke upload.

En dan de laatste stap: de bevestigingsmail. Die staat als apart endpoint in de documentatie en gaat dus niet vanzelf. Dat is het verschil met een systeem waar één aanroep alles doet, en het is ook meteen het meest gemaakte gat in zo’n koppeling.

Waarom vacatures op je eigen domein horen

Een vacaturepagina die op een adres van je wervingssysteem staat, bouwt vindbaarheid op voor dat systeem en niet voor jou.

Op je eigen site krijgt elke vacature een adres op je eigen domein. Daar kun je vanaf je andere pagina’s naartoe linken, een advertentie heen sturen en gestructureerde data bij zetten zodat hij in Google for Jobs kan verschijnen. En, niet onbelangrijk: wie op je vacature komt, ziet meteen de rest van je site.

Dat laatste doet bij werving meer dan bij welk ander onderwerp ook. Iemand die overweegt te solliciteren gaat kijken wat voor bedrijf je bent, wie er werken en wat je doet. Als je vacature op een losse careers site staat, is dat een klik naar buiten en een kans die je weggeeft.

Bijgewerkt op

Specialist voor koppelingen

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

Veelgestelde vragen

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

Ja, met de Public API, die endpoints heeft om vacatures op te halen en de details van één vacature op te vragen. Haal je alleen een lijst op, dan raadt Homerun zelf aan om in plaats daarvan hun XML-feed te gebruiken; dat scheelt een sleutel.

Kan iemand op mijn eigen site solliciteren?

Ja. Je maakt de sollicitatie aan via de API, stuurt de antwoorden op de sollicitatievragen mee, uploadt het cv als bestand en verstuurt de bevestigingsmail. Dat zijn vier aanroepen, en ze horen alle vier in het formulier te zitten.

Krijgt de sollicitant automatisch een bevestiging?

Nee, daar is een apart endpoint voor. Dat is het meest gemaakte gat in zo’n koppeling: de sollicitatie staat er wel en de sollicitant hoort niets. Wij nemen die aanroep mee en controleren hem in de test.

Hoe veilig is de koppeling?

De sleutel heeft alleen de rechten die je hem bij het aanmaken geeft, en die zijn daarna niet te wijzigen. Je kunt tot 10 sleutels tegelijk hebben, elk met een eigen vervaldatum, zodat je ze kunt vervangen zonder dat er iets stilvalt. Wij houden de sleutel op de server.

Hoeveel aanvragen mag mijn site doen?

60 per minuut. Ruim voor een vacaturesite, mits je niet bij elke bezoeker opnieuw de hele lijst ophaalt. Wij slaan de vacatures aan onze kant op en verversen op een vast ritme.

Werkt een Homerun-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 en de aanroepen lopen vanaf de server.

Let’s work together.

Je eigen gezicht, ook op de vacaturepagina.