Core Concepts
The mental model behind Coco HR — what each building block is and how they connect.
Coco HR is an AI recruiting and assessment platform. You post jobs, define what "good" looks like in a reusable template, invite candidates, and let AI score their answers with a detailed, proctored report. This page explains the pieces so the rest of the docs make sense.
The big picture
flowchart LR
A[Company workspace] --> B[Job]
B --> C[Template]
C --> D[Questions]
B --> E[Applicant / Candidate]
E --> F[Assessment]
F --> G[AI report + Verdict]
A Job describes the role. A Template attached to that job defines the assessment. Candidates apply or are invited, take the assessment, and receive an AI-scored report.
Company workspace
When you sign up, you create a company workspace. Everything you create — jobs, templates, applicants, reports — lives inside it and is shared with the people you work with. Your company also has an admin (the person who signed up), settings, and billing.
Jobs
A Job is a role you're hiring for. It holds the title, location, requirements, and description. When you save a job, Coco HR uses AI to extract the key skills from it — those skills drive assessment question generation. Jobs have a status: Draft, Open, or Closed.
Templates (the assessment blueprint)
A Template is the reusable definition of an assessment. You attach it to a job, and it decides:
- Which skills are tested.
- How many subjective (open-ended), multiple choice, and coding questions there are.
- How much time per question and overall.
- Whether answers are audio-only or typed answers are also allowed, whether a practice round is included, and whether questions are read aloud (text-to-speech).
When you save a template, Coco HR generates the questions automatically with AI, based on the job's skills.
Questions
Questions are the individual items in an assessment. Coco HR generates them at the template level, so you rarely create them by hand. Types include:
| Type | What the candidate does | How it's scored |
|---|---|---|
| Subjective | Writes or speaks an open answer | AI evaluation |
| Multiple choice (MCQ) | Picks one of four options | Auto-graded |
| Coding | Writes code in an in-browser editor | AI evaluation |
Subjective answers can be spoken (audio) or typed, depending on the template. A separate set of practice questions can warm the candidate up before the scored assessment begins.
Applicants and candidates
An Applicant (or Candidate) is a person being considered for a job. You can add them directly (resume upload auto-fills their name and email) or let them apply themselves through a public link. Each applicant has a profile, a status, and — once they finish — an assessment report.
Assessments and AI scoring
An Assessment is the test a candidate takes, plus the AI report it produces. The report includes:
- An overall AI Score.
- A scoreboard of per-metric bars (for example Completeness, Relevance, and Technical for theory questions).
- An anti-cheat / proctoring report: device and network details, plus signals like camera on, stayed in fullscreen, and tab-switch count.
- Webcam and screen recordings and periodic webcam snapshots for your manual review.
- A per-question breakdown with the candidate's answer, an AI remark, and a score badge (Meets Standard, Partial, or Inadequate).
Coco HR gives you scores, signals, and evidence. It does not make a hire/no-hire decision for you, and it does not do automated face detection — snapshots and recordings are there so a human can review.
Verdicts
A Verdict summarizes where a candidate stands: Pending, Selected, or Rejected. You can filter your applicant list by verdict to focus on the people who matter right now.
The two links
Coco HR uses two different links — it helps to keep them straight:
| Link | URL shape | Who uses it | Purpose |
|---|---|---|---|
| Public apply link | https://hr.cocolevio.com/apply/{jobId} | Anyone | Candidates apply to a job themselves (resume + details). One link per job. |
| Assessment link | https://hr.cocolevio.com/assessment/{applicantId} | One invited candidate | Take the actual assessment. One link per candidate. |
Share the apply link publicly to collect applications. Send the assessment link privately to invite a specific person to take the test.
Roles
- Company Admin — the account owner. Sees everything, including Settings, billing, integrations, security, and API management.
- Regular users (recruiters and teammates) — work with jobs, applicants, templates, questions, the dashboard, and Copilot.
Admin-only areas are hidden from regular users at the navigation level. (Team-member invitations and a full roles matrix are still being built — see "Coming soon" in the User guide.)
Billing at a glance (pay-as-you-go)
Coco HR is usage-based. You start with a 14-day free trial (no credit card). After that you can stay on pay-as-you-go, or use Free Forever by bringing your own AI provider key.
Metered rates (the rate card is always the source of truth):
| What's metered | Rate |
|---|---|
| AI-scored assessment | $4.00 each |
| Async video submission | $2.00 each |
| Storage | $1.00 per GB-month (first 10 GB free) |
| Active applicant | $0.50 per applicant per month |
Billing runs monthly in arrears through Stripe. Bringing your own AI key makes AI usage free (you pay your provider directly); storage, applicant, and video metering still apply.
Where to go next
- Quickstart — do it all end to end.
- User guide — a screen-by-screen reference.
- Billing and pricing — the full rate card.