About AdvocateHub Salesforce Package 3.529

This AppExchange Package is the newest and latest version (Version 3.529) and it includes the following items:

• Compatibility with Salesforce Lightning and Salesforce Classic
• Improved Nomination button tool and MultiHub support
• Improved Reference Request tool and MultiHub support
• New Acts of Advocacy Object and MultiHub support
• New Salesforce Dashboard Reports
• Consistent labels and naming for the components
• Customizable Nomination button and new Hub flow for contact nomination

Installing the Influitive AppExchange Package 3.529

AppExchange Package Link

1. Login to your salesforce.com account as a Salesforce administrator.
2. Open a new tab and click on the following link to install the following package:
   1. Production: https://appexchange.salesforce.com/appxListingDetail?listingId=a0N3000000B3GQGEA3
   2. Sandbox: https://test.salesforce.com/packaging/installPackage.apexp?p0=04t3o0000011PwT&isdtp=p1

3. Select Install for All Users and click Install or Upgrade .

   

4. You will be prompted to approve a third-party access. Mark the checkbox and click Continue . This is needed for your Salesforce to be able to connect to the Influitive Hub.

   

5. Once Installation is completed, you will see the completion message or email. Login to your Salesforce to check if the package version ( Setup > Platform Tools > Installed Packages > Package Name: AdvocateHub > Version Number 3.+ ).

Connect Salesforce Environment and the Hub

After the AppExchange package is installed, a Salesforce user would need to input their Salesforce username, password, and security token into your AdvocateHub to connect the instances together.

1. Log in to the AdvocateHub instance as an administrator, in admin view, click on the Gear icon in the top right corner of the screen and click on Integrations to go to the integration library.
2. Browse through the integration library until you find the  Salesforce integration and click Manage.
3. To enter your credentials, navigate to the Setup Tab and click Authenticate to start and you will see the following page. You can choose to authenticate via the Standard password and username method or via OAuth 2 login method.
   

   

4. Choose the Target Environment for the Salesforce instance you're connecting, either Production or Sandbox instance. It is currently not possible to connect to both instances at the same time. However, you may switch the instance and re-authenticate at any time.
5. Next, if you choose the Standard login method, enter the Username , Password, Token and Organization ID associated with your Salesforce account. Please make sure the Organization ID is correct and that the connected integration user has the following Salesforce: Required Field Permissions :
   1. How to find your Token : Go to My Settings on Salesforce under your Admin name > Under the Personal option > Reset My Security Token > Click on the Reset Security Token button. You will be sent an email to your inbox containing the token.
   2. How to find your Organization ID : To find Organization ID, go to Salesforce Setup > In the Quick Find Search, type Company Information.
   3. How to connect without a token :
      1. Login to Salesforce and go to Setup > Security > Network Access.
      2. Add Influitive’s IP address (contact support@influitive.com to acquire the IP address) to the list of trusted IP addresses. It can be both the start and the end of the range.
      3. Return to the Salesforce integration in the AdvocateHub and enter your credentials (without the token).
      4. You may get an error message the first time you save your credentials in the hub as our system is still communicating with SFDC to figure out the connection. If so, please try again and give it a few minutes to authenticate.
6. Under App Exchange Version , please select version 3 .5 Once all the data is confirmed, please hit Save to authenticate the integration.
7. If you run into any issues or received any error messages, please consult our Salesforce Errors and Troubleshooting documentation. If you can't find the answer to the issue, please take a screenshot of any error messages you've received and send an email to support@influitive.com.

Influitive Hub Mappings

Next is to set the Hub Mappings in your Salesforce to identify the Hub to connect with.

Hub Mappings Menu

1. Once logged into Salesforce, click on your Profile Name > My Settings > Display & Layout > Customize My Tabs

2. Add Hub Mappings > Save

   

Add AdvocateHub to Hub Mappings Menu

1. Once the menu is added, open the Influitive Hub Mapping from the Navigation tab
2. Click on the New button to add the AdvocateHubs information:

   

3. Enter your Influitive Hub's Program Name.

   

4. For Hub ID, this information is available in your AdvocateHub. Sign in to your admin account in the Hub > Click on the gear icon > Integration > Influtive API > Manage > Click the Setup tab > Copy the X_ORG_ID.
   

   

5. Paste in on the Hub ID field and Save.

   

6. To recap:
   Influitive Hub Mapping Name: Please enter the Name of your Hub Program
   Influitive Hub ID: The X ORG ID Number provided in Influitive API
   Influitive Hub Domain: Please enter the URL of the Advocatehub (e.g. https://hub.influitive.com )
7. Click Save once you're done
8. For Multiple Hubs, you will need to add all the Hub Mappings for each Hub. More on MultiHub CRM Setup .

Adding Components in the Page Layouts

After installing and deploying the AppExchange package, the Salesforce administrator will need to modify a few object layouts to add the Influitive integration components.

For further information on modifying Salesforce Page Layouts, please visit this Salesforce Help Page .

Page Layout Checklist

Layout Changes Checklist

1. Contacts Object Layout
   1. Removing old Nominate Now button & Adding the new Nominate Now button
   2. Removing Advocacy Activities & Adding Acts of Advocacy
   3. Removing Advocacy Activities (Prospect) & Adding References Given
2. Account Object Layout
   1. Adding Influitive Acts of Advocacy component
   2. Adding References Related Activities List
3. Opportunity Object Layout
   1. Adding the New Reference Request Tool
   2. Adding the References Received via Influitive related list
4. Salesforce Report Dashboard
   1. Remove the old Influitive Dashboard to make space for Influitive Dashboard 3.0.

Contacts Page Layout

To start, click Setup > Customize > Contacts > Page Layouts > Click Edit next to the layout that your Salesforce users use. The following components are provided from the AppExchange Package:

Contacts Converted Details / Nominate Button

This widget will outline the Contact details in the Hub (e.g. email, Current Points, Lifetime Points, Nominated By).

A. Removing the old Nominate Contact component

1. Search for the "Nominate Contact" component on the Contacts Page Layout > Click the Remove icon.

   

B. Adding the new Contacts Converted Details / Nominate Button

This widget will outline the Contact details in the Hub (e.g. email, Current Points, Lifetime Points, Nominated By).

1. On the same page > Select VisualForce Pages > Drag  ContactDetailConverted to the area that you prefer.

   

2. Click Save to save the changes to the Layout.

C. Remove the old Advocacy Activities Object

1. On the same page, scroll down the page to find the AdvocacyActivities object in the Related Lists > Click Remove icon.

   

D. Adding the new Acts of Advocacy Object

This custom object will list all the acts of advocacy activities that the contact completed in the Hub.

1. On the same page > Select Related Lists > Drag and drop Influitive Acts of Advocacy to the area that you prefer.

   

2. Once added, click on the wrench icon on the Influitive Acts of Advocacy component.
   

   

3. In this window, please add the following fields to display in the Acts of Advocacy Object. Click OK once you're done.
   - Acts of Advocacy Name (Required) - This describes the act of advocacy completed by the advocates.
   - Advocacy Type - https:https://influitive-supportdesk.zendesk.com/hc/en-us/articles/15750759014674-Acts-of-Advocacy
   - Source Title - This would be the challenge's name where the act of advocacy came from.
   - Date Occurred - This is the date and time the act of advocacy occurred in the Hub.
   - Content - The Challenge or Discussions responses content.
   - Prospect - If you are using the Reference request tool, this column will show the prospect's name that the contact completed a reference for from the Hub. If you are not using the Reference Request tool, you may skip adding this field column.
   
   Please Sort By: Date Occurred (Descending)
   
   

   

4. Click OK and click Save to save the changes to the Layout.

E. Removing Acts of Advocacy (Prospect) Object

1. On the same page, scroll down the page to find the AdvocacyActivities (Prospect) object in the Related Lists if it's available > Click on the Remove icon.

   

F. Add References Received via Influitive Object

This custom object will list all the reference request challenges that the contact has completed. This is related to the Salesforce: Reference Request feature that is an additional fee. If you don't have this tool in your contract, please skip this step.

1. In the same page > Select Related Lists > Drag and drop References Received via Influitive to the area that you prefer.

   

2. Once added, click on the wrench icon on the References Received via Influitive component.
3. In this window, please add the following fields to display in the Acts of Advocacy Object. Click OK once you're done.
   -  Acts of Advocacy Name (Required) - This describes the act of advocacy completed by the advocates.
   -  Advocacy Type - https:https://influitive-supportdesk.zendesk.com/hc/en-us/articles/15750759014674-Acts-of-Advocacy
   -  Source Title - This would be the challenge's name where the act of advocacy came from.
   -  Date Occurred - This is the date and time the act of advocacy occurred in the Hub.
   -  Contact - This field will show which Salesforce contact (Hub member) that completed the reference request challenge for this Salesforce prospect contact.
   -  Content - The Challenge or Discussions responses content.
   -  Program Name - This will show the name of the Hub where the activity happens.
   
   Please Sort By: Date Occurred (Descending)
   
4. Click OK and  Click Save to save the changes to the Layout.

Accounts Page Layout

To start, click Setup > Customize > Accounts > Page Layouts > Click Edit next to the layout that your Salesforce users use. The following components are provided from the AppExchange Package:

A. Adding the new Influitive Acts of Advocacy Object

This custom object will list all the acts of advocacy activities that the contacts in the Account have completed in the Hub.

1. On the same page > Select Related Lists > Drag and drop Influitive Acts of Advocacy to the area that you prefer.

   

2. Once added, click on the wrench icon . In this window, please add the following fields to display in the Influitive A cts of Advocacy Object . Click OK once you're done.
   - Acts of Advocacy Name (Required) . This describes the act of advocacy completed by the advocates.
   - Advocacy Type - https:https://influitive-supportdesk.zendesk.com/hc/en-us/articles/15750759014674-Acts-of-Advocacy
   - Contact - This is the contact record the completed the acts of advocacy.
   - Source Title - This would be the challenge's name where the act of advocacy came from.
   - Date Occurred - This is the date and time the act of advocacy occurred in the Hub.
   - Content - The Challenge or Discussions responses content.
   - Prospect - If you are using the Reference request tool, this column will show the prospect's name that the contact completed a reference for from the Hub. If you are not using the Reference Request tool, you may skip adding this field column.
   
   Please Sort By: Date Occurred (Descending)
   
   

   

3. Click OK and click S ave to save the changes to the Layout.

B. Adding the new References Received via Influitive VisualforcePage

1. In the same page, click on the Visualforce Page

2. Go to Visualforce Page > Drag and Drop " ReferencesRelatedListPage" onto the layout

   

3. Click Save to save the Layout.

4. This will be the new Related List Component that will record the reference activities for the selected Prospect’s Account and the Influitive Acts of Advocacy of the Hub member’s Salesforce Account.

   

Opportunity Page Layout

To start, click Setup > Customize > Opportunity > Page Layouts > Click Edit next to the layout that your Salesforce users use. The following components are provided from the AppExchange Package:

A. Removing the old Reference Request button if you have one in the page

1. To remove the old Reference Request button, click on the Buttons option menu > Drag and drop the Reference Request button back to the menu > Click Save .

   

B. Adding the new Reference Request Tool

1. On the same page > Head over to the Visualforce Page option > Drag and drop RequestReferenceComponentConverted to the preferred area on the layout.

   

2. Once added, you will need to adjust the size of the Visualforce Page. To do this, click on the wrench icon and change the Height (in pixels) to 600 and Show scrollbars = Checked and click OK .

3. Click Save to save the changes to the Layout.

C. Adding the new References Received via Influitive

1. In your Salesforce instance > Go to Setup > Customize > Opportunity > Page Layout > Select Layout
2. In the Related List > Drag and drop References Received via Influitive into the Layout

   

3. Click on the wrench icon and add the following fields: Acts of Advocacy Name (Required), Advocacy Type, Source Title, Date Occurred, Prospect, Content, Contact, Opportunity, Prospect > Click OK.
   

   

4. Click Save Layout
5. Here's an example of what this looks like. This component will include all reference activities the Opportunity has received.

   

The reference request tool is all done! To see the Hub members and Reference requestor experience on using the Reference Request Feature as well as the best practice for this feature, please follow the following article - Salesforce: Reference Request

Salesforce Influitive Dashboard

1. Head over to the Dashboard > Dashboard List
2. Remove the other Influitive Dashboards, there should only be one dashboard: Influitive Dashboard 3.0
3. Please note that when you delete a Dashboard, all the customizations done in that report will be deleted as well.

Salesforce-Influitive Individual Feature Setup Update

Please continue the setup update on the Influitive Integration by going through the following articles for the Salesforce integration features:

1. Salesforce: Push Acts of Advocacy
2. Salesforce: Reference Request
3. Salesforce: Automatic Customer Data Import
4. Salesforce: Nominate button / Converted Contact details
5. Salesforce Dashboards
6. Salesforce: Push Referrals 2.0