# Действия Potok

Действия позволяют боту работать с вакансиями и кандидатами в системе управления подбором персонала Potok. Сначала подключите Potok и проверьте соединение.

# Как добавить действие

1. Откройте нужного бота.
2. Перейдите во вкладку Интеграции и действия.
3. Включите Включить действия в боте.
4. Нажмите Добавить действие.
5. В блоке Что выполнить в результате нажмите Добавить действие.
6. Выберите источник Potok и нужную операцию.
7. Настройте параметры, сохраните действие, а затем сохраните изменения бота.

Параметры операций по умолчанию может определять бот. Если значение должно быть постоянным, выключите Определять автоматически и укажите его вручную либо через переменную @.

Каждая операция также позволяет включить Сохранить ID результата в переменную. Используйте эту настройку, когда ID вакансии или кандидата понадобится следующей операции.

# Найти вакансии

Ищет вакансии по параметру Название вакансии. Используйте операцию в начале сценария, чтобы получить актуальную вакансию и её ID, а не просить бота угадывать внутренний идентификатор.

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

# Найти кандидата

Ищет существующего кандидата по одному или нескольким параметрам:

• Телефон кандидата;
• Email кандидата;
• ФИО кандидата.

Сначала используйте телефон или email — это снижает риск совпадения однофамильцев. Если поиск вернул несколько карточек, не изменяйте их автоматически: запросите уточнение или передайте диалог рекрутеру.

# Получить карточку кандидата

Получает данные кандидата по двум параметрам:

• ID кандидата;
• ID вакансии.

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

# Создать кандидата

Создаёт кандидата и связывает его с выбранной вакансией. Доступны параметры:

• Имя кандидата;
• Фамилия кандидата;
• Телефон кандидата;
• Email кандидата;
• ID вакансии.

В поле Если кандидат уже существует выберите один из режимов:

• Использовать найденного кандидата — продолжить сценарий с существующей карточкой;
• Остановить действие с ошибкой — не продолжать автоматизацию при обнаружении дубля.

Перед созданием соберите контактные данные, подтвердите вакансию и выполните Найти кандидата. Не создавайте новую карточку, если не удалось однозначно проверить существующего кандидата.

# Добавить комментарий

Добавляет запись в карточку кандидата. Нужны:

• ID кандидата;
• ID вакансии;
• Комментарий — до 4000 символов.

Используйте комментарий для краткого итога скрининга: релевантный опыт, ожидания, доступность, ответы на обязательные вопросы и договорённый следующий шаг. Не сохраняйте лишние персональные или чувствительные данные.

# Перевести кандидата на этап

Переводит кандидата в выбранной вакансии на Целевой этап. Для операции нужны ID кандидата, ID вакансии и тип этапа.

Доступны типы этапов подбора:

• найден;
• откликнулся;
• скрининг;
• интервью с HR;
• интервью с заказчиком;
• оффер.

ChatRex переводит кандидата только на заранее разрешённый тип этапа. Убедитесь, что такой этап есть в воронке вакансии, и выполняйте перевод после явного результата разговора или подтверждения рекрутера.

# Рекомендуемый сценарий скрининга

1. Выполнить Найти вакансии и подтвердить вакансию с кандидатом.
2. Найти кандидата по телефону или email.
3. Если карточки нет, после согласия кандидата выполнить Создать кандидата.
4. Получить карточку кандидата и задать вопросы, предусмотренные сценарием вакансии.
5. Показать кандидату краткий итог и получить подтверждение перед сохранением.
6. Выполнить Добавить комментарий с результатом разговора.
7. При выполнении критериев перевести кандидата на разрешённый этап либо передать результат рекрутеру.

# Настройка промпта и проверка

В основной цели и описании действия укажите:

• какие данные бот должен собрать до создания кандидата;
• как проверять дубли по телефону и email;
• какие вопросы обязательны для конкретной вакансии;
• при каких условиях можно добавить комментарий и изменить этап;
• когда нужно передать диалог рекрутеру;
• что внутренние ID, технические ошибки и чужие персональные данные нельзя показывать кандидату.

Перед публикацией проверьте полный сценарий в разделе Тестирование на тестовой вакансии. Убедитесь, что не появился дубль, комментарий сохранился в нужной карточке, а этап изменился только после выполнения заданных условий.