How To Automatically Qualify Referrals Using Monday

Automate your referral program with Monday and Referral Factory! Use your regular Monday workflows and pipelines to automatically qualify successful referrals, which, in turn, could trigger a reward to the person who referred them.

πŸ“Œ  Want to know what else you can do with Referral Factory and Monday? Read the overview.

Step 1 (Optional): Create Custom Columns in Monday

β†’ Should you wish to store additional referral data related to your referred user, create the relevant columns inside Monday. You could, for example, create columns to house information like:

  • {Referred By}: The person who referred them
  • {Referral Campaign}: The name of your Referral Factory campaign (useful if you're running multiple campaigns)
  • {Referral Link}: The referral link automatically generated for the new user (useful if you will enrol newly referred leads into your referral program)

monday-referral-factory-integration-create-new-columns-in-monday-store-referral-information

Step 2: Configure How Data Should Be Sent in Referral Factory

β†’ Click Edit Campaign to enter the campaign builder. 

β†’ Navigate to the Integrations step in the bottom navigation bar. 

β†’ Scroll down until you see the option to configure settings for the Person Invited. 

β†’ Use the dropdown menu to select the board in Monday where you want to send your new referred users.

monday-referral-factory-integration-step-2-

Step 3: Set Your Qualification Rules

β†’ To automatically qualify the Person Invited when they convert in Monday, set the rules that will trigger the automatic qualification.

 

You have 4 options: 

πŸ‘‰ Option 1: Qualify when a user property changes

πŸ‘‰ Option 2: Qualify when a user property changes AND the user is moved to a specific group

πŸ‘‰ Option 3: Qualify when a user is moved to a specific group

πŸ‘‰ Option 4: Qualify when a user is moved to a specific board

Option 1: Qualify When A User Property Changes

β†’ Select β€œQualify when a user property changes”. 

β†’ Select the column in which the property will change. For example, Status.

β†’ Choose the initial value that should be used when Referral Factory first creates the lead in Monday. For example, 'New Lead'.

β†’ Then, choose the value that will be updated when you consider the item a successful or converted referral. For example, 'Qualified'. This is the status that will trigger a qualification in Referral Factory.

β†’ Click Save Qualification Settings.

monday-referral-factory-integration-step-3-option-1-qualify-by-change-in-user-property

Option 2: Qualify When A User Property Changes AND The User Is Moved To A Specific Group

β†’ Select β€œQualify when a user property changes AND the user is moved to a specific group”. 

β†’ Select the column in which the property will change. For example, Status.

β†’ Choose the initial value that should be used when Referral Factory first creates the lead in Monday. For example, 'New Lead'.

β†’ Then, choose the value that will be updated when you consider the item a successful or converted referral. For example, 'Qualified'. This is the status that will trigger a qualification in Referral Factory.

β†’ Then, select the group that the item will be moved to when you consider the referral successful.

β†’ Click Save Qualification Settings.

monday-referral-factory-integration-step-3-option-2-qualify-by-change-in-user-property-and-group

Option 3: Qualify When A User Is Moved To A Specific Group

β†’ Select β€œQualify when a user is moved to a specific group”. 

β†’ Select the group that the item will be moved to when you consider the referral successful.

β†’ Click Save Qualification Settings.

monday-referral-factory-integration-step-3-option-3-qualify-by-change-in-group

Option 4: Qualify When A User Is Moved To A Specific Board

β†’ Select β€œQualify when a user is moved to a specific board”. 

β†’ Select the board that the item will be moved to when you consider the referral successful.

β†’ Click Save Qualification Settings.

monday-referral-factory-integration-step-3-option-4-qualify-by-change-in-board

Step 4: Map Your Data Fields

β†’ Map the data fields from Referral Factory to your Monday columns using the dropdown select options. If a recently created Monday column is unavailable for selection, click the refresh button. 

❗️ For this function to work, you must map the fields {First Name} and {Email}.

Other fields are optional.

monday-referral-factory-integration-step-4-send-person-invited-map-fields-

Step 5 (Optional): Attach Information About The Person Referring

β†’ Should you wish to attach the information of the person who made the referral and you have 2 options for how to send this information to Monday:

πŸ‘‰ Option 1: You can map this information as text in additional columns on the item. Please be sure to add the relevant text columns in Monday. Map the fields to send the information to the columns you have created.

monday-referral-factory-integration-step-5-option-1-attach-information-about-person-referring

πŸ‘‰ Option 2: You can map this information as a connected item. For this function to work, you will need to add a Connect Boards column in Monday. First, select the connected board to which you want to link. Then, select the connect boards column you have created. You also have the option to create a new item for the person referring if one does not exist.  

monday-referral-factory-integration-step-5-option-2-optional-attach-information-about-the-person-referring

Step 6: Choose How To Handle Duplicates

β†’ Choose whether Referral Factory should update existing contacts. Please note that choosing to update existing contacts could override data inside Monday. Your choice will also affect whether existing contacts qualify so please choose carefully. 

monday-step-6-send-person-invited-how-to-handle-duplicates-referral-factory-integration

β†’ Click Save or Next.


 

How To Test Whether Your Integration Is Working

Step 1: Sign Up As the Person Referring

β†’ Open your campaign link in a private window or incognito mode and sign up as the Person Referring. Please note that Referral Factory uses cookies, so if you have already visited your campaign link, you may see the incorrect step. 

β†’ Be sure to use an email address that does not already exist as a user in your referral campaign and, depending on your settings, does not already exist in Monday. We recommend using plus addressing to make sure that each email address is unique and easily searchable. For example, yourname+personreferring+date@yourdomain.com.

testing-integrations-sign-up-as-person-referring-step-1 (1)

Step 2: Sign Up As the Person Invited

β†’ Next, open the referral link generated for the Person Referring and sign up as the Person Invited

how-to-test-your-integration-click-referral-link

β†’ Be sure to use an email address that does not already exist as a user in your referral campaign and, depending on your settings, does not already exist in Monday. We recommend using plus addressing to make sure that each email address is unique and easily searchable. For example, yourname+personinvited+date@yourdomain.com.

how-to-test-your-integration-sign-up-as-person-invited

Step 3: Check For New Users In Referral Factory

β†’ Navigate to the Users tab and check that both the Person Referring and the Person Invited have been created in Referral Factory.

how-to-test-your-integration-users-in-referral-factory (1)

Step 4: Check For The Person Invited in Monday

β†’ Check that the new contact for the Person Invited is created in Monday with all the data you have chosen to map across. Please be sure to check the correct board. Note that it can take up to 30 minutes for the data to pass from Referral Factory to Monday. 

how-to-test-integration-monday-new-lead-alice

Step 5: Test Your Qualification Trigger

β†’ Update the Person Invited inside Monday as per the settings you configured.  

how-to-test-integration-qualify-monday-

β†’ Return to Referral Factory to check the status of the contact you just converted in the Users tab. Note that it can take up to 30 minutes for the data to pass from Monday to Referral Factory. 

how-to-test-your-integration-qualified-user-in-referral-factory

 

πŸ“Œ Having trouble? Read the Monday Troubleshooting Guide.