Submit Article Requests

Do you have a suggestion for an article you would like to see created?
Feel free to submit this form and add your suggestions to our document board.

Please fill out the contact form below and we will reply as soon as possible.

  • Appcues Certifications & Training
  • Integration Hub
  • Contact Us
  • Docs home
  • Integrations
  • Integration Documents

Salesforce (Two-Way Integration)

Updated at September 1st, 2023

Submit Article Requests

Do you have a suggestion for an article you would like to see created?
Feel free to submit this form and add your suggestions to our document board.

Please fill out the contact form with the details about the help content you'd like to see.

  • Installation & Developers
    Installing Appcues Web Installing Appcues Mobile API & Data Troubleshooting Extras
  • Web Experiences
    Building Web Experiences Targeting Studio Customization & Styling Use Cases Troubleshooting FAQ
  • Mobile Experiences
    Installation & Overview Building Mobile Experiences Mobile Analytics & Integrations Troubleshooting
  • Account Management
    Subscription Users & Data
  • Analytics
    Experience and Event Analytics Data
  • Best Practices
    Best Practices Use Cases Pro Tips Product-led Growth
  • Integrations
    Integration Documents Use Cases Extras
  • System Status
    System Status & Incidents
+ More

Table of Contents

Why integrate Salesforce with Appcues? Use case examples What you'll need to get started What information will be passed with this integration? Setting up the integration Need to make an adjustment? SFDC Permissions SFDC Events & Activity Data Events that update properties Events that add events Configure the Integration with SFDC Integration User License Create a New User Create a New Permission Set

Why integrate Salesforce with Appcues?

The Appcues and Salesforce integration is a bi-directional, real-time connection. You can use this integration to help better target and personalize in-app experiences. Let the data flow!

Use case examples

  • Add a User Who Completes an Appcues Flow to a Salesforce Report
  • Calculate NPS by Account with Salesforce
  • Track Historical NPS with Salesforce
  • Drive Event Registration with Salesforce
  • Offer Role-Specific Onboarding with Salesforce

What you'll need to get started

  • Appcues Growth Plan. Check out more about our pricing plans here!
  • A Salesforce Plan with API Access. Enterprise Edition, Unlimited Edition, Developer Edition, Performance Edition check out the plans here.
  • UUID Match. This integration requires identical UUIDs in two places:
    1. The Appcues installation: window.Appcues.identify("USER_ID")
    2. The Salesforce record: typical as a User ID or Salesforce ID field which must have type Text. If your user IDs are numeric, you can create a formula field with the string representation of your user ID. For example, if your user ID is stored in a numeric custom field called "Product User Id," you would create a formula field with the formula TEXT(Product_User_Id__c).
  • Single Record Mapping: This integration currently supports mapping only one record, and those (partly because of the above requirement) are Lead or Contact records.
  • Appcues Events Broadcaster (Optional): Enable this add-on service if you want to send Click-to-track events to Salesforce

What information will be passed with this integration?

  • From Salesforce to Appcues:
    • Triggers when the specified object (Lead or Contact) are created or updated. This will occur automatically as long as the property has been updated. If nothing has been updated in Salesforce, nothing will be pushed to Appcues.
    • Sends specified attributes to Appcues as profile attributes to be updated
    • If a user or attribute does not yet exist in Appcues, it will be created upon sync
  • From Appcues to Salesforce:
    • Triggers (via webhook) when an end user interacts with Appcues content (e.g. submits an NPS survey)
    • Optional: Sends "NPS Score" and "NPS Feedback" to Salesforce that update the specified object (e.g. Lead or Contact)
    • Optional: Sends Appcues events to Salesforce as Events that appear on the objects Activity view
    • Optional: Sends Click-to-track events to Salesforce as Events that appears on the objects Activity view. (Requires that your account is signed up for Appcues Events Broadcaster)
    • Appcues will not create new Leads or Contacts if one does not exist for the events it is trying to sync

Syncing data between Appcues and Salesforce depends on having a "USERID" attribute that's shared in both systems. This value is commonly stored as a custom field in Salesforce. You'll need to consult your Salesforce Admin for assistance.

 

Setting up the integration

To set up the integration, you first need to select the Salesforce Integration card on our integrations page:

Integrations Settings Appcues 2023-09-01 at 1.10.39 PM

Once you click the integration card you'll be presented with a workflow to complete the integration.

Step 1 - Will ask you to authenticate your Salesforce account. You will also be asked to select which Salesforce Record Type you want to sync (Record or Lead).

Step 2 - Will ask you what direction you want the data to flow: either bi-directionally, or 1-way in a specific direction.

Step 3 - Will ask you which property on the contact or lead in Salesforce will be used to associate with the profile within Appcues. You will also select which properties on the Salesforce contact or lead you want to send to Appcues for targeting and segmenting.

Step 4 - Will ask you what types of events you would like to send from Appcues to Salesforce. First, select if you want Click-to-track events to be sent. Next, optionally map the NPS fields to send from Appcues to Salesforce. This will update those fields in Salesforce when users go through an Appcues NPS survey and submit feedback.

NOTE: Click-to-track events will only sync to Salesforce if you are signed up for Appcues Events Broadcaster

 

Once you click Finish on step 4, the setup wizard will close, and data will begin passing between the two systems.

Need to make an adjustment?

Once the integration is enabled, you can click the card at any time and select Reconfigure to adjust any of your current settings, or click Deactivate Integration to disable the integration.

 

SFDC Permissions

Permission Fields Uses Object Level Permissions
Lead or Contact (Object) Any fields you'd like to sync with Appcues Used to sync fields between the two systems.      
Note: This can be any object type, including a Custom object. Only the synced record needs to be accessible.

Create, Edit, Read      

 
Event (Object) Subject, Comment Used to record Appcues events such as "flow completed". Create, Edit, Read
Customize Application (Profile) N/A Sets up workflow rules and actions that send data from Salesforce to Appcues.  

SFDC Events & Activity Data

The Salesforce integration sends a subset of events to Salesforce. For the full list of Appcues events, see our Appcues Events Reference doc.      
These will be sent automatically as long as the Appcues > Salesforce integration is complete and the USERID attributes match.

Events that update properties

Event Name Display Name Attribute Name Attribute Type
appcues:nps_score Latest NPS Score score number
appcues:nps_feedback Latest NPS Feedback feedback string

Events that add events

Event name Subject value Comment value
appcues:nps_score Appcues NPS Score Submitted - {{ score }} {{ score }} NPS score.      
Submission location: {{ currentPageUrl }} ({{ currentPageTitle }}
appcues:nps_feedback Appcues NPS Feedback Submitted {{ feedback }}      
Submission location: {{ currentPageUrl }} ({{ currentPageTitle }}
appcues:flow_completed Appcues Flow Completed - {{ flowName }} User completed your Appcues flow titled “{{ flowName }}”.
appcues:checklist_item_completed Appcues Checklist Item #{{ itemIndex + 1 }} Completed - {{ checklistName }} User has completed an item titled, “{{ itemIndex }}”. This is part of the “{{ itemIndex }}” checklist.
appcues:checklist_completed Appcues Checklist Fully Completed - {{ checklistName }} User has completed all items in the “{{ checklistName }}” checklist.
appcues:goal_reached Appcues Goal Reached - {{ goalName }} User has completed the goal titled, “{{ goalName }}”

Configure the Integration with SFDC Integration User License

Want to use the Salesforce Integration user license to authenticate your Salesforce account in the integration setup? Great! The following steps will walk you through how to create a Salesforce Integration user, create a Permission Set, and enable the permissions that are required in Salesforce for the Appcues/Salesforce Integration to work properly. 

Create a New User

In Salesforce….

  1. Click Setup on the top right
  2. Search “users” in the Quick Find search bar
  3. Click Users
  4. Click New User
  5. Give your new user a name, email, username, and nickname
  6. Set the User License to “Salesforce Integration”
  7. Set the Profile to “Salesforce API Only System Integrations”
  8. Save the user

Create a New Permission Set

In Salesforce…

  1. Click Setup on the top right
  2. Search “Permission Sets” in the Quick Find search bar
  3. Click Permission Sets
  4. Click New
  5. Give the new permission set a label, API name, and description (optional)
  6. Leave the License set to —None—
  7. Save the permission set

Note: setting the License at this point will not give access to the full list of Object Settings and System Permissions required in the next step.

 

Object Settings and System Permissions

In Salesforce…

  • Navigate to Permission Sets
  • Click on the Permission Set label created in the previous section (opens Permission Sets Overview)
  • Click Object Settings
  • Click Contacts and/or Leads Object
  • Modify permissions:
    • Click Edit
    • Check the Modify All box (automatically checks necessary boxes)
    • Save
  • Click Events Object
  • Modify permissions:
    • Click Edit
    • Check all available Edit Access boxes
    • Click Save
  • Return to the Permission Set Overview of your new Permission Set
  • Click System Permissions
  • Modify permissions: 
    • Click Edit
    • Check the API Enabled box
    • Click Save

Assign Permission Set to Salesforce Integration User

  1. Return to the Permission Set Overview of your new Permission Set (see steps 1 & 2 in the section above)
  2. Click Manage Assignments
  1. Click Add Assignment
  2. Check the box next to the name of your Salesforce Integration user
  3. Click Next
  4. Click Assign

Authenticate Salesforce Integration in Appcues Studio with Salesforce Integration User

  1. Active Salesforce integration card in Appcues Studio
  2. On the Salesforce Authentication step, click the dropdown to authenticate your Salesforce account
  3. Click Add a new account
  4. Give the authentication a name and choose the instance type
  5. Click Create
  6. Log into Salesforce with your Salesforce Integration User’s email and password
  7. Proceed with the rest of the integration configuration settings
integration salesforce

Was this article helpful?

Yes
No
Give feedback about this article

Related Articles

  • Woopra Integration
  • Increase your trial conversion rate with Slack + Zapier
  • FullStory Integration
  • Segment (Two-Way Integration)
Appcues logo

Product

Why Appcues
How it works
Integrations
Security
Pricing
What's new

Use cases

Appcues Integration Hub
User Onboarding Software
Feature Adoption Software
NPS & Surveys
Announcements
Insights
Mobile Adoption

Company

About
Careers
we're Hiring

Support

Developer Docs
Contact

Resources

The Appcues Blog
Product Adoption Academy
GoodUX
Case studies
Webinar Series
Made with Appcues
Appcues University

Follow us

Facebook iconTwitter icon greyLinkedin iconInstagram icon
© 2022 Appcues. All rights reserved.
SecurityTerms of ServicePrivacy Policy
Expand