Підключення Djinni до RolePark

Що потрібно

• Акаунт роботодавця на Djinni з доступом до API. Відкрийте https://djinni.co/home/profile/: якщо компанія має доступ, ви побачите вкладку «ATS». Якщо її немає, напишіть у підтримку Djinni: magic@djinni.co.
• Обліковий запис адміна компанії в RolePark. Підключає Djinni лише адмін компанії, а публікують вакансії потім рекрутери.
• Один ключ API Djinni на компанію. Він не привʼязаний до конкретної людини, тож працює й після змін у команді.

Крок 1. Створіть ключ API на Djinni

1. Відкрийте https://djinni.co/home/integrations/ (вкладка «ATS» у профілі Djinni).
2. Натисніть «Створити ключ» і скопіюйте ключ.
3. Увімкніть «Увімкнути поле ATS Job ID у вакансіях». Тоді Djinni повертає ідентифікатор вакансії RolePark з кожним відгуком, і відгук потрапляє саме на свою вакансію.

Червона кнопка «Delete» поруч із ключем видаляє його. Після цього RolePark не публікує, доки ви не вставите новий ключ.

https://djinni.co/home/integrations/ ↗

Крок 2. Вставте ключ у RolePark

1. У RolePark відкрийте «Налаштування» → «Сайти вакансій» → Djinni.
2. Вставте ключ у поле «Ключ API Djinni» й натисніть «Підключити». RolePark одразу перевірить ключ у Djinni.
3. Оберіть типові значення, обовʼязкові для Djinni, яких немає в RolePark: «Рекрутер на Djinni» (пошта з переліку рекрутерів вашої компанії на Djinni), «Домен» і «Категорія». Натисніть «Зберегти типові значення».

Після збереження ключ показується лише чотирма останніми символами. «Перевірити ключ» повторює перевірку будь-коли, «Замінити ключ» міняє його без втрати налаштувань вебхука.

Крок 3. Вебхук для відгуків

RolePark сам створює вебхук у Djinni через API Djinni, щойно ключ перевірено. Робити нічого не треба: картка Djinni в RolePark пише «RolePark сам створив вебхук у Djinni».

Якщо хочете додати вебхук вручну, відкрийте Djinni → ATS → Webhooks і вкажіть:

Кожна компанія має власну непередбачувану адресу й токен. RolePark перевіряє токен на кожному запиті. «Нова адреса й токен» у картці замінює обидва одразу.

Публікація вакансії

1. Відкрийте вакансію в RolePark → вкладка «Розміщення» → панель «Djinni».
2. Якщо бракує чогось обовʼязкового для Djinni, панель це покаже. Для публікації Djinni вимагає вилку зарплати (від і до); для чернетки вона необовʼязкова. RolePark передає вилку вакансії сам, лише якщо вона в доларах США на місяць; інакше вкажіть вилку для Djinni в «Поля Djinni для цієї вакансії».
3. Натисніть «Опублікувати на Djinni»: RolePark створює оголошення на Djinni й публікує його одним кроком. «Зберегти чернетку на Djinni» створює неактивну чернетку, якої кандидати не бачать; опублікувати її можна пізніше тією самою кнопкою «Опублікувати на Djinni».
4. Djinni модерує нові оголошення. Поки триває перевірка, стан — «На модерації Djinni».

Стани в RolePark

• У черзі — запит іде на Djinni.
• Чернетка — оголошення є на Djinni, але кандидати його не бачать.
• На модерації Djinni — Djinni перевіряє оголошення.
• Опубліковано — кандидати бачать оголошення на Djinni.
• Призупинено на Djinni — вакансія на паузі; оголошення неактивне на Djinni й повернеться, щойно вакансію знову відкриють.
• Помилка — Djinni відхилив запит; причина — поруч зі станом і в журналі синхронізації.
• Знято — оголошення архівовано на Djinni.

• Коли ви змінюєте вакансію в RolePark, оголошення на Djinni оновлюється.
• Коли вакансію ставлять на паузу, RolePark призупиняє оголошення на Djinni й відновлює його, щойно вакансія знову відкрита. Коли вакансію закривають, знімають із публікації чи видаляють, RolePark знімає її з Djinni.
• Якщо Djinni тимчасово недоступний, RolePark повторює спроби з паузами, що зростають, і тримає ліміт Djinni — 100 запитів на хвилину.

Де зʼявляються відгуки

• Djinni надсилає кожен новий відгук у RolePark через вебхук, щойно він зʼявляється. Крім того, раз на 15 хвилин RolePark перевіряє відгуки кожної опублікованої вакансії, тож нічого не загубиться, навіть якщо вебхук не дійшов.
• Вони зʼявляються у вакансії на вкладці «Вхідні» з позначкою «Djinni» і посиланням на профіль кандидата на Djinni. Приймайте чи відхиляйте їх як звичайно.
• Якщо та сама людина прийшла ще й листом-сповіщенням Djinni, RolePark впізнає її за посиланням на профіль Djinni й не створює дубля.

Які дані передаються

RolePark → Djinni

• назва вакансії, опис, обовʼязкові й бажані навички, локація й формат роботи;
• вилка зарплати (публічно — лише якщо вона публічна в RolePark), домен, категорія й рекрутер на Djinni;
• ідентифікатор вакансії RolePark (як ATS Job ID).

Djinni → RolePark

• імʼя й контакти, якщо кандидат поділився ними з вами; посилання на профіль Djinni, посилання на CV, супровідний лист і час відгуку.
• RolePark не імпортує стать, відстрочку від мобілізації, фото, месенджери й відповіді на запитання квізу: їх видно в профілі на Djinni.

• Ключ API Djinni зберігається зашифрованим (AES-256-GCM), після збереження більше не показується й не пишеться в журнали.
• Відключення видаляє ключ і вебхук. Оголошення, що вже на Djinni, лишаються там, доки ви їх не знімете.

Конфіденційність ↗

Підтримка

Питання про RolePark: help@rolepark.com

Питання про доступ до API на Djinni: magic@djinni.co.