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.

Features

Contact Synchronization

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:

1. Client First Name
2. Client Last Name
3. Client Email Address
4. 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.

Notes:

1. Creating a new Contact manually in AdvisorStream will not add that Contact to Salesforce.
2. Deleting a Salesforce contact on the AdvisorStream platform will not delete the Contact in Salesforce. 

Creating and deleting contacts should be managed within Salesforce.

 

Lead Synchronization

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. 

Information passed:

1. Lead First Name
2. Lead Last Name
3. 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

• Opting Out of Email
• Email Preferences

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 as_support@broadridge.com) 

 

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:

 Basic Information

Connected App Name	AdvisorStream Integration
API Name	AdvisorStream_Integration
Contact Email	info@advisorstream.com

 

API (Enable OAuth Settings)

Enable OAuth Settings	TRUE (checked)
Callback URL	https://my.advisorstream.com/salesforce/salesforce_as/login/callback/
Selected OAuth Scopes	Access your basic information (id, profile, email, address, phone) Access and manage your data (api) Provide access to your data via the Web (web) Perform requests on your behalf at any time (refresh_token, offline_access) Allow access to your unique identifier (openid)
Request Secret for Web Server Flow	TRUE (checked)

 

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:

OAuth Policies

Permitted Users	All users may self-authorize
IP Relaxation	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).

 

Example: https://advisorstreamdevorg-dev-ed.lightning.force.com/  

Send to AdvisorStream:

Consumer Key

Consumer Secret

Salesforce URL

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.

Advisor Setup

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 

Sync Account

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