How Interviewer creation works
In the Create Interviewer flow, you configure three core areas:- Details: Role, description, logistics (location, type), interview settings, and AI instructions.
- Intake: Screening questions shown on the application form.
- Questions & Generation Config: The strategy for how the AI asks questions, whether manually defined, dynamically generated from the candidate’s resume, or based on specific skills.
Fill details for accuracy and context
1. Interviewer basics & logistics
- Write a specific Interviewer title: Include clear seniority and function (maximum 255 characters).
- Better: Senior Frontend Engineer (React)
- Avoid: Developer
- Select the closest role: Define the functional role (maximum 255 characters).
- Experience levels: Add minimum and maximum experience limits when the role requires it.
- Logistics: Define the
interviewerType(full-time, part-time, contract) andlocationType(remote, onsite). If onsite, provide the country, city, and zipcode. - Benefits: Clearly state the perks and benefits (maximum 5000 characters).
2. Interviewer description and requirements
- Description: Focus on business outcomes and real responsibilities.
- Requirements: Separate must-have skills from nice-to-have skills. Keep requirements concrete.
3. Interview settings
- Language: Choose based on the target candidate pool. Supported languages include English, Hindi, Spanish, French, Chinese, German, Italian, Japanese, and Korean.
- Mandatory fields: Set
resumeRequired,portfolioRequired, andvideoRequiredintentionally. - Duration & expiration: Set the
interviewDuration(10 to 60 minutes) andlinkExpirationDays(1 to 10 days, default is 4). - Device restriction: Enable
desktopOnlyif the interview requires a stable desktop environment rather than a mobile device.
4. AI interview configuration
These messages define what the AI will speak at the start and end of the call.- Introduction message (Maximum 1000 characters):
- Example: “Hi , welcome and thank you for taking the time to speak with us today. I’ll be conducting your interview for the Cold Calling Executive role at Gurkha Cleaning Ltd. Let’s get started.”
- Ice breaker (Optional, maximum 500 characters):
- Example: “To start off, can you tell me about yourself?”
- Interview closing message (Maximum 500 characters):
- Example: “Thank you, . That concludes the interview.”
Configure screening questions (application filter)
Screening questions are asked in the application form before interview processing. Keep screening questions concise (typically 3 to 6 questions).
Question types
- Yes/No: Binary eligibility checks (work authorization, willingness).
- Numeric: Threshold checks (years of experience, quota size).
- Text: Free-form information (links, certifications, portfolio notes).
Best practices
- Must-haves: Mark
mustHaveQualificationonly for true blockers. - Required: Use
isRequiredonly when missing data should block progression. - Expected answer: Clearly define what the system should look for to pass the candidate.
Build interview questions & generation strategy
This is the most critical section for downstream interview quality. You now have complete control over how questions are sourced using the
customQuestionConfig.1. Question generation sources
You can mix and match three different question sources and define thesectionOrder in which the AI asks them:- Manual: Pre-written, static questions asked to every candidate.
- Resume-based: The AI dynamically generates a set number of questions (up to 10) based on the candidate’s uploaded resume and your specific
generationInstructions(maximum 4000 characters). - Skills-based: The AI generates questions testing specific items from your
allowedSkillslist (up to 50 skills). You can setflexibleSkillsto true to allow the AI to adapt, and provide customgenerationInstructions.
2. Writing manual custom questions
For each manual question, you must complete the following framework:| Component | Purpose | Details & Limits |
|---|---|---|
| Question | The prompt the AI asks the candidate. | Must be specific and clear. |
| Looking for | The specific traits or evidence you want to hear. | Guides the AI’s scoring engine. |
| Strong answer (5) | Concrete examples of a top-tier response. | Sets the benchmark for a perfect score. |
| Weak answer (1) | Red flags or lack of specific evidence. | Sets the floor for a failing score. |
| Weight | Importance level (1 to 10). | 1 is informational, 9 to 10 is role-critical. |
| Max follow-ups | How many times the AI can dig deeper. | Must be between 0 and 2. |
Weight & follow-up guidance
- Weight 1: Informational only (excluded from overall score).
- Weight 5 to 8: Core competencies.
- Weight 9 to 10: Role-critical differentiators.
- Max follow-up (0): Use for straightforward factual checks.
- Max follow-up (1 to 2): Use for behavioral, competency, or dynamic resume/skills questions to ensure the AI gets enough evidence without derailing the time limit.
Question-writing formula
Use this structure to ensure the AI gets the best data:- Ask for a specific past situation.
- Ask for actions taken.
- Ask for a measurable outcome.
- Better: “Tell me about a time you improved conversion in a low-performing funnel. What did you change and what metric improved?”
- Avoid: “How do you think about conversion optimization?“
3. Interview prompt-aware best practices
The AI interviewer is programmed for specific behaviors. To align your questions with its logic:- Neutrality: The AI stays neutral (no praise).
- Evidence-based: It will utilize its follow-up allowance (up to 2 times) to request specific evidence when answers are vague.
- Scoped: Keep each question focused on exactly one competency.
Pre-publish checklist
Before you publish your Interviewer, review the following requirements:- Interviewer title, role, and logistics (location/type) are specific and accurate.
- Interview duration and link expiration are set correctly.
- Messages (intro, icebreaker, closing) are within character limits.
- Screening questions are minimal, with must-haves flagged appropriately.
- Question generation strategy (
sectionOrder) is clearly defined. - Dynamic instructions (Resume/Skills) are clear and under the 4000-character limit.
- Every manual interview question has complete evaluation criteria.
- Follow-up limits do not exceed 2 per question.

