# SmartRecruiters

## Agents Supported in SmartRecruiters

| SMS Agent                                                                                                                                                                                                                                                                            | Resume Agent                                                                                                                                                                                                                                                                                                                       | Voice/Video Agent                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ✅                                                                                                                                                                                                                                                                                    | ✅                                                                                                                                                                                                                                                                                                                                  | ✅                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| <p><strong>How does it work?</strong></p><p>As soon as candidates apply, they get a text from Milo with your questions. They respond directly in the thread, just like a real conversation. Once they finish, Milo sends over the voice or video interview invite automatically.</p> | <p><strong>How does it work?</strong><br>Please be advised that the data is not automatically pulled from ATS. You can add resume screening to your agent workflow once the integration is live and your job is connected. Candidates will then be asked to upload their resume to get screened for fit before moving forward.</p> | <p><strong>How does it work?</strong></p><p>After integration and job posting mapping, when a candidate applies to your SmartRecruiters job posting, the candidate's email address is pulled from the application form and the candidate is engaged through email to take the voice/video assessment. Once the candidate has completed it, the candidate's detailed assessment report is attached to their profile in the SmartRecruiters portal.</p> |

{% hint style="info" %}
💡**HeyMilo supports SMS screening across all ATS platforms—as long as a valid phone number (with country code) is provided.** Since most ATSs don’t collect phone numbers by default, be sure to make the mobile number a required field in your job post.

Alternatively, you can enable both resume and SMS screening on your HeyMilo job, ensuring candidates are screened even if their phone number or resume isn’t accessible via your ATS.
{% endhint %}

HeyMilo’s integration with SmartRecruiters lets you order a HeyMilo assessment from any applicant’s profile and have the results flow back to SmartRecruiters automatically.

Watch the video and follow the steps below to connect HeyMilo to SmartRecruiters:

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbKCgmPgkC7X1VTl62ocK%2Fuploads%2Ffc47V15VpLEQjc7K4SoQ%2FSmartRecruiters.mp4?alt=media&token=986126ab-5dc5-4f3b-a0f0-2e4ec2aad09d>" %}

### Enable The Integration

Connecting SmartRecruiters is a two-part handshake: first you sign in from HeyMilo, then you copy a short integration code from SmartRecruiters back into HeyMilo to turn assessments on.

{% stepper %}
{% step %} <mark style="color:$primary;">**Step 1**</mark> Open HeyMilo → **Integrations**

From the sidebar in your HeyMilo workspace, go to **Integrations** and find **SmartRecruiters** under **Available Integrations**.

<figure><img src="/files/ImgcwHHonq9u38PeJFsQ" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %} <mark style="color:$primary;">**Step 2**</mark> Click **Setup SmartRecruiters Integration**

You’ll be taken to the SmartRecruiters sign-in flow. Sign in with your SmartRecruiters admin account, then click Verify permissions → Continue to grant access.

<div><figure><img src="/files/zhKVtAAlDNUNpkhnGfnu" alt="" width="375"><figcaption></figcaption></figure> <figure><img src="/files/lXnjZ67gNkMOK0ulIPKG" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %} <mark style="color:$primary;">**Step 3**</mark> Enable Assessments in HeyMilo

Back in HeyMilo, click **Enable Assessments**. You’ll be prompted for a SmartRecruiters integration Key — that’s what Step 4 generates.

<figure><img src="/files/lIWYkBR3xjRsilaSYIXk" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %} <mark style="color:$primary;">**Step 4**</mark> Grab your integration Key from SmartRecruiters

In SmartRecruiters, click your Profile (top right) → Settings → Apps & Integrations → find HeyMilo in the list → click Connect. You’ll see a short integration **code / ID** on screen.

<figure><img src="/files/2yiYcbGUyvlH4SUwgzQq" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %} <mark style="color:$primary;">**Step 5**</mark> Paste the code back into HeyMilo

Copy that code and paste it into the Key field in HeyMilo, then click Connect. You’ll see confirmation that SmartRecruiters is connected and assessments are enabled.

<figure><img src="/files/XOCwo8EZ1LuTJAGwOkXg" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %} <mark style="color:$primary;">**Step 6**</mark> Wait \~10 minutes for the initial sync

Once connected, SmartRecruiters will sync your jobs and candidates over to HeyMilo in the background. Give it about 10 minutes before moving on so your job list is fully available.
{% endstep %}
{% endstepper %}

### Use the Integration With SmartRecruiters

Once the integration is live, you can map a SmartRecruiters job to a HeyMilo agent and start ordering the HeyMilo assessment on applicants.

{% stepper %}
{% step %} <mark style="color:$primary;">**Step 1**</mark> Create (or pick) a job in SmartRecruiters

In SmartRecruiters, go to **Jobs** → **+ Job**, fill out the mandatory fields (title, location, company), publish, and grab the candidate apply link if you want to test end-to-end.

<figure><img src="/files/0C1Skx4HH7VzUcjMf6gF" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %} <mark style="color:$primary;">**Step 2**</mark> Map the job to your HeyMilo agent

Open your HeyMilo agent’s configuration. In the SmartRecruiters job field you’ll see a dropdown of jobs synced from SmartRecruiters — select the one you just created to link them.

<figure><img src="/files/JuT1SAepMyvKBHSWyxgi" alt=""><figcaption></figcaption></figure>

If you don’t see a newly created job yet, wait a few minutes for the sync to catch up.
{% endstep %}

{% step %} <mark style="color:$primary;">**Step 3**</mark> Candidate applies

When a candidate applies to the SmartRecruiters job, they’ll appear under the job’s Applicants in SmartRecruiters — same as any other application.

<figure><img src="/files/4DFn1iGKwoFaH37Og1EK" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %} <mark style="color:$primary;">**Step 4**</mark> Order the HeyMilo assessment

Open the applicant in **SmartRecruiters**, scroll to the Assessments section on their profile, and click **Order Assessments** → select **HeyMilo AI Screening**.

<figure><img src="/files/c51aEWDE3fnZkPPz6eHM" alt="" width="375"><figcaption></figcaption></figure>

Ordering the HeyMilo assessment is manual today — you trigger it per candidate when you’re ready to screen them.

<figure><img src="/files/bJawQJh2yRSnpZyCRWlW" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %} <mark style="color:$primary;">**Step 5**</mark> HeyMilo runs the screen

Once ordered, HeyMilo engages the candidate by email, SMS, or voice/video (based on your agent). You can follow their progress in HeyMilo as usual.
{% endstep %}

{% step %} <mark style="color:$primary;">**Step 6**</mark> Results land back on the candidate

When the candidate completes the screen, the applicant’s profile in SmartRecruiters is updated and a note is added with a link to the full HeyMilo report — with links to the audio or video, scorecard with breakdowns, the full transcript, and any flags.

<figure><img src="/files/qma4RUGZYu5cR7GXG27E" alt=""><figcaption></figcaption></figure>

Additionally under Assessments you’ll see whether it was pending or processed, with their overall score once complete.

<figure><img src="/files/Ye7fmhRvv5tBEJHhYpRn" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

## Additional resources

For additional information not covered here, reach out to <support@heymilo.ai>.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.admin.heymilo.ai/integrations/ats-integration/smartrecruiters.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
