Company, Account, and User Relationships
Understanding the hierarchy of your organization on SmartInterviews.AI ensures efficient data management and user role assignment:
Structure & Roles
- The Company: Your organization sits at the top level and has exactly one Company Admin with full oversight.
- Accounts: Your company can contain multiple Accounts (e.g., HR-Tech, HR-Sales, UK-Branch) to segregate hiring pipelines and billing.
- Users: Each secondary user (Recruiter/Interviewer) must be assigned to exactly one Account.
Candidate Assignment Logic
Every candidate must belong to a specific Account for tracking and evaluation purposes:
- Account Users: When a standard user creates a candidate, that candidate is automatically assigned to the user's specific account.
- Company Admins: Since the Company Admin has global visibility, they must manually select the Account during candidate setup to ensure the record is filed correctly.
How To Register Your Company
Registering your company on SmartInterviews.AI is the first step toward automating your technical hiring process.
- Navigate to the Companies page from the main menu.
- Click on the Register Company button.
- Fill in the registration form with your company details, business category, and Point of Contact (POC) information.
- Submit the form. Your application will be sent to our administration team for validation.
- Once approved, you will receive an automated email with your login credentials and a link to the Admin Panel.
How To Register As Student
Students can self-register to access free practice interviews or company-assigned assessments.
- Go to the Students page.
- Select Register/Login.
- Choose the Student category and provide your university details.
- Upon submission, your account is created instantly.
- Check your email for your temporary password and login to the Candidate Portal.
How To Register as Professional
Experienced professionals can use our platform to validate their skills and share results with prospective employers.
- Visit the Professionals page.
- Complete the registration form with your years of experience and core technology stack.
- Verify your email address via the link sent to your inbox.
- Access your dashboard to schedule your first AI-led technical evaluation.
How To Add Candidates
Before scheduling interviews for candidates, you must first register them in the system with their roles and skills configured. This registration process creates a candidate profile that can be used for multiple interviews over time. The roles and skills you configure here determine the AI's question generation for all future interviews with this candidate.
Prerequisites
- You must be logged in as an Administrator or Manager.
- You should have identified the candidate's target role and required skills before registration.
- Have the candidate's basic contact information ready (name, email, phone).
Step 1: Access Candidate Management
- Login to the Admin Portal with your administrator or manager credentials.
- Navigate to Candidates in the sidebar menu.
- You'll see a list of all registered candidates with their current status and interview history.
- Click the Add Candidate button (usually located at the top-right of the page).
Step 2: Enter Candidate Personal Information
Fill in the candidate's basic details. This information is used for identification, communication, and record-keeping:
- First Name: Candidate's first name (e.g., "John").
- Last Name: Candidate's last name (e.g., "Smith").
- Email Address: The candidate's primary email address. This is critical for communication and interview notifications. Ensure it's correct and active.
- Phone Number: Contact phone number for additional communication or verification purposes.
Note: When selecting roles for the candidate, it is assumed that the candidate has the requisite experience for those roles. The role selection should reflect their actual capabilities and target position level.
Step 3: Configure Interview Type
Select the type of interview you plan to conduct with this candidate. This sets the overall framework for question generation:
- Technical: For software engineers, developers, data scientists, QA engineers, etc. Focuses on coding, algorithms, system design, and technical problem-solving.
- Management: For engineering managers, project managers, team leads, etc. Emphasizes leadership, project management, team dynamics, and strategic thinking.
- Mixed: Combines both technical and management aspects. Suitable for senior engineers transitioning to leadership or technical managers.
Note: You can typically change this later if the candidate's interview focus changes.
Step 4: Select Target Roles
Choose one or more job roles this candidate is being evaluated for. The system supports multiple role selection, which is particularly useful for techno-functional positions where candidates need both technical and managerial competencies:
- Development Roles: Full Stack Developer, Frontend Developer, Backend Developer, Mobile Developer (iOS/Android), Game Developer, etc.
- Data & AI Roles: Data Scientist, Data Engineer, Machine Learning Engineer, AI Researcher, Data Analyst, etc.
- Infrastructure Roles: DevOps Engineer, Cloud Engineer, Site Reliability Engineer (SRE), System Administrator, Network Engineer, etc.
- Quality & Testing: QA Engineer, Test Automation Engineer, Performance Engineer, etc.
- Management Roles: Engineering Manager, Technical Lead, Product Manager, Project Manager, Scrum Master, etc.
- Specialized Roles: Security Engineer, Database Administrator, Solutions Architect, etc.
For Techno-Functional Roles: You can select roles from both technical and managerial categories. For example, select "Full Stack Developer" + "Technical Lead" for a senior position requiring both coding expertise and team leadership.
The selected roles ensure questions are relevant to all aspects of the candidate's target position. Hold Ctrl (Windows) or Cmd (Mac) to select multiple roles.
Step 5: Select Required Skills and Technologies
This is the most detailed and critical step. Select multiple skills - choose all the specific technologies, frameworks, and competencies the candidate should be evaluated on. The AI will generate questions covering these areas:
Technical Skills Selection Guidelines:
- Programming Languages: Select the languages relevant to the role (e.g., JavaScript, Python, Java, C++, C#, Ruby, Go, PHP, Swift, Kotlin, TypeScript, etc.).
- Frontend Technologies: React, Angular, Vue.js, Svelte, HTML5, CSS3, SASS, Bootstrap, Material-UI, Redux, etc.
- Backend Frameworks: Node.js, Express.js, Django, Flask, FastAPI, Spring Boot, .NET Core, Ruby on Rails, Laravel, etc.
- Databases: MySQL, PostgreSQL, MongoDB, Redis, Cassandra, DynamoDB, Oracle, SQL Server, etc.
- Cloud Platforms: AWS (EC2, S3, Lambda, RDS), Azure, Google Cloud Platform (GCP), DigitalOcean, etc.
- DevOps Tools: Docker, Kubernetes, Jenkins, GitLab CI/CD, GitHub Actions, Terraform, Ansible, etc.
- Version Control: Git, GitHub, GitLab, Bitbucket, SVN, etc.
- Testing: Jest, Mocha, Pytest, JUnit, Selenium, Cypress, Postman, etc.
- Other Tools: APIs (REST, GraphQL), Microservices, Message Queues (RabbitMQ, Kafka), Elasticsearch, etc.
Soft Skills and Domain Knowledge:
- Soft Skills: Communication, Problem Solving, Teamwork, Leadership, Critical Thinking, Time Management, etc.
- Methodologies: Agile, Scrum, Kanban, Waterfall, DevOps practices, Test-Driven Development (TDD), etc.
- Architecture: System Design, Microservices Architecture, Event-Driven Architecture, Design Patterns, etc.
- Security: OWASP Top 10, Authentication/Authorization, Encryption, Secure Coding, etc.
Best Practices for Skill Selection:
- Be Specific: Select only skills that are genuinely required for the position. More skills don't mean better assessment.
- Prioritize Core Skills: Focus on 4-7 core skills rather than 15-20 superficial ones. The AI can only ask so many questions in a typical interview.
- Match Job Requirements: Align skills with the actual job description to ensure relevant assessment.
- Consider Experience Level: Select technologies the candidate claims expertise in, not just what's on the job description.
- Balance Breadth and Depth: For senior roles, include both technical skills and architectural/leadership topics.
Step 6: Set Difficulty Level
Choose the difficulty level that matches the candidate's experience and the complexity of questions you want the AI to ask:
- Easy:
- Suitable for: Entry-level candidates, fresh graduates, or those with 0-2 years of experience
- Question focus: Basic syntax, fundamental concepts, simple programming constructs
- Expectations: Understanding of core principles, correct answers without deep optimization
- Example topics: Variable declarations, loops, basic functions, simple data structures
- Medium:
- Suitable for: Mid-level candidates with 2-5 years of experience
- Question focus: Practical scenarios, moderate algorithms, integration challenges, real-world problem-solving
- Expectations: Working solutions with edge case consideration, understanding of trade-offs
- Example topics: API integration, database queries, error handling, performance considerations
- Hard:
- Suitable for: Senior candidates with 5+ years of experience, architects, team leads
- Question focus: Complex systems, optimization, architectural decisions, scalability, leadership scenarios
- Expectations: Efficient solutions, system design thinking, production-grade considerations, strategic choices
- Example topics: Microservices architecture, distributed systems, performance optimization, team management
Step 7: Review and Save
- Review all entered information carefully:
- Verify email address is correct (typos will prevent interview invitations)
- Confirm roles and skills match the actual requirements
- Ensure difficulty level aligns with candidate's experience
- Click Save or Register Candidate.
- The system creates the candidate profile and assigns a unique candidate ID.
- The candidate now appears in your Candidates list with status "Registered".
Step 8: What Happens After Registration
- The candidate profile is saved in the system with all configured roles and skills.
- The candidate is now available in the dropdown when scheduling interviews (see Setting Up Interviews).
- No interview is automatically scheduled - you must explicitly schedule one using the interview scheduling interface.
- You can edit the candidate's profile anytime to update skills, difficulty level, or contact information.
- The same candidate can be used for multiple interviews over time without re-entering their information.
Managing Existing Candidates
After registration, you can manage candidates through the Candidates page:
- View Details: Click the candidate name or View icon to see their full profile, interview history, and results.
- Edit Profile: Update contact information, roles, skills, or difficulty level. Changes apply to future interviews only.
- Deactivate: Temporarily disable a candidate without deleting their history (e.g., if they withdraw from the process).
- Delete: Permanently remove a candidate and all associated data. Use cautiously as this cannot be undone.
- Schedule Interview: Quick action to schedule a new interview for this candidate.
- View Interview History: See all past and scheduled interviews for this candidate.
Best Practices for Candidate Registration
- Register Before Scheduling: Always register candidates first with their complete profile before attempting to schedule interviews.
- Batch Registration: If you have multiple candidates for the same role, register them together with consistent skill configurations for fair comparison.
- Keep Profiles Updated: If a candidate's target roles or skills change, update their profile before scheduling additional interviews.
- Use Descriptive Notes: Add internal notes to help your team understand the context (recruiting round, referral source, special requirements).
- Verify Email Early: Double-check email addresses during registration to avoid issues when sending interview invitations.
- Standardize Difficulty Levels: Use consistent difficulty criteria across similar positions for fair evaluation.
- Document Skill Requirements: Maintain a standard skill set for each role type to ensure consistency across candidates.
Troubleshooting
- Cannot Save Candidate: Ensure all required fields (name, email, roles, skills) are filled. Email must be in valid format.
- Duplicate Email Error: A candidate with this email already exists. Search for them in the candidates list or use a different email.
- Skills Not Appearing: Some skills are role-specific. Change the selected roles to see different skill options.
- Cannot Select Multiple Skills or Roles: Hold Ctrl (Windows) or Cmd (Mac) to select multiple items in the roles and skills dropdowns.
- Candidate Not Appearing in Interview Dropdown: Ensure the candidate is saved and in "Active" status. Deactivated candidates don't appear in interview scheduling.
- Wrong Roles Selected: Edit the candidate profile before scheduling interviews. You cannot change roles during interview scheduling.
How To Set Up An Interview
Our platform supports two types of users with different interview setup flows: Companies & Recruiters who schedule interviews for registered candidates, and Students & Professionals who schedule their own practice interviews. Both approaches leverage AI-powered question generation and real-time assessment.
For Companies & Recruiters
Admin & Manager Access RequiredAdministrators and Managers can schedule customized interviews for specific candidates through the admin portal. The system will automatically send invitation emails and track the interview lifecycle.
Prerequisites
Important: Before scheduling an interview, you must first register the candidate with their roles and skills configured. The candidate's profile determines which questions the AI will generate.
- Candidate must be registered in the system (see Adding Candidates section).
- Candidate's role and required skills must be configured in their profile.
- Candidate must be in "Active" status.
Step 1: Access the Interview Scheduling Interface
- Login to the Admin Portal with your administrator or manager credentials.
- Navigate to Interviews in the sidebar menu.
- Click the Schedule Interview button (usually located at the top-right of the page).
Step 2: Select Candidate from Dropdown
Choose the candidate you want to schedule an interview for:
- Candidate Dropdown: Open the candidate selection dropdown. This shows all registered candidates with their names and email addresses.
- Search Functionality: If you have many candidates, use the search box to filter by name or email.
- Candidate Preview: After selecting a candidate, the system displays their configured:
- Target roles (e.g., "Full Stack Developer, Technical Lead")
- Selected skills (e.g., "JavaScript, React, Node.js, PostgreSQL")
- Difficulty level (e.g., "Medium")
- Interview type (e.g., "Technical")
- Edit Profile Link: If the displayed information is incorrect, click "Edit Candidate Profile" to update their roles and skills before proceeding.
Note: The roles and skills shown here were configured when the candidate was registered. You cannot change them during interview scheduling. To modify them, you must edit the candidate's profile first.
Step 3: Choose Interview Mode
The system supports two interview modes. Select the one that best matches your assessment needs:
Mode 1: Role/Skills Based Interview (Default)
Questions are generated based on the candidate's configured roles and skills from their profile:
- The AI uses the roles and skills you selected during candidate registration.
- Questions cover all the technologies and competencies configured in the candidate profile.
- Best for: General skill assessment, technical screening, competency validation.
- No additional configuration needed - simply proceed to the next step.
Mode 2: Job Description Based Interview
Questions are generated based on a specific job description, providing more targeted and role-specific assessment:
- Prerequisites:
- You must have a Job Description created with an AI-generated summary.
- The Job Description must be linked to your account (only JDs associated with your account will appear).
- The Job Description must be in "Active" status.
- How to use:
- Select the "Job Description Based" interview mode option.
- A dropdown will appear showing all active job descriptions linked to your account.
- Search and select the relevant job description from the dropdown.
- The AI will generate questions based on:
- The JD summary (role requirements, responsibilities, technical skills)
- Combined with the candidate's configured skills (for additional depth)
- Benefits:
- Questions are highly specific to the actual job posting.
- Assesses candidate fit for the exact role requirements.
- More relevant evaluation for position-specific hiring.
- Note: If no job descriptions appear in the dropdown, verify that they are linked to your account and have Active status. See the Job Description Based Interview section for detailed setup.
Step 4: Configure Interview Duration and Language
- Duration Per Question: Set the time limit for each question (default: 3 minutes per question).
- According to research, 3-5 minutes is more than sufficient to answer most interview questions.
- Technical questions typically require no more than 3 minutes for a complete answer.
- Managerial questions may require up to 5 minutes based on the complexity of scenarios.
- The total interview duration = Question Count × Duration Per Question (e.g., 10 questions × 3 minutes = 30 minutes total).
- Language: Choose the interview language (English, Spanish, French, etc., depending on your system configuration).
- Question Count: Set the total number of questions for the interview (default: 10).
- The default of 10 questions is based on research showing that candidates typically lose interest and engagement when interviews exceed 10-12 questions.
- You can adjust this based on your requirements, but consider that more questions may lead to candidate fatigue and reduced response quality.
- Recommended range: 8-12 questions for optimal candidate experience.
- Coding Task Count: (Optional) Specify how many questions should be coding tasks.
- Coding tasks require candidates to write actual code to solve programming problems.
- The coding task count is included in the total question count, not additional to it.
- For example: If you set 10 total questions with 3 coding tasks, the interview will have 7 regular questions + 3 coding questions.
- Use coding tasks for technical roles where hands-on programming assessment is important.
- Typical mix: 20-30% coding tasks (e.g., 2-3 coding tasks out of 10 questions).
Step 5: Review and Schedule
- Review all entered information in the confirmation dialog:
- Candidate name and email
- Configured roles and skills (from candidate profile)
- Interview duration and language
- Linked job description (if applicable)
- Set the Interview Window - Define the 24-hour availability window for the interview:
- Once scheduled, the candidate has a 24-hour window to complete the interview from when they start.
- You can optionally set a specific start date/time if you want to control when the interview becomes available.
- The system automatically sets the expiry as 24 hours after the interview is started by the candidate.
- This ensures candidates have adequate time to complete without leaving interviews open indefinitely.
- Click Schedule Interview or Save.
Step 6: What Happens Next
- The system generates a unique, secure interview link for the candidate.
- The AI prepares questions based on:
- The candidate's configured roles and skills (from their profile)
- The selected difficulty level (from their profile)
- The linked job description summary (if applicable)
- The interview duration you specified
- An email is sent to you (the administrator/manager) who scheduled the interview with:
- The interview access link for the candidate
- Interview details (roles, skills, duration, 24-hour window)
- Candidate information
- You must communicate the interview link to the candidate through your preferred channel (email, messaging platform, etc.).
- The interview appears in your Interviews Dashboard with status "Scheduled".
- You'll receive notifications when the candidate starts and completes the interview.
- After completion, detailed feedback and recordings become available for review.
Understanding the Workflow
The complete interview workflow for companies follows this sequence:
- Register Candidate: Add candidate with roles, skills, and difficulty level configured (see Adding Candidates).
- Schedule Interview: Select the candidate from dropdown, optionally link a job description, set duration.
- Adaptive Question Generation: The system generates questions adaptively during the interview based on the candidate's answers. Questions are not pre-generated but selected in real-time based on response quality, ensuring appropriate difficulty progression.
- Receive Interview Link: The account user (administrator/manager) who scheduled the interview receives an email with the interview link. The user must then communicate this link to the candidate through their preferred channel.
- Candidate Takes Interview: Candidate completes the AI-led interview at their convenience (within expiry window).
- AI Evaluates Responses: System analyzes answers in real-time and provides detailed feedback after completion.
- Review Results: You review scores, feedback, and recordings to make hiring decisions.
For Students & Professionals
Self-Service InterviewSelf-registered users can schedule their own practice interviews to prepare for real job interviews, assess their skills, and identify areas for improvement. This is ideal for students, job seekers, and professionals looking to upskill.
Step 1: Create an Account or Login
- Visit the platform's Candidate Portal or main landing page.
- If you don't have an account:
- Click Sign Up or Register.
- Enter your name, email, and create a password.
- Verify your email address through the confirmation link sent to your inbox.
- If you already have an account, simply Login with your credentials.
Step 2: Navigate to Interview Scheduling
- After logging in, look for Schedule Interview, New Interview, or Practice Interview in the navigation menu.
- This typically appears on your dashboard or in the sidebar.
Step 3: Select Your Target Role
Choose the job role you're preparing for or want to be assessed on:
- Technical Roles: Full Stack Developer, Frontend Developer, Backend Developer, Data Scientist, QA Engineer, DevOps Engineer, Mobile Developer, etc.
- Management Roles: Engineering Manager, Product Manager, Project Manager, Scrum Master, Technical Lead, etc.
- The selected role determines the type of questions you'll receive.
Step 4: Choose Technologies and Skills
Select the specific technologies or skills you want to be tested on:
- Programming Languages: JavaScript, Python, Java, C++, Ruby, Go, etc.
- Frameworks: React, Angular, Vue.js, Django, Spring Boot, Express.js, etc.
- Databases: MySQL, PostgreSQL, MongoDB, Redis, etc.
- Cloud & DevOps: AWS, Azure, Docker, Kubernetes, Jenkins, etc.
- Other Skills: System Design, Algorithms, Data Structures, APIs, Testing, etc.
- You can typically select 3-5 skills per interview for focused assessment.
Step 5: Set Difficulty Level
Choose a difficulty level that matches your current experience:
- Beginner: If you're new to the technology or have less than 1 year of experience.
- Intermediate: If you have 1-3 years of experience and can handle practical problems.
- Advanced: If you have 3+ years and can tackle complex architectural questions.
- Expert: If you're preparing for senior/principal roles requiring deep expertise.
Step 6: Apply Promo Code (If Available)
- If you have a Promo Code or Discount Coupon, enter it in the designated field.
- Promo codes may provide:
- Free interview credits
- Discounts on interview packages
- Extended interview duration
- Access to premium features
- Click Apply to validate the code.
Step 7: Review Pricing and Confirm
- Review the interview cost (if applicable). Some platforms offer:
- Free tier: 1-2 interviews per month
- Pay-per-interview: Single interview purchase
- Subscription plans: Unlimited interviews for a monthly fee
- Review interview parameters: role, skills, difficulty, duration.
- Click Confirm or Proceed to Payment (if applicable).
Step 8: Complete Payment (If Required)
- If the interview requires payment, you'll be redirected to a secure payment gateway.
- Supported payment methods typically include:
- Credit/Debit cards (Visa, Mastercard, American Express)
- UPI (for Indian users)
- Net Banking
- Digital wallets (PayPal, Razorpay, Stripe, etc.)
- Complete the payment and wait for confirmation.
Step 9: Start Your Interview
- After confirmation, you'll see an Start Interview button or receive an email with the interview link.
- You can start immediately or schedule for later (within the validity period, usually 30 days).
- Before starting, ensure:
- Your webcam and microphone are working
- You have a stable internet connection
- You're in a quiet, well-lit environment
- You have the required interview duration available without interruptions
- Click Start Interview when ready.
- Grant camera and microphone permissions when prompted by your browser.
Step 10: After the Interview
- Once completed, the AI analyzes your responses and generates detailed feedback.
- You'll receive an email notification when the results are ready (usually within a few minutes).
- Access your Interview Dashboard or My Interviews to:
- View your overall score and performance breakdown
- Read detailed feedback on each question
- Watch video recordings of your responses
- Download a PDF report for your records
- Identify strengths and areas for improvement
Understanding Interview Configuration Options
Both user types benefit from understanding how configuration affects the interview experience:
Role Selection Impact
- Technical Roles: Expect coding questions, algorithm challenges, system design scenarios, debugging tasks, and technical problem-solving.
- Management Roles: Expect situational questions, leadership scenarios, conflict resolution, project planning, team management, and strategic thinking.
- Mixed Roles: Combination of both technical depth and management breadth.
Skill Selection Strategy
- Focused Approach: Select 2-3 skills for in-depth assessment (recommended for preparation).
- Broad Approach: Select 5-7 skills for comprehensive coverage (recommended for general readiness check).
- The AI generates questions proportionally across selected skills.
- More skills = broader but less deep coverage per skill.
Difficulty Level Effects
- Easy:
- Questions: Basic syntax, simple algorithms, fundamental concepts, straightforward problem-solving
- Expectations: Correct understanding of basics, no deep optimization required
- Suitable for: Entry-level candidates or those new to the technology (0-2 years experience)
- Typical duration: 30 minutes (10 questions × 3 minutes)
- Medium:
- Questions: Practical scenarios, moderate algorithms, integration tasks, real-world problem-solving
- Expectations: Working solutions with consideration for edge cases and trade-offs
- Suitable for: Mid-level candidates with practical experience (2-5 years experience)
- Typical duration: 30-40 minutes (10 questions × 3-4 minutes)
- Hard:
- Questions: Complex systems, optimization, architectural decisions, scalability, leadership scenarios
- Expectations: Efficient solutions, trade-off analysis, system design thinking, strategic considerations
- Suitable for: Senior candidates, architects, team leads (5+ years experience)
- Typical duration: 40-50 minutes (10 questions × 4-5 minutes)
Best Practices for Successful Interviews
For Companies Scheduling Interviews:
- Match Difficulty to Position: Accurately set the difficulty level based on the actual job requirements, not aspirational levels.
- Be Specific with Skills: Select skills that are genuinely required for the role, not just "nice to have".
- Set Realistic Duration Per Question: Use 3-4 minutes per question for most roles. Technical questions need ~3 minutes; managerial questions may need up to 5 minutes.
- Use Job Descriptions: Link a well-written JD for more targeted, role-specific questions.
- Clear Communication: When sending the interview link to candidates, inform them about the interview format, total duration, number of questions, and technical requirements (camera, microphone, stable internet).
- Provide Adequate Notice: Give candidates at least 24-48 hours after sharing the interview link to prepare and test their setup.
- Explain the 24-Hour Window: Clearly communicate that once the candidate starts the interview, they have 24 hours to complete it.
For Candidates Taking Interviews:
- Test Your Setup: Check camera, microphone, and internet speed before starting. Most platforms offer a system check.
- Choose Appropriate Difficulty: Start one level below your perceived skill to build confidence, then progress upward.
- Focus Your Practice: Select 3-4 skills you're actively using or preparing for, rather than spreading too thin.
- Find a Quiet Space: Background noise and interruptions can affect both your performance and the AI's assessment.
- Think Out Loud: Verbally explain your thought process. The AI evaluates communication and reasoning, not just final answers.
- Take Your Time: It's better to give one well-explained answer than rush through multiple shallow responses.
- Review Feedback Thoroughly: After completion, study the detailed feedback to identify improvement areas.
- Practice Regularly: Schedule practice interviews weekly or bi-weekly to track improvement over time.
Troubleshooting Common Issues
- Cannot Select Required Skills: Ensure you've selected a primary role first. Skills are filtered based on role relevance.
- Email Not Received (Companies): If you didn't receive the interview link email after scheduling, check your spam folder. You can also manually copy the interview link from the Interviews Dashboard by clicking on the scheduled interview.
- Payment Failed (Candidates): Try a different payment method, clear browser cache, or contact support. Your interview slot is held for 10 minutes.
- Interview Link Expired: The 24-hour window starts when the candidate begins the interview. If they don't complete within 24 hours, contact support to reset or reschedule the interview.
- Too Many Skills Selected: Most systems limit to 5-7 skills per interview. Reduce your selection or schedule multiple focused interviews.
- Wrong Difficulty Level: For scheduled interviews (companies), edit the candidate profile before scheduling the interview. The difficulty level cannot be changed once the interview is scheduled.
- Cannot Start Interview: Ensure you're using a supported browser (Chrome, Firefox, Edge), have granted camera/microphone permissions, and have a stable internet connection (minimum 2 Mbps upload speed).
- Promo Code Invalid: Verify the code is correctly entered (case-sensitive), check expiry date, and ensure it applies to your account type (some codes are organization-specific).
How To Set Up Job Description Based Interview
Create targeted interviews based on specific job descriptions for more accurate candidate assessment. The AI will generate questions tailored to the exact requirements of your job posting.
Prerequisites
- You must have at least one Job Description created and saved in the system.
- The job description must have an AI-generated summary (created automatically when you save a new JD).
- The job description must be in Active status.
Step 1: Create or Manage Job Descriptions
Before scheduling a job description-based interview, you need to create and manage job descriptions:
- Login to the Admin Portal.
- Navigate to Job Descriptions in the sidebar menu.
- Click Add Job Description button.
- Fill in the job details:
- Job Title: The position name (e.g., "Senior Full Stack Developer").
- Company Name: (Optional) The hiring company name.
- Department: Select from predefined departments or leave blank.
- Experience Level: Entry, Mid-level, Senior, Lead, or Principal.
- Employment Type: Full-time, Part-time, Contract, etc.
- Location: Job location or "Remote".
- Job Description: Paste the complete job description (minimum 100 characters).
- Tags: (Optional) Add searchable tags for easy filtering.
- Select the appropriate Account (for admins managing multiple accounts).
- Click Save Job Description.
- Important: The AI will automatically generate a structured summary in 10-15 seconds. This summary includes:
- Role summary and core responsibilities
- Required technical skills and programming languages
- Tools & frameworks needed
- Core competencies and domain knowledge
- Experience requirements and preferred skills
- Wait for the summary to be generated before using the JD for interviews. You can verify this by checking the "Summary" column in the Job Descriptions list.
Step 2: Schedule Interview with Job Description
Once your job description is ready with an AI summary, you can schedule interviews:
- Navigate to Interviews in the sidebar menu.
- Click Add Interview button.
- Fill in the candidate details:
- Search and select the Candidate from existing candidates.
- Set the Interview Start Date & Time.
- The End Date & Time is automatically set to 24 hours after start time.
- Configure Portal Access hours before the interview.
- Select the Language for the interview.
- In the Interview Configuration section:
- Select Job Description Based Interview radio button.
- Click on the Job Description field to open the search modal.
- In the Job Description Search Modal:
- Use the search box to find your job description by title, company, or keywords.
- Filter by Account, Experience Level, or Active status.
- Review the summary preview to ensure it matches your requirements.
- Only job descriptions with "Active" status and generated summaries can be selected.
- Double-click on a job description row or click the Select button.
- The selected job description will display in the field with a blue checkmark.
- Configure interview settings:
- Total Questions: Number of questions (5-20).
- Code Writing Questions: How many should be coding problems.
- Time Per Question: Minutes allocated per question (1-10).
- Difficulty Level: Easy, Medium, or Hard.
- Voice: Select AI interviewer voice.
- Review the payment section if applicable (promo codes or payment required).
- Click Schedule Interview.
- The candidate will receive an invitation email with a secure magic link to access the interview portal.
Step 3: Understanding How Job Description Interviews Work
Job description-based interviews offer targeted assessment:
- AI-Generated Questions: Questions are dynamically created based on the structured job description summary, ensuring relevance to the actual role requirements.
- Comprehensive Coverage: The AI considers all aspects of the job description including technical skills, responsibilities, tools, frameworks, and competencies.
- Contextual Evaluation: Candidate responses are evaluated against the specific job requirements rather than generic role/skill combinations.
- Snapshot Protection: A snapshot of the job description summary is saved with each interview, ensuring consistency even if the original JD is modified later.
- Better Candidate Matching: More accurate assessment of candidate fit for the specific position.
Step 4: Managing and Regenerating Job Description Summaries
You can manage your job descriptions and their AI summaries:
- View Summary: Click the view (👁️) icon on any job description to see the full AI-generated summary with all sections.
- Regenerate Summary: If the job description is updated, click Regenerate in the view modal to create a new AI summary.
- Edit Job Description: Click the edit (✏️) icon to modify job details. The summary will be regenerated automatically if the job description text changes.
- Archive/Activate: Toggle between active and archived status. Only active JDs with summaries can be used for new interviews.
- Search & Filter: Use the search and filter options to quickly find job descriptions by title, company, department, or experience level.
Best Practices
- Complete Job Descriptions: Provide detailed job descriptions (at least 200 words) for better AI summary quality.
- Clear Requirements: List specific technologies, tools, and frameworks rather than generic terms.
- Include Responsibilities: Describe actual day-to-day responsibilities to help AI generate scenario-based questions.
- Specify Experience Level: Clearly indicate seniority level to ensure appropriate question difficulty.
- Regular Updates: Keep job descriptions current and regenerate summaries when requirements change.
- Review Summaries: Always review the AI-generated summary before scheduling interviews to ensure accuracy.
- Use Descriptive Titles: Choose clear, searchable job titles for easy identification when scheduling interviews.
Troubleshooting
- Summary Not Generated: Wait 15-20 seconds after saving. Refresh the page if needed.
- Job Description Not Selectable: Ensure the JD is Active and has a generated summary.
- Empty Summary Sections: The AI only extracts information explicitly mentioned in the job description. Add more details and regenerate.
- Wrong Summary Content: If the summary doesn't match the job description, try regenerating it or contact support.
How To Modify An Interview
If you need to change the parameters of a scheduled interview:
- Locate the interview in the Interview Dashboard.
- Click the Edit (pencil) icon next to the record.
- You can update the role, required skills, or difficulty level before the candidate starts.
- Note: Once an interview has reached "In Progress" or "Completed" status, parameters cannot be modified.
How To Create A New Account
For large organizations, you may want to create separate "Accounts" for different departments (e.g., HR-Tech, HR-Sales).
- Ensure your company has a Signed Contract status in our system.
- Navigate to Account Management in the sidebar.
- Click Add Account.
- Enter a unique name for the department/sub-entity.
- This allows you to segregate candidate data and interview billing per department.
How To Create Users
Assign secondary users (Recruiters or Interviewers) to specific accounts.
- Go to User Management.
- Click Add User.
- Enter the user's name and email.
- Assign them a Role (User or Manager) and link them to a specific Account.
- The new user will receive an email to set up their own password.
How To Change Password
Self-Service
Individual users can change their own passwords at any time:
- While logged in, look for the Sidebar Footer.
- Click on Change Password (🔐).
- Enter your current password followed by your desired new password.
- Passwords must be at least 8 characters long and include a mix of letters and numbers.
- Click Update to apply the change immediately.
For Managers/Admins
Managers can reset passwords for users within their associated company accounts:
- Navigate to User Management in the Admin Panel.
- Locate the specific user in the list and click the Edit icon.
- Enter a new password in the password field.
- Click Update User to save the changes.
How To Check Interview Responses
- Navigate to Interviews or Responses in the Admin Panel.
- Find the candidate in the list and click the View (👁️) icon.
- You will see:
- The AI's Overall Rating (1-10).
- A summary of strengths and weaknesses.
- Question-by-question transcriptions and evaluations.
- Audio/Video recordings (if enabled).
How To Report An Issue
Encountered a technical glitch? Our support team is here to help.
- Go to the Contact page.
- Select Technical Support as the inquiry type.
- Provide your Account ID and the specific Interview UUID if the issue occurred during an active session.
- Attach a screenshot of the error if possible. We typically respond within 4 business hours.
- Alternatively, email us at support@smartinterviews.ai.