Effortlessly import your contacts and keep your lists up-to-date with our Salesforce integration. Make it easier to manage email lists and contact records by connecting AdvisorStream and Salesforce.
In this article you will learn, the connecting partners with instructions on how to connect your Salesforce organization to the AdvisorStream platform, information about the data being passed between the two platforms and the features currently available.
AdvisorStream will pull Contacts from the Salesforce Contacts object to the AdvisorStream platform as individual Contacts. The sync will also create a default contact list in AdvisorStream called “Salesforce Contacts” where contacts will appear by default.
Information used for Synchronization:
- Client First Name
- Client Last Name
- Client Email Address
- Salesforce Contact ID #
Salesforce contacts pulled into AdvisorStream are READ-ONLY, with Salesforce being the source of the contact. It is recommended that Salesforce Connected organizations manage adding, removing, and moving contacts from within the Salesforce environment.
Contacts follow SaleForces Ownership rules in a one-to-one relationship. Contacts that are owned by the Salesforce user account and connected to an AdvisorStream account will be synchronized. Contacts that are owned by other members of a connected network will not be synchronized.
- Creating a new Contact manually in AdvisorStream will not add that Contact to Salesforce.
- Deleting a Salesforce contact on the AdvisorStream platform will not delete the Contact in Salesforce.
Creating and deleting contacts should be managed within Salesforce.
The Organic leads generated from the AdvisorStream platform via the organic opt-in form are pushed back to Salesforce as a lead object in the “leads” section of Salesforce. The AdvisorStream integration will create the lead in your Salesforce instance.
Leads that are sent to Salesforce are also added to a “Salesforce Leads” Contact list within AdvisorStream.
- Lead First Name
- Lead Last Name
- Lead Email Address
Email Preferences - Opt-out
Contacts and leads in Salesforce that have HasEmailOptOut set to false will not be synced with AdvisorStream. Existing contacts will be set to inactive if HasEmailOptOut = true and the contact/lead has already been imported.
Salesforce Email Preferences - Reference Documentation
Configuring Salesforce within your AdvisorStream account is a two-step process. The first set of steps takes place within your Salesforce and the second set of steps takes place within AdvisorStream.
(Note: If you do not see the Integration Tabs in your Account Settings, please get in touch with Customer Success at firstname.lastname@example.org)
Setup in Salesforce
Partners wishing to enable the salesforce integration will need to set up AdvisorStream as a Connected App. A Salesforce Administrator is required to set up a connected application.
Step 1: Settings and Setup
Login to Salesforce and click the settings button (gear icon) and select Setup.
Step 2: App Manager
In the left navigation menu, look for PLATFORM TOOLS, select Apps, and then select Apps Manager.
Step 3: Create New Connected App
On the upper right-hand side, click the New Connected App button
Step 4: New Connected App Information
Setup the following fields on the new connected app page:
Connected App Name
API (Enable OAuth Settings)
Enable OAuth Settings
Selected OAuth Scopes
Request Secret for Web Server Flow
When completed entering the information, select Save.
Step 5: Manage Connected Apps
Using the left-hand navigation, under the PLATFORM TOOLS section, select Apps > Connected Apps > Manage Connected Apps, you will then see a list of available connected applications on the center screen - as indicated by (1) in the screenshot below.
Find AdvisorStream Integration in your list and select Edit. - as indicated by a screenshot (2) below.
Step 6: Configure OAuth Policies
Configure the following information on the main screen under the OAuth Policies section:
All users may self-authorize
Relax IP Restrictions
Refresh Token Policy
Refresh Token is valid until revoked
Step 7: Consumer Key and Consumer Secret
From the left-hand navigation return to Apps > App Manager and locate the AdvisorStream listing.
Select the down arrow at the far right which will expand a menu.
Select View from the drop-down menu, this will take you into the details of the AdvisorStream integration.
In the API (Enable OAuth Settings) section, find the Consumer Key and Consumer Secret.
You will need to provide the Consumer Key and Consumer Secret for the AdvisorStream integration to the AdvisorStream Team. Please also provide the URL of your Salesforce instance (the URL you use to log in).
Send to AdvisorStream:
Secure forms of file transfer and information sharing are available, please reach out to us for more information.
This completes the administrative level requirements to enable the AdvisorStream integration in a Salesforce instance. Please allow a few days upon sending your key and secret for AdvisorStream to complete the Partner Setup on our platform.
Once the Partner Setup process has been completed, the AdvisorStream team has received your Consumer Key and Secret, and have completed, advisors in your network will now be able to self authenticate and enable the Integration within the AdvisorStream accounts.
The following steps are performed by an Individual User with an AdvisorStream account.
1. Login to your AdvisorStream account and go to your Account Settings:
2. Then, click Integrations from your navigation menu on the left:
3. Then, click on the Salesforce area: Activate and Authenticate
Once Integrations has been selected, Advisor should see a tile with the Salesforce logo.
Click on the tile to expand the Integration options screen.
Select the Connect Account button.
Enter Salesforce credentials of the User that is connecting their account.
Authorize permissions for the Salesforce Token.
Once this has been authorized, the Salesforce Integration is now active for this individual user
The user should sync their contacts and leads immediately by using the Sync Account button. This will synchronize contacts and leads, and create and contact lists on the AdvisorStream platform.
Automated syncing of contacts and leads will happen on a regular basis, however the button can be used to refresh the information between AdvisorStream and Salesforce immediately