בקצרה
- שלוש דרכי חיבור: חיבור ATS מובנה, ה-API הציבורי עם webhooks, או הראיון מוטמע בעמוד הקריירה שלכם. אפשר להשתמש ביותר מאחת.
- ATS: מקשרים משרה ושלב ב-Workable, Greenhouse, Teamtailor, Recruitee או Breezy HR לראיון שפורסם. כל מועמד שעובר לשלב הזה מוזמן פעם אחת, והתוצאות חוזרות כהערה.
- API: יוצרים מועמדים והזמנות מהמערכות שלכם עם מפתח API בהרשאות מוגדרות, ומקבלים עדכון על מה שקרה דרך webhooks חתומים.
- הטמעה: מריצים את הראיון בתוך האתר שלכם עם סקריפט אחד, מהאתרים שאתם מאשרים.
- קודם בודקים: שולחים אירוע בדיקה של webhook, מעבירים מועמד ניסיון דרך השלב, וקוראים את יומני המסירה והפעילות לפני העלייה לאוויר.
שלוש דרכים לחבר ראיונות AI
אינטגרציית ATS לראיונות AI חוסכת למגייסים שלכם העתקה והדבקה: המועמדים מוזמנים מהמערכת שאתם כבר משתמשים בה, והתוצאות חוזרות אליה. אם ל-ATS שלכם אין חיבור מובנה, או שאתם מגייסים דרך פורטל משלכם, ה-API הציבורי וההטמעה עושים את אותה עבודה עם מעט קוד.
- חיבור ATS מובנה. Workable, Greenhouse, Teamtailor, Recruitee ו-Breezy HR. בלי קוד: מדביקים מפתח, מקשרים משרה ושלב, והעברת מועמד לשלב הזה שולחת את ההזמנה.
- API ציבורי ו-webhooks. המערכת שלכם יוצרת מועמדים והזמנות דרך REST ומושכת תוצאות; webhooks מודיעים לה כשמשהו קורה.
- SDK להטמעה. סקריפט אחד מריץ את הראיון במסגרת בעמוד הקריירה שלכם. הוא צריך קישור הזמנה, ולכן הוא עובד יחד עם ה-API.
כל שלוש הדרכים מחייבות תוכנית בתשלום ומנהל חברה. הראיון זהה לזה שמועמדים מקבלים מקישור באימייל, כולל האפשרות להקליד במקום לדבר.
בחירה בין ה-ATS, ה-API וההטמעה
| חיבור ATS מובנה | API ציבורי ו-webhooks | SDK להטמעה (עם ה-API) | |
|---|---|---|---|
| מתאים במיוחד ל | צוותים שעובדים עם אחת מחמש מערכות ה-ATS הנתמכות | כל ATS אחר או תהליך עבודה משלכם | עמוד קריירה או פורטל שבשליטתכם |
| נדרש קוד | אין | קריאות API ומקלט webhooks | כמה שורות בדף, ובנוסף ה-API |
| מה שולח את ההזמנה | העברת מועמד לשלב המקושר | קריאת ה-API שלכם | קריאת ה-API שלכם; הקישור מוטמע בדף שלכם |
| התוצאות חוזרות כ | הערה על המועמד ב-ATS | תוצאות שאתם מושכים אחרי webhook התוצאות | אותו דבר; הדף רק יודע שהמועמד סיים |
אם ל-ATS שלכם יש חיבור מובנה, כדאי להתחיל בו. בוחרים ב-API כשצריך שליטה על מי מוזמן ומתי. מוסיפים את ההטמעה כשהמועמדים צריכים להישאר באתר שלכם.
הגדרת אינטגרציית ATS לראיונות AI
חיבור ATS וקישור משרה
- מפרסמים את הראיון. רק ראיון שפורסם אפשר לקשר למשרה.
- פותחים את אינטגרציות ← ATS ולוחצים על חיבור ATS. מדביקים את פרטי הגישה של ה-ATS (איפה למצוא אותם). testee בודקת אותם מול ה-ATS לפני השמירה, ואז שומרת אותם מוצפנים ומציגה רק רמז מוסתר.
- מגדירים את ה-webhook. ב-Workable וב-Breezy HR לא צריך לעשות כלום: testee רושמת אותו. ב-Greenhouse, Teamtailor ו-Recruitee מוסיפים webhook ב-ATS עם הכתובת שבכרטיס ה-Webhook של החיבור, ומחליפים את הסוד כפי שמוסבר בכרטיס.
- מקשרים משרה. לשונית המשרות מציגה את המשרות הפתוחות ב-ATS. פותחים אחת, בוחרים את הראיון שפורסם ואת השלב ששולח את ההזמנה, ושומרים.
- מסמנים משרות בעיר ניו יורק בקישור, כך שההזמנות יכללו את ההודעה שלכם לפי Local Law 144 וייפתחו 10 ימי עסקים לאחר מכן.


מה קורה לכל מועמד
- הזמנה אחת בלבד, לא משנה כמה פעמים ה-ATS שולח את האירוע. אירועים של משרות או שלבים שלא קישרתם מתעלמים מהם.
- שדות קבועים: האימייל והשם של המועמד, המשרה והשלב, והמזהה ב-ATS. אין מיפוי שצריך להגדיר.
- התוצאות כהערה: ציון הכיסוי (לבדיקה, לא החלטת גיוס), הסיכום וקישור לתוצאות. אפשר לכבות את הכתיבה חזרה ל-ATS בכל חיבור בנפרד.
- כשלים: תקלה זמנית מטופלת בניסיונות חוזרים למשך כשמונה שעות; סירוב, למשל כשלא נותרו דקות ראיון, מופיע ביומן.
- זמן נוסף למועמד שביקש זאת מוגדר בדף ההזמנה בלוח הבקרה, עד שהוא מתחיל.
השהיה מעכבת הזמנות והערות עד שממשיכים. אם ה-ATS דוחה את המפתח בהמשך, החיבור מציג "נדרש חיבור מחדש" וההערות ממתינות.
שימוש ב-API וב-webhooks של ראיונות AI
ה-REST API הציבורי עושה את מה שמגייס עושה בלוח הבקרה: מציג את הראיונות שפורסמו, יוצר מועמדים, מזמין אותם ומושך תוצאות. התיעוד המלא נמצא בתיעוד ה-API של ראיונות AI.
מפתחות API
- יוצרים מפתח בתפריט אינטגרציות ← מפתחות API. הסוד (aik_live_…) מוצג פעם אחת בלבד ונשלח כ-bearer token, אף פעם לא בכתובת URL.
- הרשאות (scopes): לכל מפתח נותנים רק את ההרשאות שהמערכת שלו משתמשת בהן, כמו invitations:write ו-results:read.
- רשימת IP מורשים: עד 50 כתובות או טווחים, למשל הכתובות היוצאות של השרתים שלכם.
- תפוגה: 30 יום, 90 יום (ברירת המחדל), שנה, תאריך עד שנתיים קדימה, או ללא תפוגה. הרשימה מזהירה 7 ימים מראש.
- מגבלת קצב: 120 בקשות בדקה לכל מפתח.


הזמנת מועמד מהמערכת שלכם
- GET /v1/interviews מחזיר את רשימת הראיונות שפורסמו.
- POST /v1/candidates עם השם והאימייל. מועמד שני עם אותו אימייל נדחה, לכן כדאי לשמור את ה-id.
- POST /v1/invitations עם שני ה-ids. התגובה מכילה את הקישור, שמוצג פעם אחת; testee גם שולחת אותו למועמד באימייל.
- שולחים כותרת Idempotency-Key בכל POST. ניסיון חוזר עם אותו מפתח אחרי timeout לא יוצר שום דבר פעמיים (המפתחות תקפים 24 שעות).
| שדה אופציונלי בהזמנה | מה הוא עושה |
|---|---|
| externalId | המזהה שלכם (למשל של המועמדות למשרה). הוא חוזר בהזמנה ובכל webhook |
| returnUrl | בסיום, המועמד רואה כפתור שמחזיר לכתובת https הזו (לא בתוך ההטמעה) |
| extraTime | 25, 50 או 100 אחוז יותר זמן למועמד שביקש זאת; ראיון נמשך לכל היותר 60 דקות, כולל זמן נוסף. אף פעם לא מוחזר על ידי ה-API ולא נשלח ב-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. ה-payloads מכילים רק ids ואת ה-externalId שלכם, אף פעם לא שמות או ציונים; ב-results.ready מושכים את התוצאות עם GET /v1/sessions/{id}/results.
- מאמתים כל חתימה: HMAC-SHA256 של חותמת הזמן ושל הגוף הגולמי, עם הסוד של נקודת הקצה כמפתח. משווים בזמן קבוע ודוחים חותמות זמן ישנות מ-5 דקות (קוד בתיעוד ה-webhooks).
- עונים ב-2xx תוך 10 שניות. כשלים נשלחים שוב עם השהיה הולכת וגדלה למשך כ-24 שעות.
- יש לצפות לכפילויות ולכל סדר: מדלגים על מזהה אירוע שכבר טופל, וקוראים את המצב הנוכחי מה-API.
הטמעת הראיון בעמוד הקריירה שלכם
הטמעת ראיון בעמוד הקריירה משאירה את המועמדים באתר שלכם: סקריפט אחד מציב את הראיון במסגרת ומדווח מה המועמד עושה (תיעוד ה-SDK להטמעה).
הטמעת הראיון
- מאשרים את האתר שלכם בתפריט אינטגרציות ← הטמעה: מקור (origin) https בלי נתיב, עד 20. הראיון לא ייטען במסגרת בשום מקום אחר.
- יוצרים את ההזמנה בשרת שלכם ומעבירים את הקישור שלה לדף. מפתח ה-API אף פעם לא נכנס לדף.
- מטמיעים אותו עם TesteeEmbed.mount: רכיב מכיל, הקישור ופונקציית onEvent. לשונית ההטמעה בלוח הבקרה מציגה את קטע הקוד.
- מטפלים באירועים: ready, login_required, started, completed, feedback_submitted ו-error, כל אחד עם ids בלבד.
דילוג על קוד ההתחברות
כברירת מחדל המועמד מתחבר בתוך המסגרת עם קוד בן 6 ספרות שנשלח אליו באימייל; הדף שלכם אף פעם לא רואה אותו. אם האתר שלכם כבר חיבר את המועמד, יוצרים את ההזמנה דרך ה-API עם skipSignIn, והקישור לבדו פותח את הראיון. אי אפשר להגדיר זאת מלוח הבקרה.
- המחיר: הקישור הופך למפתח היחיד, כך שכל מי שמחזיק בו יכול לעבור את הראיון. כדאי להגביל את התפוגה ליום או יומיים, ליצור את ההזמנה רגע לפני שהמועמד מתחיל, ולהציג אותה רק מאחורי ההתחברות שלכם.
- בתיעוד: ההזמנה מציגה "ההתחברות דולגה", והתוצאות מציינות שהזהות אומתה על ידי האתר של החברה שלכם.
בדיקה לפני העלייה לאוויר
הרצת ניסיון
- משתמשים במועמד ניסיון עם אימייל שאפשר לקרוא; תצוגות מקדימות של חברי הצוות לא שולחות webhooks.
- שולחים אירוע בדיקה של webhook מהתפריט של נקודת הקצה: test.ping חתום, כך שהוא בודק גם את קוד אימות החתימה שלכם.
- קוראים את יומן המסירה בדף של נקודת הקצה. שליחה חוזרת (Replay) שולחת מסירה שוב עם אותו id, וכך בודקת שאתם מדלגים על כפילויות.
- מעבירים את המועמד לשלב המקושר ובודקים את לשונית הפעילות של חיבור ה-ATS: כל אירוע, הזמנה והערה מסומנים כהושלם, בניסיון חוזר, נכשל או הושמט.
- עוברים את הראיון ובודקים שהגיע results.ready, או שההערה הופיעה ב-ATS. פתרונות לבעיות נפוצות נמצאים בתיעוד פתרון התקלות של ATS.
הערות אבטחה
- המפתחות נשארים בשרת, אחד לכל מערכת, רק עם ההרשאות שהיא צריכה, רשימת IP מורשים ותפוגה. מבטלים מפתח שיש חשד שדלף.
- קודם מאמתים, אחר כך סומכים: דוחים webhooks שהחתימה או חותמת הזמן שלהם לא עוברות אימות, וקוראים את הנתונים מה-API.
- מאשרים רק את האתרים שלכם להטמעה.
- קישורי הזמנה הם אישיים: אף פעם לא רושמים אותם ביומנים ולא משתפים אותם, במיוחד עם skipSignIn.
התראות Slack
בתפריט אינטגרציות ← Slack מתחברים עם "הוספה ל-Slack" או עם incoming webhook, בוחרים אילו התראות לפרסם, כמו "התוצאות מוכנות", ושולחים הודעת בדיקה (תיעוד Slack).
סיכום
- אם אתם עובדים עם אחת מחמש מערכות ה-ATS הנתמכות, השתמשו בחיבור המובנה: קשרו כל משרה ושלב לראיון שפורסם.
- אחרת, השתמשו ב-API עם מפתחות בהרשאות מוגדרות ועם תפוגה ועם כותרות Idempotency-Key, ואמתו כל webhook.
- כדי להשאיר את המועמדים באתר שלכם, הוסיפו את ההטמעה, ודלגו על קוד ההתחברות רק מאחורי ההתחברות שלכם.
- לפני העלייה לאוויר, הריצו מועמד ניסיון אחד מתחילה ועד סוף.
שאלות ותשובות
האם testee משתלבת עם Greenhouse או עם Workable?
כן, באופן מובנה, וגם עם Teamtailor, Recruitee ו-Breezy HR. מקשרים משרה ושלב לראיון שפורסם; כל מועמד שעובר לשלב הזה מוזמן פעם אחת, והתוצאות חוזרות כהערה.
האם יש API לראיונות AI?
כן. ה-REST API יוצר מועמדים והזמנות, מדווח על הסטטוס שלהם ומחזיר תוצאות, דוחות PDF וייצואי CSV. webhooks חתומים מודיעים למערכת שלכם כשמשהו קורה.
ה-ATS שלי לא נתמך. אפשר בכל זאת לחבר אותו?
כן, דרך ה-API: יוצרים את ההזמנה כשהמועמד מגיע לשלב הנכון, שומרים עליה את ה-externalId שלכם, ומושכים את התוצאות כשמגיע results.ready.
האם מועמדים יכולים לעבור את הראיון בעמוד הקריירה שלנו?
כן, עם ה-SDK להטמעה: מאשרים את האתר שלכם בתפריט אינטגרציות ← הטמעה, יוצרים את ההזמנה עם ה-API ומטמיעים אותה בדף שלכם.
האם התוצאה מקדמת מועמדים ב-ATS?
לא. testee אף פעם לא מעבירה או דוחה מועמד. ההערה כוללת את ציון הכיסוי, שמסומן לבדיקה ולא כהחלטת גיוס; אדם מחליט.
מה צריך להיות ברשימת תיוג לאינטגרציית ATS?
אילו משרות ושלבים שולחים הזמנות, מי אחראי על המפתחות, איך webhooks מאומתים, מה חוזר ל-ATS, איך מזהים כשלים, איך מטפלים במועמדים מהעיר ניו יורק ובבקשות להתאמות, והרצת ניסיון.