TalentApproved

3 API-вызова для передачи оценок ATS в HR и разработку

3 API-вызова для передачи оценок ATS в HR и разработку

Отдавайте предпочтение нативному API оценки, если ваша система отслеживания кандидатов его предоставляет. Если нет — используйте интеграцию на уровне системы учёта или единый API оценки. В любом случае предусмотрите три ключевых действия: получение списка доступных тестовых пакетов, запуск оценки для кандидата и синхронизацию результатов через вебхуки. Расширенные возможности или доступ к интеграции в целом могут быть доступны только на платном или партнёрском уровне.

Кратко:

  • Нативные API оценки обеспечивают наилучший опыт для рекрутеров, позволяя фильтровать и ранжировать кандидатов по структурированным баллам прямо в ATS.
  • Когда API оценки недоступен, резервные интеграции прикрепляют результаты в виде заметок или файлов, что ограничивает возможность фильтрации и сортировки результатов кандидатов.
  • Рекомендуемая последовательность интеграции включает получение пакетов, запуск оценок и получение результатов через вебхуки с акцентом на надёжную идентификацию и корректную обработку кодов ответа.
  • Работодатели обязаны проверять и документировать инструменты оценки на предмет справедливости и соответствия законодательству до их внедрения, обеспечивая хранение результатов с журналом аудита и фиксацию согласия кандидатов.
  • Тщательное тестирование интеграции в тестовой среде и отслеживание успешности вебхуков помогают предотвратить ошибки и появление «потерянных» результатов в реальном процессе найма.
Talent Approved
Оценивайте навыки глубже, чем позволяет резюме
Talent Approved помогает работодателям создавать индивидуальные оценки навыков, анализировать структурированные результаты и принимать более взвешенные решения о найме.
Перейти на Talent Approved

Содержание

Нативные API, резервные интеграции и единые API оценки

Три паттерна интеграции охватывают практически любой стек инструментов найма, и каждый из них определяет, что рекрутеры видят внутри ATS.

Нативный API оценки — наиболее чистый вариант. Он предоставляет тестовые пакеты, задания и структурированные результаты непосредственно в записи ATS, что позволяет рекрутерам фильтровать и ранжировать кандидатов по баллам так же, как они фильтруют по этапу или источнику. Документация для разработчиков Ashby описывает это как стандартную схему: получить список пакетов, запустить оценку и записать результаты через вебхук.

Когда ATS не имеет специальных эндпоинтов для оценки, команды прибегают к резервному варианту: прослушивают события смены этапа и прикрепляют результаты в виде заметок, ссылок или загруженных файлов. Это сохраняет базовое покрытие, но лишает данные структурированной оценки, из-за чего рекрутеры теряют возможность сортировать или фильтровать результаты внутри ATS, согласно руководству по интеграции Kombo.

Единый API оценки занимает промежуточное положение. Он стандартизирует пакеты, вебхуки заданий и обратную запись результатов сразу для множества платформ ATS, поэтому вендор выполняет интеграцию один раз и получает доступ к десяткам систем, вместо того чтобы создавать и поддерживать отдельный коннектор для каждой из них, — как описано в обзоре единого API оценки.

  • Нативный API: лучший опыт для рекрутеров, привязан к одному ATS.
  • Резервная интеграция: наибольший охват, слабейшая оценка внутри ATS.
  • Единый API: меньше долгосрочных затрат на поддержку для вендоров, работающих с несколькими ATS.

Построение интеграции: пошаговый чеклист

Прежде чем писать какой-либо код, убедитесь, что ATS действительно предоставляет API оценки, и изучите документацию для разработчиков. Многие платформы публикуют только общие эндпоинты для кандидатов или заявок, и использование их в качестве эндпоинтов оценки — распространённая ошибка на раннем этапе.

  1. Сначала сопоставьте идентификаторы. Используйте ID заявки или UUID кандидата в каждом вызове, чтобы результаты прикреплялись к нужной записи, а не оказывались «потерянными» — эта ловушка упоминается в руководстве по интеграции JobCannon.
  2. Выберите схему аутентификации. Большинство платформ используют API-ключи, партнёрские ключи или OAuth, и каждый вариант требует собственной политики безопасного хранения и ротации.
  3. Следуйте стандартной последовательности вызовов. Получите список пакетов с помощью assessment.list, запустите тест через assessment.start, затем прослушайте вебхук, срабатывающий по завершении, и запишите результат обратно.
  4. Обрабатывайте задокументированные коды ответа. Справочник Ashby API для assessment.start перечисляет 200, 409 и 422 как типичные ответы, и ваша интеграция должна иметь определённое поведение для каждого из них.
  5. Определите формат полезной нагрузки с результатами. Предусмотрите итоговые баллы, частичные оценки, временны́е метки, вложения и любые пользовательские атрибуты, по которым ваша команда захочет фильтровать данные в дальнейшем.
  6. Планируйте ограничения по частоте запросов. Заранее запрашивайте увеличение квот перед периодами активного найма, чтобы поток приглашений кандидатам не спровоцировал ошибки 429 в разгар кампании.

Совет профессионала: Храните ID заявки вместе с каждой входящей и исходящей полезной нагрузкой, в том числе в логах — это позволит легко отследить неудавшийся вебхук до конкретного кандидата.

Работодатели, а не вендоры, несут юридическую ответственность за тестирование при трудоустройстве. Руководство EEOC по тестам при трудоустройстве и процедурам отбора чётко указывает, что инструменты отбора должны быть валидированы и соответствовать требованиям должности, а работодатели остаются ответственными за непропорциональное воздействие даже в случае, если тест разработан третьей стороной. Перед интеграцией инструмента любого вендора в реальный процесс найма запрашивайте документацию по валидации. Наша статья о руководящих принципах тестирования EEOC подробно разбирает требования UGESP.

  • Перед запуском запрашивайте у любого вендора оценок документацию по валидации и анализу неблагоприятного воздействия.
  • Храните результаты оценок с чётким журналом аудита и определённым сроком хранения — не бессрочно.
  • Уточняйте у вендоров, как они фиксируют согласие на проведение проктоинга или видеонаблюдение и применимо ли в данном случае оценочное воздействие на защиту данных.
  • Документируйте процесс проверки валидации, проводите пилотную проверку справедливости на ранних результатах и сохраняйте соответствующие свидетельства.

Наш сборник рекомендаций по тестированию на неблагоприятное воздействие рассказывает, как провести такой пилотный анализ и что исправить, если показатели выглядят неравномерно.

Выбор между нативной интеграцией, единым API и индивидуальной разработкой

Прежде чем тратить инженерные ресурсы, вместе с руководителями HR и разработки пройдитесь по краткому чеклисту.

  • Уточните, какие функции ATS поддерживает нативно, а какие требуют обходных решений.
  • Спросите у любого вендора оценок, поддерживают ли они уже ваш ATS, и предусмотрена ли за партнёрское подключение плата или требование подписки — некоторые платформы ограничивают доступ к модулям интеграции на более высоких тарифах, согласно сравнению платформ оценки от Coderbyte.
  • Убедитесь, что обратная запись включает структурированные баллы, а не просто ссылку или вложение, чтобы рекрутеры могли фильтровать по результату.
  • Заранее определите требования к надёжности вебхуков и повторным попыткам, и назначьте ответственных за мониторинг с обеих сторон.
  • Убедитесь, что вендор может предоставить документацию по валидации, средства защиты от мошенничества и соглашение об обработке данных.

Совет профессионала: Перед подписанием любых договорённостей запросите доступ к песочнице. Вендор, который не может продемонстрировать сквозное срабатывание тестового вебхука, не готов к работе в вашей производственной среде.

Сквозное тестирование интеграции и раннее выявление сбоев

Тестовая среда должна имитировать полный жизненный цикл до того, как её коснётся хоть один реальный кандидат: создайте тестовое задание, запустите вебхук вручную и убедитесь, что результат корректно отображается в интерфейсе ATS, а не только в записи базы данных.

  1. Проводите тесты в тестовой среде, охватывающие получение списка пакетов, создание задания и обратную запись результатов на основе реалистичных тестовых данных.
  2. Отслеживайте показатели успешности вебхуков и тенденции ошибок, создайте сверочный отчёт, который фиксирует «потерянные» результаты до их накопления.
  3. Используйте идентификаторы корреляции в каждом запросе, чтобы тикет в службу поддержки можно было отследить в обеих системах за минуты, а не часы.
  4. Реализуйте идемпотентную логику повторных попыток, чтобы повторно отправленный вебхук никогда не создавал дублирующий результат, и держите наготове скрипт для заполнения пропущенных событий.
  5. Напишите краткий операционный регламент с указанием того, кто получает уведомление при сбое вебхука и как безопасно перезапустить зависшее задание.

Место Talent Approved в интеграции с ATS

Платформа Talent Approved включает функцию, которая генерирует ролевые оценки на основе описаний вакансий или списков навыков, а также антимошеннический мониторинг и краткие резюме на основе ИИ, ускоряющие процесс проверки. На стороне интеграции Talent Approved следует тому же жизненному циклу — список, запуск и обратная запись, — описанному выше; привязка ID заявки или UUID кандидата к каждому вызову обеспечивает корректное сопоставление результатов с нужной записью ATS. Ценовая модель — оплата по факту: $5 за каждого завершившего оценку кандидата, без необходимости подписки. Команды, реализующие интеграцию, также могут ознакомиться с нашим руководством о том, как работают мгновенные оценки, и нашими ресурсами по соответствию требованиям EEOC для получения сведений о внедрении и валидации.

Место Talent Approved в интеграции с ATS — обзорная диаграмма

Типичные ошибки HR-команд при интеграции с ATS

Типичные ошибки HR-команд при интеграции с ATS — обзорная диаграмма

Большинство команд относятся ко всем API ATS одинаково, а затем удивляются, когда их «интеграция оценки» оказывается лишь прослушивателем смены этапа без какой-либо структурированной оценки. Решение — не дополнительные инженерные часы. Решение — в первый же день проверить, существует ли реальный API оценки вообще.

Начните с небольшого пилота на одной открытой вакансии, прежде чем затрагивать весь процесс найма. Наблюдайте за двумя вещами одновременно: действительно ли рекрутеры используют фильтрацию по баллам, и не выявляют ли ранние результаты разрыва в справедливости между группами кандидатов. Когда нативный API оценки или проверенный единый API доступен — выбирайте его. Опыт рекрутеров и правовая защищённость одинаково зависят от структурированных, поддающихся фильтрации результатов, а не от обходного решения, пристёгнутого к API общего назначения.

— Jimmie

Документация для разработчиков и руководства по соответствию требованиям, достойные закладки

Держите под рукой документацию по интеграции оценок Ashby, обзор единого API оценки и руководство EEOC по тестированию. По вопросам инженерной поддержки интеграции компании, специализирующиеся на реализации API и вебхуков, такие как Ampersand, готовы оказать помощь.

Источники

Часто задаваемые вопросы

Что означает интеграция с ATS?

Интеграция с ATS означает подключение системы отслеживания кандидатов к другому инструменту, например платформе оценки, чтобы данные передавались между ними автоматически, а не копировались вручную. Применительно к оценкам это означает получение тестовых пакетов, запуск теста для кандидата и запись результата обратно в его запись в ATS.

Какие ATS-системы считаются лучшими?

Единого официального рейтинга лучших платформ ATS не существует, а правильный выбор зависит от размера компании, объёма найма и необходимых интеграций. Вместо того чтобы называть конкретных вендоров, HR-командам следует оценивать любой ATS прежде всего по наличию задокументированного API оценки — как описано в документации для разработчиков Ashby, — а не ориентироваться на общие рейтинги популярности.

В чём разница между ATS и CRM?

ATS управляет процессом найма на открытые вакансии, отслеживая кандидатов от подачи заявки до оффера. CRM для рекрутинга, напротив, управляет долгосрочными отношениями с потенциальными кандидатами, в том числе теми, кто в данный момент не проходит активный отбор, — это принципиально иная задача, нежели отслеживание активных соискателей в воронке найма.

Как расшифровывается ATS?

ATS расшифровывается как applicant tracking system (система отслеживания кандидатов) — программное обеспечение, которое HR-команды используют для публикации вакансий, сбора заявок и продвижения кандидатов по этапам найма. При наличии специального API оценки она также может запускать тесты навыков и получать структурированные результаты непосредственно в записи кандидата — согласно жизненному циклу интеграции, описанному в справочнике API Ashby.