: Методы требуют наличия платного доступа для работодателя
Документация по переписке для соискателя доступна в отдельной статье.
- Модель работы, термины и процедуры
- Общее описание процесса работы с откликами/приглашениями
- Коллекции и работодательские состояния откликов/приглашений
- Список откликов/приглашений
- Просмотр отклика/приглашения
- Просмотр списка сообщений в отклике/приглашении
- Отправка сообщения в отклике/приглашении
- Приглашение соискателя на вакансию
- Изменение состояния отклика/приглашения
- Изменение состояния нескольких откликов/приглашений
- Просмотр предпочитаемой сортировки откликов
- Изменение предпочитаемой сортировки откликов
- Отметить отклики прочитанными
Отклики и приглашения соответствуют модели, которая выражается в запросах и ответах API. Если приложение использует модель правильно, то изменение бизнес-логики откликов и приглашений не будет требовать переработки или исправления.
В откликах и приглашениях используются понятия:
-
отклик – объект, порождённый по инициативе соискателя (отклик на вакансию). Отклик всегда происходит одним резюме на одну вакансию.
-
приглашение – объект, порождённый по инициативе работодателя (приглашение на вакансию). Приглашение всегда происходит к одному резюме на одну вакансию.
Кроме процесса появления объекта, работа с откликом или приглашением происходит одинаково.
-
коллекция – набор откликов/приглашений, объединённых по определённым критериям. Коллекции используются, когда в вашем приложении требуется отобразить список откликов/приглашений. Не стоит полагаться на то, что в определённые этапы обработки отклика/приглашения оно будет входить в известные коллекции, так как эта логика может изменяться.
-
соискательское состояние отклика/приглашения – статус отклика/приглашения (поле
state), который видит соискатель. Возможные значения выдаются в справочникеnegotiations_stateи не зависят от вакансии в отклике/приглашении. -
работодательское состояние отклика/приглашения – статус отклика/приглашения у работодателя. Может отличаться от соискательского. Список возможных статусов зависит от вакансии и работодателя, поэтому список необходимо запрашивать, передавая нужную вакансию.
-
действие по отклику/приглашению – действие, которое можно выполнить над откликом/приглашением. В результате действия работодательское и соискательское состояния отклика/приглашения могут как поменяться, так и остаться прежними.
Не следует путать действие, коллекцию и состояние – они могут быть похожи, но предназначены для разных целей.
Вся работа с откликами/приглашениями происходит в рамках одной выбранной вакансии. Даже у одного работодателя могут быть вакансии с различными правилами работы по откликам/приглашениям.
Сначала необходимо получить список коллекций и работодательских состояний. Используйте коллекции для получения списков откликов/приглашений. Предлагайте пользователю выбирать, какую из коллекций он хочет получить. Для получения всех откликов/приглашений нужно последовательно получить все коллекции. Список состояний используется только как справочник.
Для создания приглашения необходимо запросить вакансии работодателя,
применимые к выбранному резюме. Получить эту информацию можно в
списке вакансий работодателя, там же
будут указаны необходимые параметры (ключ arguments) и состояние созданного
отклика (ключ resulting_employer_state). У разных работодателей и разных
вакансий могут быть различные правила и состояния добавляемого отклика. Для
каждой пары вакансия + резюме может быть только один отклик/приглашение.
Для создания приглашения, работодатель должен иметь активированный доступ к базе резюме. Для работы с существующим откликом/приглашением доступ не требуется. Это позволяет обрабатывать отклики на вакансии, даже не имея доступ к базе резюме.
Если вам необходимо совершить действие по отклику/приглашению,
ориентируйтесь на список действий, который будет доступен в
списке (коллекции) откликов/приглашений и в
отдельном отклике/приглашении. Если действие приводит
к смене состояния по отклику/приглашению, это будет явно указано в ключе
resulting_employer_state. Не все действия приводят к смене состояния.
После приглашения соискателя вы можете начать с ним
свободную переписку. Вы сможете
отправлять сообщения, а соискатель – вам отвечать.
При необходимости переписку для конкретной вакансии
можно отключить (поле allow_messages).
Чтобы соискательский отклик считался просмотренным работодателем необходимо сделать одно из следующих действий:
- запросить список сообщений по урлу, пришедшему при запросе списка (коллекции) откликов/приглашений или отдельного отклика/приглашения,
- запросить сообщения по отклику
- запросить резюме по урлу, пришедшему при запросе списка (коллекции) откликов/приглашений или отдельного отклика/приглашения
- с помощью отдельного метода отметить определенные отклики как прочитанные
!! Данный метод доступен в OpenAPI
!! Данный метод доступен в OpenAPI
!! Данный метод доступен в OpenAPI
‼️ Обратите внимание, что методы для работы с сообщениями в рамках отклика/приглашения от имени соискателя и менеджера работодателя устарели, и новые возможности чатов в них не будут поддерживаться. В связи с этим переписка может некорректно отображаться.
!! Данный метод доступен в OpenAPI
!! Данный метод доступен в OpenAPI
!! Данный метод доступен в OpenAPI
!! Данный метод доступен в OpenAPI
!! Данный метод доступен в OpenAPI
!! Данный метод доступен в OpenAPI