K čemu webhooky slouží?
Webhooky slouží k notifikaci různých událostí v rámci ATS Recruitis, např. pro potřeby vašich kariérních stránek.
K dispozici jsou tyto typy webhooků:
- Přidání nové pozice - Notifikace na přidání nové pozice v systému
- Editace pozice - Notifikace na změnu obsahu pozice
- Otevření pozice - Notifikace na změnu stavu pozice na "Otevřená"
- Uzavření pozice - Notifikace na změnu stavu pozice na "Uzavřená"
- Archivace pozice - Notifikace na změnu stavu pozice na "Archivovaná"
- Publikace pozice na kanále - Notifikace na přidání pozice na publikační kanál
- Stažení pozice z publikačního kanálu - Notifikace na odebrání pozice z publikačního kanálu
- Přidána odpověď na inzerát - Notifikace při aplikaci kandidáta na konkrétní pozici
- Kandidát označen pro export - Notifikace na změnu stavu kandidáta pro export do externího systému
- Změna flow kandidáta - Notifikace při posunu kandidáta v procesu náboru
- Kandidát zamítnut - Notifikace při zamítnutí kandidáta
- Kandidát smazán z pozice - Notifikace při smazání kandidáta ze systému
- Změna stavu položky checklistu - Notifikace na změnu stavu v checklistu u odpovědi
- Přijetí / odmítnutí pohovoru ze strany kandidáta - Notifikace při reakci kandidáta na událost pohovoru
💡 Nastavení webhooků mohou provádět jen administrátoři v tomto menu.
1. Přidání webooku
Pro přidání nového webhooku otevřeme Nastavení" | "Webhooky. Nejprve vyberete typ webhooku a vložíte celou URL adresu stránky, na které chcete dostávat notifikace o změnách. Pokud zadaná stránka opravdu existuje a může dostávat notifikace, tak se po kliknutí na "Test" otestuje spojení. Po úspěšném otestování se tlačítko změní na "Uložit".
💡 Pro správné otestování webhooku je potřeba mít tzv. verifikaci domény tedy, testovaná adresa musí vrátit hash obsažený v body.verification parametru. (odkaz na api dokumentaci)
💡 Technickou dokumentaci pro webhooky naleznete v příslušné části v rámci obecné dokumentace API
2. Jednotlivé typy webhooků
Níže jsou příkaldy akcí v systému s příkladem, jakým se tato akce projeví na webhooku.
1. Přidání nové pozice
2. Editace pozice
3. Otevření pozice
4. Uzavření pracovní pozice
5. Archivace pracovní pozice
6. Publikace pracovní pozice na publikačním kanále
7. Stažení pracovní pozice z publikačního kanálu
8. Přidána odpověď na inzerát
9. Kandidát označen pro export
Tato funkce slouží pro označení kandidáta pro export do systémů třetích stran (typicky HRIS apod.) a je k dispozici pouze pokud vaše firma má takové napojení realizované, tj. naprogramované na míru.
11. Kandidát zamítnut
12. Kandidát smazán z pozice
13. Změna stavu položky checklistu
14. Přijetí / odmítnutí pohovoru ze strany kandidáta