битрикс24 hh интеграция автоматизирует подбор персонала, упорядочивает общение с кандидатами и сокращает время закрытия вакансий.
Для начала подготовьте рабочий корпоративный портал Bitrix24 с правами администратора, активный рекрутинговый аккаунт HeadHunter и подписку API.
Подготовка систем
Зайдите в личный кабинет HeadHunter, откройте раздел «API ключи», запросите ключ типа employer, задав название интеграции, и сохраните сгенерированное значение.
В Bitrix24 перейдите в «Приложения», введите в поиске «HeadHunter», установите приложение партнёра, или создайте собственную веб-хуковую точку в разделе «Вебхуки» для входящих запросов.
При создании веб хака укажите доступ к сущностям CRM, вакансиям и контактам, скопируйте секретный токен для дальнейшего связывания с HeadHunter.
Настройка вакансий
Вернитесь в кабинет HeadHunter, откройте «Интеграции», вставьте URL вебхука Bitrix24, добавьте параметр внутри строки запроса, задающий идентификатор вакансии, включите передачу кандидатов в режиме real-time.
В Bitrix24 откройте карточку вакансии, включите пользовательские поля, совпадающие с параметрами, поступающими из HeadHunter: resume_id, vacancy_id, expected_salary, city, источник.
В меню CRM выберите пункт «Правила конверсии», укажите создание лида при получении нового кандидата, задайте ответственного менеджера по умолчанию.
Автоматизация процессов
Откройте Конструктор роботов, создайте цепочку: после появления лида — конвертация в сделку «Подбор сотрудника», перенесите резюме в комментарий, отправьте уведомление рекрутеру, назначьте звонок руководителю отдела.
Добавьте триггер «Письмо от кандидата» для автоматического перехода этапа после отклика, настройте сценарий изменения статуса в зависимости от оценки тестового задания.
Для проверки создайте тестовую вакансию HeadHunter и отклик при помощи отдельного аккаунта соискателя, убедитесь, что контакт, сделка и задачи появились в CRM менее чем через минуту.
Храните API-ключ в зашифрованном хранилище портала, обновляйте токен каждые девяносто дней, ограничивайте доступ к вебхуку по IP, пропускайте поток резюме через предустановленный фильтр, чтобы избежать спама.
Используйте пакетные запросы HeadHunter, если планируется импорт архива резюме, активируйте пакетную обработку в Интеграциях Bitrix24, ускорив загрузку до тысячи резюме за час.
Синхронизированные системы избавляют HR-команду от монотонного копирования данных, улучшают аналитику закрытия позиций, повышают прозрачность коммуникаций между рекрутерами и руководителями подразделений.
Конвейер найма ускоряется, когда отклики с hh.ru попадают в CRM сразу после отправки кандидатом формы. Сводная карточка создаётся в Лидах, фото и резюме прикрепляются, теги вакансии подтягиваются автоматически.
Подготовка окружения
Для работы канала потребуется корпоративный тариф Bitrix24 с доступом к REST, а на стороне hh.ru — токен API работодателя. В профиле компании HeadHunter открывается вкладка «Интеграции», генерируется ключ с отметкой Get_resumes. Сервер Bitrix24 принимает входящие POST-запросы из диапазона IP hh.ru. Для тестовой среды удобно использовать публичный туннель ngrok, доменное имя прописывается в настройках вебхака.
База пользователей Bitrix24 пополняется ролями HR-менеджер и Руководитель подбора. У каждой назначаются права на добавление лидов, просмотр кандидатов и изменение стадий воронки «Подбор персонала».
Создание интеграционного приложения
В разделе «Приложения» Bitrix24 запускается мастер «Собственное приложение». Имя, короткое описание и иконка заполняются в шапке. Тип подключения — «Server-to-Server». Поле Auth указывает URL скрипта, принимающего токен hh.ru. Права доступа CRM, user, im описываются галкой.
В репозитории создаётся точка входа index.php. Скрипт получает JSON, извлекает vacancy.id и resume.id, обращается к методу crm.lead.add, формирует лид с источником «HeadHunter», телефоном и почтой из резюме. При дублировании используется метод crm.duplicate.findbycommand.
Для обратного потока создаётся cron-задача, обращающаяся к hh.ru/resumes/{id}/messages и отправляющая кандидата статус отклика. Статус выбирается на основе стадии лида: Iinterview, Offer, Reject.
Финальная отладка
После деплоя приложение активируется в маркетплейсе портала. В карточке вакансии hh.ru включается чек-бокс «Отправлять отклики в стороннюю систему». Отклик тестового аккаунта создаёт лид в Bitrix24 за 1-2 секунды. Чат HR-менеджера получает уведомление через команду im.notify.
Для воронки «Подбор персонала» настраиваются роботы: автоматический переход лида на стадию «Собеседование» при добавлении события «Запись на интервью», отправка письма через SMTP при переводе на стадию «Оффер», закрытие лида с причиной Hire после подписания документа в Bitrix24. Сигналы задержки ставят паузы между письмами.
Отчёты строятся в разделе Аналитика. Пользователь выбирает фильтр «Источник HeadHunter», видит среднее время между откликом и нанятием, конверсию по каждой стадии, затраты на размещение вакансий. Данные экспортируются в Excel из одного клика.
При передаче персональных данных используется HTTPS и подпись X-HH-Signature. Ключ хранится в .env, переменная считывается скриптом при каждом запросе. Доступ к журналу запросов ограничивается IP-фильтром nginx.
Распространённые ошибки: неверный Content-Type, устаревший токен, дублирование лидов из-за отсутствия проверки по email. Для устранения полезна настройка webhook-retry на стороне hh.ru и использование метода crm.lead.list с фильтром search.
После окончания найма интеграция остаётся активной. Новые вакансии HeadHunter подписываются на ту же точку входа, так что масштабирование команды проходит без изменений в коде.