Автоматизация рекрутинга в 1 клик
Получаем отклики из формы, созданной на конструкторе Тильда, сразу в сервис
Вы можете подключить сервис FriendWork к своему сайту.

Данная инструкция подготовлена на примере конструктора лендингов Tilda.

В первую очередь вам необходимо обратиться в службу поддержки support@friendwork.ru для получения ссылки для интеграции (WebHook) с вашим лендингом.

После получения ссылки необходимо зайти в настройки сайта.
Выбираем «Формы».
Опускаем страницу вниз, выбираем «Webhook».
Вставляем ссылку, специально приготовленную для вашей компании и сохраняем.
Далее возвращаемся на страницу вашего проекта в Tilda и создаем форму отклика.
Выбираем форму отклика.
Переходим в «Контент».
Обязательно подключаем «Webhook» в подключенных сервисах и заполняем поля для ввода.
При заполнении полей ввода необходимо обязательно указать поля переменных. Остальные поля можно менять и заполнять на ваше усмотрение. Главное корректно заполнить имена переменных.
Мы поддерживаем следующий набор полей:

lastName – будет записано как фамилия кандидата

firstName – будет записано как имя кандидата

middleName – будет записано как отчество кандидата

phone – будет записано как контактный телефон кандидата

email – будет записано как контактный e-mail кандидата

coverLetterсопроводительное письмо отклика, будет помещено в комментарий к кандидату

comment – произвольная информация, будет помещена в комментарий к кандидату

fullName – альтернатива первым двум полям; информация из данного поля будет разобрана на имя и фамилию и отчество кандидата, поддерживается как порядок ИМЯ ФАМИЛИЯ ОТЧЕСТВО, так и ФАМИЛИЯ ИМЯ ОТЧЕСТВО;
рекомендованный формат – ФАМИЛИЯ ИМЯ ОТЧЕСТВО

publishedJobId – техническое поле; необходимо передавать id публикации, к которой будет прикрепляться отклик

referer – будет записано как источник отклика кандидата; поддерживает как наши алиасы, так и полные имена ресурсов (hh (алиас) и HeadHunter (полное имя) и так далее)

city – будет записано как город проживания кандидата

citizenship – будет записано как гражданство кандидата

candidateStatusIdid статуса, который будет выставлен кандидату. Поддерживаются статусы с типом Без даты и времени, Дата и время. Тип Диапазон дат на данный момент не поддерживается. Если у Вас возникает потребность, напишите нам, мы реализуем поддержку данного типа.

candidateStatusName – название статуса, который будет выставлен кандидату

candidateStatusDate – дата статуса, который будет выставлен кандидату

isCandidateStatusForAllDay – флаг для статуса, который указывает, что статус назначен на весь день

updateSource – флаг, который указывает необходимо ли обновить источник у кандидата, если будет найден дубликат

customFieldsValues – массив объектов для кастомных полей. Каждый объект массива содержит два свойства. Св-во SystemName содержит название кастомного поля, которое уникально идентифицируем кастомное поле. Название можете узнать у поддержки. Св-во Value содержит значение, которое вы хотите сохранить в кастомное поле. Пример:

"customFieldsValues": [

{

"SystemName": "yourFieldSystemName1",

"Value": 5

},

{

"SystemName": "yourFieldSystemName2",

"Value": [0,1]

}

]




Если у Вас включена функция «Посылать UTM» в настройках WebHook в Tilda, то в сервис также будут отправлены следующие метки, которые будут помещены в комментарий к кандидату:

utm_source

utm_medium

utm_campaign

utm_content

utm_term


Если во время публикации вакансии в настройках откликов был выбран статус идентичен статусу, выбранному в настройках Tilda, то создастся только один статус в ленте событий кандидата. Данная функция реализована для вашего удобства.



Чтобы отклики сохранялись корректно, необходимо добавить информацию про вашу вакансию. Для этого добавляем поле «Скрытое поле», указываем переменную publishedJobId и ID вакансии на «Карьерном портале FriendWork».
ID вакансии – это последние цифры в ссылке на вакансию на вашем «Карьерном портале FriendWork». Более подробно про публикацию вакансий на «Карьерном портале» по ссылке.
По завершению настройки полей необходимо «Сохранить».
И далее «Опубликовать».
Ниже пример запроса по API, с помощью которого Вы можете проверить работу WebHook.

https://app.friend.work/api/Applications/Webhooks?token={токен}

где {token} это 16 символьная строка содержащая латинские символы и цифры. Токен генерируется нашей службой поддержки

Тип запроса

POST

Примеры запроса 1


{

"lastName": "lastName",

"firstName": "firstName",

"middleName": "middleName",

"phone": "78569412333",

"email": "test@test.test",

"coverLetter": "coverLetter",

"comment": "comment",

"publishedJobId": 1258,

"referer": "HeadHunter",

"city": "Москва",

"citizenship": "Россия"

}

Примеры запроса 2

{

"lastName": "lastName",

"firstName": "firstName",

"middleName": "middleName",

"phone": "78569412333",

"email": "test@test.test",

"coverLetter": "coverLetter",

"comment": "comment",

"publishedJobId": 1258,

"referer": "HeadHunter",

"candidateStatusId": 24464,

"candidateStatusDate": "2020.10.03 18:00"

}

Примеры запроса 3

{

"lastName": "lastName",

"firstName": "firstName",

"middleName": "middleName",

"phone": "78569412333",

"email": "test@test.test",

"coverLetter": "coverLetter",

"comment": "comment",

"publishedJobId": 1258,

"referer": "HeadHunter",

"utm_source": "utm_source",

"utm_medium": "utm_medium",

"customFieldsValues": [

{

"fieldGuid": "516a6851-4316-4f24-8c9b-965f28663719",

"value": 1

},

{

"fieldGuid": "a86d35db-f75e-4cbe-b1e4-407bb1360693",

"value": 2

},

{

"fieldGuid": "2818af03-0142-4cf2-8fc6-50440d9fc353",

"value": [1]

},

{

"fieldGuid": "ea65bde8-e249-45ec-a8a4-2351d0dbdc8b",

"value": "String="

},

{

"fieldGuid": "91e9e654-8e5a-445d-9255-0d4e8bdeab48",

"value": "Text"

}

]

}

Примеры запроса 4

{

"lastName": "lastName",

"firstName": "firstName",

"middleName": "middleName",

"phone": "78569412333",

"email": "test@test.test",

"coverLetter": "coverLetter",

"comment": "comment",

"publishedJobId": 1258,

"referer": "HeadHunter",

"city": "Москва",

"citizenship": "Россия",

"candidateStatusId": 24464,

"candidateStatusDate": "2020.10.03 18:00",

"utm_source": "utm_source",

"utm_medium": "utm_medium",

"customFieldsValues": [

{

"fieldGuid": "516a6851-4316-4f24-8c9b-965f28663719",

"value": 1

},

{

"fieldGuid": "a86d35db-f75e-4cbe-b1e4-407bb1360693",

"value": 2

},

{

"fieldGuid": "2818af03-0142-4cf2-8fc6-50440d9fc353",

"value": [1]

},

{

"fieldGuid": "ea65bde8-e249-45ec-a8a4-2351d0dbdc8b",

"value": "String="

},

{

"fieldGuid": "91e9e654-8e5a-445d-9255-0d4e8bdeab48",

"value": "Text"

}

]

}