> ## Documentation Index
> Fetch the complete documentation index at: https://docs.exterview.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Darwinbox
> Step-by-step: schedule an Exterview AI interview from a candidate's Darwinbox hiring workflow, and what the candidate does in each interview mode.
**Core.** Exterview AI connects to Darwinbox as an **Assessment Provider**. A recruiter schedules an Exterview interview from the assessment stage of a candidate's hiring workflow, the candidate completes it, and the score and report come back onto the candidate's profile in Darwinbox.
This is an assessment-provider connection: Darwinbox starts the interview, and Exterview returns the score, report, and status. It does not keep candidate and job records in sync in both directions. Bidirectional ATS and HRIS sync is Upcoming.
This page is the step-by-step process. It is written for **Darwinbox AM and CSD teams**, **customer HR and recruitment teams**, and the **Exterview delivery team**, so everyone works from the same steps.
Endpoints, credentials, payload formats and error codes are not published
here. Your Exterview contact issues those directly as part of onboarding.
## Before you begin
**Studio**, **Event Framework** and **Assessment Provider** must be on.
Raise a CSD task if any are missing.
Your Exterview contact issues the connection values and the list of
assessment templates for your tenant. Credentials are issued per customer
and are never reused across tenants.
The integration also needs values that only the Darwinbox side can give you,
per tenant. Gather all of them before setup starts: a missing one stops the
integration at a point that looks like a different problem.
| Value | Who supplies it | Handling |
| -------------------------------- | ---------------- | ----------------------------------------------------------------------------- |
| Tenant instance URL | Darwinbox | The full URL, not just the company name. |
| Fetch Job Details endpoint | Darwinbox | |
| Fetch Job Details API key | Darwinbox | Share by vault link. Never by email or chat. |
| Assessment Status endpoint | Darwinbox | |
| Assessment Status API key | Darwinbox | Share by vault link. Travels inside the result payload, not as a header. |
| Basic Auth username and password | Darwinbox | Share by vault link. Required in addition to the API key, and case-sensitive. |
| Tenant discriminator header | Darwinbox | Must match the tenant exactly, including case. |
| Environment | Both sides agree | State whether this set is UAT or production, and never mix the two. |
| Test user login and user ID | Darwinbox | For verifying the flow before go-live. |
| Test mailbox | Customer | Must be a mailbox your team can actually open, for OTP and invite checks. |
Send every credential by vault link. A key pasted into email or a chat
thread stays in that thread's history, and rotating it afterwards is the
only way to undo it.
Every candidate needs a valid, unique **email address** and **mobile
number** in Darwinbox. Missing either will stop the interview being
scheduled.
Ask your IT or network team to allow **`*.exterview.ai`** and
**`*.exterview.io`** through your web proxy, firewall and email gateway.
Both are required: invitation emails are delivered from these domains, and
the interview itself runs on them.
Without this, the integration can look configured and still fail. The
webhook may be rejected on the way out, invitation emails may be quarantined
before the candidate sees them, or the interview page may not load for
candidates on the corporate network.
## One-time setup in Darwinbox
Go to **Studio → Event Framework → Webhook Configuration → CREATE**. Give it
a name, enter the values Exterview issued you, and leave **Use PUT Method**
unchecked.
Go to **Settings → Company → Assessment Providers → CREATE NEW ASSESSMENT
PROVIDER**. Name it `Exterview AI` and select the webhook configuration you
just created. Without this, Darwinbox cannot trigger interviews or receive
results.
Go to **Settings → Custom Field** and tag **Display IN = Assessment
Providers**. Create `duration` (numeric, in minutes) and `interview_type`
(dropdown). The field names are case-sensitive and must match exactly.
Create the `interview_type` dropdown options exactly as your Exterview
contact specifies. The values are validated character for character,
including spaces and capitalisation.
Go to **Settings → Company → Assessments** and create one assessment per
Exterview template. Then go to **Settings → Recruitment → Assign
Assessment** and assign each one to the applicable jobs. **Skipping the
assign step is the most common setup mistake**. The assessment will not
appear in the hiring workflow without it.
In the job's **Hiring Workflow**, add a stage of type **Assessment**. Set
**No of days to expire**. This drives the candidate's deadline. Choose
**Manual** evaluation with named evaluators, or **Automatic** with a cutoff
percentage. Optionally tick **Enable Auto Schedule** to fire the interview
when the previous stage completes.
A typical flow: Shortlisting → Screening → **Exterview Assessment** → Face
to Face → HR → Offer.
## Scheduling an interview
Open the candidate profile, go to the **Overview** tab, and check the
hiring flow. Confirm the earlier stages are **Completed**.
The stage shows *Pending for scheduling*. Click **SCHEDULE** to open the
modal.
Keep the default event name. Choose the Exterview template, add at least one
evaluator, and set the two custom fields: **`duration`** and
**`interview_type`**. `interview_type` is what decides which of the modes
below the candidate gets. Check the end date meets your SLA.
The stage now shows **SCHEDULED** with a **CANCEL** button, and the
candidate is contacted within minutes. If anything was rejected, the message
on screen is Exterview's, read it, it says what to fix.
**`duration` caps the interview length. It does not change what you are
charged.** One completed interview produces one report, charged once at that
report's credit price, however long the session ran.
***
The rest of this page covers what happens after scheduling, split by mode.
## Phone call
The candidate is interviewed over a normal phone call. There is no browser
session, no OTP and no screen share.
Exterview calls the mobile number on the candidate's Darwinbox record, at
the number and country code held there.
The AI interviewer asks structured questions and the candidate answers out
loud. The call is recorded and transcribed.
The interview ends when the question set is complete or the candidate hangs
up. Scoring starts immediately.
Exterview scores the call and returns a **Phone Screen** report to the
candidate's Darwinbox record, with the score, the recommendation and the
evidence behind it.
**The candidate needs:** a reachable mobile number and a quiet environment. Nothing else.
## Voice
A voice-only AI interview in the browser. No avatar is shown.
The candidate receives an email with the role title, an **Interview
Deadline** and a **Join the Interview** button. If it is missing, check
**Promotions** and **Spam**.
The page shows the candidate's registered email address. They click **Send
OTP**, then enter the 6-digit code. Allow up to 2 minutes for delivery, and
about 60 seconds between resends. Watch for stray spaces when pasting.
The browser asks for **Entire screen / Window / Tab**. **Entire screen** is
recommended.
The session runs as a voice conversation with the AI interviewer. The
candidate answers by voice or chat. The microphone must stay on and the
candidate should not switch tabs. They click **End** to finish.
Exterview scores the session and returns an **AI Screening** report to the
candidate's Darwinbox record, with the score, the recommendation and the
recording behind it.
**The candidate needs:** latest Chrome on desktop, a working microphone, stable internet, and a quiet room.
## Avatar
The full experience, the same as Voice, with an on-screen interviewer avatar.
As for Voice: role title, deadline, and a **Join the Interview** button.
Same OTP step as Voice, send, enter the 6-digit code, resend after about 60
seconds if it expires.
**Entire screen** is recommended. The camera is also required for this mode.
The interviewer avatar appears on the left and the candidate on the right,
with the timer at the top. The AI asks structured questions and the
candidate responds by voice or chat. Camera and microphone must stay active
and the candidate should not switch tabs. They click **End** to finish.
Exterview scores the session and returns an **AI Screening** report to the
candidate's Darwinbox record, with the score, the recommendation and the
recording behind it.
**The candidate needs:** latest Chrome on desktop, a working camera and microphone, stable internet, and a quiet, well-lit room.
***
## Cancelling
Click **CANCEL** on the scheduled stage. Only that stage is cancelled, other
stages on the candidate are unaffected. Read the confirmation message shown
afterwards; it comes from Exterview. Cancelling returns the stage to a
schedulable state, so you can schedule again.
Once Exterview marks an interview complete, **no further updates can be made**
to that assessment in Darwinbox. Cancelling and scheduling again is the only
way to give a candidate another attempt.
## Common problems
The assessment has not been assigned, or the assessment stage is not on the
hiring workflow. Re-check the assign and workflow steps in
[One-time setup](#one-time-setup-in-darwinbox).
Read the message on screen. It is Exterview's and it names the problem. The
usual causes are a missing candidate email or mobile number, a non-numeric
`duration`, or an `interview_type` value that does not match the expected
option exactly, including spaces and capitalisation.
Ask them to check Promotions and Spam. If the address is wrong, correct it in
Darwinbox and reschedule the stage.
Allow up to 2 minutes, then use **Resend OTP** after about 60 seconds. Pasting
often carries a trailing space, retyping the code by hand fixes most
rejections.
Use the latest Chrome on desktop and re-enable camera, microphone and
screen-share permissions from the padlock in the address bar.
Allow a short sync delay and refresh the candidate page. If it still has not
appeared, contact your Exterview support channel.
## Support
| Purpose | Contact |
| -------------------------------------- | ------------------------------------------------------------------------------------------------ |
| Exterview AI integration and support | [admindev@exterview.ai](mailto:admindev@exterview.ai) |
| Darwinbox modules, framework and setup | Raise a ticket on **Ask Darwin**, or your Darwinbox CSD / AM team |
## Best practices
Most failed integrations come down to one of a few specific mistakes, all of them avoidable.
| Do this | Avoid this |
| --------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| **Assign each assessment to its jobs** after creating it. | **Skipping the assign step.** This is the most common setup mistake: the stage never appears in the workflow. |
| **Copy the `interview_type` values exactly as Exterview gives them to you.** | **Retyping them from memory.** A different capitalisation or a stray space is rejected. |
| **Whitelist `*.exterview.ai` and `*.exterview.io`** on the proxy, firewall and email gateway. | **Assuming the network will allow it.** A blocked domain looks like a broken integration, not a blocked one. |
| **Cancel the stage and reschedule** to give a candidate another attempt. | **Trying to edit a completed assessment.** Once Exterview marks it complete, no further updates are possible. |
| **Treat `duration` as a time cap only.** | **Shortening `duration` to save money.** One completed interview is one report, charged once, however long it ran. |