Salesforce Integration
Connect Salesforce as your CRM and keep accounts, contacts, opportunities, and support cases flowing into Statisfy automatically — no engineering help required.What this integration does
- Two-way sync — accounts, contacts, and opportunities sync from Salesforce into Statisfy, and edits you make in Statisfy can sync back. See Salesforce Bi-Directional Sync for the write-back side.
- Bring any object — pull additional Salesforce objects (contracts, entitlements, success plans — anything) into Statisfy as related records.
- Owner mapping — tell Statisfy which Salesforce field holds each owner (Account Owner, CSM, and so on) so the right people see the right accounts.
- ARR & renewal dates — point at the Salesforce fields you trust, or have Statisfy calculate them from related records like subscriptions.
- Support cases & Chatter — pull Salesforce Cases in as support activity with AI sentiment analysis, and optionally sync Chatter posts.
Prerequisites
- Admin access in Statisfy — only admins see integration settings.
- Admin access in Salesforce — the person connecting must be able to approve a connected app and should have visibility into the objects you want to sync. If you can install apps from the Salesforce AppExchange, you have enough access.
- The Statisfy managed package installed in your Salesforce org — if you’re connecting for the first time, follow Salesforce Integration Steps for the one-time install.
Step 1 — Connect
- In Statisfy, go to Integrations → Admin Apps and find the Salesforce card.
- Click Connect. A Salesforce sign-in window opens.
- Sign in with your Salesforce admin account and click Allow.
- The card now shows Connected. Click Settings on the card to configure what syncs.
Step 2 — Configure the settings wizard
The settings page has seven sections. Only Account Filtering is required — you can leave the rest at their defaults and come back any time. Click Save when you’re done; every save is versioned (see Configuration history).1. Account Filtering (required)
Decide which Salesforce accounts come into Statisfy.- Single filter — one filter; every matching account is brought in as a Customer.
- Typed filters — separate filters for Customer, Prospect, and Partner. Each account gets the type of the first filter it matches. Accounts matching no filter are not synced.
2. Owner Mapping
Tell Statisfy which Salesforce field identifies each kind of owner. The dropdown shows only fields on your Account object that point to a Salesforce user, so you can’t pick an invalid field.| Salesforce field (example) | Statisfy owner type |
|---|---|
OwnerId | Account Owner |
CSM__c | CSM |
Sales_Rep__c | Sales Rep |
Support_Owner__c | Support Owner |
TAM__c | Technical Account Manager |
Success_Manager__c | Success Manager |
3. ARR & Renewal
Choose where Statisfy gets each account’s annual recurring revenue (ARR) and renewal date. Three options for each:- None — don’t sync it.
- Direct field — pick the Account field that already holds the value (ARR fields must be number/currency fields; renewal must be a date field).
- Calculated from related records — have Statisfy compute it from a child object, e.g. “sum the Amount on all active Subscription records.” You choose the object, the value field, how to combine values (sum, max, or latest), and an optional filter to scope which records count.
4. Custom Objects
Bring any other Salesforce object into Statisfy as related records on an account or contact. Click Add Custom Object and fill in:| Setting | What it means |
|---|---|
| Object API name | The Salesforce object to pull in (pick from the list) |
| Display name | What it’s called in Statisfy (e.g. “Contracts”) |
| Parent entity | Whether records attach to an Account or a Contact |
| Matching field | The field on that object that links it back to the account or contact |
| Filter (optional) | A condition to limit which records sync |
| Fields to sync (optional) | Pick specific fields, or leave empty to sync all |
5. Support Cases
Turn this on to pull Salesforce Cases into Statisfy as support activities, with AI sentiment analysis on the conversation.| Setting | What it means |
|---|---|
| Case filter | A condition to limit which cases sync (Validate shows samples) |
| Lookback window | How far back to pull cases — 1 to 365 days |
| Conversation source | Where the case conversation lives: Case Comments (default) or Email Messages |
| Extra fields (optional) | Core fields (subject, status, priority, dates) sync automatically; add more here |
6. Chatter
Optionally sync Salesforce Chatter posts and comments from Accounts and Opportunities into the activity timeline. Chatter is the one section with its own Sync Frequency control — choose Hourly, Daily, or Weekly and click Save Schedule. Two things to know:- No schedule means no syncing. Turning the Chatter toggle on isn’t enough — you must also save a Sync Frequency, or Chatter will never run.
- The schedule saves separately. “Save Schedule” applies immediately and is independent of the main Save button at the bottom of the page (which saves the rest of your Chatter settings). Use Disable Schedule to stop scheduled runs.
7. Advanced
Most teams never touch this section. It lets you restrict exactly which fields sync (“allowlists” — only the fields you list are synced) for Accounts and Opportunities, map extra Contact fields, or exclude specific Contact fields. Use it to trim sync size on very large orgs or to bring in non-standard fields without a custom object.Step 3 — Run your first sync and check the results
- After connecting, Statisfy automatically runs a first full sync that pulls your recent Salesforce history; ongoing syncs then run daily. Support cases also refresh daily. (Details: your first sync.)
- The Sync Job banner at the top of the settings page shows the latest run and its status. Changed a setting and don’t want to wait? Click Run Sync Job to sync now.
Changing settings later
Edit any section and save — changes take effect on the next sync (use Run Sync Job to apply them immediately). Every save is kept as a version you can see in the page header; to restore a previous version, contact support@statisfy.com. See Configuration history.Syncing changes back to Salesforce
Edits made in Statisfy — to accounts, contacts, opportunities, and synced custom objects — can be written back to Salesforce so both systems stay in step. See the Salesforce Bi-Directional Sync Guide to set this up.Troubleshooting
Saving fails with 'SOQL validation failed'
Saving fails with 'SOQL validation failed'
ARR or renewal date looks wrong on an account
ARR or renewal date looks wrong on an account
- Direct field — open that account in Salesforce and confirm the field actually holds the value you expect.
- Calculated — click Validate and compare the sample results against Salesforce; the filter or the combine rule (sum/max/latest) usually needs adjusting.
A custom object isn't showing on accounts
A custom object isn't showing on accounts
- Confirm the object is added and saved in the wizard’s Custom Objects section.
- Verify the matching field really links back to the Account (or Contact) for the records you expect.
- Check the optional filter — too restrictive a condition silently excludes records.
- Newly added objects appear after the next sync — click Run Sync Job instead of waiting.
Support cases are missing or out of date
Support cases are missing or out of date
- Check that the Support Cases toggle is on.
- Make sure the lookback window covers the cases you expect — it maxes out at 365 days.
- Check the case filter isn’t too narrow.
- If cases sync but conversations are empty, try switching the conversation source between Case Comments and Email Messages — different orgs store case conversations in different places.
Chatter posts aren't appearing
Chatter posts aren't appearing
The sync says 'completed' but no data appears
The sync says 'completed' but no data appears
The Connect button fails or loops
The Connect button fails or loops
FAQ
Will connecting change anything in Salesforce?
Will connecting change anything in Salesforce?
Who can set this up?
Who can set this up?
Can I change my filters after the first sync?
Can I change my filters after the first sync?
How fresh is the data?
How fresh is the data?
How do I disconnect?
How do I disconnect?