ИНТЕГРАЦИЯ HEADHUNTER
Перенос откликов в Битрикс24
Новые кандидаты — в CRM, без повторного ввода данных.
Административный доступ
Для настройки подключения введите пароль из конфигурации сервера.
Пароль не сохраняется в браузере. Сессия действует в пределах вкладки.
Статус соединений
Для переноса нужны обе системы
Синхронизация
Сверка проверяет отклики в очереди «Неразобранные». Вебхуки обрабатывают поступающие новые отклики независимо от запуска браузера.
Ручной импорт разрешён только после подключения служебного СП. Автоматический запуск включается через AUTO_IMPORT_ENABLED=1.
Для переноса уже обработанных откликов можно включить расширенный импорт ниже.
Последние операции
Создание карточек, пропуски и ошибки
Подключение HeadHunter
Выполняется от имени менеджера работодателя с доступом к откликам.
Client ID, Client Secret и HH-User-Agent указываются только на сервере в файле .env.
Подключённые аккаунты и сотрудники
Один OAuth-логин hh.ru может содержать несколько рабочих аккаунтов. Каждому рабочему аккаунту укажите ID сотрудника Битрикс24.
Повторная авторизация требуется только если hh.ru отозвал доступ или не смог продлить токен. Два логина подключаются одной и той же кнопкой по очереди.
Подключение Битрикс24
Из портала авторизация сотрудников поступает при открытии приложения. Сервисный REST-доступ из .env используется для фоновой синхронизации. Отдельный OAuth нужен только для внешней административной панели.
ВНИМАНИЕ: B24_CLIENT_ID/SECRET в Render не равны полученному access_token. Внутри портала приложение должно получать AUTH_ID при каждом запуске; для фоновой синхронизации необходим BITRIX_REST_WEBHOOK. Для настройки полей служебного СП техническому пользователю нужны crm и userfieldconfig.
Хранилище интеграции в Битрикс24
Все настройки, аккаунты, OAuth-токены и сопоставления сохраняются в Битрикс24. Два собственных поля технического СП создаются только по подтверждению администратора. Не выбирайте здесь СП с кандидатами.
Изменить рабочее место существующего СП
Если служебный СП уже создан, выберите его в списке выше, затем выберите новое цифровое рабочее место. Новые СП и карточки не создаются. Остальные процессы рабочего места сохраняются.
Создать новый служебный СП
Создаётся только новый технический СП. Выберите существующее цифровое рабочее место: все его текущие СП должны сохраниться. Никаких существующих карточек или полей приложение не изменяет.
Для восстановления на другом сервере рекомендуется добавить PORTAL_STATE_ENTITY_TYPE_ID в .env. Важно: ID смарт-процесса отличается от внутреннего ID типа в цифровом рабочем месте.
Получение новых откликов автоматически
HH отправляет события на сервер; периодическая сверка восполняет возможные пропуски.
Подписка использует событие NEW_NEGOTIATION_VACANCY. Адрес должен быть доступен из интернета по HTTPS.
Соответствие вакансий и карточек
Сначала добавьте вакансию и выберите целевой СП для откликов (не служебный). Затем загрузятся его поля — ниже можно сопоставить ID отклика, ссылки, резюме и остальные значения с существующими полями портала.
Целевой СП откликов и встраивание
Выбери основной СП кандидатов из текущего портала. Для новых вакансий он будет выбран по умолчанию; прежние сопоставления не меняются. Здесь же проверь и включи единственную вкладку.
Системный источник CRM для этой интеграции
В новых карточках проставляется системное поле «Источник» (`sourceId`). Чаты и восстановление связей обрабатывают только карточки с выбранным источником. Карточки других интеграций не меняются. Если в СП источники отключены — включите их в настройках самого СП.
Проверка дублей использует xmlId и существующее поле ID отклика (если выбрано ниже). Сопоставляйте рабочий аккаунт hh.ru с сотрудником, которому следует назначать карточки.
Кандидат · hh.ru
Контекст карточки Битрикс24, ответственный, история сообщений и отправка от привязанного менеджера hh.ru.
Чат hh.ru
Сначала откройте карточку.
Для безопасности сообщение отправляется строго через аккаунт hh.ru, который указан в сопоставлении вакансии. Если сотрудник не совпадает, отправка запрещена.
Журнал интеграции
События регистрации, результаты переноса, ошибки API