hyper ai / docs / integrations / salesforce
Integration available

Salesforce Integration

Hyper AI integrates with Salesforce to sync every demo to your CRM automatically. When a demo ends, the prospect is matched by email to an existing Contact or Lead, or added as a new Lead, and the demo is logged as a completed activity on their record. You can send each qualification answer to any Lead field you choose.

OAuth 2.0 CRM sync Field mapping Activity logging
Salesforce
01 — Permissions

Required Salesforce permissions

Hyper AI connects through OAuth 2.0 (with PKCE). It never sees or stores your Salesforce password. You will be asked to allow these scopes when connecting your org.

api
read & write
Find, create and update Leads and Contacts, log activities (Tasks), and read field definitions for the mapping picker. Hyper AI only works with these objects.
refresh_token · offline_access
offline
Keeps the connection working without you being logged in to Salesforce. Tokens are renewed automatically.
oauth
auth
Secure authorization of your Salesforce org. No passwords are stored, and you can revoke access at any time.

Hyper AI acts as the Salesforce user who connected the integration, with that user's permissions.

02 — How it works

What happens after a demo

Once connected, the integration runs automatically with no manual steps required. Here's the full data flow:

1
Connect your org

A Salesforce admin installs the Hyper AI app and connects it from the Integrations page in Hyper AI. There are no API keys to copy.

2
The prospect is matched by email

When a demo ends, Hyper AI looks up the prospect's email:

  • If it belongs to a Contact, that Contact is used. Hyper AI only writes your mapped qualification answers to it and never changes its name, email or account.
  • Otherwise, if there is an open (unconverted) Lead with that email, the Lead is updated.
  • Otherwise, a new Lead is created.
3
Qualification answers go to the fields you choose

Map each qualification question to any writable Lead field, including custom fields. Answers are converted to the field's type, and picklist answers are matched by label or value.

4
The demo is logged as an activity

Each demo is added as a completed Task, “Hyper AI demo with [agent name]”, dated on the day of the demo. It includes the summary, lead score, qualification answers, suggested next steps, and links to the recording, transcript and audio.

5
Your team follows up in Salesforce

New Leads show up in your Lead views and reports, and the demo appears on the record's activity timeline. Your team doesn't have to export or re-enter anything.

Webinars work the same way. Registrations and attendance are logged as activities on the registrant's Contact or Lead, and a Lead is created if the registrant isn't in Salesforce yet.

03 — Field Mapping

What goes where in Salesforce

Prospect details go to the standard Lead fields, each qualification answer goes to the Lead field you pick, and the demo itself is logged as a Task.

Hyper AI field Salesforce (Lead)
name FirstName / LastNameA single name goes to Last Name. If there's no name, the part of the email before the @ is used.
email EmailThe key used to match records.
company CompanyRequired by Salesforce. If the prospect didn't give one, Hyper AI sends “Not provided”.
phone Phone
job_title Title
qualification_answer Any Lead field you pickText, picklist, multi-select, number, currency, percent, checkbox, date, email, phone and URL fields.
demo_activity Task (Activity)Summary, score, answers, next steps and links, logged on the Lead or Contact.

For an existing Contact, the mapped answers go to the Contact field with the same API name, or failing that, the same label. This usually matches how your org maps Lead fields on conversion.

If Salesforce rejects a mapped value, for example because of a validation rule or a value that isn't in a restricted picklist, Hyper AI saves the record without that field instead of losing the whole sync.

04 — Setup & Configuration

Getting connected

Before you start

  • You're the owner of your Hyper AI workspace.
  • Your Salesforce edition includes API access: Enterprise, Unlimited, Performance or Developer. Professional Edition needs the API add-on.
  • A Salesforce admin is available. Salesforce only lets an org connect apps that an admin has installed.

Connect

1
Connect from Hyper AI

In Hyper AI, go to Integrations and click Connect next to Salesforce.

2
Authorize in Salesforce

Log in to Salesforce as the user Hyper AI should act as, and click Allow. This user needs to be able to create and edit Leads, edit Contacts and create Tasks.

3
You're connected

You're sent back to Hyper AI, and the card shows Connected as [your org name]. From now on, every demo syncs automatically.

Map qualification questions

1
Open your agent

Go to Advanced → Qualification Questions.

2
Pick a Salesforce field

Under each question, click the Salesforce field chip next to CRM fields and pick the Lead field where the answer should go.

3
Refresh after adding fields

Fields you add in Salesforce later appear after you click Refresh fields in the picker.

Disconnect

  • In Hyper AI, go to Integrations and click Disconnect next to Salesforce. This revokes Hyper AI's access in Salesforce.
  • A Salesforce admin can also revoke access from Salesforce, or uninstall the Hyper AI app.
  • Records and activities that were already synced stay in Salesforce.
05 — Troubleshooting

Frequently asked questions

Your Salesforce edition doesn't include API access. Professional Edition needs the API add-on from Salesforce.
This happens when the connecting user is deactivated or loses permissions, or when an admin revoked Hyper AI's access. Reconnect from the Integrations page. If your org restricts logins by IP range, an admin can open Setup → External Client App Manager → Hyper AI → Policies and set IP relaxation to Relax IP restrictions.
The prospect has to give an email address during the demo, because email is the matching key. Your org's own rules can also block the record, for example a blocking duplicate rule, or a required custom Lead field with no default value. Duplicate rules that only show an alert don't stop the sync. If you can't tell why, contact us and we'll check the sync result for that demo.
Check that each question has a Salesforce field selected under CRM fields. Questions the prospect didn't answer, or answered too vaguely, aren't sent. If Salesforce rejected a value, for example because of a validation rule or a restricted picklist, the rest of the record is still saved without that field.
That's on purpose. Hyper AI never changes an existing Contact's name, email or account. It only writes your mapped qualification answers and logs the demo activity.
Not yet. Connect your production org (or a Developer Edition org for testing).
No. Hyper AI renews its access automatically, even if your team runs no demos for weeks.
Reach us at dev@gethyper.ai or book a call with the team at cal.eu/hyper/30min. We typically respond within a few hours.