Передача кандидатов из сервиса Rabotyaga.pro через webhook

Вебхук – это HTTP POST-запрос, отправляемый нашей системой на ваш удаленный сервер. Вся информация об отклике содержится в теле запроса и в его заголовках.

На каждый созданных вебхук Работяга предпринимает до 4-х попыток отправить событие: сразу после возникновения, а также, в случае неуспешной доставки, с интервалами в 10, 20 и 30 секунд после последней неуспешной попытки.

Сервис, принимающий события, должен отвечать кодом 200, 201 или 204 на прием вебхука для индикации успешности доставки события.

Типы событий:

RESPONSE – Отклики на вакансии.

Подключение webhook

Вебхуки настраиваются в разделе "Работодатели" https://rabotyaga.pro/cabinet/companies
Только пользователи, добавившие работодателя в сервис и являющиеся главным администратором работодателя, могут добавлять и удалять вебхуки.

Путь: Работодатели – Настройки – Интеграции – Кнопка "Добавить webhook"

Заголовки webhook

{
    "X-Rabotyaga-Event": "RESPONSE",
    "X-Rabotyaga-Webhook-Id": "eiwiyu58vdhlm5k6glflf329",
    "X-Rabotyaga-Signature": "c1c06c8ab796aef4b9207b0694b08a71d2b15d2e5022dadc9c757c5a9f8fcf3e"
}

X-Rabotyaga-Event – тип события
X-Rabotyaga-Webhook-Id – уникальный идентификатор вебхука
X-Rabotyaga-Signature – hex digest sha256 hmac тела вебхука, сгенерированный с помощью вашего секретного ключа ("" или отсутствует, если в вебхуке не указан секретный ключ)

Тело webhook события RESPONSE:

{
  "company_id": "", /* STRING ID компании-работодателя в сервисе Работяга.про */
  "company_name": "", /* STRING Название компании-работодателя*/
  "job_offer_id": "", /* STRING ID вакансии в сервисе Работяга.про*/
  "job_offer_landing_page_url": "", /* STRING URL-адрес HR-лендинга */
  "job_title": "", /* STRING Заголовок вакансии на которую откликнулся кандидат*/
  "job_seeker_phone": "",	/* STRING номер контактного телефона, указанный кандидатом*/
  "job_seeker_work_experience": "",	/* STRING опыт работы по вакансии, указанный кандидатом*/
  "job_seeker_city": "", /* STRING город проживания, может быть указан кандидатом или автоматически определен*/
  "job_seeker_first_name": "",	/* STRING Имя кандидата*/
  "job_seeker_middle_name": "",	/* STRING Отчество кандидата*/
  "job_seeker_surname": "",	/* STRING Фамилия кандидата*/
  "source_data": { /* OBJECT Объект с UTM-метками по источнику откуда пришел кандидат*/
    "utm_source": "", /* STRING utm_source*/
    "utm_medium": "", /* STRING utm_medium*/
    "utm_campaign": "", /* STRING utm_campaign*/
    "utm_content": "", /* STRING utm_content*/
    "utm_term": "" /* STRING utm_term*/
  },
  "response_time_unix": 1711462188000, /* INT время отклика на вакансию в UNIX-формате*/
  "job_seeker_accept_politics": "Да", /* STRING Согласился ли с политикой обработки персональных данных*/
  "users_with_access_ids": [ /* ARRAY массив STRING ID пользователей сервиса Работяга, имеющих доступ к данному отклику*/
    "",...
  ],
  "job_offer_id_in_your_system": "", /* STRING ID вакансии в сторонней системе обработки откликов, например это может быть внутренний ID вакансии в Skillaz или другом сервисе, данный параметр можно указать при добавлении или редактировании вакансии в сервисе*/
  "hrl_check_data": {/* OBJECT Объект с результатом HRL-проверки доступности абонента*/
    "status": ("available"|"unknown"), /* STRING статус абонента "available" - доступен, "unknown" - неизвестно, номер может быть доступен и работать, если оператор OTHER*/
    "mobile_operator": ("TELE2"|"MTS"|"MEGAFON"|"BEELINE"|"OTHER"),/* STRING сотовый оператор абонента, на текущий момент проверка HRL-статуса возможна только у абонентов TELE2, MTS, MEGAFON, BEELINE, если другой оператор значение будет OTHER*/
    "check_time_unix": 1741858939000 /* INT время проверки доступности абонента в UNIX-формате*/
  }
}

hrl_check_data

В теле вебхука присутствует объект hrl_check_data – данные о проверке доступности абонента.

Важно! На текущий момент времени проверка возможна только для абонентов операторов МТС, Билайн, Мегафон, Теле2, во всех остальных случаях оператор будет OTHER и HRL-статус "unknown", но это не означает что абонент указал неверный номер или недоступен.

job_offer_id_in_your_system

Параметр, передающий ID вакансии в сторонней системе обработки откликов, например это может быть внутренний ID вакансии в Skillaz или другом сервисе, данный параметр можно указать при добавлении или редактировании вакансии в сервисе. https://rabotyaga.pro/cabinet/joboffers

Путь: Вакансии – Настройки – Редактировать