Frequently Asked Questions

Answers to common questions about webhooks, interviews, and API concepts.

What is a call vs. interview?

You can conceptualize a call simply as an interview session (a phone call, or webcall). An interview can contain many sessions, but usually it only takes 1 session to complete an interview. And an interview you can conceptualize it as the entirety of the script that our AI recruiter will need to go through. And each interview will be attached with an outcome.

What are the outcomes/statuses of the interview?

When an interview attains an outcome, it means at this point we have
determined the status and have all the information we need from the candidate.
Once a status has been established, no additional reminder messages will be sent.

Interview Completed States:

  • completed - Interview finished successfully. Used when no qualifying
    questions are configured in the script, and the interview successfully
    completed all tasks.
  • qualified - Interview finished and the candidate passed all qualifying
    questions. The script must have qualifying questions configured with binary pass/fail
    criteria.
  • unqualified - Interview finished and the candidate failed one or more
    qualifying questions (triggered a disqualification condition).

Interview Not Completed States:

  • candidate_not_interested - Candidate indicated they are not interested in
    the position during the call.
  • ai_opt_out - Candidate requested to opt out of the AI interview and speak
    with a human.
  • candidate_not_responsive - Candidate did not respond to interview outreach
    (SMS/email/calls).
  • ai_stopped_override - Interview was manually stopped by a recruiter or
    admin before completion.

Interview Not Sent States:

  • not_sent_duplicate - Interview not initiated because a duplicate candidate
    record was detected. Note: this may require a custom logic add-on.
  • not_sent_already_completed - Interview not initiated because the candidate
    already completed an interview for this job.
  • not_sent_unreachable - Interview not initiated because the candidate's
    contact info was invalid or unreachable.
How can I kickoff the interview process?

We have 3 ways to kickoff the interview process through our endpoints:

  1. Calls -> Register a call
  2. Candidates -> Create a new candidate (include the fields send_sms and send_email)
  3. Candidates -> Send Interview
What happens if a candidate hangs up or does not finish the entire interview?

We handle the case where a candidate hangs up for any reason. In the case when this happens, we keep track of how far the candidate progressed in the interview. We will nudge them to finish the interview, and when another call is started, it will continue from where it was left off in the previous call.

What if a candidate never responds to outreach?

Our system reaches out to candidates a maximum of 5 times. The first message from the initial outreach, and then 4 reminders afterwards. We mark the outcome of the interview as candidate_not_responsive after we've exhausted all outreaches

Can I restart or re-initiate an interview with a candidate?

If an interview is active and was already initiated, you cannot start another. Our API will return an error that the candidate was already reached out to. If you could create a new call to restart the interview if absolutely needed, but typically it is one interview per candidate.

How do I get updated data about the interview or candidate?

We have 2 ways to get data back about the candidate's interview status:

  1. Webhook (recommended)
  2. Polling Data with the endpoint Candidate -> Retrieve candidate information
How do I create another organization or manage multiple?

We allow you to create new organizations and you as the administrator can manage multiple organizations. At the moment this isn't possible through our API. If you need to add more organizations added, reach out to us at [email protected]