OTYS API koppelen aan je website.

OTYS is een applicant tracking system uit Houten, onderdeel van de Mysolution Group. De leverancier omschrijft het als een ATS “made by recruiters for recruiters” en OTYS Go! bestaat inmiddels vijfentwintig jaar.

De gebruikers zijn recruitmentbureaus, uitzenders, staffingbedrijven en corporate recruitmentteams. In het vaste abonnement zitten onderdelen als de AI Assistant, mytranscript voor interviews, Multiposter voor het verspreiden van vacatures, een talentpool en een koppeling met LinkedIn.

Voor een website gaat het om twee dingen: de vacatures die naar buiten mogen, en de sollicitaties die terugkomen. De rest van het systeem blijft waar het hoort.

Via de Web API. Je vraagt een sleutel aan bij OTYS, wisselt die in voor een JSON Web Token en stuurt dat token mee bij elke aanvraag. De documentatie staat als Swagger online, dus wat er precies terugkomt is na te lezen voordat er een regel code is geschreven.

Voor de site halen we de vacatures op, per lijst of per slug, slaan ze op aan onze kant en maken er eigen pagina’s van met zoeken en filteren. Dat OTYS zelf met een slug per vacature werkt is prettig: het adres op je site kan daarmee gelijklopen met wat er in OTYS staat.

De andere kant op gaat de sollicitatie. Die wordt verwerkt en start direct een procedure in OTYS Go!, dus een recruiter ziet hem op dezelfde plek als elke andere kandidaat. Met webhooks laat OTYS je systeem weten dat er iets is veranderd, in plaats van dat je blijft vragen of er nieuws is.

OWS staat voor OTYS Web Services en is de bredere, oudere laag. Het bijzondere eraan is dat het dezelfde laag is die OTYS Go! zelf gebruikt: volgens de handleiding gaan alle handelingen die een gebruiker in de interface doet via OWS-aanvragen, waardoor een externe partij technisch hetzelfde kan als iemand achter het scherm. Je praat met services als VacancyService en CandidateService, in JSON-RPC of XML-RPC.

Dat is veel macht, en voor een vacaturesite meer dan nodig. De Web API is er juist voor dit doel: vacatures tonen en sollicitaties verwerken. Wij bouwen daarom daarop, tenzij er iets moet wat er niet in zit.

Eén ding om te weten als je toch met OWS te maken krijgt: de sleutel hangt aan een gebruiker en erft diens rechten. Ziet een koppeling bepaalde gegevens niet, dan is de rechten van die gebruiker de eerste plek om te kijken.

Veel ATS-leveranciers bieden een kant-en-klaar vacatureoverzicht dat je in je site hangt. Dat werkt, en het staat er snel.

Het verschil zit in wat er van je vacatures overblijft voor een zoekmachine. Wat in een widget of een iframe staat komt niet in de HTML van je eigen pagina: geen eigen adres per vacature, geen eigen titel, geen gestructureerde data die Google als vacature herkent. Je vacatures staan er dan voor een bezoeker en niet voor iemand die zoekt.

Met een koppeling op de Web API bouwen we ze als echte pagina’s van je site. Elke vacature heeft een eigen adres, je kunt er vanaf je andere pagina’s naartoe linken, en de sollicitatieknop staat er gewoon op. OTYS blijft de plek waar de vacature wordt beheerd.