Skip to main content

Creating new CRM fields for AI Recruiter

Updated over 3 weeks ago

Before your integration goes live, you'll need to create a set of new fields in your CRM. These fields are where CollegeVine writes your AI agent's activity back to your records after each sync.

We recommend creating these as dedicated, CollegeVine-specific fields for clean reporting and to avoid conflicts with existing data.


AI engagement fields

These fields capture your AI agent's communication activity with each student over time. All stats are cumulative (all-time per lead).

These fields are export only, and should not be included in an import to CollegeVine.

Field name

Field type

Summary of all AI communications

Text (long)

Number of CollegeVine chat messages sent by AI agent

Number

Number of CollegeVine chat messages received by AI agent

Number

Number of emails sent by AI agent

Number

Number of emails opened

Number

Number of emails clicked

Number

Number of outbound phone calls made by AI agent

Number

Number of outbound phone calls answered

Number

Number of inbound phone calls received by AI agent

Number


AI opt-out fields

These are new fields you'll need to create β€” they are exclusive to AI outreach opt-outs and separate from any existing opt-out fields you may already have in your CRM. CollegeVine writes to these fields to reflect each student's opt-out status across AI communication channels. These fields are export only, and should not be included in an import to CollegeVine.

Field name

Field type

CV SMS opt out

Boolean (true/false)

CV phone opt out

Boolean (true/false)

CV email opt out

Boolean (true/false)

CV global opt out

Boolean (true/false)

πŸ“‹ Want to understand how opt-outs work? See: How opt-outs are handled by the AI Recruiter


AI consent field

This field should be included on your import to CollegeVine.

Field name

Field type

Notes

Consents to AI phone calls/SMS

Boolean (true/false)

Identifies students who have explicitly consented (or not) to AI outreach via phone and SMS. Leave empty if consent status is unknown.

πŸ“‹ Not sure how to collect consent? See: Collecting student consent for AI Recruiter outreach (phone and SMS)


Self-reported identity field (Website Recruiter / Chatbot only)

If you have a website recruiter or AI chatbot, you'll also need to create this field to capture identity information students share through that channel. This field should also be included on your import to CollegeVine.

Field name

Field type

Options

Self-Reported Identity

Text

Ex: parent, transfer, etc.

Did this answer your question?