Auto-responses is a tool that automates the job search routine on hh.ru. You connect your HeadHunter account, collect vacancies via a search query, select the ones you like — and the system sends applications automatically.
How It Works
The entire process consists of four steps:
- Connect your account — authorize via hh.ru
- Collect vacancies — configure search query and load results
- Filter and select — review list, choose vacancies, configure your letter
- Automatic sending — the system sends applications in the background
Connecting a HeadHunter Account
Go to HeadHunter Automation → Accounts in the sidebar and click Connect Account.
Authorization goes through the official hh.ru OAuth — we never store your password. After logging in, the system receives an access token used to interact with the HeadHunter API.
You can connect multiple accounts simultaneously.
Collecting Vacancies
After connecting your account, select a resume and click Fetch Vacancies. A search query builder will open — a panel with parameters that form a request to the hh.ru API.
Search Parameters
The constructor supports all hh.ru search parameters:
- Text search — keywords to search for vacancies
- Exclude words — words to exclude from results
- Search scope — where to search: title, description, or company name
- Work experience — no experience, 1–3 years, 3–6 years, etc.
- Employment type — full-time, part-time, internship
- Work schedule — full day, shift, flexible
- Work format — remote, office, hybrid
- Schedule by days — 5/2, 2/2, rotational and others
- Working hours — full day, part day, from 4 hours
- Education — required education level
- Employment form — contract type (civil, labor code, self-employed)
- Temporary work — include temporary/seasonal vacancies
- Region — city or area (searchable tree)
- Professional role — specialization (searchable tree)
- Industry — company's business sector (searchable tree)
- Salary — minimum amount and currency, show only with specified salary
- Labels — e.g., accredited IT company
- Publication period — last day, week, month, or custom date range
- Sort order — by date, relevance, salary, or distance
- Site — hh.ru, rabota.by, hh.kz, and others
- Language — result localization
Settings are saved in the browser — no need to refill next time.
What Happens During Loading
- The system pages through all search results (up to 500 vacancies at a time)
- For each vacancy it saves: title, employer, link, test assignment and cover letter requirements
- Duplicates are automatically filtered — if a vacancy is already loaded, it won't appear again
Loaded vacancies receive the "Fetched" status and appear in the list.
Working with the Vacancy List
Local Filters
After loading vacancies, quick filters are available right above the list:
- Text search — search by vacancy title or employer name
- Status filter — show only vacancies with a specific status (fetched, accepted, sent, declined, etc.)
- Hide with test assignment — remove vacancies that require a test
- Hide with cover letter — remove vacancies that require a cover letter
Bulk Actions
Select vacancies and use the actions menu:
- Send applications — queue for automatic sending
- Archive — hide unwanted vacancies (can be restored)
- Decline — mark as not interesting
- Reset status — return to "Fetched" status
- Delete — permanently remove from the list
For convenience, you can select all vacancies on the page or select by status: only fetched, only accepted, or only declined.
Sending Applications
Select vacancies and click Send Applications. In the dialog, choose the cover letter type:
No Letter
The application is sent without a cover letter. Suitable for bulk sending when speed matters.
Template Letter
You can add up to 3 template letter variants. When sending, the system randomly picks one of the templates for each vacancy — this protects against hh.ru bans, as identical responses may be flagged as spam.
AI Letter
The system generates a personalized cover letter for each vacancy using AI.
You provide a prompt — an instruction for generation. For example: "Write a short letter, mention my experience with React and TypeScript, tone — friendly and professional".
Before sending, you can click Test Generation — the system will show a sample letter for the first selected vacancy so you can evaluate the result.
Automatic Sending Process
After confirmation, the system starts sending in the background:
- Applications are sent every 30 seconds in batches
- Delays are maintained between submissions to respect hh.ru rate limits
- You can close the page — sending continues on the server
Vacancy Statuses
| Status | Meaning |
|---|---|
| Fetched | Vacancy loaded, awaiting your decision |
| Accepted | Selected for sending, waiting in queue |
| Sent | Application successfully sent |
| Already applied | You've already applied to this vacancy before |
| Denied | hh.ru rejected the application (vacancy closed or criteria mismatch) |
| Unprocessable | Vacancy unavailable or deleted |
| Declined | You manually declined the vacancy |
Sending progress is displayed in real time on the statistics panel with visualization for each status.
Error Handling
The system automatically handles common issues:
- Captcha — if hh.ru shows a captcha, the account is temporarily paused (for 1 hour), then sending resumes
- Rate limits — when limits are exceeded, the system pauses and continues later
- Expired token — automatic token refresh. If refresh fails, the account status changes to "Authorization required"
- AI generation errors — if letter generation fails, the system retries on the next cycle