Разбирайте отклики на вакансии и зовите сильных первыми

Агент работает с hh.ru через официальный API api.hh.ru: активные и архивные вакансии, отклики вместе с перепиской по ним, статистику просмотров, базу резюме и список менеджеров компании. Из этого складывается разбор откликов по вакансиям, короткий список кандидатов под открытую позицию с причиной по каждому имени и утренняя сводка: сколько откликов пришло за сутки, по каким вакансиям тишина и что скоро уйдёт в архив.

Отклик на hh.ru — не письмо, а отдельная сущность с собственной перепиской, поэтому агент читает ветку целиком, а не последнее сообщение, и различает, ответили кандидату или только открыли резюме. База резюме живёт отдельно от откликов: там своя выдача с фильтрами и своей постраничностью, а карточка приходит обезличенной, пока контакты не открыты. Поэтому кандидатов из поиска и кандидатов из откликов агент держит разными списками и не выдаёт одних за других.

На запись агент умеет многое: создать и обновить вакансию, продлить её или убрать в архив, ответить в отклике, пригласить на интервью, перевести отклик в отказ. Делает он это по вашему решению, а не сам: приглашение и отказ уходят кандидату вживую и назад не отыгрываются, поэтому агент сначала показывает, кому и что собирается написать, и отправляет после подтверждения.

Доступ выдаётся входом через hh.ru: вы подтверждаете его во всплывающем окне, токен возвращается сам и продлевается без вашего участия. Видит агент ровно то, что разрешено вашему менеджеру, частоту запросов к API держит в допустимых пределах, а поиск по базе укладывает в суточный лимит — 500 уникальных резюме на менеджера, поэтому сужает фильтры, а не выгребает базу подряд. Если данных нет из-за прав или лимита, он скажет об этом прямо, а не покажет пустую таблицу.