انتقل إلى المحتوى

ربط مقابلات الذكاء الاصطناعي بنظام تتبع المتقدمين أو الواجهة البرمجية أو صفحة الوظائف.

تكامل مقابلات الذكاء الاصطناعي مع نظام تتبع المتقدمين، أو الواجهة البرمجية العامة مع Webhooks، أو المقابلة مضمّنة في صفحة الوظائف لديك: ما يفعله كلٌّ منها، وكيف تختار، وكيف تُعدّه وتختبره.

تاريخ التحديث 17 نوفمبر 2026 · قراءة 9 دقائق

في هذه الصفحة

باختصار

  • ثلاثة مداخل: اتصال أصلي بنظام تتبع المتقدمين، أو الواجهة البرمجية العامة مع Webhooks، أو المقابلة مضمّنة في صفحة الوظائف لديك. ويمكنك استخدام أكثر من واحد.
  • نظام تتبع المتقدمين: اربط وظيفة ومرحلة في Workable أو Greenhouse أو Teamtailor أو Recruitee أو Breezy HR بمقابلة منشورة. فيُدعى كل مرشح يُنقل إلى تلك المرحلة مرة واحدة، وتعود النتائج كملاحظة.
  • الواجهة البرمجية: أنشئ المرشحين والدعوات من أنظمتك الخاصة بمفتاح API محدد الصلاحيات، واعرف ما حدث عبر Webhooks موقّعة.
  • التضمين: شغّل المقابلة داخل موقعك بسكربت واحد، من المواقع التي تسمح لها.
  • اختبر أولًا: أرسل حدث Webhook تجريبيًا، وانقل مرشحًا تجريبيًا عبر المرحلة، واقرأ سجلات التسليم والنشاط قبل الإطلاق الفعلي.

ثلاث طرق لربط مقابلات الذكاء الاصطناعي

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

  • اتصال أصلي بنظام تتبع المتقدمين. Workable وGreenhouse وTeamtailor وRecruitee وBreezy HR. بلا كود: الصق مفتاحًا، واربط وظيفة ومرحلة، ونقلُ المرشح إلى تلك المرحلة يُرسل الدعوة.
  • الواجهة البرمجية العامة وWebhooks. يُنشئ نظامك المرشحين والدعوات عبر REST ويجلب النتائج؛ وتُعلمه Webhooks حين يحدث شيء ما.
  • حزمة SDK للتضمين. سكربت واحد يشغّل المقابلة داخل إطار في صفحة الوظائف لديك. ويحتاج إلى رابط دعوة، لذا يُستخدم مع الواجهة البرمجية.
فيديو تعليمي، 3:16. ربط Greenhouse ووصل مرحلة إحدى الوظائف بمقابلة، ثم Slack، ومفتاح API، وخطاف ويب. باللغة الإنجليزية، مع ترجمة مكتوبة.

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

الاختيار بين نظام تتبع المتقدمين والواجهة البرمجية والتضمين

اتصال أصلي بنظام تتبع المتقدمينالواجهة البرمجية العامة وWebhooksحزمة SDK للتضمين (مع الواجهة البرمجية)
الأنسب لـالفرق التي تستخدم أحد أنظمة تتبع المتقدمين الخمسة المدعومةأي نظام آخر لتتبع المتقدمين أو سير عملك الخاصصفحة وظائف أو بوابة تتحكم فيها
الكود المطلوبلا شيءاستدعاءات للواجهة البرمجية ومستقبِل لـ Webhooksبضعة أسطر في الصفحة، إضافة إلى الواجهة البرمجية
ما الذي يُرسل الدعوةنقل المرشح إلى المرحلة المرتبطةاستدعاؤك للواجهة البرمجيةاستدعاؤك للواجهة البرمجية؛ ويُثبَّت الرابط في صفحتك
تعود النتائج على شكلملاحظة على المرشح في نظام تتبع المتقدميننتائج تجلبها بعد Webhook النتائجالشيء نفسه؛ والصفحة تعرف فقط أن المرشح انتهى

ابدأ بالاتصال الأصلي إن كان نظام تتبع المتقدمين لديك يدعمه. واختر الواجهة البرمجية حين تحتاج إلى التحكم في من يُدعى ومتى. وأضف التضمين حين ينبغي أن يبقى المرشحون في موقعك.

إعداد تكامل مقابلات الذكاء الاصطناعي مع نظام تتبع المتقدمين

اربط نظام تتبع المتقدمين واربط وظيفة

  1. انشر المقابلة. لا يمكن ربط وظيفة إلا بمقابلة منشورة.
  2. افتح التكاملات ← ATS واضغط «ربط ATS». الصق بيانات اعتماد نظام تتبع المتقدمين (أين تجدها). يجرّبها testee مع النظام قبل الحفظ، ثم يخزّنها مشفّرة ولا يعرض منها سوى تلميح مُقنَّع.
  3. أعدّ الـ Webhook. لا يحتاج Workable وBreezy HR إلى شيء: يسجّله testee بنفسه. أما في Greenhouse وTeamtailor وRecruitee، فأضف Webhook في نظام تتبع المتقدمين بالعنوان الظاهر في بطاقة Webhook الخاصة بالاتصال، وتبادل السر كما توضّح البطاقة.
  4. اربط وظيفة. تعرض علامة تبويب الوظائف الوظائف المفتوحة في نظام تتبع المتقدمين. افتح إحداها، واختر المقابلة المنشورة والمرحلة التي تُرسل الدعوة، ثم احفظ.
  5. ضع علامة على وظائف مدينة نيويورك في الربط، لتحمل الدعوات إشعارك الخاص بـ Local Law 144 وتُفتح بعد 10 أيام عمل.
اتصال Workable: إعداداته، والـ webhook، والوظائف المرتبطة بالمقابلات.
اتصال Workable: إعداداته، وبطاقة Webhook، ووظائف مرتبطة كلٌّ منها بمقابلة منشورة.

ما الذي يحدث لكل مرشح

  • يُدعى مرة واحدة، مهما تكرر إرسال نظام تتبع المتقدمين للحدث. وتُتجاهل أحداث الوظائف أو المراحل التي لم تربطها.
  • حقول ثابتة: البريد الإلكتروني للمرشح واسمه، والوظيفة والمرحلة، والمرجع في نظام تتبع المتقدمين. لا توجد مطابقة حقول تحتاج إلى إعداد.
  • النتائج كملاحظة: درجة التغطية (للمراجعة، لا قرار توظيف)، والملخص، ورابط إلى النتائج. ويمكنك إيقاف الكتابة إلى النظام لكل اتصال على حدة.
  • الإخفاقات: تُعاد المحاولة عند انقطاع الخدمة لمدة ثماني ساعات تقريبًا؛ أما الرفض، كنفاد دقائق المقابلات، فيظهر في السجل.
  • الوقت الإضافي لمرشح طلبه يُضبط في صفحة الدعوة في لوحة التحكم، إلى أن يبدأ المقابلة.

يُعلّق الإيقاف المؤقت الدعوات والملاحظات إلى أن تستأنف. وإذا رفض نظام تتبع المتقدمين المفتاح لاحقًا، يظهر على الاتصال «يلزم إعادة الربط» وتنتظر الملاحظات.

استخدم الواجهة البرمجية لمقابلات الذكاء الاصطناعي وWebhooks

تؤدي واجهة REST البرمجية العامة ما يفعله مسؤول التوظيف في لوحة التحكم: عرض المقابلات المنشورة، وإنشاء المرشحين، ودعوتهم، وجلب النتائج. والمرجع موجود في وثائق الواجهة البرمجية لمقابلات الذكاء الاصطناعي.

مفاتيح API

  • أنشئ مفتاحًا من التكاملات ← مفاتيح API. يُعرض السر (aik_live_…) مرة واحدة ويُرسل كرمز bearer، ولا يوضع أبدًا في عنوان URL.
  • النطاقات: امنح كل مفتاح الصلاحيات التي يستخدمها نظامه فقط، مثل invitations:write وresults:read.
  • قائمة عناوين IP المسموح بها: حتى 50 عنوانًا أو نطاقًا، مثل العناوين الصادرة لخوادمك.
  • انتهاء الصلاحية: 30 يومًا، أو 90 يومًا (الافتراضي)، أو سنة واحدة، أو تاريخ حتى سنتين مقدمًا، أو بلا انتهاء. وتنبّه القائمة قبل 7 أيام.
  • حدّ المعدل: 120 طلبًا في الدقيقة لكل مفتاح.
تبويب مفاتيح API مع مفاتيح نشطة وأخرى ملغاة، وصلاحياتها وقواعد عناوين IP.
علامة تبويب مفاتيح API: صلاحيات كل مفتاح وقواعد IP الخاصة به، مع الإبقاء على المفاتيح الملغاة للتوثيق.

ادعُ مرشحًا من نظامك

  1. GET /v1/interviews يعرض مقابلاتك المنشورة.
  2. POST /v1/candidates مع الاسم والبريد الإلكتروني. يُرفض إنشاء مرشح ثانٍ بالبريد الإلكتروني نفسه، لذا احفظ المعرّف.
  3. POST /v1/invitations مع المعرّفين كليهما. تتضمن الاستجابة الرابط، ويُعرض مرة واحدة؛ ويرسله testee أيضًا إلى المرشح بالبريد الإلكتروني.
  4. أرسل ترويسة Idempotency-Key مع كل طلب POST. فإعادة المحاولة بالمفتاح نفسه بعد انتهاء المهلة لا تُنشئ أي شيء مرتين (تبقى المفاتيح صالحة 24 ساعة).
حقل اختياري في الدعوةوظيفته
externalIdمعرّفك الخاص (طلب التوظيف مثلًا). يعود مع الدعوة وفي كل Webhook
returnUrlبعد الانتهاء، يرى المرشح زرًا للعودة إلى عنوان https هذا (لا داخل التضمين)
extraTimeوقت إضافي بنسبة 25 أو 50 أو 100 بالمئة لمرشح طلبه؛ وتستغرق المقابلة 60 دقيقة كحد أقصى بما في ذلك الوقت الإضافي. لا تعيده الواجهة البرمجية أبدًا ولا يُرسل في Webhooks
nycNoticeالمرشح يقيم في مدينة نيويورك: تحمل الرسالة إشعارك، وتُفتح المقابلة بعد 10 أيام عمل
skipSignInسبق أن سجّل موقعك دخول المرشح: الرابط وحده يفتح المقابلة (انظر التضمين)

Webhooks

أضف نقطة نهاية من التكاملات ← Webhooks: عنوان https عامًا وأحداثه، وهي invitation.created وinvitation.opened وinvitation.resent وinvitation.revoked وinvitation.expired وsession.started وsession.completed وresults.failed وreview.decision_changed وcandidate.erased وresults.ready. لا تحمل البيانات المرسلة سوى المعرّفات وexternalId الخاص بك، ولا تتضمن أبدًا أسماء أو درجات؛ وعند results.ready، اجلب GET /v1/sessions/{id}/results.

  • تحقّق من كل توقيع: وهو HMAC-SHA256 للطابع الزمني والمحتوى الخام، بمفتاح هو سر نقطة النهاية. قارن في زمن ثابت وارفض الطوابع الزمنية الأقدم من 5 دقائق (الكود في وثائق Webhooks).
  • أجب برمز 2xx خلال 10 ثوانٍ. تُعاد محاولة الإخفاقات مع فواصل متزايدة لمدة 24 ساعة تقريبًا.
  • توقّع التكرار وأي ترتيب: تجاوز معرّف أي حدث سبق أن عالجته، واقرأ الحالة الحالية من الواجهة البرمجية.

ضمّن المقابلة في صفحة الوظائف لديك

يُبقي تضمين المقابلة في صفحة الوظائف المرشحين في موقعك: سكربت واحد يضع المقابلة في إطار ويُبلغ بما يفعله المرشح (وثائق حزمة SDK للتضمين).

ضمّن المقابلة

  1. اسمح لموقعك من التكاملات ← التضمين: أصل https بلا مسار، حتى 20 أصلًا. ولن تُحمَّل المقابلة داخل إطار في أي مكان آخر.
  2. أنشئ الدعوة على خادمك ومرّر رابطها إلى الصفحة. ولا يوضع مفتاح API في الصفحة أبدًا.
  3. ثبّتها باستخدام TesteeEmbed.mount: حاوية، والرابط، ودالة onEvent. وتعرض علامة تبويب التضمين في لوحة التحكم مقتطف الكود.
  4. عالج الأحداث: ready وlogin_required وstarted وcompleted وfeedback_submitted وerror، ولا يحمل كلٌّ منها سوى المعرّفات.

تخطي رمز تسجيل الدخول

افتراضيًا، يسجّل المرشح الدخول داخل الإطار برمز من 6 أرقام يُرسل إليه بالبريد الإلكتروني؛ ولا تراه صفحتك أبدًا. وإذا كان موقعك قد سجّل دخول المرشح بالفعل، فأنشئ الدعوة عبر الواجهة البرمجية مع skipSignIn، وسيفتح الرابط وحده المقابلة. ولا يمكن ضبط ذلك من لوحة التحكم.

  • المقايضة: يصبح الرابط المفتاح الوحيد، فيستطيع أي شخص يملكه إجراء المقابلة. اجعل مدة الصلاحية يومًا أو يومين، وأنشئ الدعوة قبيل بدء المرشح مباشرةً، ولا تعرضها إلا خلف تسجيل الدخول الخاص بك.
  • في السجل: تُظهر الدعوة «تم تخطي تسجيل الدخول»، وتذكر النتائج أن الهوية تحقّق منها موقع شركتك.

اختبر قبل الإطلاق الفعلي

تشغيل تجريبي

  1. استخدم مرشحًا تجريبيًا ببريد إلكتروني يمكنك قراءته؛ فالمعاينات التي يجريها أعضاء الفريق لا تُرسل أي Webhooks.
  2. أرسل حدث Webhook تجريبيًا من قائمة نقطة النهاية: حدث test.ping موقّع، فيختبر كود التحقق من التوقيع لديك أيضًا.
  3. اقرأ سجل التسليم في صفحة نقطة النهاية. يرسل زر إعادة الإرسال التسليم مرة أخرى بالمعرّف نفسه، ما يختبر أنك تتجاوز التكرارات.
  4. انقل المرشح إلى المرحلة المرتبطة وتحقّق من علامة تبويب النشاط في اتصال نظام تتبع المتقدمين: كل حدث ودعوة وملاحظة إما منجز، أو قيد إعادة المحاولة، أو فاشل، أو متجاهَل.
  5. أجرِ المقابلة وتحقّق من وصول results.ready، أو من ظهور الملاحظة في نظام تتبع المتقدمين. وتجد حلول المشكلات الشائعة في وثائق استكشاف أخطاء نظام تتبع المتقدمين وإصلاحها.

ملاحظات أمنية

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

إشعارات Slack

من التكاملات ← Slack، اربط عبر «إضافة إلى Slack» أو Webhook وارد، واختر الإشعارات التي تُنشر، مثل «النتائج جاهزة»، وأرسل رسالة تجريبية (وثائق Slack).

الخلاصة

  • إذا كنت تستخدم أحد أنظمة تتبع المتقدمين الخمسة المدعومة، فاستخدم الاتصال الأصلي: اربط كل وظيفة ومرحلة بمقابلة منشورة.
  • وإلا، فاستخدم الواجهة البرمجية بمفاتيح محددة الصلاحيات ومنتهية الصلاحية وترويسات Idempotency-Key، وتحقّق من كل Webhook.
  • لإبقاء المرشحين في موقعك، أضف التضمين، ولا تتخطَّ رمز تسجيل الدخول إلا خلف تسجيل الدخول الخاص بك.
  • قبل الإطلاق الفعلي، شغّل مرشحًا تجريبيًا واحدًا من البداية إلى النهاية.

أسئلة وأجوبة

هل يتكامل testee مع Greenhouse أو Workable؟

نعم، تكاملًا أصليًا، وكذلك مع Teamtailor وRecruitee وBreezy HR. تربط وظيفة ومرحلة بمقابلة منشورة؛ فيُدعى كل مرشح يُنقل إلى تلك المرحلة مرة واحدة، وتعود النتائج كملاحظة.

هل توجد واجهة برمجية لمقابلات الذكاء الاصطناعي؟

نعم. تُنشئ واجهة REST البرمجية المرشحين والدعوات، وتُبلغ عن حالتها، وتعيد النتائج وتقارير PDF وملفات تصدير CSV. وتُعلم Webhooks الموقّعة نظامك حين يحدث شيء ما.

نظام تتبع المتقدمين لدي غير مدعوم. هل يمكنني ربطه مع ذلك؟

نعم، عبر الواجهة البرمجية: أنشئ الدعوة حين يصل المرشح إلى المرحلة المناسبة، واحفظ externalId الخاص بك عليها، واجلب النتائج عند وصول results.ready.

هل يمكن للمرشحين إجراء المقابلة في صفحة الوظائف لدينا؟

نعم، باستخدام حزمة SDK للتضمين: اسمح لموقعك من التكاملات ← التضمين، وأنشئ الدعوة عبر الواجهة البرمجية، وثبّتها في صفحتك.

هل تنقل النتيجة المرشحين إلى المرحلة التالية في نظام تتبع المتقدمين؟

لا. لا ينقل testee أي مرشح ولا يرفضه أبدًا. تحمل الملاحظة درجة التغطية، موسومة بأنها للمراجعة لا قرار توظيف؛ والقرار لشخص.

ما الذي ينبغي أن تتضمنه قائمة التحقق لتكامل نظام تتبع المتقدمين؟

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

المصادر

  1. وثائق المطورين لـ testee: تكاملات أنظمة تتبع المتقدمين
  2. وثائق المطورين لـ testee: واجهة REST البرمجية
  3. وثائق المطورين لـ testee: Webhooks
  4. وثائق المطورين لـ testee: حزمة SDK للتضمين
  5. وثائق المطورين لـ testee: Slack
  6. مواصفة Standard Webhooks
  7. RFC 2104، HMAC: Keyed-Hashing for Message Authentication

جرّبه علىوظيفتك القادمة.

أنشئ مقابلة منظمة بالذكاء الاصطناعي من الوصف الوظيفي لديك في دقائق.14 يومًا مجانًا، دون بطاقة.