People.ai & Outreach Integration Setup Steps

Purpose:

The purpose of this article is to provide direction to Outreach Users in setting up the people.ai integration. 

For Outreach and People.ai to work together, there are some additional steps in the Outreach Salesforce plugin that need to be taken. These steps will ensure duplicate activities are not pushed to Salesforce. This is achieved by adding a unique message ID to your Salesforce Task object, which allows People.ai to identify which mailings have already synced with Outreach, and which ones have not yet synced.

Intended Audience: 

• Outreach Users

Notes: 

• Outreach’s Advanced task mapping feature must be enabled for People.ai & Outreach to work together without duplication.
• For more information regarding adding and enabling this feature, contact your AE. 

Setting up the Salesforce Plugin for the People.ai Integration

Adjusting the Lead and Contact Salesforce Objects in Outreach

Note: These steps can only be completed by an individual with an admin Outreach license.

1. Click on the initials on the bottom left-hand corner of the Outreach platform
2. On the settings panel that appears, find the section labeled “system config” and click on “plugins”.
   
3. Click into the Salesforce plugin and select the lead type object.
4. Find the section of the page labeled “messages & events”. Under this section, disable the toggle labeled “outbound messages sent within Outreach”.
   
5. Further down the “messages & events” list, find the toggle labeled “include message ID for field events” and make sure it’s enabled. This allows Outreach to push message IDs from Outreach emails into Salesforce. People.ai checks the message ID before creating a new activity in Salesforce. Enabling this toggle prevents duplicate activities. If you do not see this toggle, please reach out to our support team.
   
6. Next to the same toggle, click on the gear icon. Here, you’ll need to insert the API field name that you’re using for their Message ID field. If this is not a custom field, you can keep the default provided by Outreach.
   
7. Save your changes and repeat steps 1-6 on the contact object.

Adjusting the Task Salesforce Object in Outreach

1. Navigate back to the Salesforce plugin. Select the Task <> Mailing object.
2. On the top of the page, click on “fields”.
3. Click the add button on the top right-hand side of the page and scroll to the bottom of the list of mappings. Map the Outreach Message ID field to the Salesforce Message ID field.
   
4. To the right of your new field mapping, make sure the “updates out” checkbox is enabled.
   
5. Save your changes.

Before the integration is complete, make sure you connect with the client success and support team at People.ai to set up their side of the integration.