संक्षेप में
- जोड़ने के तीन तरीक़े: नेटिव ATS कनेक्शन, वेबहुक के साथ पब्लिक API, या आपके करियर पेज पर एम्बेड किया गया इंटरव्यू। आप एक से ज़्यादा तरीक़े इस्तेमाल कर सकते हैं।
- ATS: Workable, Greenhouse, Teamtailor, Recruitee या Breezy HR में एक जॉब और स्टेज को पब्लिश किए गए इंटरव्यू से लिंक करें। उस स्टेज में ले जाए गए हर उम्मीदवार को एक बार आमंत्रित किया जाता है, और नतीजे नोट के रूप में वापस जाते हैं।
- API: सीमित स्कोप वाली API कुंजी से अपने सिस्टम से उम्मीदवार और आमंत्रण बनाएँ, और साइन किए गए वेबहुक से जानें कि क्या हुआ।
- एम्बेड: एक स्क्रिप्ट से इंटरव्यू को अपनी साइट के अंदर चलाएँ, उन साइटों से जिन्हें आप अनुमति देते हैं।
- पहले टेस्ट करें: लाइव जाने से पहले वेबहुक का टेस्ट इवेंट भेजें, एक टेस्ट उम्मीदवार को स्टेज से गुज़ारें, और डिलीवरी और गतिविधि लॉग पढ़ें।
AI इंटरव्यू जोड़ने के तीन तरीक़े
AI इंटरव्यू का ATS इंटीग्रेशन आपके रिक्रूटरों को कॉपी-पेस्ट से बचाता है: उम्मीदवारों को उसी सिस्टम से आमंत्रित किया जाता है जो आप पहले से इस्तेमाल करते हैं, और नतीजे उसी में लौटते हैं। अगर आपके ATS का कोई नेटिव कनेक्शन नहीं है, या आप अपने ख़ुद के पोर्टल से हायर करते हैं, तो पब्लिक API और एम्बेड थोड़े कोड के साथ यही काम करते हैं।
- नेटिव ATS कनेक्शन। Workable, Greenhouse, Teamtailor, Recruitee और Breezy HR। कोई कोड नहीं: एक कुंजी पेस्ट करें, एक जॉब और एक स्टेज लिंक करें, और उम्मीदवार को उस स्टेज में ले जाते ही आमंत्रण चला जाता है।
- पब्लिक API और वेबहुक। आपका सिस्टम REST के ज़रिए उम्मीदवार और आमंत्रण बनाता है और नतीजे लाता है; कुछ होने पर वेबहुक उसे बताते हैं।
- एम्बेड SDK। एक स्क्रिप्ट आपके करियर पेज पर एक फ़्रेम में इंटरव्यू चलाती है। इसे आमंत्रण लिंक चाहिए, इसलिए यह API के साथ इस्तेमाल होता है।
तीनों के लिए पेड प्लान और कंपनी एडमिन चाहिए। इंटरव्यू वही होता है जो उम्मीदवारों को ईमेल लिंक से मिलता है, जिसमें बोलने की जगह टाइप करने का विकल्प भी शामिल है।
ATS, API और एम्बेड में से चुनना
| नेटिव ATS कनेक्शन | पब्लिक API और वेबहुक | एम्बेड SDK (API के साथ) | |
|---|---|---|---|
| किसके लिए सबसे अच्छा | पाँच समर्थित ATS में से किसी एक पर काम करने वाली टीमें | कोई भी दूसरा ATS या आपका अपना वर्कफ़्लो | आपके नियंत्रण वाला करियर पेज या पोर्टल |
| ज़रूरी कोड | कोई नहीं | API कॉल और एक वेबहुक रिसीवर | पेज पर कुछ लाइनें, साथ में API |
| आमंत्रण किससे जाता है | उम्मीदवार को लिंक की गई स्टेज में ले जाने से | आपकी API कॉल से | आपकी API कॉल से; लिंक आपके पेज पर माउंट होता है |
| नतीजे किस रूप में लौटते हैं | ATS में उम्मीदवार पर एक नोट | नतीजे, जिन्हें आप नतीजों वाले वेबहुक के बाद लाते हैं | वही; पेज को सिर्फ़ यह पता चलता है कि उम्मीदवार ने इंटरव्यू पूरा कर लिया |
अगर आपके ATS का नेटिव कनेक्शन है, तो उसी से शुरू करें। जब आपको इस पर नियंत्रण चाहिए कि किसे और कब आमंत्रित किया जाए, तो API चुनें। जब उम्मीदवारों को आपकी साइट पर ही रहना हो, तो एम्बेड जोड़ें।
AI इंटरव्यू का ATS इंटीग्रेशन सेट करें
ATS जोड़ें और एक जॉब लिंक करें
- इंटरव्यू पब्लिश करें। सिर्फ़ पब्लिश किया गया इंटरव्यू ही किसी जॉब से लिंक किया जा सकता है।
- इंटीग्रेशन → ATS खोलें और ATS जोड़ें दबाएँ। ATS के क्रेडेंशियल पेस्ट करें (इन्हें कहाँ ढूँढें)। testee सहेजने से पहले ATS के साथ इन्हें आज़माता है, फिर इन्हें एन्क्रिप्ट करके सहेजता है और सिर्फ़ एक छिपा हुआ संकेत दिखाता है।
- वेबहुक सेट करें। Workable और Breezy HR के लिए कुछ नहीं करना होता: testee इसे ख़ुद रजिस्टर करता है। Greenhouse, Teamtailor और Recruitee के लिए, ATS में कनेक्शन के वेबहुक कार्ड पर दिए पते के साथ एक वेबहुक जोड़ें और कार्ड पर बताए तरीक़े से सीक्रेट का आदान-प्रदान करें।
- एक जॉब लिंक करें। जॉब टैब में ATS की खुली जॉब दिखती हैं। एक खोलें, पब्लिश किया गया इंटरव्यू और वह स्टेज चुनें जो आमंत्रण भेजती है, और सहेजें।
- New York City की जॉब चिह्नित करें लिंक पर, ताकि आमंत्रणों में आपका Local Law 144 नोटिस हो और वे 10 कार्यदिवस बाद खुलें।


हर उम्मीदवार के लिए क्या होता है
- सिर्फ़ एक बार आमंत्रण, ATS चाहे जितनी बार इवेंट भेजे। जिन जॉब या स्टेज को आपने लिंक नहीं किया, उनके इवेंट अनदेखे कर दिए जाते हैं।
- तय फ़ील्ड: उम्मीदवार का ईमेल और नाम, जॉब और स्टेज, और ATS का रेफ़रेंस। कोई मैपिंग कॉन्फ़िगर नहीं करनी पड़ती।
- नतीजे नोट के रूप में: कवरेज स्कोर (समीक्षा के लिए, भर्ती का फ़ैसला नहीं), सारांश और नतीजों का लिंक। आप हर कनेक्शन के लिए यह वापस लिखना बंद कर सकते हैं।
- विफलताएँ: आउटेज होने पर लगभग आठ घंटे तक दोबारा कोशिश की जाती है; अस्वीकृति, जैसे इंटरव्यू मिनट ख़त्म हो जाना, लॉग में दिखती है।
- अतिरिक्त समय जिस उम्मीदवार ने माँगा हो, उसके लिए डैशबोर्ड में आमंत्रण के पेज पर सेट किया जाता है, जब तक वह शुरू न करे।
रोकें दबाने पर आमंत्रण और नोट तब तक रुके रहते हैं जब तक आप फिर से शुरू न करें। अगर बाद में ATS कुंजी अस्वीकार करता है, तो कनेक्शन पर फिर से जोड़ना ज़रूरी दिखता है और नोट इंतज़ार करते हैं।
AI इंटरव्यू API और वेबहुक इस्तेमाल करें
पब्लिक REST API वही करता है जो एक रिक्रूटर डैशबोर्ड में करता है: पब्लिश किए गए इंटरव्यू की सूची देखना, उम्मीदवार बनाना, उन्हें आमंत्रित करना और नतीजे लाना। रेफ़रेंस AI इंटरव्यू API डॉक्स में है।
API कुंजियाँ
- कुंजी बनाएँ इंटीग्रेशन → API कुंजियाँ में। सीक्रेट (aik_live_…) सिर्फ़ एक बार दिखाया जाता है और bearer टोकन के रूप में भेजा जाता है, कभी URL में नहीं।
- स्कोप: हर कुंजी को सिर्फ़ वही अनुमतियाँ दें जो उसका सिस्टम इस्तेमाल करता है, जैसे invitations:write और results:read।
- IP अनुमति-सूची: 50 तक पते या रेंज, जैसे आपके सर्वर के आउटबाउंड पते।
- समाप्ति: 30 दिन, 90 दिन (डिफ़ॉल्ट), 1 साल, 2 साल तक आगे की कोई तारीख़, या कभी नहीं। सूची 7 दिन पहले चेतावनी देती है।
- रेट लिमिट: हर कुंजी पर प्रति मिनट 120 अनुरोध।


अपने सिस्टम से उम्मीदवार को आमंत्रित करें
- GET /v1/interviews आपके पब्लिश किए गए इंटरव्यू की सूची देता है।
- POST /v1/candidates नाम और ईमेल के साथ। उसी ईमेल वाला दूसरा उम्मीदवार अस्वीकार कर दिया जाता है, इसलिए id सहेज लें।
- POST /v1/invitations दोनों id के साथ। जवाब में लिंक होता है, जो सिर्फ़ एक बार दिखाया जाता है; testee उसे उम्मीदवार को ईमेल भी करता है।
- Idempotency-Key हेडर भेजें हर POST पर। टाइमआउट के बाद उसी कुंजी के साथ दोबारा कोशिश करने से कुछ भी दो बार नहीं बनता (कुंजियाँ 24 घंटे चलती हैं)।
| आमंत्रण का वैकल्पिक फ़ील्ड | यह क्या करता है |
|---|---|
| externalId | आपकी अपनी id (मसलन, नौकरी का आवेदन)। यह आमंत्रण पर और हर वेबहुक में वापस आती है |
| returnUrl | इंटरव्यू पूरा करने के बाद उम्मीदवार को इस https पते पर वापस जाने का बटन दिखता है (एम्बेड के अंदर नहीं) |
| extraTime | जिस उम्मीदवार ने माँगा हो, उसके लिए 25, 50 या 100 प्रतिशत ज़्यादा समय; एक इंटरव्यू अतिरिक्त समय समेत ज़्यादा से ज़्यादा 60 मिनट का होता है। API इसे कभी नहीं लौटाता और न ही वेबहुक में भेजता है |
| nycNotice | उम्मीदवार New York City में रहता है: ईमेल में आपका नोटिस होता है, और इंटरव्यू 10 कार्यदिवस बाद खुलता है |
| skipSignIn | आपकी साइट ने उम्मीदवार को पहले ही साइन इन करा दिया है: सिर्फ़ लिंक से इंटरव्यू खुल जाता है (एम्बेड देखें) |
वेबहुक
इंटीग्रेशन → वेबहुक में एक एंडपॉइंट जोड़ें: एक पब्लिक https URL और उसके इवेंट, जो हैं invitation.created, invitation.opened, invitation.resent, invitation.revoked, invitation.expired, session.started, session.completed, results.failed, review.decision_changed, candidate.erased और results.ready। पेलोड में सिर्फ़ id और आपकी externalId होती है, कभी नाम या स्कोर नहीं; results.ready पर GET /v1/sessions/{id}/results से नतीजे लाएँ।
- हर सिग्नेचर सत्यापित करें: टाइमस्टैम्प और रॉ बॉडी का HMAC-SHA256, एंडपॉइंट के सीक्रेट से बना। तुलना कॉन्स्टेंट टाइम में करें और 5 मिनट से पुराने टाइमस्टैम्प अस्वीकार करें (वेबहुक डॉक्स में कोड)।
- 10 सेकंड के भीतर 2xx से जवाब दें। विफल डिलीवरी को लगभग 24 घंटे तक बैकऑफ़ के साथ दोबारा भेजा जाता है।
- दोहराव और किसी भी क्रम की उम्मीद रखें: जिस इवेंट id को आप सँभाल चुके हैं उसे छोड़ दें, और मौजूदा स्थिति API से पढ़ें।
इंटरव्यू को अपने करियर पेज में एम्बेड करें
करियर पेज पर इंटरव्यू एम्बेड करने से उम्मीदवार आपकी साइट पर ही रहते हैं: एक स्क्रिप्ट इंटरव्यू को फ़्रेम में दिखाती है और बताती है कि उम्मीदवार क्या कर रहा है (एम्बेड SDK डॉक्स)।
इंटरव्यू एम्बेड करें
- अपनी साइट को अनुमति दें इंटीग्रेशन → एम्बेड में: बिना पाथ वाला एक https ओरिजिन, 20 तक। इंटरव्यू किसी और जगह फ़्रेम में लोड नहीं होगा।
- अपने सर्वर पर आमंत्रण बनाएँ और उसका लिंक पेज को दें। API कुंजी कभी पेज में नहीं जाती।
- इसे माउंट करें TesteeEmbed.mount से: एक कंटेनर, लिंक और एक onEvent फ़ंक्शन। डैशबोर्ड का एम्बेड टैब स्निपेट दिखाता है।
- इवेंट सँभालें: ready, login_required, started, completed, feedback_submitted और error, हर एक में सिर्फ़ id।
साइन-इन कोड छोड़ना
डिफ़ॉल्ट रूप से उम्मीदवार फ़्रेम के अंदर अपने ईमेल पर भेजे गए 6 अंकों के कोड से साइन इन करता है; आपका पेज उसे कभी नहीं देखता। अगर आपकी साइट ने उम्मीदवार को पहले ही साइन इन करा दिया है, तो API के ज़रिए skipSignIn के साथ आमंत्रण बनाएँ, और सिर्फ़ लिंक से इंटरव्यू खुल जाएगा। डैशबोर्ड इसे सेट नहीं कर सकता।
- इसकी क़ीमत: लिंक ही अकेली चाबी बन जाता है, इसलिए जिसके पास भी वह है, वह इंटरव्यू दे सकता है। समाप्ति एक-दो दिन रखें, आमंत्रण उम्मीदवार के शुरू करने से ठीक पहले बनाएँ, और उसे सिर्फ़ अपने साइन-इन के पीछे दिखाएँ।
- रिकॉर्ड में: आमंत्रण पर "साइन इन छोड़ा गया" दिखता है, और नतीजों में लिखा होता है कि पहचान आपकी कंपनी की साइट ने सत्यापित की।
लाइव जाने से पहले टेस्ट करें
एक टेस्ट रन
- एक टेस्ट उम्मीदवार इस्तेमाल करें ऐसे ईमेल के साथ जिसे आप पढ़ सकें; टीम के सदस्यों के प्रीव्यू कोई वेबहुक नहीं भेजते।
- वेबहुक का टेस्ट इवेंट भेजें एंडपॉइंट के मेन्यू से: एक साइन किया गया test.ping, ताकि आपके सिग्नेचर वाले कोड की भी जाँच हो जाए।
- डिलीवरी लॉग पढ़ें एंडपॉइंट के पेज पर। दोबारा भेजें उसी id के साथ डिलीवरी फिर से भेजता है, जिससे जाँच होती है कि आप दोहराव छोड़ देते हैं।
- उम्मीदवार को लिंक की गई स्टेज में ले जाएँ और ATS कनेक्शन का गतिविधि टैब देखें: हर इवेंट, आमंत्रण और नोट पूरा, दोबारा कोशिश जारी, विफल या अनदेखा होता है।
- इंटरव्यू दें और देखें कि results.ready आया या ATS में नोट दिखा। आम समस्याओं के समाधान ATS ट्रबलशूटिंग डॉक्स में हैं।
सुरक्षा से जुड़ी बातें
- कुंजियाँ सर्वर पर ही रहें, हर सिस्टम के लिए एक, सिर्फ़ ज़रूरी स्कोप, IP अनुमति-सूची और समाप्ति के साथ। जिस कुंजी के लीक होने का शक हो, उसे रद्द करें।
- पहले सत्यापित करें, फिर भरोसा करें: जिन वेबहुक का सिग्नेचर या टाइमस्टैम्प सही न निकले उन्हें अस्वीकार करें, और डेटा API से पढ़ें।
- सिर्फ़ अपनी साइटों को अनुमति दें एम्बेड के लिए।
- आमंत्रण लिंक निजी होते हैं: उन्हें कभी लॉग या साझा न करें, ख़ासकर skipSignIn के साथ।
Slack सूचनाएँ
इंटीग्रेशन → Slack में, Slack में जोड़ें या किसी इनकमिंग वेबहुक से कनेक्ट करें, चुनें कि कौन-सी सूचनाएँ पोस्ट हों, जैसे नतीजे तैयार, और एक टेस्ट संदेश भेजें (Slack डॉक्स)।
सारांश
- पाँच समर्थित ATS में से किसी एक पर हों तो, नेटिव कनेक्शन इस्तेमाल करें: हर जॉब और स्टेज को पब्लिश किए गए इंटरव्यू से लिंक करें।
- वरना, सीमित स्कोप वाली, समाप्त होने वाली कुंजियों और Idempotency-Key हेडर के साथ API इस्तेमाल करें, और हर वेबहुक सत्यापित करें।
- उम्मीदवारों को अपनी साइट पर रखने के लिए, एम्बेड जोड़ें, और साइन-इन कोड सिर्फ़ अपने साइन-इन के पीछे ही छोड़ें।
- लाइव जाने से पहले, एक टेस्ट उम्मीदवार के साथ शुरू से आख़िर तक पूरा रन चलाएँ।
सवाल और जवाब
क्या testee, Greenhouse या Workable के साथ इंटीग्रेट होता है?
हाँ, नेटिव रूप से, और Teamtailor, Recruitee और Breezy HR के साथ भी। आप एक जॉब और एक स्टेज को पब्लिश किए गए इंटरव्यू से लिंक करते हैं; उस स्टेज में ले जाए गए हर उम्मीदवार को एक बार आमंत्रित किया जाता है, और नतीजे नोट के रूप में वापस जाते हैं।
क्या कोई AI इंटरव्यू API है?
हाँ। REST API उम्मीदवार और आमंत्रण बनाता है, उनकी स्थिति बताता है और नतीजे, PDF रिपोर्ट और CSV एक्सपोर्ट लौटाता है। साइन किए गए वेबहुक आपके सिस्टम को बताते हैं कि कब कुछ हुआ।
मेरा ATS समर्थित नहीं है। क्या मैं फिर भी उसे जोड़ सकता हूँ?
हाँ, API के ज़रिए: जब उम्मीदवार सही स्टेज पर पहुँचे तो आमंत्रण बनाएँ, उस पर अपनी externalId रखें, और results.ready आने पर नतीजे लाएँ।
क्या उम्मीदवार हमारे करियर पेज पर इंटरव्यू दे सकते हैं?
हाँ, एम्बेड SDK के साथ: इंटीग्रेशन → एम्बेड में अपनी साइट को अनुमति दें, API से आमंत्रण बनाएँ और उसे अपने पेज पर माउंट करें।
क्या नतीजा ATS में उम्मीदवारों को आगे बढ़ाता है?
नहीं। testee कभी किसी उम्मीदवार को आगे नहीं बढ़ाता या अस्वीकार नहीं करता। नोट में कवरेज स्कोर होता है, जिस पर लिखा होता है कि वह समीक्षा के लिए है, भर्ती का फ़ैसला नहीं; फ़ैसला एक इंसान लेता है।
ATS इंटीग्रेशन की चेकलिस्ट में क्या होना चाहिए?
कौन-सी जॉब और स्टेज आमंत्रण भेजती हैं, कुंजियों का मालिक कौन है, वेबहुक कैसे सत्यापित होते हैं, ATS में क्या वापस जाता है, विफलताओं का पता कैसे चलता है, New York City के उम्मीदवारों और सुविधा के अनुरोधों को कैसे सँभाला जाता है, और एक टेस्ट रन।