Webhooky pre zamestnávateľov

Čo webhooky dokážu

Každú novú reakciu kandidáta vám JobsAI okamžite pošle ako zabezpečenú HTTPS požiadavku (udalosť application.received) na adresu, ktorú si zaregistrujete. Správa obsahuje meno, e-mail a telefón kandidáta, sprievodný list, údaje o pozícii a odkaz na detail reakcie - rovnaké informácie ako notifikačný e-mail, len strojovo čitateľné. Hodí sa na napojenie n8n, Zapier, Make alebo vlastného ATS.

Nastavenie krok za krokom

• Na prehľade firmy kliknite na Webhooky (API). Funkcia je dostupná len pre overené firmy a spravujú ju vlastníci a administrátori.
• Vložte HTTPS adresu vášho systému a kliknite na Pridať.
• Uložte si podpisové tajomstvo - z bezpečnostných dôvodov sa zobrazí len raz.
• Kliknite na Overiť: na adresu pošleme testovaciu udalosť endpoint.verify a váš systém musí odpovedať stavom 2xx.
• Doručujeme len na overené a aktívne adresy.

Zabezpečenie

• Každú požiadavku podpisujeme HMAC-SHA256. V hlavičke X-JobsAI-Signature: t=<čas>,v1=<podpis> je podpis vypočítaný z reťazca <čas>.<telo požiadavky> vaším tajomstvom - overením podpisu máte istotu, že správa pochádza od JobsAI.
• Hlavička X-JobsAI-Event-Id je rovnaká aj pri opakovanom doručení - použite ju na odstránenie duplicít.

Spoľahlivosť doručenia

• Keď adresa neodpovie stavom 2xx, doručenie opakujeme (6 pokusov počas približne hodiny), potom ho označíme ako nedoručené.
• Históriu všetkých doručení vrátane odpovedí vidíte v sekcii História doručení; neúspešné doručenie pošlete znova tlačidlom Poslať znova.