Integrace vašeho pracovního portálu s naším ATS Recruitis

Nápověda Recruitis · Aktualizováno

Propojte svůj pracovní portál s ATS Recruitis

Děkujeme, že se chcete propojit s ATS Recruitis. Každé nové napojení znamená, že naši zákazníci můžou inzerovat na dalším portálu jedním kliknutím a reakce kandidátů jim chodí rovnou do ATS. Nemusí nic kopírovat ani přeposílat e-maily a nic se neztratí.

Pro vás jako inzertní portál je to stejně výhodné. Vašim zákazníkům, kteří ATS Recruitis používají, výrazně zjednodušíte spolupráci: nabídky si od nás automaticky načtete a reakce jim automaticky předáte zpět do ATS Recruitis. Usnadníte tedy výrazně práci jejich recruitérům a získáte stabilní přísun aktuálních nabídek. Po spuštění vás navíc rádi zařadíme mezi propojené portály na našem webu a v online helpu.

💡 Napojení je zdarma, bez zdlouhavého schvalovacího procesu a bez vazby na tarif zákazníka. A navíc... rádi vám se vším pomůžeme.

Metody napojení

Doporučujeme REST API.

Je to nejjednodušší řešení jak pro vás, tak pro naše zákazníky a takto se napojuje většina nových portálů. Kompletní popis najdete v dokumentaci Recruitis API.

Pro integraci pracovního portálu jsou klíčové dva endpointy:

  • Načítání pozic: GET /jobs
    • dokumentace
    • Pozice filtrujete podle publikačního kanálu, který zákazník vytvoří pro váš portál, (query parametr channel_id[]).
    • Načtete tak jen ty nabídky, které chce zákazník u vás inzerovat (případně pro kanál pro kariérní stránky, pokud chtějí publikovat vše automaticky shodně s kariérkami)
  • Zápis kandidátů: POST /answers 
    • dokumentace 
    • Reakci kandidáta zapíšete přímo k odpovídající pozici v Recruitis, i s kontaktními údaji, CV a průvodním dopisem.
    • Pozici určíte polem job_id.

Zákazník si u vás v nastavení zadá svůj API token (případně i ID publikačního kanálu). Vy ho uložíte k danému zákazníkovi a přes něj pak načítáte pozice i zapisujete kandidáty.

Alternativa XML feed

Pozice lze načítat také přes XML publikační kanál, který obsahuje i odkaz na odpovědní formulář Recruitis. Kandidát pak reaguje přes náš formulář. Tato cesta je technicky jednodušší, ale kandidát musí opustit váš portál a ztrácíte kontrolu nad uživatelským zážitkem. Proto preferujeme API.

Pozice nemusíte načítat jen z Recruitis

Pokud nabídky přebíráte jinak než z ATS Recruitis (například je zákazník zadává přímo u vás na job boardu), stačí, když zákazník u inzerátu vyplní ID pozice z ATS Recruitis. Toto ID pak pošlete v poli job_id při zápisu kandidáta.

Jak získat přístup

  1. Napište nám na podpora@recruitis.io a uveďte e-mail člověka, který bude integraci vyvíjet.
  2. Založíme vám zdarma testovací účet v ATS Recruitis. Přijde vám aktivační e-mail.
  3. Vyzvedněte si token v menu Nastavení › Integrace › API přístupy tlačítkem „Zobrazit token".
    • Použijte token, u kterého je v poli „Zaměstnanec" zvolený „Firemní token". Má stejně omezená oprávnění, jaká budou mít nastavená vaši zákazníci, takže testujete v reálných podmínkách.
  4. Vyviňte a otestujte integraci přímo na testovacím účtu. Pozice i reakce kandidátů si můžete vytvářet bez omezení.
  5. V ostrém provozu jen nahradíte testovací token tokenem konkrétního zákazníka. Produkční token vám z bezpečnostních důvodů předá každý zákazník sám (ideálně, pokud v nastavení vašeho job boardu bude mít pole, kam token může vložit sám, aby se token vůbec neposílal).

Podmínky

  • API je dostupné všem zákazníkům bez ohledu na tarif.
  • Napojení nemusíme formálně schvalovat a nevyžadujeme registraci integračního partnera.
  • Nejsou žádné další technické ani obchodní podmínky z naší strany.
  • Obchodní podmínky inzerce si nastavujete sami. Je jen na vás, za jakých podmínek zákazníkům napojení nabídnete.
  • Jedinou prosbou je férová spolupráce: dejte nám vědět, až bude integrace hotová, a pošlete podklady pro go-live (viz níže). Díky nim budeme zákazníkům umět s nastavením poradit.

Co je potřeba pro go-live

Aby vaše napojení naši zákazníci našli a uměli ho používat, potřebujeme od vás:

  • Vaše logo pro náš web, ideálně ve formátu SVG.
  • Krátké demo video ukazující, jak vaše napojení funguje.
  • Popis fungování a logiky integrace,
    • Ideálně jako dokument, jehož obsah pak zveřejníme v našem online helpu. Měl by odpovědět na tyto otázky:
      • Jak zákazník napojení zapne: kde u vás zadá API token, zda je potřeba ID publikačního kanálu a zda je nutná předchozí domluva nebo smlouva.
      • Jak se pozice dostane na portál: zda ji načítáte z Recruitis přes publikační kanál, nebo ji zákazník zadává u vás a jen ji páruje přes ID pozice.
      • Jak často pozice obnovujete a jak rychle se nová pozice na portálu objeví.
      • Jak reagujete na změny: úpravu titulku, popisu nebo jiných údajů a ukončení či stažení pozice z publikačního kanálu.
      • Jak zapisujete kandidáty: zda okamžitě nebo dávkově, jak často, jaká data předáváte (kontakt, CV, průvodní dopis…) a pod jakým zdrojem se kandidát v Recruitis zobrazí.
      • Kdo zajišťuje podporu: na koho se má zákazník obrátit, když napojení na vaší straně nefunguje (e-mail, telefon, případně odkaz na váš help).

Jakmile podklady dostaneme, přidáme váš portál mezi propojené portály na našem webu a do online helpu.

Pokud budete chtít propojení propagovat i u sebe, rádi vám pošleme naše logo.

💡 Tyto podklady jsou pro spuštění ostrého provozu zásadní. Naši zákazníci nerozlišují, jestli chyba vznikla u vás, nebo u nás. Pro ně jde vždy o situaci „Recruitis nefunguje“. Proto musíme mít dost informací, abychom vaše napojení uměli podporovat aspoň na první úrovni. Pokud je od vás nedostaneme, budeme vaše napojení zákazníkům komunikovat jako nepodporované. Při závažných nebo opakovaných problémech vám po předchozím upozornění zneplatníme přístupové tokeny.

 

Související články

09. 05. 2022

Kariérní stránky

Zde se dozvíte, jaké máte možnosti propojení vašich kariérních stránek a ATS Recruitis. Možnosti zahrnují iframe, API propojení nebo možnost využit odpovědní formulář.

09. 05. 2022

Odpovědní formuláře

Jak na integraci pomocí odpovědních formulářů a landing page.

09. 05. 2022

Pracovní portály

Seznam pracovních portálů, které lze v tuto chvíli integrovat a způsob, jakým se tato integrace dělá. Patří mezi ně portály jobs.cz, práce.cz, profesia, jenpráce, startupjobs, Nelisa, dobrápráce, ikariéra, cocuma, WelcomeToTheJungle, CzechCrunch jobs, FajnBrigády, Jobox.io, easy-práce, Skilleto, MediJob, Expats.cz a další.