Skip to main content

Which fields should I include in my import to CollegeVine's AI Recruiter?

Updated over a month ago

Required:

  • First name

  • Last name

  • Email

  • Admission year (YYYY)

  • Date of birth (YYYY-MM-DD)

Recommended:

  • Phone number (+1XXXXXXXXXX)

    • required to call students and gather consent to call

    • E.164 is the preferred format (+1XXXXXXXXXX), but can be accepted without country code for US numbers (XXXXXXXXXX)

  • Consents to AI phone calls (true/false or leave the value empty)

    • required to identify leads that have already consented to AI phone calls

    • Please use the following values:

      • true = lead has explicitly opted in

        • AI Recruiter will make phone calls without emailing for consent first

      • false = lead has explicitly opted out

        • AI Recruiter will neither make phone calls nor email for consent

      • Leave the field empty if you are missing consent information for the lead

        • AI Recruiter will email the lead to ask for consent and then make phone calls accordingly

  • Lead stage field(s) to indicate where in the enrollment funnel your leads are

    • Most partners include 1 or 2 lead stage fields, and use these fields for two main purposes:

      • To tell the AI Recruiter when to start/stop treating a lead

      • To give the AI Recruiter custom instructions on how to treat each lead (e.g., If stage = Application-Started then encourage the student to log back into their application portal at www.university.edu/apply/login)

    • Later, your team will work with your CollegeVine Project Manager to map your 1-2 lead stage field values to the funnel stages your AI Recruiter understands (see below) and set the logic for when to start/stop treatment.

      • Prospect

      • Inquiry

      • Application - started

      • Application - completed

      • Decision - accepted

      • Decision - rejected

      • Decision - waitlisted

      • Enrolled

    • If you have one stage field that maps nicely to the above options, great!

    • Otherwise, you can use up to two fields that, when combined, map to the funnel stages. For example, here’s what one partner did:

      • Field 1 (Lead Stage):

        • Prospect

        • Inquiry

        • Applicant

        • Enrolled

      • Field 2 (Application Status):

        • Started

        • Completed

        • In Review

        • Accepted

        • Rejected

        • Waitlisted

      • In this example:

        • Applicant + Waitlisted = Decision - waitlisted

        • Prospect = Prospect

Other suggested fields:

  • Any other fields you have that would be helpful for the AI recruiter to use to personalize messages to leads. Examples include:

    • Location fields: Street address, City, State, Zip code, or Country

    • Intended major

    • Gender

    • Preferred Name

    • FAFSA completed

    • Has visited campus

  • Note: In a later step, you will be able to map each of these fields to a CollegeVine default property or create a Custom Property so your AI Recruiter knows how to handle each data point.

Did this answer your question?