# Ceipal

> Integrating HeyMilo with Ceipal gives your team access to full end-to-end conversational AI recruiting inside your existing hiring pipeline. Once connected, HeyMilo automatically engages candidates, screens them using your configured workflow (SMS, resume checks, voice/video interviews), evaluates their fit, and syncs the results back into Ceipal—keeping your pipeline clean and up to date.

## Agents Supported in Ceipal

| 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 HeyMilo with your questions. They respond directly in the thread, just like a real conversation. Once they finish, HeyMilo 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 Ceipal 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 Ceipal 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 %}

## Follow These Easy Steps to Set Up the HeyMilo Integration With Ceipal

Click through the interactive demo, and follow the steps below to learn how to connect Ceipal with HeyMilo:

{% embed url="<https://app.storylane.io/share/xf8gyh8gimie>" %}

{% stepper %}
{% step %} <mark style="color:blue;">**Step 1**</mark> Go to Admin Setup

In Ceipal, click your profile icon.

1. Navigate to **Admin Setup**.
2. Under **Global Settings**, click **Custom Fields**.

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

{% step %} <mark style="color:blue;">**Step 2**</mark> Create Custom Fields

You’ll add three new fields so HeyMilo can send results back into Ceipal.

Click **Add** and create the following fields exactly as written:

* **HeyMilo Interview Score**
* **HeyMilo Interview Report**
* **HeyMilo Admin URL**

For each field:

* Select **Applicant** under *Application Modules*
* Choose **Text** under *Field Data Type*

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

* Click **Save**
  {% endstep %}

{% step %} <mark style="color:blue;">**Step 3**</mark> Create the Custom API (Writeback Endpoint)

This API allows HeyMilo to push interview results back into Ceipal.

**1. Go to Custom API Configuration**

* Navigate to **Custom API Configuration**
* Click **Add**

**2. Create Your Writeback API**

Fill in the fields:

* **Name:** HeyMilo WriteBack API, or Update Applicants e.g.
* **Module:** Applicants
* **Method:** POST(Push To Ceipal)

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

Ceipal requires a few mandatory fields:

* FirstName
* Email

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

Leave the predefined fields as they are.

**3. Enable the Custom Fields**

Scroll down to **User-Defined Fields**.

Check all three fields you created earlier:

* HeyMilo Interview Score
* HeyMilo Interview Report
* HeyMilo Admin URL

Mark them as *Mandatory* and *Included in API*.

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

Click **Save**.

**4. Download the Format File**

After saving, you’ll see an option called **Download Format**.

* Click it to download a `.doc` file containing your API endpoint.
* Open it in Google Docs or Word.

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

* Inside, copy the **endpoint URL** (this is what HeyMilo needs).
  {% endstep %}

{% step %} <mark style="color:blue;">**Step 4**</mark> Configure Your API Credentials

Now you’ll grab the credentials Ceipal generates for your writeback API.

1. Go to **API Access Configurations**
2. Choose a username (this is *not* your Ceipal login)
3. Create an API password
4. Copy your **API Key**

You will now have:

* **Endpoint URL**
* **API Username**
* **API Password**
* **API Key**

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

Paste these into the HeyMilo integration fields.

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

Once entered, your integration goes live!
{% endstep %}
{% endstepper %}

## Mapping Ceipal Jobs to a HeyMilo Agent

To activate screening for a specific role:

{% stepper %}
{% step %} <mark style="color:blue;">**Step 1**</mark> Copy your Ceipal Job Posting ID

This is available within your job posting details.
{% endstep %}

{% step %} <mark style="color:blue;">**Step 2**</mark> Open your agent in HeyMilo

Go to **View Configuration**.
{% endstep %}

{% step %} <mark style="color:blue;">**Step 3**</mark> Select Ceipal as your ATS

Paste the **Job Posting ID** into the mapping field.
{% endstep %}

{% step %} <mark style="color:blue;">**Step 4**</mark> Save

Your job and agent are now linked — candidates applying to this job will automatically enter the configured HeyMilo workflow.
{% endstep %}
{% endstepper %}

## What Happens After Setup

Once the integration is active:

#### Candidates apply in Ceipal

HeyMilo automatically pulls new applicants.

#### HeyMilo runs your configured workflow

SMS → Resume screening → Form screening → Voice/Video interview.

#### Results sync back into Ceipal

Interview score, full report, and admin URL appear in the custom fields you created.

#### Your team reviews everything inside Ceipal

No switching systems, no extra steps.

## How to Review Candidate Results

HeyMilo results appear in **Candidate → Personal Details and scroll down to User Defined Fields**:

* **HeyMilo Interview Score:** numeric score based on your criteria
* **HeyMilo Interview Report:** full evaluation summary
* **HeyMilo Admin URL:** one-click access to transcripts, videos, audio, and detailed scoring inside HeyMilo

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

Recruiters simply open the candidate’s profile to see everything.

## Additional Resources

For anything not covered here, reach out at [**support@heymilo.ai**](mailto: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/ceipal.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.