Pipedrive And Referral Factory Integration: A Full Guide

Discover how Pipedrive and Referral Factory combine to enhance your referral program. Sync contacts, generate unique referral links, and track metrics inside Pipedrive. Plus, import new leads and qualify them seamlessly.

pipedrive referral program

Are you looking for referral program software that works with Pipedrive? 

Get your referral program up and running, and integrated with Pipedrive, in just a few days πŸ‘‰ Try Referral Factory for free for 15 days!

If you already have a Referral Factory account, then keep reading to learn how to set up your integration πŸ‘‡



In this guideπŸ‘‡

1. What you can do with Pipedrive and Referral Factory πŸš€

2. How To Connect Your Pipedrive Integration

3. How To Configure Your Pipedrive Integration

3.1. How To Sync Pipedrive Leads or Contacts with Referral Factory (and Generate Their Referral Links)

3.2. How To Send Users from Referral Factory to Pipedrive

3.3. How To Automatically Qualify Successful or Converted Referrals 

3.3.1. How to Qualify A Referral in Pipedrive When a Lead Converts into a Deal

3.3.2. How To Qualify A Referral in Pipedrive When A Lead Converts Into A Deal and Moves to Any Stage

3.3.3. How To Qualify A Referral in Pipedrive by Deal Stage

3.3.4. How To Qualify A Referral in Pipedrive When a Deal is Marked as Won

4. Uninstall your Pipedrive Integration from Referral Factory

5. Troubleshoot Your Pipedrive Integration


 


1. What You Can Do With Pipedrive and Referral Factory πŸš€

πŸ‘‰ Sync your Pipedrive contacts to automatically generate their unique referral links, which you can then send back into Pipedrive along with their referral metrics. That way, you can distribute referral links directly from Pipedrive and monitor your referrers' performance from within your CRM.

πŸ‘‰ Send new referred leads generated via your referral program straight into Pipedrive as leads or deals.

πŸ‘‰ Qualify successful or converted leads simply by updating their lead status, by deal stage, or by converting a lead into a deal and moving it to a specific deal stage (for example, "Closed Won"). 


 

2. How To Connect Your Pipedrive Integration

 

What You Need:

  • Any Referral Factory plan.
  • Any Pipedrive plan.
  • A draft or live referral campaign in Referral Factory.

β†’ In the left-hand navigation bar of your Referral Factory dashboard, click the Settings tab.

β†’ Click Connect under the Pipedrive logo. 

β†’ A pop-up will appear. Review the permissions and then click Allow and Install.

authorize_pipedrive

β†’ Success!

❗️Please note that you can only connect one Pipedrive account to Referral Factory at a time. You may be able to connect additional Pipedrive accounts via Zapier. Please consult this guide:

πŸ“– Zapier And Referral Factory: A Full Guide πŸ“– 


 

3. How To Configure Your Pipedrive Integration

Once your Pipedrive account is connected to Referral Factory, you will need to configure your integration inside your campaign(s). 

❗️ If you want to sync multiple referral campaigns with Pipedrive, you will need to configure the integration for each campaign.  

 

There are three main functions to configure to use your Pipedrive integration to its full potential:

πŸ‘‰ Sync all or some of your Pipedrive contacts with Referral Factory.

πŸ‘‰ Send users from Referral Factory into Pipedrive as leads or deals.

πŸ‘‰ Qualify successful referrals when a field changes or a status updates in Pipedrive.

πŸ’‘ Want to know more about qualifying converted or successful referrals in general? Read this guide:

πŸ“– How to Qualify Converted or Successful Referrals πŸ“–

 

3.1. How To Sync Pipedrive Contacts with Referral Factory (and Generate Their Referral Links)

πŸ’‘ The integration between Referral Factory and Pipedrive allows for seamless data transfer in both directions. You can send data from Referral Factory to Pipedrive and vice versa, ensuring that all relevant information is synchronized between the two platforms. This integration enhances the efficiency and effectiveness of your referral program by streamlining the data exchange process.

 

Before you configure the sync between Referral Factory and Pipedrive, you will need to create custom fields in Pipedrive for the referral data you want to sync:

  • Referral Link
  • Referral Count (optional)
  • Converted Referral Count (optional)

You can learn more about creating custom fields in Pipedrive's knowledge base: 

πŸ”— Create Custom Fields πŸ”—

 

You can sync your Pipedrive contacts from two places in the Referral Factory dashboard:

πŸ‘‰ From the Users Tab.

β†’ Click Add Users.

β†’ Click Sync Your CRM Contacts.

 

salesforce-1

 

πŸ‘‰ From the Promote section inside the campaign builder.

β†’ Click Generate referral links for your CRM contacts.

 

salesforce-3

 

β†’ Select whether you want to sync your Pipedrive contacts on an ongoing basis. In other words, every time you add a new contact in Pipedrive who meets the criteria you set for the sync, they will be automatically added to your referral campaign.

❗️Contacts that you sync will not be automatically notified or sent their referral link. If you would like to notify them, please use your own marketing channels or Referral Factory's once-off email feature. You can learn more about once-off emails here: πŸ“– How To Create A Once-Off Email πŸ“– 

 

You have the option to sync:

  • All your Pipedrive contacts or
  • A list of Pipedrive contacts based on filters

To learn more about filtering in Pipedrive, please consult their knowledge base:

πŸ”— Filtering in Pipedrive πŸ”—

β†’ Select whom you want to sync between Referral Factory and Pipedrive. If you want to select a list of people based on a filter, choose the filter name from the drop-down list.

β†’ Map the data fields for Referral Link, Referral Count (optional), and Converted Referral Count (optional) to the custom fields you have created in Pipedrive.

β†’ Click Next.

 

 

β†’ Check that the number of leads or contacts to be synced matches the number of leads or contacts in your Pipedrive account or selected list.

β†’ Click Next.

 

 

β†’ Click Save to confirm and start the sync.

 

β†’ Success!


 

3.2. How To Send New Users from Referral Factory to Pipedrive as Leads or Deals

Referral Factory can automatically create a new lead or deal in Pipedrive when someone signs up to participate in your referral program. In most cases, you would want to send referred users into your CRM. However, you can also send users who sign up to refer via the campaign join link (as a person referring). 

 

πŸ“Œ If a Referral Factory user is already a Pipedrive contact, don’t worry! Referral Factory will check the user’s email address against your contact list and will only create new contacts. 

 

This function must be configured from inside the campaign builder. 

β†’ Select the Campaigns tab from the left-hand menu bar.

β†’ Click Edit Campaign.

 

salesforce (8)

 

β†’ Once you're inside the campaign builder, select Integration from the bottom navigation bar.

β†’ Select which Referral Factory users you want to send into Salesforce.

πŸ‘‰ Select Direct if you want to send the Person Referring and/or  

πŸ‘‰ Select Referred if you want to send the Person Invited.

 

 

πŸ’‘ If you are automatically generating referral links for your contacts through the CRM sync and not allowing people to sign up for referral links via the campaign join link, you do not need to send direct users.

 

πŸ’‘ Not sure about what counts as a user, or the difference between the person referring and the person invited? Read this πŸ“– What Is A User? πŸ“–

 

β†’ Select whether the new user should be created as a Lead or a Deal in Pipedrive. You can learn about the difference in Pipedrive's knowledge base: πŸ”— Leads vs Deals πŸ”—

 

β†’ The next section of the page only applies if you want to automatically qualify a referral when a lead converts in Pipedrive. If you only want to send users without adding a qualification trigger, you can ignore these options. The settings for automatic qualification will be covered in the next section (click here to jump to that section).

 

πŸ‘‰ Before you begin mapping your data fields, decide which data you want to send from Referral Factory to Pipedrive. 

β†’ Create the relevant form fields in your campaign Pages for the Person Referring and/or Pages for the Person Invited. 

β†’ Create the relevant custom data fields in Pipedrive.

❗️For the integration to work, you must create a custom field for {Referral Code}❗️

You will likely want to create fields like "Campaign Name", "Referral link", "Referrer First Name", "Referrer Email Address", "Referral Count" and "Converted Referral Count". 

πŸ‘‰ Once you have created the relevant data fields, continue the configuration in the integration step of the campaign builder. 

 

πŸ‘‰πŸ‘‰πŸ‘‰πŸ‘‰πŸ‘‰πŸ‘‰πŸ‘‰πŸ‘‰πŸ‘‰πŸ‘‰πŸ‘‰πŸ‘‰πŸ‘‰πŸ‘‰πŸ‘‰πŸ‘‰πŸ‘‰πŸ‘‰πŸ‘‰πŸ‘‰πŸ‘‰πŸ‘‰πŸ‘‰πŸ‘‰πŸ‘‰πŸ‘‰πŸ‘‰πŸ‘‰πŸ‘‰πŸ‘‰πŸ‘‰πŸ‘‰πŸ‘‰πŸ‘‰πŸ‘‰πŸ‘‰πŸ‘‰πŸ‘‰πŸ‘‰πŸ‘‰πŸ‘‰πŸ‘‰

 

β†’ Click Map the below fields to the fields in Pipedrive.

β†’ Use the drop-down options to match the relevant data between Referral Factory and Pipedrive. The options in the drop-downs will pull directly from your Pipedrive account. 

❗️Pipedrive requires that you map the following fields:

β†’ {First Name}

β†’ {Email} 

β†’ {Title} 

β†’ {Referral Code}

❗️ If these fields are not mapped, the integration will not work ❗️

πŸ’‘ For the Pipedrive integration to work correctly, you need to map a data field from Referral Factory to populate in Pipedrive's default {Title} field which is used to label leads and or deals. Since you wouldn't be likely to ask for this information from your users, we recommend mapping a default Referral Factory field like {Campaign Name} or {Source}. However, you could also map other form fields you create, such as {Last Name} or {Company}.

 

β†’ If you would also like to send information about the Person Referring (e.g., {First Name} and {Email}) when a new referred lead is sent to Pipedrive, toggle on the option to Pass extra data fields through with each referred user (this will attach information from the person referring). Remember that you would need to have created custom fields for this data in Pipedrive before you can map the data. 

 

 

β†’ You also have the option to sync additional Pipedrive values that you would like to include. Simply click on Choose your default Pipedrive values from the fields below. These options will be pulled directly from your Pipedrive account.

 

 

β†’ Click Next.

 

Here is an example of how the information may appear in Pipedrive:

 

3.3. How To Automatically Qualify Successful or Converted Referrals 

You can use Referral Factory's integration with Pipedrive to trigger a qualification in Referral Factory when a data field or status changes in Pipedrive. 

πŸ’‘ Are you unsure about what it means to qualify a referral? Read this help guide to learn about marking successful or converted referrals as qualified: 

 

πŸ“– How to Qualify Converted or Successful Referrals πŸ“–

 

What will change in Pipedrive when you consider a referral successful? Select from the following options to trigger a successful or converted referral in Referral Factory:

πŸ‘‰ A Lead Would Convert Into A Deal

πŸ‘‰ When A Lead Converts Into A Deal and Moves to Any Stage

πŸ‘‰ A Deal Stage Would Change

πŸ‘‰ A Deal Would Be Marked As Won

 

πŸ“Œ The fields available in these settings pull directly from your Pipedrive account. So, if you have custom deal stages, these will be available for selection. 


 

3.3.1. How To Qualify A Referral in Pipedrive When A Lead Converts Into A Deal

 

β†’ Under 'When we send these users into Pipedrive, should we create a lead or a deal?', select 'Create a lead’.

β†’ Under 'Which of the options...', select 'Whenever Lead Converts to Deal'.

You can learn more about converting leads to deals in Pipedrive in their knowledge base: πŸ”— Converting leads to deals πŸ”—

 

3.3.2. How To Qualify A Referral in Pipedrive When A Lead Converts Into A Deal and Moves to Any Stage

 

β†’ Under 'When we send these users into Pipedrive, should we create a lead or a deal?', select 'Create a lead’.

β†’ Under 'Which of the options...', select 'Whenever Lead Converts to a Deal With Any Stage'.

β†’ Select your deal pipeline.

β†’ Select the deal stage at which you'd like to trigger the qualification.

You can learn more about converting leads and deals in Pipedrive in their knowledge base: πŸ”— Converting leads to deals πŸ”—.


 

3.3.3. How To Qualify A Referral in Pipedrive by Deal Stage

 

β†’ Under 'When we send these users into Pipedrive, should we create a lead or a deal?', select 'Create a deal’.

β†’ Under 'Which of the options...', select 'The deal stage would change'.

β†’ Select your deal pipeline.

β†’ Select the stage that the deal should go to when it's first created by Referral Factory.

β†’ Select the deal stage at which you'd like to trigger the qualification.

You can learn more about deals in Pipedrive in their knowledge base: πŸ”— Deals: What they are and how to add themπŸ”—.


 

 

3.3.4. How To Qualify A Referral in Pipedrive When a Deal is Marked as Won

 

 

β†’ Under 'When we send these users into Pipedrive, should we create a lead or a deal?', select 'Create a deal’.

β†’ Under 'Which of the options...', select 'The deal would be marked as WON'.

β†’ Select your deal pipeline.

β†’ Select the stage that the deal should go to when it's first created by Referral Factory.

You can learn more about deals in Pipedrive in their knowledge base: πŸ”— Deals: What they are and how to add themπŸ”—.


4. Uninstall your Pipedrive integration from Referral Factory

β†’ Navigate to the Settings tab on the left-hand side.
β†’ Under the Pipedrive logo, select 'Disconnect'.

disconnect_pipedrive

❗️ Once disconnected, no user data will sync between Pipedrive and Referral Factory or vice versa. However, any data that was synced before will still be available in both systems. 

 


 

5. Troubleshooting

 

Having trouble with the Pipedrive integration? Please consult our troubleshooting guide: πŸ“– Troubleshoot Your Pipedrive Integration πŸ“–