TalentApproved

3 استدعاءات API لتسليم درجات تقييم ATS لموارد البشرية والهندسة

3 استدعاءات API لتسليم درجات تقييم ATS لموارد البشرية والهندسة

فضّل واجهة برمجة التطبيقات (API) الأصلية للتقييم عندما يوفرها نظام تتبع المتقدمين. وإذا لم يتوفر ذلك، فارجع إلى تكامل سجل النظام الرئيسي أو واجهة API موحدة للتقييم. في كلتا الحالتين، خطط لثلاثة إجراءات أساسية: سرد حزم الاختبارات المتاحة، وتشغيل تقييم لمرشح ما، ومزامنة النتائج عبر الـ webhooks. قد تكون الميزات الأكثر ثراءً أو الوصول إلى التكامل بالكامل مشروطًا بخطة مدفوعة أو مستوى شراكة.

ملخص سريع:

  • توفر واجهات API الأصلية للتقييم أفضل تجربة للمسؤولين عن التوظيف، إذ تتيح تصفية المرشحين وترتيبهم بناءً على درجات منظمة داخل نظام تتبع المتقدمين.
  • عندما لا تتوفر واجهة API للتقييم، تُلحَق النتائج عبر تكاملات بديلة كملاحظات أو ملفات، مما يحدّ من القدرة على تصفية نتائج المرشحين أو فرزها.
  • يتضمن تسلسل التكامل الموصى به سرد الحزم وتشغيل التقييمات والتقاط النتائج عبر الـ webhooks، مع التركيز على التعريف الآمن والتعامل السليم مع رموز الاستجابة.
  • يجب على أصحاب العمل التحقق من صحة أدوات التقييم وتوثيقها للتأكد من عدالتها والامتثال القانوني قبل النشر، وضمان تخزين النتائج مع مسار تدقيق وتسجيل الموافقة.
  • يساعد اختبار التكامل بشكل شامل في بيئة التجهيز وتتبع نجاح الـ webhooks على منع الأخطاء والنتائج المعلقة في مسار التوظيف الفعلي.
Talent Approved
قيّم المهارات ما وراء السيرة الذاتية
تساعد Talent Approved أصحاب العمل على إنشاء تقييمات مهارات مخصصة، ومراجعة النتائج المنظمة، واتخاذ قرارات توظيف أكثر استنارة.
استكشف Talent Approved

جدول المحتويات

واجهات API الأصلية والتكاملات البديلة وواجهات API الموحدة للتقييم

تغطي ثلاثة أنماط تكامل تقريبًا كل مكدس توظيف، ويغير كل منها ما يراه المسؤولون عن التوظيف داخل نظام تتبع المتقدمين.

واجهة API الأصلية للتقييم هي الخيار الأنظف. فهي تعرض حزم الاختبارات والطلبات والنتائج المنظمة مباشرةً داخل سجل نظام تتبع المتقدمين، مما يعني أن المسؤولين عن التوظيف يمكنهم تصفية المرشحين وترتيبهم حسب الدرجة بالطريقة ذاتها التي يصفّون بها حسب المرحلة أو المصدر. توثيق المطورين الخاص بـ Ashby يصف هذا على أنه الشكل المعياري: سرد الحزم، وبدء التقييم، وكتابة النتائج مرة أخرى عبر webhook.

عندما لا يمتلك نظام تتبع المتقدمين نقاط نهاية مخصصة للتقييم، تلجأ الفرق إلى مستمعي تغيير المرحلة وتُلصق النتائج كملاحظات أو روابط أو ملفات مرفوعة. يحافظ هذا على التغطية الأساسية، لكنه يحذف التسجيل المنظم، فيفقد المسؤولون عن التوظيف القدرة على الفرز أو التصفية حسب النتيجة داخل نظام تتبع المتقدمين، وفقًا لـ دليل التكامل الخاص بـ Kombo.

تقع واجهة API الموحدة للتقييم بين الاثنين. فهي توحّد الحزم وـ webhooks الطلبات وكتابة النتائج مرة أخرى عبر منصات متعددة لأنظمة تتبع المتقدمين في آنٍ واحد، بحيث يتكامل البائع مرة واحدة ويصل إلى عشرات الأنظمة بدلاً من بناء موصل منفصل لكل منها وصيانته، كما هو موضح في نظرة عامة على واجهة API الموحدة للتقييم.

  • واجهة API الأصلية: أفضل تجربة للمسؤولين عن التوظيف، مرتبطة بنظام تتبع متقدمين واحد.
  • التكامل البديل: أوسع تغطية، وأضعف تسجيل داخل نظام تتبع المتقدمين.
  • واجهة API الموحدة: صيانة أقل على المدى البعيد للبائعين الذين يخدمون أنظمة تتبع متقدمين متعددة.

بناء التكامل: قائمة مراجعة خطوة بخطوة

قبل كتابة أي كود، تأكد من أن نظام تتبع المتقدمين يكشف فعلاً عن واجهة API للتقييم واسحب وثائق المطور. كثير من المنصات تنشر فقط نقاط نهاية عامة للمرشحين أو الطلبات، والتعامل معها كنقاط نهاية للتقييم خطأ شائع في المراحل المبكرة.

  1. رسم خريطة المعرّفات أولاً. استخدم معرف الطلب أو UUID المرشح في كل استدعاء حتى تُلصق النتائج بالسجل الصحيح بدلاً من أن تصبح معلقة، وهو فخ أشارت إليه إرشادات التكامل الخاصة بـ JobCannon.
  2. اختيار نمط المصادقة. تستخدم معظم المنصات مفاتيح API أو مفاتيح الشركاء أو OAuth، ويتطلب كل منها سياسة تخزين آمن وتدوير خاصة به.
  3. اتباع تسلسل الاستدعاء المعياري. سرد الحزم باستخدام assessment.list، وتشغيل الاختبار باستخدام assessment.start، ثم الاستماع لـ webhook يُطلق عند الاكتمال وكتابة النتيجة مرة أخرى.
  4. التعامل مع رموز الاستجابة الموثقة. تسرد مرجع Ashby API لـ assessment.start الرموز 200 و409 و422 كاستجابات نموذجية، ويحتاج تكاملك إلى سلوك محدد لكل منها.
  5. تحديد حمولة النتائج. خطط للدرجات الإجمالية والدرجات الفرعية والطوابع الزمنية والمرفقات وأي سمات مخصصة تريد فريقك تصفيتها لاحقًا.
  6. التخطيط لحدود المعدل. اطلب زيادة الحصة قبل فترات التوظيف عالية الحجم حتى لا تؤدي موجة من دعوات المرشحين إلى أخطاء 429 في منتصف الحملة.

نصيحة احترافية: خزّن معرف الطلب إلى جانب كل حمولة صادرة وواردة، حتى في السجلات، حتى يسهل تتبع webhook الفاشل إلى مرشح بعينه.

يتحمل أصحاب العمل، لا البائعون، العبء القانوني لاختبارات التوظيف. توضح إرشادات EEOC بشأن اختبارات التوظيف وإجراءات الاختيار أن أدوات الاختيار يجب أن تكون محققةً ومرتبطة بالوظيفة، وأن أصحاب العمل يظلون مسؤولين عن التأثير السلبي غير المتناسب حتى عندما يكون طرف ثالث قد بنى الاختبار. اطلب من أي بائع تقييم وثائق التحقق قبل دمج أدواته في مسار توظيف مباشر. تستعرض مقالتنا الخاصة بإرشادات اختبار EEOC متطلبات UGESP بمزيد من التفصيل.

  • اطلب وثائق التحقق وتأثير الأثر السلبي من أي بائع تقييم قبل الإطلاق.
  • خزّن نتائج التقييم مع مسار تدقيق واضح وفترة احتفاظ محددة، لا إلى أجل غير مسمى.
  • اسأل البائعين عن كيفية تسجيلهم للموافقة على المراقبة أو مراقبة كاميرا الويب، وما إذا كان تقييم أثر حماية البيانات ينطبق.
  • وثّق مراجعة التحقق، وأجرِ فحص عدالة تجريبيًا على النتائج المبكرة، واحتفظ بهذه الأدلة في الملف.

يشرح دليل اختبار التأثير السلبي الخاص بنا كيفية تشغيل تحليل التجربة التمهيدية وما يجب إصلاحه عندما تبدو الأرقام غير متكافئة.

الاختيار بين التكامل الأصلي وواجهة API الموحدة والبناء المخصص

قبل تخصيص وقت هندسي، مرّ عبر قائمة مراجعة قصيرة مع مسؤولي الموارد البشرية والهندسة معًا.

  • تأكد من الميزات التي يدعمها نظام تتبع المتقدمين بشكل أصلي مقابل تلك التي تتطلب حلاً بديلاً.
  • اسأل أي بائع تقييم عما إذا كان يدعم بالفعل نظام تتبع المتقدمين الخاص بك، وما إذا كان إعداد الشراكة يستلزم رسومًا أو اشتراطات اشتراك، إذ تضع بعض المنصات وحدات التكامل خلف مستويات أعلى، وفقًا لمقارنة Coderbyte لتكاملات منصة التقييم.
  • تحقق من أن الكتابة المرتجعة تتضمن درجات منظمة لا مجرد رابط أو مرفق، حتى يتمكن المسؤولون عن التوظيف من التصفية حسب النتيجة.
  • حدد توقعات موثوقية الـ webhook وإعادة المحاولة مسبقًا، وحدد من يتولى المراقبة من كلا الطرفين.
  • تأكد من قدرة البائع على تقديم وثائق التحقق وضوابط مكافحة الغش واتفاقية معالجة البيانات.

نصيحة احترافية: اطلب بيئة اختبار sandbox قبل التوقيع على أي شيء. البائع الذي لا يستطيع إثبات إطلاق webhook اختباري من البداية إلى النهاية ليس مستعدًا لمسار الإنتاج الخاص بك.

اختبار التكامل من البداية إلى النهاية والكشف المبكر عن الأعطال

ينبغي أن تحاكي بيئة التجهيز دورة الحياة الكاملة قبل أن يلمسها أي مرشح فعلي: أنشئ طلبًا تجريبيًا، وشغّل الـ webhook يدويًا، وتأكد من أن النتيجة تظهر بشكل صحيح داخل واجهة مستخدم نظام تتبع المتقدمين، لا فقط في سجل قاعدة البيانات.

  1. شغّل اختبارات التجهيز التي تغطي سرد الحزم وإنشاء الطلبات وكتابة النتائج مرة أخرى مقابل بيانات نموذجية واقعية.
  2. تتبع معدلات نجاح الـ webhook وأنماط الأخطاء، وأنشئ تقرير تسوية يُبرز النتائج المعلقة قبل أن تتراكم.
  3. استخدم معرفات ارتباط في كل طلب حتى يمكن تتبع تذكرة الدعم عبر كلا النظامين في دقائق لا ساعات.
  4. أنشئ منطق إعادة محاولة متكافئًا حتى لا يُنشئ webhook مُعاد إرساله نتيجةً مكررة، واحتفظ بسكريبت ملء الفجوات جاهزًا لأي أحداث فائتة.
  5. اكتب دليل تشغيل قصيرًا يحدد من يتلقى التنبيه عند فشل الـ webhook وكيفية إعادة تشغيل طلب معلق بأمان.

أين تتناسب Talent Approved مع تكامل نظام تتبع المتقدمين

تتضمن منصة Talent Approved ميزةً تُنشئ تقييمات خاصة بالدور من وصف الوظيفة أو قوائم المهارات، إلى جانب مراقبة مكافحة الغش وملخصات مُولَّدة بالذكاء الاصطناعي تُسرّع المراجعة. على صعيد التكامل، تتبع Talent Approved دورة الحياة ذاتها القائمة على السرد والتشغيل والكتابة المرتجعة المشروحة أعلاه، وتعيين معرف الطلب أو UUID المرشح في كل استدعاء يُبقي النتائج مرتبطة بشكل صحيح بسجل نظام تتبع المتقدمين المناسب. نموذج التسعير نفسه يقوم على الدفع مقابل الاستخدام، بقيمة 5 دولارات لكل مرشح مُكمَل، دون الحاجة إلى اشتراك. يمكن للفرق التي تُنفّذ التكامل أيضًا مراجعة دليلنا حول كيفية عمل التقييمات الفورية وموارد الامتثال الخاصة بـ EEOC للحصول على تفاصيل التنفيذ والتحقق.

أين تتناسب Talent Approved مع تكامل نظام تتبع المتقدمين — مخطط نظرة عامة

ما تخطئ فيه فرق الموارد البشرية بشأن تكامل نظام تتبع المتقدمين

ما تخطئ فيه فرق الموارد البشرية بشأن تكامل نظام تتبع المتقدمين — مخطط نظرة عامة

تتعامل معظم الفرق مع كل واجهة API لنظام تتبع المتقدمين بالطريقة ذاتها، ثم تُفاجأ عندما يتبيّن أن "تكامل التقييم" ليس سوى مستمع لتغيير المرحلة دون أي تسجيل منظم مرتبط به. الحل ليس ساعات هندسية أكثر، بل التحقق من اليوم الأول مما إذا كانت واجهة API حقيقية للتقييم موجودة أصلاً.

ابدأ بتجربة تمهيدية صغيرة على دور مفتوح واحد قبل الاقتراب من مسار التوظيف الكامل. راقب أمرين في آنٍ واحد: ما إذا كان المسؤولون عن التوظيف يستخدمون فعلاً تصفية الدرجات، وما إذا كانت النتائج المبكرة تُظهر أي فجوة في العدالة عبر مجموعات المرشحين. عندما تكون واجهة API أصلية للتقييم أو واجهة API موحدة محققة متاحة، اختَرها. تجربة المسؤولين عن التوظيف والقابلية للدفاع القانوني كلتاهما تعتمدان على نتائج منظمة وقابلة للتصفية، لا على حل بديل مُلصق على واجهة API متعددة الأغراض.

— Jimmie

وثائق المطورين وإرشادات الامتثال الجديرة بالإشارة المرجعية

احتفظ بوثائق تكامل تقييمات Ashby ونظرة عامة على واجهة API الموحدة للتقييم وإرشادات اختبار EEOC في متناول يدك. لدعم الهندسة على جانب التكامل، تتخصص شركات مثل Ampersand في أعمال تنفيذ API والـ webhook.

المصادر

الأسئلة الشائعة

ماذا يعني تكامل نظام تتبع المتقدمين؟

يعني تكامل نظام تتبع المتقدمين ربط نظام تتبع المتقدمين بأداة أخرى، مثل منصة التقييم، بحيث تنتقل البيانات تلقائيًا بينهما بدلاً من نسخها يدويًا. بالنسبة للتقييمات تحديدًا، يعني ذلك سرد حزم الاختبارات وتشغيل اختبار لمرشح وكتابة الدرجة مرة أخرى في سجل المرشح في نظام تتبع المتقدمين.

ما هي أبرز أنظمة تتبع المتقدمين؟

لا يوجد تصنيف رسمي واحد لأفضل منصات نظام تتبع المتقدمين، ويعتمد الاختيار الصحيح على حجم الشركة وحجم التوظيف والتكاملات المطلوبة. بدلاً من تسمية بائعين بعينهم، ينبغي لفرق الموارد البشرية تقييم أي نظام تتبع متقدمين بناءً على ما إذا كان يكشف عن واجهة API موثقة للتقييم، كما هو موضح في وثائق مطوري Ashby، بدلاً من الاعتماد على قوائم الشعبية العامة.

ما الفرق بين نظام تتبع المتقدمين وإدارة علاقات العملاء للتوظيف؟

يدير نظام تتبع المتقدمين سير عمل التوظيف للأدوار المفتوحة، وتتبع المرشحين من التقديم حتى العرض. في المقابل، يدير نظام إدارة علاقات العملاء للتوظيف العلاقات طويلة الأمد مع المرشحين المحتملين، بمن فيهم الأشخاص الذين لا يتقدمون بنشاط، وهي مهمة مختلفة عن تتبع المتقدمين النشطين عبر مسار التوظيف.

ما الذي يرمز إليه اختصار ATS؟

يرمز ATS إلى نظام تتبع المتقدمين (Applicant Tracking System)، وهو البرنامج الذي تستخدمه فرق الموارد البشرية لنشر الوظائف وجمع الطلبات وتحريك المرشحين عبر مراحل التوظيف. عندما يدعم واجهة API مخصصة للتقييم، يمكنه أيضًا تشغيل اختبارات المهارات وتلقي النتائج المنظمة مباشرةً على سجل المرشح، وفقًا لدورة حياة التكامل الموضحة في مرجع API الخاص بـ Ashby.