विषय पर बढ़ें

Greenhouse के लिए Polyguard PreScreen

उत्पाद Polyguard PreScreen
ATS Greenhouse (Job Board API + Harvest v1/v2)
कंसोल console.polyguard.ai
सेटअप समय लगभग 20 मिनट
संपर्क [email protected]

इस मार्गदर्शिका को PDF के रूप में डाउनलोड करें

इसके बजाय PreScreen के /admin पेज से सेटअप कर रहे हैं?

पुराने एडमिन पेज की मार्गदर्शिका देखें। वह पेज बंद किया जा रहा है; किसी भी नए सेटअप के लिए इस मार्गदर्शिका का उपयोग करें।


1. अवलोकन

PreScreen हर आवेदन को एक Polyguard Trust Check पर निर्भर बनाता है: एक छोटी जाँच, जो उम्मीदवार अपने फ़ोन पर पूरी करता है, और जो पुष्टि करती है कि आवेदन करने वाला एक वास्तविक व्यक्ति है। असत्यापित उम्मीदवार आपकी पाइपलाइन के पहले चरण में रोके जाते हैं; सत्यापित उम्मीदवार स्वचालित रूप से आगे बढ़ते हैं, और सत्यापन आवेदन पर दर्ज होता है।

यह कैसे काम करता है

आवेदन दो तरीकों से Greenhouse तक पहुँचते हैं, और PreScreen दोनों को कवर करता है।

उम्मीदवार कहाँ आवेदन करता है इसे कैसे नियंत्रित किया जाता है
होस्टेड आवेदन आपकी Polyguard करियर साइट फ़ॉर्म Trust Check पास होने तक सबमिशन रोकता है, फिर सत्यापन संलग्न करके Greenhouse को सबमिट करता है
प्रत्यक्ष आवेदन Greenhouse स्वयं, LinkedIn, Indeed या रेफ़रल के माध्यम से Greenhouse Polyguard को सूचित करता है, जो उम्मीदवार को ईमेल से Trust Check भेजता है और पूरा होने तक उसे पहले चरण में रोकता है

अधिकांश आवेदन दूसरे तरीके से आते हैं, इसीलिए खंड 5 का web hook वैकल्पिक नहीं है।

आप क्या कॉन्फ़िगर करेंगे

  • Polyguard कंसोल में एक PreScreen ऐप, अपने स्वयं के होस्टनाम के साथ
  • दो Greenhouse API कुंजियाँ: Job Board (सबमिट करने के लिए) और Harvest (आगे बढ़ाने के लिए)
  • एक कस्टम आवेदन फ़ील्ड जो सत्यापन दर्ज करता है
  • हर संरक्षित नौकरी पर एक Human Verification चरण
  • Greenhouse से Polyguard तक एक web hook

कौन क्या करता है

(Polyguard) चिह्नित चरणों के लिए Polyguard स्टाफ़ खाते की आवश्यकता है। बाकी सब कुछ खाता व्यवस्थापक कर सकता है।


2. पूर्वापेक्षाएँ

आवश्यकता विवरण
Greenhouse पहुँच एक उपयोगकर्ता जो Dev Center प्रबंधित कर सके (सामान्यतः Site Admin) और इंटरव्यू योजनाएँ संपादित कर सके
Polyguard खाता व्यवस्थापक भूमिका के साथ console.polyguard.ai पर कंसोल पहुँच
ब्रांड सामग्री करियर साइट के लिए लोगो, सटीक ब्रांड रंग और कंपनी का प्रदर्शित नाम
एक परीक्षण नौकरी एक खुली नौकरी जिस पर आप लाइव होने से पहले शुरू से अंत तक आवेदन कर सकें

सीक्रेट केवल एक बार दिखाए जाते हैं

Greenhouse एक API कुंजी ठीक एक बार दिखाता है, और Polyguard कंसोल इसे केवल-लेखन रूप में संग्रहीत करता है, बाद में केवल अंतिम 4 अक्षर दिखाता है। हर मान को बनाते ही कंसोल में कॉपी करें।


3. अपने Greenhouse मान एकत्र करें

इस खंड की सभी चीज़ें Configure (⚙️) → Dev Center के अंतर्गत हैं, कस्टम फ़ील्ड और पाइपलाइन चरण को छोड़कर।

Greenhouse Dev Center

3a से 3f तक पूरा करें और मानों को पास रखें। आप उन्हें खंड 4 में कंसोल में पेस्ट करेंगे।

3a. Job Board API कुंजी

  1. Dev Center साइडबार में API Credential Management खोलें।

    API Credential Management हाइलाइट किए हुए Dev Center

  2. ऊपर दाईं ओर Create new API credentials पर क्लिक करें।

    Create new API credentials बटन

  3. भरें:

    • API Type: Job Board
    • Partner: Unlisted vendor, या Custom
    • Description: Polyguard: Job Board
  4. Manage permissions पर क्लिक करें और यह अनुमति दें:
    • POST Submit Application अनुमति
  5. कुंजी कॉपी करें, फिर I have stored the API Key पर क्लिक करें।

डेमो मोड

इसे बाद में खाली छोड़ने से करियर साइट डेमो मोड में रहती है: यह ठीक वही दिखाती है जो सबमिट किया गया होता, Greenhouse पर पोस्ट किए बिना। लाइव होने से पहले ड्राई रन के लिए यह उपयोगी है।

3b. बोर्ड टोकन

आपके सार्वजनिक बोर्ड URL, job-boards.greenhouse.io/<your-board-token> में स्लग। पुष्टि करें कि यह आपकी लाइव भूमिकाएँ लौटाता है। किसी कुंजी की आवश्यकता नहीं, ये एंडपॉइंट सार्वजनिक हैं:

curl -s "https://boards-api.greenhouse.io/v1/boards/<your-board-token>/jobs" | head -c 300

3c. सत्यापन टोकन के लिए कस्टम फ़ील्ड

पूरे संगठन के लिए एक फ़ील्ड, एक बार बनाई जाती है। Greenhouse का Create a new custom application field देखें।

  1. Configure → Custom Options → Application → Add Field।
  2. भरें:
    • Name: Polyguard Verification Token
    • Field type: Single-line text
  3. सहेजें, फ़ील्ड फिर से खोलें, और उत्पन्न फ़ील्ड कुंजी नोट करें, उदाहरण के लिए polyguard_verification_token।

3d. Human Verification चरण

  1. एक नौकरी खोलें → Job Setup → Interview Plan → Add stage → Create a custom stage।
  2. भरें:
    • Stage name: Human Verification, ठीक इसी वर्तनी में
    • Position: दूसरा, पहले चरण के तुरंत बाद
  3. सहेजें।

Greenhouse कस्टम पहले चरण की अनुमति नहीं देता। आवेदन पहले चरण में आते हैं, असत्यापित उम्मीदवार वहाँ रोके जाते हैं, और PreScreen उन्हें पास होने पर Human Verification में आगे बढ़ाता है।

हर संरक्षित नौकरी को यह चरण चाहिए

जिन टीमों की पाइपलाइनें इन चरणों को अलग नाम देती हैं, उन्हें PreScreen सेटिंग पेज के Candidate verification कार्ड पर Pipeline stages by team के अंतर्गत सूचीबद्ध किया जा सकता है, उनके अपने प्रारंभिक और सत्यापित चरण नामों के साथ।

यह चरण, इसी नाम और दूसरी स्थिति में, हर उस नौकरी पर मौजूद होना चाहिए जिसे आप संरक्षित करना चाहते हैं। खुली नौकरियों में इसे लागू करने के लिए Edit job stage in bulk का उपयोग करें।

3e. On-behalf-of उपयोगकर्ता

Greenhouse हर चरण परिवर्तन को एक वास्तविक उपयोगकर्ता से जोड़ता है। एक चुनें, आदर्श रूप से एक समर्पित भर्ती-संचालन खाता।

  1. Configure → Users और उस उपयोगकर्ता को खोलें।
  2. URL के अंत से संख्यात्मक id पढ़ें। उदाहरण के लिए, app.greenhouse.io/account/user/12345 से 12345 मिलता है।

3f. Harvest API कुंजी

  1. API Credential Management → Create new API credentials।
  2. भरें:
    • API Type: Harvest, Harvest V3 नहीं, जो समर्थित नहीं है
    • Partner: Unlisted vendor, या Custom
    • Description: Polyguard: Harvest
  3. Manage permissions पर क्लिक करें और केवल ये अनुमतियाँ दें:
स्कोप PreScreen को इसकी आवश्यकता क्यों है
Job Stages → Get: Retrieve Job Stages for Job नौकरी की पाइपलाइन में गेट चरण खोजना
Applications → Patch: Edit Application कस्टम फ़ील्ड में सत्यापन टोकन लिखना
Applications → Move: Move Application सत्यापित उम्मीदवार को आगे बढ़ाना
Applications → Get: Retrieve / List Applications आवेदन की स्थिति और स्रोत पढ़ना
Candidates → Get: Retrieve / List Candidates उम्मीदवार का नाम और ईमेल पढ़ना
Sources → Get: List Sources आवेदन कहाँ से आया यह निर्धारित करना
  1. सहेजें, फिर कुंजी कॉपी करें।

Edit Application वह अनुमति है जो लोग अक्सर छोड़ देते हैं

इसके बिना टोकन लिखना 403 के साथ अस्वीकृत हो जाता है जबकि उम्मीदवार फिर भी आगे बढ़ता है, इसलिए फ़ील्ड चुपचाप खाली रह जाती है और कुछ भी टूटा हुआ नहीं दिखता।


4. Polyguard में ऐप कॉन्फ़िगर करें

4a. PreScreen ऐप बनाएँ (Polyguard)

कंसोल → Create App → ऐप प्रकार PreScreen।

कंसोल में PreScreen ऐप बनाना

इसे बनाने से {account-slug}.prescreen.polyguard.ai रूप का होस्टनाम आरक्षित होता है। उसी खाते पर दूसरे टेनेंट को -2, -3, इत्यादि मिलता है।

4b. होस्टनाम जाँचें (परिवर्तन Polyguard करता है)

Settings → Prescreen → Hostnames वह होस्ट दिखाता है जिस पर यह टेनेंट सर्व किया जाता है। खाता व्यवस्थापक इसे पढ़ सकते हैं; केवल Polyguard स्टाफ़ इसे बदल सकता है।

Hostnames कार्ड

यह एड्रेस बार से आगे भी महत्वपूर्ण है: खंड 5 का web hook URL इससे बनता है, और वह पता भी जिस पर Polyguard सत्यापन परिणाम भेजता है।

नोट

आरक्षित नाम तब तक लाइव साइट नहीं है जब तक Polyguard इसे टेनेंट के डिप्लॉयमेंट से नहीं जोड़ता। यह Polyguard का कार्य है और इस मार्गदर्शिका के बाकी हिस्से को नहीं रोकता।

4c. ATS कनेक्शन

Settings → Prescreen → ATS connection, प्रदाता Greenhouse।

ATS कनेक्शन फ़ॉर्म

फ़ील्ड मान स्रोत
Job Board API key Job Board कुंजी 3a
Harvest API key Harvest कुंजी 3f
Harvest webhook secret खंड 5 में उत्पन्न
Board token आपका बोर्ड स्लग 3b
On-behalf-of user id संख्यात्मक उपयोगकर्ता id 3e
Gate stage name Human Verification 3d
Polyguard field key उदा. polyguard_verification_token 3c
Manual source names वैकल्पिक, डिफ़ॉल्ट Internal Applicant ऐसे स्रोत जिन्हें कभी Trust Check ईमेल नहीं भेजा जाता
Trust Check expiry (days) वैकल्पिक, डिफ़ॉल्ट 3 1 से 7
Reject application on expiry वैकल्पिक अन्यथा समाप्त आवेदन रोके रहते हैं
Rejection reason id वैकल्पिक खाली होने पर Greenhouse का डिफ़ॉल्ट उपयोग होता है
Company name वैकल्पिक Trust Check ईमेल में प्रदर्शित नाम

Save ATS configuration पर क्लिक करें। सहेजने पर सीक्रेट फ़ॉर्म से हट जाते हैं और बाद में अपने अंतिम 4 अक्षर दिखाते हैं; किसी सीक्रेट को खाली छोड़ने से संग्रहीत मान बना रहता है, हटता नहीं।


5. Greenhouse में web hook पंजीकृत करें

जब भी कोई उम्मीदवार आवेदन सबमिट करता है, Greenhouse Polyguard को सूचित करता है। यही प्रत्यक्ष आवेदनों को नियंत्रित करता है, और होस्टेड आवेदनों को आगे बढ़ाता है।

5a. कंसोल से URL और सीक्रेट प्राप्त करें

ATS connection फ़ॉर्म में, Harvest webhook secret के ठीक ऊपर:

Web hook URL और सीक्रेट

  1. web hook URL कॉपी करें।
  2. Harvest webhook secret के बगल में Generate पर क्लिक करें, फिर मान कॉपी करें।
  3. Save ATS configuration पर क्लिक करें।

सहेजने से पहले सीक्रेट कॉपी करें

यह केवल तब तक पढ़ने योग्य है; उसके बाद कंसोल अंतिम 4 अक्षर दिखाता है और कुछ नहीं। यदि आप इसे खो देते हैं, तो नया उत्पन्न करें और Greenhouse को मिलान के लिए अपडेट करें।

5b. Web hook बनाएँ

Configure (⚙️) → Dev Center → Web Hooks → Create a new web hook खोलें:

सेटिंग मान
Name Polyguard: Candidate submitted application
When Candidate has submitted application
Endpoint URL 5a में कॉपी किया गया URL, ठीक जैसा दिखाया गया
Secret key 5a में उत्पन्न सीक्रेट, दोनों तरफ़ समान
Error Recipient Email [email protected], ताकि डिलीवरी विफल होने पर Polyguard को सूचना मिले
Disabled? No

Create Web hook पर क्लिक करें।

Create A New Web Hook फ़ॉर्म

कंसोल द्वारा दिया गया URL ज्यों का त्यों उपयोग करें

जिस URL में आपका बोर्ड टोकन जोड़ा गया हो, वह अपनी सेटिंग किसी बिल्कुल अलग जगह से पढ़ता है और हर डिलीवरी को अस्वीकार कर देगा, जबकि Greenhouse को सफलता लौटाता रहेगा।


6. सत्यापन

लाइव होने से पहले चारों चलाएँ।

6.1 सूचियाँ

अपने होस्टनाम पर करियर साइट खोलें। आपकी लाइव Greenhouse भूमिकाएँ आपके ब्रांड में दिखनी चाहिए।

6.2 होस्टेड आवेदन

  1. करियर साइट के माध्यम से आवेदन करें और फ़ोन पर Trust Check पूरी करें।
  2. Greenhouse में पुष्टि करें कि उम्मीदवार दिखता है, Human Verification में है, और Polyguard Verification Token फ़ील्ड भरी हुई है।

6.3 प्रत्यक्ष आवेदन

  1. अपने सार्वजनिक Greenhouse बोर्ड के माध्यम से आवेदन करें, 6.2 से भिन्न ईमेल पते का उपयोग करते हुए।
  2. पुष्टि करें कि Trust Check ईमेल आता है।
  3. इसे पूरा करें और पुष्टि करें कि आवेदन Human Verification में आगे बढ़ता है।

भिन्न ईमेल का उपयोग करें

6.2 वाला ईमेल दोबारा उपयोग करने पर उस नौकरी के लिए पहले से कैश किया गया सत्यापन मिल जाता है, इसलिए आवेदन तुरंत आगे बढ़ जाता है और ईमेल मार्ग का कभी परीक्षण नहीं होता।

6.4 मैन्युअल ओवरराइड

Tools → Manual verify, किसी ऐसे उम्मीदवार की लिंक id के साथ जिसकी पुष्टि आपने किसी अन्य तरीके से की है, उस आवेदन को आगे बढ़ाता है। प्रति लिंक एक उपयोग।


7. PreScreen का उपयोग

रोज़मर्रा

कुछ नहीं करना है। आवेदन आते हैं, उम्मीदवार सत्यापित होते हैं, और सत्यापित उम्मीदवार आवेदन पर टोकन दर्ज होने के साथ Human Verification में आगे बढ़ते हैं। जो उम्मीदवार कभी सत्यापित नहीं होते, वे अपनी Trust Check समाप्त होने तक पहले चरण में रहते हैं।

ऑपरेटर उपकरण

कंसोल स्थान यह क्या करता है
Tools → Manual verify किसी अन्य माध्यम से सत्यापित उम्मीदवार को आगे बढ़ाना
Tools → Send test email डिलीवरी की पुष्टि के लिए स्वयं को Trust Check भेजना
Analytics खाते के लिए Trust Check फ़नल
Settings → Prescreen → Branding कंपनी का नाम, रंग, लोगो और थीम

बाद में नौकरी जोड़ना

नई नौकरियों को दूसरी स्थिति में Human Verification चरण चाहिए (3d)। बाकी सब कुछ खाता-व्यापी है और पहले से कॉन्फ़िगर है।


8. समस्या निवारण

आवेदन कभी आगे नहीं बढ़ते, और Greenhouse कोई त्रुटि नहीं बताता

दोनों रिसीवर डिलीवरी अस्वीकार करने पर भी HTTP 200 देते हैं, क्योंकि गैर-2xx उत्तर से Greenhouse web hook को अक्षम कर देगा। इसलिए Greenhouse की ओर से गलत सीक्रेट बिल्कुल सही सीक्रेट जैसा दिखता है। web hook की हाल की डिलीवरी जाँचें, फिर पुष्टि करें कि सीक्रेट दोनों तरफ़ अक्षर-दर-अक्षर मेल खाता है।

उम्मीदवार आगे बढ़ता है लेकिन टोकन फ़ील्ड खाली रहती है

Harvest कुंजी में Applications → Patch: Edit Application नहीं है (3f)। लिखना 403 के साथ अस्वीकृत होता है जबकि चरण परिवर्तन फिर भी सफल होता है।

Polyguard तक कुछ भी नहीं पहुँचता

पुष्टि करें कि web hook एंडपॉइंट ठीक वही URL है जो कंसोल दिखाता है। /<your-board-token> जोड़ा हुआ URL अपनी सेटिंग कंसोल के बजाय डिप्लॉयमेंट के अपने स्टोर से लेता है, इसलिए हर डिलीवरी हस्ताक्षर जाँच में विफल होती है।

कंसोल में किया गया परिवर्तन प्रभावी नहीं हुआ

कॉन्फ़िगरेशन 60 सेकंड के लिए कैश होता है। एक मिनट प्रतीक्षा करें और पुनः प्रयास करें। ब्रांडिंग अपवाद है: नीचे देखें।

ब्रांडिंग परिवर्तन करियर साइट पर नहीं दिखते

इसे एक घंटे तक का समय दें। करियर इंडेक्स और नौकरी पेज पहले से रेंडर किए जाते हैं और हर घंटे ताज़ा होते हैं, इसलिए ब्रांडिंग परिवर्तन अगली रीफ़्रेश पर लिया जाता है, अगले पेज लोड पर नहीं।

कंसोल में खाली छोड़ी गई फ़ील्ड डिप्लॉयमेंट के अपने कॉन्फ़िगरेशन पर वापस जाती है, और जिस मान को साइट असुरक्षित मानकर अस्वीकार करती है (ऐसा लोगो या साइट URL जो https:// नहीं है, ऐसा रंग जो मान्य CSS रंग नहीं है) वह भी उसी तरह वापस जाता है, इसलिए यदि एक फ़ील्ड पुरानी ब्रांडिंग पर रहती है जबकि बाकी अपडेट हो जाती हैं, तो मान जाँचें।

Trust Check आमंत्रण ईमेल अभी भी अपनी कंपनी का नाम डिप्लॉयमेंट कॉन्फ़िगरेशन से लेता है, इन फ़ील्ड से नहीं।

करियर साइट कोई भूमिका नहीं दिखाती

या तो बोर्ड टोकन गलत है (3b), या कंसोल में चुना गया प्रदाता डिप्लॉयमेंट में चल रहे प्रदाता से मेल नहीं खाता। यह बेमेल मौन है: कंसोल सेटिंग बस अनदेखी कर दी जाती हैं।

किसी उम्मीदवार को कभी Trust Check ईमेल नहीं भेजा गया

बिना स्रोत वाले आवेदन, या Manual source names में सूचीबद्ध स्रोत वाले आवेदन, भर्तीकर्ता प्रविष्टियाँ माने जाते हैं और जानबूझकर कभी ईमेल नहीं किए जाते। हाथ से उम्मीदवार जोड़ने वाले भर्तीकर्ता ने पहले ही तय कर लिया है कि वे पाइपलाइन में हैं।


9. सहायता

Greenhouse दस्तावेज़

Polyguard से असंबंधित Greenhouse प्लेटफ़ॉर्म समस्याओं के लिए, अपने Greenhouse व्यवस्थापक या Greenhouse सहायता से संपर्क करें।