Вебхуки для роботодавців

Що вміють вебхуки

Нові відгуки кандидатів JobsAI надсилає як захищений HTTPS-запит (подія application.received) на адресу, яку ви зареєструєте. Повідомлення містить ім'я, e-mail і телефон кандидата, супровідний лист, дані про вакансію та посилання на деталі відгуку - ту саму інформацію, що й сповіщення e-mail, лише в машиночитному вигляді. Підходить для підключення n8n, Zapier, Make або власної ATS.

Налаштування крок за кроком

• В огляді компанії натисніть Вебхуки (API). Функція доступна лише перевіреним компаніям, керують нею власники та адміністратори.
• Введіть HTTPS-адресу вашої системи та натисніть Додати.
• Збережіть секрет підпису - з міркувань безпеки він показується лише один раз.
• Натисніть Перевірити: на адресу ми надішлемо тестову подію endpoint.verify, і ваша система має відповісти статусом 2xx.
• Доставляємо лише на перевірені та активні адреси.

Безпека

• Кожен запит підписано HMAC-SHA256. Заголовок X-JobsAI-Signature: t=<час>,v1=<підпис> містить підпис, обчислений з рядка <час>.<тіло запиту> вашим секретом - перевіривши підпис, ви маєте певність, що повідомлення надійшло від JobsAI.
• Заголовок X-JobsAI-Event-Id однаковий і при повторній доставці - використовуйте його для усунення дублікатів.

Надійність доставлення

• Якщо адреса не відповідає статусом 2xx, ми виконуємо не більше 6 спроб загалом. Інтервал між спробами збільшується; збій сервісу може затримати відновлення. Після вичерпання спроб доставку позначаємо як невдалу.
• Розділ Історія доставлень показує кожне доставлення разом із відповідями; невдале доставлення надішліть знову кнопкою Надіслати знову.

Якщо кандидат повторно відгукнеться після відкликання, буде створено нову подію з тим самим ID відгуку та більшим значенням application.submissionVersion. Повторна доставка тієї самої події зберігає її ID. Очікувану доставку для попередньої спроби або відкликаного відгуку зупиняємо; кнопка повторного надсилання не скасовує це обмеження.

Використовуйте Надіслати знову після усунення причини помилки. Доставку, яка вже виконується, не можна запустити повторно одночасно. Ми фіксуємо, хто запросив повторення, і зберігаємо початкову подію та її вміст. Успішна відповідь 2xx означає, що ваша система прийняла запит; вона не підтверджує завершення подальшої обробки у вашій ATS.

Інші інтеграції

Окрім отримання відгуків через вебхуки, ви можете доручити зареєстрованому ШІ-агенту готувати й керувати вакансіями від імені вашої компанії. Див. ШІ-агенти для компаній.