مختصراً
- جڑنے کے تین طریقے: براہِ راست 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 کے ساتھ) | |
|---|---|---|---|
| کس کے لیے بہترین | پانچ معاون ATSs میں سے کسی ایک پر کام کرنے والی ٹیمیں | کوئی بھی دوسرا 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 کی کھلی جابز کی فہرست ہوتی ہے۔ ایک کھولیں، شائع شدہ انٹرویو اور وہ مرحلہ چنیں جو دعوت نامہ بھیجتا ہے، اور محفوظ کریں۔
- نیویارک سٹی کی جابز نشان زد کریں لنک پر، تاکہ دعوت ناموں میں آپ کی Local Law 144 کی اطلاع شامل ہو اور وہ 10 کاروباری دن بعد کھلیں۔


ہر امیدوار کے لیے کیا ہوتا ہے
- صرف ایک بار دعوت، چاہے ATS کتنی ہی بار ایونٹ بھیجے۔ جن جابز یا مراحل کو آپ نے لنک نہیں کیا ان کے ایونٹس نظر انداز کر دیے جاتے ہیں۔
- مقررہ فیلڈز: امیدوار کی ای میل اور نام، جاب اور مرحلہ، اور ATS کا حوالہ۔ کوئی میپنگ ترتیب دینے کی ضرورت نہیں۔
- نتائج بطور نوٹ: کوریج اسکور (جائزے کے لیے، بھرتی کا فیصلہ نہیں)، خلاصہ اور نتائج کا لنک۔ آپ ہر کنکشن کے لیے واپس لکھنا بند کر سکتے ہیں۔
- ناکامیاں: سروس بند ہونے پر تقریباً آٹھ گھنٹے تک دوبارہ کوشش کی جاتی ہے؛ انکار، جیسے انٹرویو منٹس ختم ہو جانا، لاگ میں دکھایا جاتا ہے۔
- اضافی وقت درخواست کرنے والے امیدوار کے لیے ڈیش بورڈ میں دعوت نامے کے صفحے پر مقرر کیا جاتا ہے، جب تک وہ شروع نہ کرے۔
روکنے پر دعوت نامے اور نوٹس تب تک رکے رہتے ہیں جب تک آپ دوبارہ شروع نہ کریں۔ اگر بعد میں ATS کی کو مسترد کر دے، تو کنکشن پر "دوبارہ منسلک کرنا ضروری ہے" دکھائی دیتا ہے اور نوٹس انتظار کرتے ہیں۔
AI انٹرویو API اور ویب ہکس استعمال کریں
پبلک REST API وہی کرتی ہے جو ریکروٹر ڈیش بورڈ میں کرتا ہے: شائع شدہ انٹرویوز کی فہرست، امیدوار بنانا، انہیں دعوت دینا اور نتائج حاصل کرنا۔ حوالہ AI انٹرویو API دستاویزات میں ہے۔
API کیز
- ایک کی بنائیں انٹیگریشنز ← API کیز میں۔ سیکرٹ (aik_live_…) صرف ایک بار دکھایا جاتا ہے اور bearer ٹوکن کے طور پر بھیجا جاتا ہے، کبھی URL میں نہیں۔
- دائرۂ اختیار (scopes): ہر کی کو صرف وہی اجازتیں دیں جو اس کا نظام استعمال کرتا ہے، جیسے invitations:write اور results:read۔
- IP اجازت فہرست: 50 تک ایڈریس یا رینجز، جیسے آپ کے سرورز کے آؤٹ باؤنڈ ایڈریس۔
- میعاد: 30 دن، 90 دن (ڈیفالٹ)، 1 سال، 2 سال آگے تک کی کوئی تاریخ، یا کبھی نہیں۔ فہرست 7 دن پہلے خبردار کرتی ہے۔
- ریٹ کی حد: فی کی ایک منٹ میں 120 درخواستیں۔


اپنے نظام سے امیدوار کو دعوت دیں
- GET /v1/interviews آپ کے شائع شدہ انٹرویوز کی فہرست دیتا ہے۔
- POST /v1/candidates نام اور ای میل کے ساتھ۔ اسی ای میل والا دوسرا امیدوار مسترد ہو جاتا ہے، اس لیے id محفوظ کر لیں۔
- POST /v1/invitations دونوں ids کے ساتھ۔ جواب میں لنک ہوتا ہے، جو صرف ایک بار دکھایا جاتا ہے؛ testee اسے امیدوار کو ای میل بھی کرتا ہے۔
- Idempotency-Key ہیڈر بھیجیں ہر POST پر۔ ٹائم آؤٹ کے بعد اسی کی کے ساتھ دوبارہ کوشش کچھ بھی دو بار نہیں بناتی (کیز 24 گھنٹے چلتی ہیں)۔
| دعوت نامے کا اختیاری فیلڈ | یہ کیا کرتا ہے |
|---|---|
| externalId | آپ کی اپنی id (مثلاً ملازمت کی درخواست کی)۔ یہ دعوت نامے پر اور ہر ویب ہک میں واپس آتی ہے |
| returnUrl | مکمل کرنے کے بعد امیدوار کو اس https ایڈریس پر واپسی کا بٹن نظر آتا ہے (ایمبیڈ کے اندر نہیں) |
| extraTime | درخواست کرنے والے امیدوار کے لیے 25، 50 یا 100 فیصد اضافی وقت؛ ایک انٹرویو اضافی وقت سمیت زیادہ سے زیادہ 60 منٹ کا ہوتا ہے۔ API کبھی اسے واپس نہیں کرتی اور نہ ویب ہکس میں بھیجا جاتا ہے |
| nycNotice | امیدوار نیویارک سٹی میں رہتا ہے: ای میل میں آپ کی اطلاع شامل ہوتی ہے، اور انٹرویو 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۔ پے لوڈز میں صرف ids اور آپ کی externalId ہوتی ہے، کبھی نام یا اسکور نہیں؛ results.ready پر GET /v1/sessions/{id}/results سے نتائج حاصل کریں۔
- ہر دستخط کی تصدیق کریں: ٹائم اسٹیمپ اور خام باڈی کا HMAC-SHA256، جس کی کلید اینڈ پوائنٹ کا سیکرٹ ہے۔ موازنہ مستقل وقت (constant time) میں کریں اور 5 منٹ سے پرانے ٹائم اسٹیمپ مسترد کریں (ویب ہکس دستاویزات میں کوڈ)۔
- 10 سیکنڈ کے اندر 2xx سے جواب دیں۔ ناکامیوں پر تقریباً 24 گھنٹے تک وقفے بڑھاتے ہوئے دوبارہ کوشش کی جاتی ہے۔
- تکرار اور کسی بھی ترتیب کی توقع رکھیں: جو ایونٹ id آپ نمٹا چکے ہیں اسے چھوڑ دیں، اور موجودہ حالت API سے پڑھیں۔
انٹرویو کو اپنے کیریئرز پیج میں ایمبیڈ کریں
کیریئرز پیج پر انٹرویو کا ایمبیڈ امیدواروں کو آپ کی سائٹ پر رکھتا ہے: ایک اسکرپٹ انٹرویو کو فریم میں رکھتا ہے اور بتاتا ہے کہ امیدوار کیا کرتا ہے (ایمبیڈ SDK دستاویزات)۔
انٹرویو ایمبیڈ کریں
- اپنی سائٹ کی اجازت دیں انٹیگریشنز ← ایمبیڈ میں: بغیر پاتھ کے ایک https اوریجن، 20 تک۔ انٹرویو کسی اور جگہ فریم میں لوڈ نہیں ہوگا۔
- دعوت نامہ اپنے سرور پر بنائیں اور اس کا لنک صفحے کو دیں۔ API کی کبھی صفحے میں نہیں جاتی۔
- اسے ماؤنٹ کریں TesteeEmbed.mount کے ساتھ: ایک کنٹینر، لنک اور ایک onEvent فنکشن۔ ڈیش بورڈ کا ایمبیڈ ٹیب کوڈ کا ٹکڑا دکھاتا ہے۔
- ایونٹس کو سنبھالیں: ready، login_required، started، completed، feedback_submitted اور error، ہر ایک میں صرف ids۔
سائن ان کوڈ چھوڑنا
ڈیفالٹ طور پر امیدوار فریم کے اندر اپنی ای میل پر بھیجے گئے 6 ہندسوں کے کوڈ سے سائن ان کرتا ہے؛ آپ کا صفحہ اسے کبھی نہیں دیکھتا۔ اگر آپ کی سائٹ امیدوار کو پہلے ہی سائن ان کر چکی ہے، تو API کے ذریعے skipSignIn کے ساتھ دعوت نامہ بنائیں، اور صرف لنک سے انٹرویو کھل جائے گا۔ ڈیش بورڈ سے یہ مقرر نہیں ہو سکتا۔
- قیمت یہ ہے: لنک ہی واحد چابی بن جاتا ہے، اس لیے جس کے پاس بھی ہو وہ انٹرویو دے سکتا ہے۔ میعاد ایک دو دن رکھیں، دعوت نامہ امیدوار کے شروع کرنے سے عین پہلے بنائیں، اور اسے صرف اپنے سائن ان کے پیچھے دکھائیں۔
- ریکارڈ میں: دعوت نامے پر "سائن ان چھوڑ دیا گیا" دکھائی دیتا ہے، اور نتائج میں لکھا ہوتا ہے کہ شناخت کی تصدیق آپ کی کمپنی کی سائٹ نے کی۔
لائیو جانے سے پہلے ٹیسٹ کریں
ایک ٹیسٹ رن
- ٹیسٹ امیدوار استعمال کریں ایسی ای میل کے ساتھ جو آپ پڑھ سکیں؛ ٹیم ممبرز کے پیش منظر کوئی ویب ہک نہیں بھیجتے۔
- ویب ہک کا ٹیسٹ ایونٹ بھیجیں اینڈ پوائنٹ کے مینو سے: ایک دستخط شدہ test.ping، اس لیے یہ آپ کے دستخط والے کوڈ کو بھی جانچتا ہے۔
- ڈیلیوری لاگ پڑھیں اینڈ پوائنٹ کے صفحے پر۔ "دوبارہ بھیجیں" اسی id کے ساتھ ڈیلیوری دوبارہ بھیجتا ہے، جس سے جانچ ہوتی ہے کہ آپ تکرار کو چھوڑتے ہیں۔
- امیدوار کو لنک شدہ مرحلے میں منتقل کریں اور ATS کنکشن کا سرگرمی ٹیب دیکھیں: ہر ایونٹ، دعوت نامہ اور نوٹ مکمل، دوبارہ کوشش جاری، ناکام یا نظر انداز ہوتا ہے۔
- انٹرویو دیں اور دیکھیں کہ results.ready پہنچا، یا ATS میں نوٹ ظاہر ہوا۔ عام مسائل کے حل ATS ٹربل شوٹنگ دستاویزات میں ہیں۔
سیکیورٹی نوٹس
- کیز سرور پر رہتی ہیں، ہر نظام کے لیے ایک، صرف ضروری دائرۂ اختیار، IP اجازت فہرست اور میعاد کے ساتھ۔ جس کی کے لیک ہونے کا شبہ ہو اسے منسوخ کریں۔
- پہلے تصدیق، پھر بھروسا: جن ویب ہکس کا دستخط یا ٹائم اسٹیمپ ناکام ہو انہیں مسترد کریں، اور ڈیٹا API سے پڑھیں۔
- صرف اپنی سائٹس کی اجازت دیں ایمبیڈ کے لیے۔
- دعوت نامے کے لنکس ذاتی ہیں: انہیں کبھی لاگ یا شیئر نہ کریں، خاص طور پر skipSignIn کے ساتھ۔
Slack اطلاعات
انٹیگریشنز ← Slack میں، "Slack میں شامل کریں" یا ایک incoming webhook کے ذریعے جوڑیں، چنیں کہ کون سی اطلاعات پوسٹ ہوں، جیسے "نتائج تیار ہیں"، اور ایک ٹیسٹ پیغام بھیجیں (Slack دستاویزات)۔
خلاصہ
- پانچ معاون ATSs میں سے کسی ایک پر ہوں تو، براہِ راست کنکشن استعمال کریں: ہر جاب اور مرحلے کو شائع شدہ انٹرویو سے لنک کریں۔
- ورنہ، محدود دائرے والی، میعادی کیز اور 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 میں کیا واپس جاتا ہے، ناکامیوں کا پتا کیسے چلتا ہے، نیویارک سٹی کے امیدواروں اور سہولت کی درخواستوں کو کیسے نمٹایا جاتا ہے، اور ایک ٹیسٹ رن۔