Webhooky pro zaměstnavatele

Co webhooky umí

Každou novou reakci kandidáta vám JobsAI okamžitě pošle 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, doručení opakujeme (6 pokusů během zhruba hodiny), pak ho 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.