АТС: Создание отклика

Для автоматизации подачи заявок с вашего сайта в ATS следуйте этому алгоритму.

Шаг 1. Поиск вакансии

Найдите нужную вакансию, чтобы получить её job_id и привязанную pipeline_id.

• Метод: POST /api/v1/jobs/search

Шаг 2. Определение этапа воронки

Получите доступные этапы для выбранной воронки и выберите ID этапа, например Новый.

• Метод: GET /api/v1/pipelines/all
• Действие: найдите нужный pipeline_id и выберите stage.id

Шаг 3. Выбор источника

Получите справочник источников, чтобы указать, откуда пришёл отклик.

• Метод: GET /api/v1/sources/all
• Действие: сохраните нужный source_id

Шаг 4. Загрузка файла резюме

Загрузите файл резюме PDF, DOC или DOCX для автоматического парсинга.

• Метод: POST /api/v1/upload-cv-file
• Формат: multipart/form-data
• Результат: сохраните полученный cv_id

Шаг 5. Создание апликанта

Создайте карточку апликанта, используя данные из парсинга или данные, введённые пользователем.

• Метод: POST /api/v1/applicant
• Важно: передайте cv_ids из предыдущего шага, чтобы файл прикрепился к карточке

Шаг 6. Назначение на вакансию

Свяжите апликанта с вакансией на выбранном этапе.

• Метод: POST /api/v1/candidate
• Передайте: job_id, applicant_id, pipeline_id, pipeline_stage_id

Шаг 7. Чтение тегов апликанта

Теги проставляются в интерфейсе. Через API они доступны для чтения и фильтрации.

• Метод: GET /api/v1/applicant-labels/all
• Результат: id, title и color каждого тега организации
• Требуется permission recruiting_module

В карточке апликанта теги приходят в поле labels. Чтобы найти всех с нужным тегом, передайте его id в фильтр label_ids метода POST /api/v1/applicants/search.

Проставить тег через API пока нельзя: у POST /api/v1/applicant и PUT /api/v1/applicants/{applicant_id} нет поля label_ids.

Шаг 8. Изменение этапа или комментария

Кандидата можно двигать по воронке, дисквалифицировать или комментировать.

• Метод: POST /api/v1/candidates/{candidate_id}/actions
• Метод: DELETE /api/v1/candidates/{candidate_id}/actions/{id}

Пример полезных полей:

pipeline_stage_id: ID нового этапа
disqualification_reason_id: причина дисквалификации
reserved: перевод в резерв
comment: комментарий
datetime_action_date: опциональная дата действия для "забытых" событий

Если указать datetime_action_date, текущее состояние кандидата может не измениться автоматически, поэтому этот параметр лучше использовать только для исторических действий.

Другие методы по апликантам и вакансиям

Получить апликанта

• Метод: GET /api/v1/applicants/{applicant_id} - полная карточка апликанта.

Добавить контакты апликанта

• Метод: POST /api/v1/applicants/{applicant_id}/contacts
• Тело: массив контактов, у каждого type, value и необязательный label. Контакты добавляются к уже существующим.
• type: email, phone, telegram, skype, instagram, behance, linkedin, viber, github, facebook, zoom, link, other.
• Возвращает полную карточку апликанта.

Скачать резюме в PDF

• Метод: GET /api/v1/{applicant_id}/download-cv/{cv_id}
• hide_salary (по умолчанию true) убирает ожидаемую зарплату.
• hide_other (по умолчанию false) убирает имя, контакты, фото, дату рождения и локацию - для обезличенного резюме.
• Возвращает файл, имя файла - в Content-Disposition.
• Требуется permission manage_candidates.

Создать вакансию

• Метод: POST /api/v1/jobs
• Обязательны title и pipeline_id (из GET /api/v1/pipelines/all). status по умолчанию draft.
• Тело такое же, как у PUT /api/v1/jobs/{id}. department_id и division_id берутся из GET /api/v1/departments/all и GET /api/v1/divisions/all.
• Возвращает созданную вакансию.