Что такое API и для чего нужен

API — это программный интерфейс, с помощью которого можно реализовать интеграцию Talantix с другими системами.

Действует в тарифах «Оптимальный» и «Продвинутый». 

Возможности использования API

С помощью API вы можете реализовать следующие сценарии:

📤Выгрузка данных

1. Выгружать данные по кандидатам для систем учёта кадров или сторонних рассыльщиков.
2. Выгружать массив данных по вакансиям, кандидатам и движениям по воронке для аналитических систем (например, Power BI и аналогичных).

📋Загрузка заявок на вакансии

1. Загружать в Talantix заявки, согласованные в других системах (1С, Босс-Кадровик, Jira и др.), с тем же набором полей, что и в Talantix.
2. Настраивать автоматическую подгрузку изменений в заявке. Например, при смене статуса согласования в 1С статус в Talantix обновится автоматически — без ручного переноса.

🌐Загрузка откликов с внешних источников

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

🔄Перемещение кандидатов по этапам

Перемещать отклик кандидата из сторонней системы по этапам воронки или в отказ. Это позволяет:

• забирать отклики кандидатов в стороннюю систему (например, чат-бот или систему тестирования);
• обрабатывать отклики в сторонней системе (например, общаться с кандидатом), а затем перемещать кандидата по этапам подбора или в отказ.

Перемещение фиксируется в истории кандидата. Если перевод осуществляется на этап, связанный с этапом внешней публикации hh.ru, отклики с этой публикации синхронизируются с hh.ru автоматически.

При повторном переводе кандидата на тот же этап запись в истории не дублируется. Также есть возможность указать источник ставки при переводе кандидата на этап «Выход на работу».

Какие данные можно получить через API

• список заявок
• детальную информацию о заявке по её ID (идентификатору)
• данные о текущем пользователе API (общая информация, подключённые интеграции, настройки нотификаций)
• список кандидатов с поиском по строке и возможными фильтрами
• информацию о кандидате на вакансии (этап, на котором он сейчас; этап, на котором он был; возраст; зарплата; источник; метки; причины отказа; дата обновления резюме; город)
• информацию о кандидате по ID (карточка; все резюме; комментарии; вакансии, на которых находится кандидат; история; переписка)
• информацию о вакансии по ID
• данные по вакансии, её этапы, кандидаты на каждом этапе, их оценка, сопроводительные письма
• данные лендинга, сбора откликов, настройки уведомлений, менеджеров внутри вакансии
• список менеджеров компании
• шаблоны сообщений
• подсказки названий этапов при создании новых

Как начать работу с API

Для работы с API необходимо:

1. Сгенерировать токен в личном кабинете Talantix. В результате вы получите ссылку.
2. Полученную ссылку передать своим разработчикам для внедрения. Ссылка будет содержать токен и подробную документацию для разработчиков.

Как сгенерировать токен для использования API

1. Авторизуйтесь в личном кабинете Talantix в учётной записи с правами «Администратор» и перейдите в «Мой профиль» — вкладка «API».

2. Нажмите кнопку «Новый токен».

Вы можете создать несколько токенов. Мы рекомендуем создавать отдельный токен под каждую интеграцию.

3. Введите название токена, например Bitrix24, и нажмите «Создать».

4. После генерации нажмите кнопку «Скопировать», чтобы скопировать ссылку с токеном и документацией.

Готово. Отправьте скопированную ссылку разработчикам.

Срок действия и управление токенами

• Срок действия ссылки — 30 дней. По истечении этого срока ссылка станет неактивной, и потребуется создать новый токен.
• Неактивность — если в течение 120 дней API с существующими токенами не использовался, обновить или использовать их будет нельзя — необходимо завести новые токены.

Созданные токены будут отображаться во вкладке API с отметкой «Активен» или «Истёк», если срок действия токена закончился.

Вы можете:

• отредактировать название токена;
• удалить токен.

Смена роли и блокировка пользователя, создавшего токены

Если вы захотите сменить роль (передать права администратора другому сотруднику или понизить роль администратора), система предупредит вас о том, что созданные токены перестанут работать.

Рекомендация: перед сменой роли создайте новые токены, передайте их разработчикам, убедитесь в корректной работе интеграции и только после этого меняйте роль.

Аналогично — при блокировке пользователя с правами администратора, у которого есть активные токены, система уведомит о необходимости создать новые токены и передать их разработчикам.

Как добавить в Talantix своего технического специалиста для настройки API

1. Создайте для вашего специалиста учетную запись в Talantix.

2. Назначьте ему роль «Администратор» — только пользователи с этой ролью могут создавать и управлять API-токенами.

Нужно ли оплачивать рабочее место для технического специалиста?

• Если цель: только чтение данных по API и передача их в вашу внутреннюю систему, рабочее место для технического специалиста с ролью «Администратор» оплачивать не нужно. Вы можете использовать тариф «Оптимальный» без дополнительных затрат.
• Если цель: с помощью API создавать кандидатов, заявки, оставлять комментарии и совершать другие действия, доступные только пользователям с выделенным рабочим местом, — тогда для технического специалиста с ролью «Администратор» необходимо выделить рабочее место и оплачивать его.

Перейти в Talantix