> ## Documentation Index
> Fetch the complete documentation index at: https://docs.heymilo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> Integrating HeyMilo with Ceipal gives your team access to full end-to-end conversational AI recruiting inside your existing hiring pipeline.

# Ceipal

Once connected, HeyMilo automatically engages candidates, screens them using your configured workflow (SMS, form screening, resume checks, voice/video interviews), evaluates their fit, and syncs the results back into Ceipal—keeping your pipeline clean and up to date and enriched.

### 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> |

<Note>
  💡**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.
</Note>

### 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:

<iframe className="w-full aspect-video rounded-xl" src="https://app.storylane.io/share/xf8gyh8gimie" allowFullScreen />

<Steps>
  <Step title="Go to Admin Setup">
    In Ceipal, click your profile icon.

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

    <Frame>
      ![](https://110840537-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbKCgmPgkC7X1VTl62ocK%2Fuploads%2FSBDg66Hs18oEtKHAY8ce%2Fcdsacdsasssaa%20\(1\).jpeg?alt=media\&token=5f2c6c25-c18f-4023-a562-b0d600461317)
    </Frame>
  </Step>

  <Step title="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*

    <Frame>
      ![](https://110840537-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbKCgmPgkC7X1VTl62ocK%2Fuploads%2F8zIxaaosdQgmf0GHhAWs%2Fafewafewaww%20\(1\).jpeg?alt=media\&token=a09a9f04-a4e2-4b87-bac2-b0654f377070)
    </Frame>

    * Click **Save**
  </Step>

  <Step title="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)

    <Frame>
      ![](https://110840537-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbKCgmPgkC7X1VTl62ocK%2Fuploads%2FsiVH4vJBe6sgqc1pfsPx%2Ffeafewa1111%20\(1\).jpeg?alt=media\&token=5a7054b8-3316-4d9c-9c05-a4cab7356701)
    </Frame>

    Ceipal requires a few mandatory fields:

    * FirstName
    * Email

    <Frame>
      ![](https://110840537-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbKCgmPgkC7X1VTl62ocK%2Fuploads%2FO17Ff34ij4eXlLwySo3F%2Ffdsafdsasqqq%20\(1\).jpeg?alt=media\&token=6a9172b9-4b9c-4e6e-a98c-fae2b462a06e)
    </Frame>

    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*.

    <Frame>
      ![](https://110840537-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbKCgmPgkC7X1VTl62ocK%2Fuploads%2FdTz9ihvYFEx7NNITk6lv%2Fcdacbbfdfv%20\(1\).jpeg?alt=media\&token=ade3c8b3-754a-488c-a348-09f8d088ed85)
    </Frame>

    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.

    <Frame>
      ![](https://110840537-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbKCgmPgkC7X1VTl62ocK%2Fuploads%2Fqcsy2KBSuJpQvmmY4wqY%2FzH2sfsgefTlIZdii1qKTa.jpg?alt=media\&token=f0e0ed76-9604-4759-9fa9-309ba1e2cb78)
    </Frame>

    * Inside, copy the **endpoint URL** (this is what HeyMilo needs).
  </Step>

  <Step title="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**

    <Frame>
      ![](https://110840537-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbKCgmPgkC7X1VTl62ocK%2Fuploads%2F3fuhv7NKdTIkEQldulEx%2Ffdafewafewafeggg%20\(1\).jpeg?alt=media\&token=42cb09f6-d41c-4d24-90ad-097ab1d71b39)
    </Frame>

    Paste these into the HeyMilo integration fields.

    <Frame>
      <img src="https://110840537-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbKCgmPgkC7X1VTl62ocK%2Fuploads%2Fum8O04P4CW3I5Qj9Q2Xr%2Ffewafewafewww%20(1).jpeg?alt=media&token=837c46ff-f61e-42dc-b9f1-718737bb949f" className="mx-auto" style={{ width:"77%" }} />
    </Frame>

    Once entered, your integration goes live!
  </Step>
</Steps>

### Mapping Ceipal Jobs to a HeyMilo Agent

To activate screening for a specific role:

<Steps>
  <Step title="Copy your Ceipal Job Posting ID">
    This is available within your job posting details.
  </Step>

  <Step title="Open your agent in HeyMilo">
    Go to the Integrations tab.
  </Step>

  <Step title="Select Ceipal as your ATS">
    Paste the **Job Posting ID** into the mapping field.
  </Step>

  <Step title="Save">
    Your job and agent are now linked — candidates applying to this job will automatically enter the configured HeyMilo workflow.
  </Step>
</Steps>

### 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

<Frame>
  ![](https://110840537-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbKCgmPgkC7X1VTl62ocK%2Fuploads%2FVu29MdRVMjJc6Ep5tS3i%2FlAdzK8UJAB5BeAyO2HlqW.png?alt=media\&token=fdad41d9-eaaa-456e-a03a-b39fbe388f35)
</Frame>

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).
