JobsAI

Webhooky pre zamestnávateľov

Nechajte si nové reakcie kandidátov posielať rovno do vlastného systému (n8n, Zapier, ATS).

Čo webhooky dokážu

Nové reakcie kandidátov vám JobsAI posiela 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

  • Ak adresa neodpovie stavom 2xx, vykonáme najviac 6 pokusov celkovo. Čakanie medzi pokusmi sa predlžuje; výpadok služby môže obnovu oneskoriť. Po vyčerpaní pokusov doručenie 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.

Ak kandidát stiahnutú reakciu odošle znova, vznikne nová udalosť s rovnakým ID reakcie a vyššou hodnotou application.submissionVersion. Opakovanie tej istej udalosti zachová jej ID. Čakajúce doručenia staršieho pokusu alebo stiahnutej reakcie zastavíme; tlačidlo na opätovné odoslanie toto obmedzenie neobchádza.

Tlačidlo Poslať znova použite po odstránení príčiny chyby. Prebiehajúce doručenie nemožno spustiť súbežne. Opakovanie zaznamená, kto oň požiadal, a zachová pôvodnú udalosť aj jej obsah. Úspešná odpoveď 2xx znamená, že váš systém požiadavku prijal; nepotvrdzuje dokončenie nadväzujúceho procesu vo vašom ATS.

Ďalšie napojenia

Okrem prijímania reakcií cez webhooky môžete poveriť registrovaného AI agenta, aby za firmu pripravoval a spravoval pracovné ponuky. Pozrite AI agenti pre firmy.