InformationTitleOutreach Add / Remove from Sequence NodeURL NameOutreachAddRemovefromSequenceNode6901fb2e1ad25Step-by-StepContents: OverviewSetting up LeanData-Outreach IntegrationPrerequisitesSteps to ImplementOutreach Sequence & Mailbox SetupAdd to Sequence Node in FlowBuilderMonitoring and TroubleshootingAppendix Overview Customers who utilize both LeanData and Outreach can initiate Outreach actions within LeanData’s FlowBuilder interface. Features Add Prospect to Sequence in OutreachSelect Mailbox for automated emailsUpdate the record owner in OutreachRemove Prospect from Sequences in Outreach Setting up LeanData-Outreach Integration Before you are able to use these FlowBuilder Nodes, you will have to connect and enable the LeanData-Outreach Integration according to the steps outlined in the LeanData - Outreach FlowBuilder Integration Guide. Add to Sequence Node in FlowBuilder You can add an Add to Sequence Action Node from the Integrations > Sales Engagement > Outreach Section in the FlowBuilder interface. Within the Add to Sequence Node, there are a few configurable options. Which Sequence do you want to add the prospect to? In the Which Sequence do you want to add the prospect to? section, you need to select the public Sequence where you want to add the Lead or Contact. There are two options available: Specific Sequence With this option, you will select a specific Sequence from a dropdown list of public Sequences synced from Outreach. If you have recently added or updated your Sequences and they don't appear in the dropdown, click the circular refresh icon to sync your Sequences. Sequence ID from a Variable The Sequence ID from a Variable option lets you dynamically reference a Sequence ID stored in a variable. This ID corresponds directly to the Sequence’s identifier in Outreach. The Sequence ID must be stored in a variable or field located upstream in your graph. For instance, if you want to match specific Campaigns to particular Sequences, you can create these mappings in a Data Table and set a Sequence ID variable in this node to add the Lead/Contact to the correct Sequence. Mailbox for Email Delivery: This designates the user mailbox “sending” automated emails in Sequences. The “From:” field will display the Outreach user’s default mailbox email address in the automated emails. Lead or Contact Owner: this will set the Salesforce record owner as the sender in emails. Ensure that all potential Salesforce record owners have Outreach user accounts and Mailboxes enabled. V1 of this integration does not accommodate Queues as Salesforce record owners User Field on Lead or Contact: this will set the Salesforce user populated in the designated Salesforce User field as the sender in emails. To set the sender as the Outreach Prospect Owner, map the Owner field in Outreach to the Owner field in Salesforce. Visit Settings > Plugins > Salesforce > Lead and Contact > Fields > Map Prospect “Owner” to a Salesforce field on the Lead and Contact > Check “Updates Out.” Specific User: this will display a list of all Outreach Users with Mailbox Send and Sync enabled. If you create or enable Send / Sync for new Outreach users while you are in a LeanData session, refresh to update the list of available user mailboxes. Outreach Ownership Assignment: Checking the box will allow you to designate a User with the same options above, and LeanData will update the Prospect owner in Outreach to the User indicated here. Notes: Convert Lead + “Add to Sequence” Behavior: When a Lead is successfully converted to a Contact, LeanData will add the related Contact to the designated Sequence. If utilizing the Convert Lead node, ensure the mapping of Salesforce fields to Outreach fields in LeanData Partner settings is complete for Contacts. “Merge Dupe” + “Add to Sequence” Behavior: LeanData will NOT add the Prospect to a Sequence if a Merge Dupe node is in the same path as the Add to Sequence Node. Node Placement & Edge Options Node Placement: Depending on sync direction, different triggers or conditions should be utilized with the “Add to Sequence” node. Salesforce > Outreach: If your sync settings are set up where Leads or Contacts are created in Salesforce then synced over to Outreach, use the “Updated Lead / Contact” trigger node or condition of “Outreach Prospect ID” as has changed / is not null. Outreach > Salesforce: If your sync settings are set up where Prospects are created in Outreach then synced over to Salesforce, use the “New Lead / Contact” trigger node or the condition of “Outreach Prospect ID” is not null.Salesforce If bi-directional sync is on, then configure using both of the options above. Edge Options: Users have the ability to choose the next node LeanData should move onto if there’s one of the below errors Configuration Error: the authorization for Outreach is invalidMissing Prospect ID: the Outreach ID is missing on the Lead or ContactMissing User ID: the Outreach ID is missing on the User (the user for mailbox selection)Queue Owner: the record is Queue-owned and the mailbox selected is the Lead / Contact Owner Remove from Sequence Node in FlowBuilder In addition to Adding Prospects to Sequences in Outreach, you can also remove Prospects from Sequences using the Remove from Sequence Action Node. Before using this node, you will have to follow a few setup steps. Pre-Setup for Remove From Sequence Create Salesforce Field You will first have to create a custom Salesforce field on your Lead/Contacts which LeanData will trigger in order to remove a prospect from a sequence: Navigate to Salesforce Setup > Object Manager > Lead (or Contact) > Fields & Relationships > New. Select the Checkbox field Type. Click Next.Enter a Field Label and Field Name. You may use whatever you wish but recommend something you can easily identify for its purpose like "Outreach Stop Sequence". Description and Help Text are optional. Click Next. On the next screens, select your desired field level security and desired page layouts, then click Save.Repeat this process for the Contact Object if you plan on using this in Contact Router. Create & Map Outreach Field You will then need to map this new Salesforce field to a new Outreach field to be bi-directionally synced with Salesforce. Please follow the field mapping instructions from the Outreach article How to Map a Field in Outreach. Configure Outreach Trigger to Stop Sequence From Outreach, create a trigger based on the custom field on the Prospect being updated to True. Select your Target to be the Prospect. This Trigger should initiate two Trigger Actions: Stop Sequences and Set Field. Configure the Trigger Actions to mark the Prospect as Finished in All Sequences, and also to mark your Outreach Stop Sequence field as False (to reset the field). For more information on Outreach Triggers, please see the Outreach help article: How to Create an Outreach Trigger. Configuring the Remove from Sequence Node From within Lead or Contact FlowBuilder, drag a Remove From Sequence Node onto your graph. You can find this from the Node Bar Under Integrations > Sales Engagement > Outreach. Within the Remove From Sequence Node, there are a few configurable options: Update Lead/Contact Field Within the Update Lead/Contact Field section you will want to select the custom Salesforce field you previously created in Salesforce and mapped for stopping Outreach Sequences: Outreach Stop Sequence. For the value, select True. Email Notifications You can configure email notifications to be sent in the case of a successful update or a failure. Advanced Settings The only fallback edge is Next Node, which will allow you to direct the Lead / Contact to additional nodes after updating the field which removes a Prospect from a sequence. Monitoring and Troubleshooting Audit Logs Outreach actions are included in LeanData Audit Logs In some cases, LeanData cannot perform the requested actions in Outreach. Audit Log Filters: You can filter your Audit logs by the Outcome of the Outreach action, specifically: Outreach - Success (Outreach), Pending (Outreach), Error (Outreach). Note that the Error (Fallback) Outcome filter will not show any Outreach Fallback errors at this time. Pending (Outreach): If LeanData cannot perform the requested action in Outreach, we will try again after the amount of time set in your Partner App settings. At that point of time, the record will be set to “Pending” in the Audit Logs. Records will remain in the “Pending” state until ultimate failure or success. Error (Outreach): After six retries, LeanData will mark the records as an error for the Outreach portion of the Path in the Audit Logs. Both Pending records and Error records will display the audit trail of each attempt to complete the action. If LeanData follows an edge (ex: Queue Owner), it will mark the node in the Path as an Error and will not show an error message in the Outcome columnIf LeanData cannot perform the requested action because of misconfigured settings (ex: incorrect field mapping on the LeanData set up for Outreach) or unexpected issues, we will revert back any changes made on the record in the path.If LeanData cannot perform the requested action because of a callout error, only the action of adding a Prospect to a Sequence will fail.
