Перейти к основному содержимому

Перевод кандидатов по этапам вакансии

Базовый метод​

Базовый метод позволяет переводить кандидата(ов) на выбранный этап вакансии. Перевод фиксируется в истории кандидата. В случае перевода на этап, связанный с этапом внешней публикации hh.ru, полученные с нее отклики синхронизируются на hh.ru в автоматическом режиме. Вызов метода идемпотентен, т.е. повторный перевод кандидата на тот же этап завершается успешно, при этом записи в истории не задублируются.

mutation TransferPersonsToWorkflowStatus {
  transferPersonsToWorkflowStatus(personIds: [2936997], workflowStatusId: 422589) {
    __typename
    ... on PersonsToWorkflowStatusTransferredSuccess {
      ... on PersonsToWorkflowStatusTransferredSuccess {
        message
      }
    }
    ... on PersonsToWorkflowStatusTransferError {
      errorType
    }
  }
}

Посмотреть в playground

подсказка

Поле personsIds заполняется идентификаторами кандидатов (максимальное количество 50), в поле workflowStatusId указывается идентификатор этапа вакансии. Примеры получения кандидатов/этапов вакансии

Специальные методы перевода на этапы "Выход на работу" и "Отказ"​

При переводе на этапы "Выход на работу" и "Отказ" наряду с базовым можно использовать специальные методы, принимающие дополнительные аргументы.

Метод перевода на этап "Выход на работу"​

Метод позволяет перевести кандидатов вакансии на этап "Выход работу" с опциональной возможностью указания идентификатора источника ставки.

mutation HirePersons {
  hirePersons(
    personIds: [29379891]
    vacancyId: 56486
    hiringPositionSource: {id: 33, type: HIRING_REQUEST}
  ) {
    __typename
    ... on PersonsHiredSuccess {
      message
    }
    ... on PersonsHireError {
      errorType
    }
  }
}

Посмотреть в playground

примечание

В настоящий момент в качестве источника ставки доступна только заявка на подбор (HIRING_REQUEST)

подсказка

Заявки на подбор, привязанные к вакансии, можно получить с помощью запроса

query VacancyHiringRequests {
  vacancy(id: 56527) {
    ... on VacancyItem {
      hiringRequests {
        items {
          id
          hiringPositionCounters {
            hired
            planned
          }
        }
      }
    }
  }
}

Посмотреть в playground

Метод перевода на этап "Отказ"​

Метод перевода в "Отказ" позволяет передать следующие опциональные аргументы: идентификаторы причин отказа, комментарий менеджера и сообщение для кандидатов.

mutation DiscardPersons {
  discardPersons(
    personIds: [2937738]
    vacancyId: 56437
    comment: {text: "comment discard"}
    discardMessage: {subject: "subject", text: "text", channel: EMAIL}
    discardReasonIds: [37]
  ) {
    __typename
    ... on PersonsDiscardedSuccess {
      message
    }
    ... on PersonsDiscardError {
      errorType
    }
  }
}

Посмотреть в playground

примечание

Канал отправки сообщения (email либо hh.ru) определятся параметром channel

Приглашение кандидата на hh.ru​

Метод позволяет направить приглашение кандидату через hh.ru с перемещением в публикации на этап "Первичный контакт" и переводом на привязанный к нему этап вакансии в Талантикс.

mutation HhInvitePersons {
  invitePersonsOnHhRu(
    vacancyId: 56427
    personIds: [2936997]
    workflowStatusId: 422589
    inviteMessage: {text: "message text", withSMSNotification: true}
  ) {
    ... on PersonsHhInvitedSuccess {
      invitedPersonIds
      inviteFailureReasons {
        personIds
        failureReason
      }
    }
    ... on PersonsHhInviteError {
      errorType
      errors {
        field
        violatedConstraints
      }
    }
  }
}

Посмотреть в playground

примечание

Вызов данного метода возможен для кандидатов, импортированных из публикации hh.ru. Для вакансий с мультипривязкой (имеющей более одной привязанной публикации) в аргументе personIds можно передать не более одного кандидата.

подсказка

Поле workflowStatusId принимает опциальный идентификатор этапа вакансии Талантикс. Данный этап должен иметь связь с этапом(ми) публикации hh.ru, после вызова кандидат перемещается на привязанный этап публикации hh.ru.

Получить связи этапов вакансии и ее публикаций можно с помощью запроса

query WorkflowsExternalBindings {
  vacancy(id: 56427) {
    ... on VacancyItem {
      workflowStatuses {
        items {
          id
          name
          importFromHhStatuses
        }
      }
    }
  }
}

Посмотреть в playground