JobsAI

Webhooky pro zaměstnavatele

Nechte si nové reakce kandidátů posílat rovnou do vlastního systému (n8n, Zapier, ATS).

Co webhooky umí

Nové reakce kandidátů vám JobsAI posílá jako zabezpečený HTTPS požadavek (událost application.received) na adresu, kterou si zaregistrujete. Zpráva obsahuje jméno, e-mail a telefon kandidáta, průvodní dopis, údaje o pozici a odkaz na detail reakce - stejné informace jako notifikační e-mail, jen strojově čitelné. Hodí se pro napojení na n8n, Zapier, Make nebo vlastní ATS.

Nastavení krok za krokem

  • Na přehledu firmy klikněte na Webhooky (API). Funkce je dostupná jen pro ověřené firmy a spravují ji vlastníci a administrátoři.
  • Vložte HTTPS adresu vašeho systému a klikněte na Přidat.
  • Uložte si podpisové tajemství - z bezpečnostních důvodů se zobrazí jen jednou.
  • Klikněte na Ověřit: na adresu pošleme testovací událost endpoint.verify a váš systém musí odpovědět stavem 2xx.
  • Doručujeme jen na ověřené a aktivní adresy.

Zabezpečení

  • Každý požadavek podepisujeme HMAC-SHA256. V hlavičce X-JobsAI-Signature: t=<čas>,v1=<podpis> je podpis spočítaný z řetězce <čas>.<tělo požadavku> vaším tajemstvím - ověřením podpisu máte jistotu, že zpráva pochází od JobsAI.
  • Hlavička X-JobsAI-Event-Id je stejná i při opakovaném doručení - použijte ji k odstranění duplicit.

Spolehlivost doručení

  • Když adresa neodpoví stavem 2xx, provedeme nejvýše 6 pokusů celkem. Čekání mezi pokusy se prodlužuje; výpadek služby může obnovu zpozdit. Po vyčerpání pokusů doručení označíme jako nedoručené.
  • Historii všech doručení včetně odpovědí vidíte v sekci Historie doručení; neúspěšné doručení pošlete znovu tlačítkem Poslat znovu.

Pokud kandidát staženou reakci odešle znovu, vznikne nová událost se stejným ID reakce a vyšší hodnotou application.submissionVersion. Retry stejné události ponechává její ID. Čekající doručení staršího pokusu nebo stažené reakce zastavíme; tlačítko Poslat znovu toto omezení neobchází.

Tlačítko Poslat znovu použijte po odstranění příčiny chyby. Probíhající doručení nelze spustit souběžně. Opakování zaznamená, kdo o něj požádal, a zachová původní událost i její obsah. Úspěšná odpověď 2xx znamená, že váš systém požadavek přijal; nepotvrzuje dokončení navazujícího procesu ve vašem ATS.

Další napojení

Kromě přijímání reakcí přes webhooky můžete pověřit registrovaného AI agenta, aby za firmu připravoval a spravoval pracovní nabídky. Viz AI agenti pro firmy.