Skip to main content

How do I integrate my AI One Stop to Salesforce using API

Here's how to integrate your AI One Stop with your Salesforce CRM using our CollegeVine API.

Updated over a week ago

Part 1: Salesforce UI set up

  1. Click this URL to download CollegeVine’s custom Salesforce package. Log in to the Salesforce instance you want to install the package into


  2. Select who you’d like to install the package for. “Install for Admins only” is the default, but you can select a different option if you’d like.

  3. Click the “I acknowledge…” check box, and then click “Install

  4. When the installation completes, click “Done


Part 2: CollegeVine UI set up

  1. Log in to www.collegevine.com

  2. Navigate to AI One Stop > Students

  3. Click on “CRM sync”


  4. Select the Salesforce option in the Connection section


  5. Paste the URL to your Salesforce instance in the “Enter your Salesforce URL” box.


    You can find your Salesforce URL by going to your Salesforce instance and copying the first portion of your URL in the browser:

  6. Click the “Authorize” button. (note, you cannot authorize before the package is fully installed in your Salesforce instance)

  7. When the Salesforce pop-up appears, log in to your Salesforce instance.

  8. On the next screen, select “Allow.

  9. Then, navigate to CollegeVine and select which object you want to sync to your AI Recruiter. Partners frequently choose their Contact or Opportunity object.

  10. For the “Email field,” select the field on your Salesforce object that you store the students primary email address in.

    The eligible fields from your Salesforce object will auto-populate in the drop-down list.

  11. Then, select any other fields to be synced. See the list below for required and recommended fields:

    Required fields:

    • First name

    • Last name

    • Email - already selected in step 9.

    • Date of birth (optional)

    Note: For DOB Fields, you may now set your preferred format that better align with how your CRM is structured. Be sure to use a consistent format to import your students successfully as this is one of the required fields. You will be able to set this up when you map your fields on the CollegeVine side (Step 17).



    Other suggested fields:

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

      • Program / major

      • Student Class (i.e Freshman)

      • Gender

  12. Then, under “Sync records filtered by this field” choose the field in Salesforce that you are using to distinguish which student records you want to sync to CollegeVine.

    • This field must be a Boolean (ie. “checkbox”) field and live on the Salesforce object you selected in step 8. This field must be updateable

    • The number of records with a ‘true’ value for this field should be less than or equal to the number of student uploads you have on your CollegeVine contract. Ask your CollegeVine project manager if you are unsure about your contract amount!

    • Partners often use automations in Salesforce to populate this field based on the strategy their team has aligned on. (e.g. when a new inquiry enters Salesforce, mark them as ‘true’)

  13. After you’ve selected all of your fields, click “Next”. Note: You can go back and edit the synced fields at any time.

  14. Under the Data schema configuration section, choose how you want conflicts resolved.

  15. Map columns to CollegeVine properties, or create a custom property.

  16. Certify communication consent (checkbox)

  17. Click Next to save your field mappings and move on to the next step



    📣Note: If you later change/update/add new fields to the file you send to CollegeVine, you must come back to the field mapping step, update the mapping, and save the changes to ensure your future imports will not fail.

  18. Select which additional AI Engagement data you want CollegeVine to export back to Salesforce for every record, and which fields on your Salesforce object you want them to map to.

    • If you don’t already have fields created on your object to store the values, you can create new fields and then click “refresh” inside of CollegeVine to repopulate the field option list.

  19. Next to “Configure AI engagement fields” click “More details” and then “Edit”.

  20. Within the next section, map the AI One Stop engagement fields to their respective fields in your Salesforce instance. If there are any fields you do not want to send to Salesforce, you do not need to map them.

  21. Click “Next

  22. Click “Start the integration” to start the automatic integration, or manually trigger the first import by clicking “Run an import now” if you’d prefer.

FAQs​

  1. How do I swap from SFTP set up if I want to change to the API setup?

    Click “More details

    Click “Edit

    Click “Change connection type


    2. Which additional fields will the AI recruiter send to our CRM?


    Additional AI engagement data for each student

    • Summary of all AI communications

    • Number of chat messages sent by AI agent

    • Number of chat messages sent by the student

    • Number of emails sent by the AI agent

    • Number of emails opened by the student

    • Number of emails clicked by the student

    • Number of outbound phone calls made by the AI agent

    • Number of outbound phone calls answered by the student

    • Number of inbound phone calls made by the student

    • CV email opt out

    • CV SMS opt out

    • CV phone opt out

    • CV global opt out

Did this answer your question?