Je koppelt OTYS zelf: één ticket bij OTYS-support voor een API-gebruiker, en daarna plak je de API-key in Hyre.
Voordat je begint
Je bent key-user in OTYS. Alleen wie het ticket aanmaakt, kan het zien en beantwoorden.
Je weet je OTYS-klantnummer en je omgeving (
[bedrijf].otysapp.com).In Hyre mag iedereen de koppeling maken. De write target kiezen doet een owner of admin.
Stap voor stap
1. Vraag OTYS-support om een API-gebruiker
Dien dit ticket in als key-user. Vul je klantnummer en omgeving in:
``` Onderwerp: OWS API-gebruiker aanmaken
Beste OTYS support,
Wij willen graag een API gebruiker aanmaken via OWS. Klantnummer: [klantnummer], omgeving: [bedrijf].otysapp.com
Kunnen jullie het volgende voor ons doen: 1. Een aparte API-gebruiker aanmaken, met een OWS API-key. 2. Deze gebruikersinstellingen aanzetten voor die gebruiker: SE77, SE78, SE2757, SE3315 en de CRM-/relatiemodule. 3. Lees- en schrijfrechten op deze Otys.Services: - CandidateService - VacancyService - ProcedureService - RelationService - RelationContactService - NoticeService - ReminderService - CalendarService - TaskService - DocumentTypeService - DossierService - AttachedDocumentsService 4. Toestemming om het veld userId (eigenaar) te zetten bij kandidaten en relatiecontactpersonen.
Stuur de API-key via een veilige weg.
Alvast bedankt! ```
De SE-instellingen kun je als key-user ook zelf aanzetten: ga naar Gebruikersinstellingen, zet Type instelling op Gebruiker en kies de API-gebruiker. Let op: het scherm opent op je eigen account, dus kies echt de API-gebruiker.
2. Koppel OTYS in Hyre
Ga naar Settings › Integrations, zoek OTYS en klik op Connect.
Plak de API-key en bevestig.
Staat er op de kaart Ask for: met namen van services? Dan mist de API-gebruiker nog rechten. Vraag die aan bij OTYS-support en klik daarna in Hyre op Re-check access.
Owner of admin: maak OTYS de write target via ⋯ › Make ATS write target (en Make CRM write target als je relaties en contactpersonen ook in OTYS bijhoudt).
3. Maak het Hyre profile-veld en zet de recruiters goed
Maak in OTYS een extraInfo-veld met de naam Hyre profile, van minimaal 2.000 tekens.
Klik in Hyre bij Settings › Fields op Refresh.
Laat elke recruiter in Hyre inloggen met hetzelfde e-mailadres als in OTYS. Dan komen notities op naam van de recruiter.
Goed om te weten
Hyre schrijft alleen naar OTYS als een recruiter erom vraagt: via de acties op een gesprek (Run agent), de routine ATS- & CRM-sync, of een vraag aan je AI-assistent.
Notities komen in het dossier van de kandidaat of contactpersoon, onder het notitietype van jullie eigen OTYS dat bij het soort gesprek past. Past er geen type, dan onder "Overige".
E-mailgesprekken schrijft Hyre niet naar OTYS. OTYS zet gesynchroniseerde mail zelf al in het dossier.
Auteur van een notitie. Mist de API-gebruiker instelling SE3315, of kent OTYS de recruiter niet, dan komt de notitie er toch, met bovenaan "Logged by
via Hyre".
Velden zoals opzegtermijn en "beschikbaar per" kan Hyre alleen bijwerken als de API-gebruiker rechten op die velden heeft. Zonder die rechten mislukt de kandidaatupdate. Op de kaart in Hyre zie je dan wat er mist.
Cv's: laat je key-user in OTYS een documenttype CV aanmaken (instelling GE91). Anders komen cv's onder "Overige".
Opmerkingenveld: wil je verslagen in het opmerkingenveld in plaats van in het dossier, weet dan dat schrijven naar dat veld het hele veld overschrijft. Het dossier is veiliger.
Functietitel, werkgever en LinkedIn blijven in Hyre.
Kandidaten zonder telefoonnummer of e-mailadres koppelt Hyre niet aan gesprekken.
Stuur de API-key nooit per mail, ook niet naar ons. Je plakt hem zelf in Hyre.
Bekijk de les
Video: Integratie in de Hyre Academy, hoofdstuk Admin setup.
Gerelateerd