Pipedrive integration
Overview
When you connect Pipedrive to Ortto, we sync your People, Organizations, and activities related to Deals, Notes, and Person updates. The data is read-only, but you can use actions in Playbooks to send information back to Pipedrive, like creating or updating deals.
This integration helps you engage customers throughout their journey, from nurturing new leads to retaining existing customers.
Common use cases include:
- Nurturing subscribers into deals.
- Welcoming new customers and subscribers.
- Retaining existing customers.
It also lets you connect Pipedrive data with key activities, like website visits, email interactions, and marketing revenue attribution.
Pipedrive prerequisites
To integrate with Pipedrive, you’ll need an active Pipedrive account and System Administrator access.
Connect from Ortto
To connect to Pipedrive:
- Navigate to CDP > Data sources > click New data source.
- Under CRM or All data sources, select Pipedrive, then Get started.
- On Connect to Pipedrive, if needed, select Advanced options to:
- Choose which CDP fields can be modified from the Pipedrive data source, or
- Choose not to modify CDP data fields that already have a value.
- Click Connect then authorize access to your Pipedrive account.
- At Fields, choose which Pipedrive fields will be synchronized across to your Ortto account’s customer data platform (CDP).At this point, you can set specific Pipedrive fields to determine the email and SMS permissions for Pipedrive contacts synced to Ortto. This is designed for when you use a custom field instead of marketing status to determine a contact’s subscription status. (Otherwise, new Pipedrive contacts added to Ortto will be subscribed (or unsubscribed) according to their marketing status in Pipedrive.)
- At Data retention, select to either:
- store only the last 90 days of activity data, or
- select the time frame for the data stored, and the activities which will be stored.
- On the Select records page, choose between syncing all your chosen object data in the previous step across to Ortto (by leaving Sync all selected), or click Selectively sync to specify conditions on Pipedrive object data related to people or organizations in your Ortto’s CDP that will be synced.
- On the Merge page, select the appropriate strategy by which people’s (customers') data is merged from Pipedrive into your Ortto’s CDP.
- Click Sync to finish.
- Click Done to exit the setup.
NOTE: It is recommended to set the data retention limits while setting up the data source. Updating the data retention limits in the future will require a resync of the data source, which may affect multiple audiences and campaigns within your customer data platform (CDP). Learn more about configuring data retention under Configuring data retention.
NOTE: Each object can be associated with a maximum of 50 records.
NOTE:
The merge options:
- Import and merge new records only.
- Import and overwrite any records that exist.
- Import new records only.
are equivalent to the respective emerge strategies for people:
- Append only.
- Overwrite existing.
- Ignore.
How is the data merged into Ortto?
Data is merged from Pipedrive to Ortto on the initial connection. Subsequently, newly modified objects are synced shortly after they occur.
The Pipedrive integration is initially configured as read only, which means that no data is sent from Ortto to Pipedrive. Should you wish to send data from Ortto to Pipedrive, you can create a journey or playbook using Pipedrive actions.
NOTE: Journey and playbook actions are only available to customers on selected Ortto plans.
Learn more about sending data from Ortto to Pipedrive.
When a person is added to your CDP from the Pipedrive data synchronization, if they do not already exist as a contact in your CDP, they are added as a new contact. Any new contacts are automatically subscribed to receive email communications. (New contacts are unsubscribed to SMS by default.)
If a contact synced from Pipedrive already exists in Ortto, the contact will not have their email or SMS permissions changed; they will remain as they were set in Pipedrive.
Initial data sync
Person, organization, deal, activity and note objects, along with default fields and any custom fields you selected, are merged into the Ortto CDP. The merge follows the data merge strategy selected during the initial connection with Pipedrive. Ortto activities store data based on the objects you chose to be synced during the integration.
Depending on the number of records in your Pipedrive account, due to API limitations of Pipedrive the initial sync may take several hours. You can view the state of the connection on the Data sources page.
Ongoing data sync
Pipedrive data is merged in to Ortto shortly after it occurs.
Resynchronizing data
Pipedrive data is resynchronized when the data source is reconnected and when the data retention limits are adjusted. The resync will not perform a full backfill of data, it will only import changes that occurred since the last Ortto request for Pipedrive data.
A resync of the Pipedrive data may affect the audiences and campaigns within the CDP by resetting the attributes for the person, and activities, causing a person to potentially re-enter an audience or campaign within the CDP.
What does the data source add to my account?
The Pipedrive data source adds:
- Pipedrive contact and account records and their associated fields to your CDP, known as people or organizations respectively in Ortto.
- Pipedrive activities from the last 90 days including leads, opportunities, campaigns and tasks. In some cases, however, it may be necessary to store an activity and its attribute data for longer. Therefore, Ortto provides a mechanism for customers to opt-in to selectively store their activity data for longer. Learn more about data retention under Configuring data retention.
NOTE: If your Pipedrive account was connected prior to 22nd Oct 2022, custom fields are not included in the Pipedrive activities Ortto receives. Switching this setting on via the “custom fields” section of your Pipedrive data source will cause new versions of all existing Pipedrive activities.
This change to the activities will break any existing audience, filter, report or campaign using the existing Pipedrive activities and they must be manually updated to select the new version of the Pipedrive activities.
Please be mindful that once you turn this setting ON, even if you later switch it OFF again, you will still need to update all uses of your Pipedrive activities.
- The ability to use Liquid syntax in campaign messages to personalize your messages using merge tags for Pipedrive person fields and activity attributes. Learn more about using Liquid syntax under Personalizing campaign content with Liquid.
- NOTE: Deleting a Pipedrive data source connection will not remove the current entries in the CDP for people or activities that were merged from that Pipedrive connection.
- Pipedrive audiences based on activity data, such as slipping subscribers, engaged deals, and repeat customers.
View Pipedrive fields in your CDP
Customize your CDP field visibility and add Pipedrive fields by clicking the cog icon, then select or clear the fields you want to show or hide. Pipedrive fields are indicated with the small Pipedrive icon.
Access the Pipedrive data source view
When a data source is connected, you are provided with a data source view. On the Data sources page, click the data source you wish to view.
A data source’s view is the administration page where you can:
- view and manage the data source in the left-hand details panel, and
- under the relevant tabs on the right-hand side, view:
- an Overview of the data source,
- an Activity feed, and
- an Audience table, which displays the people imported from Pipedrive.
In the details panel, you can give the data source a new name (this will not affect your Pipedrive account settings). To do so, hover over the name and click the pencil icon, then type the new name and click on a blank area of the page to save the name. You can also disconnect the data source, and modify:
- whether to modify system CDP fields,
- the merge strategy,
- the default and custom Pipedrive fields to sync
- Ortto activities to sync to Pipedrive, and
- the data retention period.
Learn more about managing data sources.
Using Pipedrive
Learn how to maximize your Pipedrive integration with Ortto’s filters, reports, dashboards, campaigns, and coupons.
Learn more about using Pipedrive in Ortto.
Troubleshooting Pipedrive
Find solutions to common issues and questions when using Pipedrive as a data source.
Learn more about troubleshooting Pipedrive.