Referral Factory can automatically create a new contact in Zoho when someone signs up using their friend's referral link. That way, your team can pick up the referred lead without skipping a beat!

→ For the Zoho integration to work correctly, you will need to create a custom field in Zoho to store Referral Factory’s unique user ID for the Person Invited, which we call {Referral Code}. If you plan to send your referred user to Zoho as a Lead, create the custom field in the Leads module. If you plan to send your referred user to Zoho as a Contact, create the custom field in the Contacts module.

→ (Optional) Should you wish to store additional referral data related to your referred user, create the relevant fields inside Zoho. Be sure to create these fields in the relevant module. You could, for example, create fields to house information like:

→ Use Zoho’s lead conversion mapping function to match the fields you just created to store {Referral Code}. This will allow Referral Factory to track the referred lead as they move through your Zoho pipelines and workflows.

→ 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.

→ Select whether Referral Factory should create a new Lead or a new Contact in Zoho.

→ If you would like to automatically qualify the Person Invited when they convert in Zoho, set the rules that will trigger the automatic qualification. If you choose to qualify users using a different method, simply leave this section blank.

→ To automatically qualify the Person Invited when they convert in Zoho, set the rules that will trigger the automatic qualification in Referral Factory.

You have 4 options:

👉 Option 1: When A Lead Converts Into A Contact

👉 Option 2: When A Lead Field Changes

👉 Option 3: When A Lead Converts Into A Deal

👉 Option 4: When A Contact Field Changes

→ Depending on the option you select, you may need to choose a field you want to track, set the initial value of the field or the first status of the Lead/Contact, and the value/status at which you would consider a referred user as successful.

Depending on the qualification option you select, you will need to configure a workflow rule in Zoho.

→ Return to the Zoho Setup Page.

→ Under “Automation,” select "Workflow Rules."

→ Click on "Create Rule" and make sure to select the "Contacts" module.

→ Give your workflow rule a name (e.g., "Lead to Contact").

→ Set the trigger for the workflow: When a “Record Action” is “Created.”

→ In the Conditions step, select “All Contacts.”

→ Under “Instant Actions”, select “Webhook.”

→ Give your webhook a name (e.g., "Lead to Contact").

→ In the URL To Notify field, enter this exact URL https://referral-factory.com/zoho/webhook

→ Scroll down to the Body section, select “Form-Data” under the “Type” dropdown.

→ Add 1 Module Parameter in the Body section:

Parameter Name: code Parameter Type: Contacts Parameter Value: Referral Code

→ Add 1 Custom Parameter:

Parameter Name: conversion Parameter Value: 1

→ Click “Save and Associate.”

→ Save your workflow rule.

→ Return to the Zoho Setup Page.

→ Under “Automation,” select "Workflow Rules."

→ Click on "Create Rule" and make sure to select the "Leads" module.

→ Give your workflow rule a name (e.g., "Lead Status Update").

→ Set the trigger for the workflow: When a “Record Action” is “Edited.”

→ In the next step, select "Specific Field Gets Modified," choose the field you would like to use to trigger the qualification, and select "When Any Value Changes."

→ In the Conditions step, select “All Leads.”

→ Under “Instant Actions”, select “Webhook.”

→ Give your webhook a name (e.g., "Lead Status Update").

→ In the URL To Notify field, enter this exact URL https://referral-factory.com/zoho/webhook

→ In the Body section, select “Form-Data” under the “Type” dropdown.

→ Add 2 Module Parameters:

→ Click “Save and Associate.”

→ Save your workflow rule.

→ Return to the Zoho Setup Page.

→ Under “Automation,” select "Workflow Rules."

→ Click on "Create Rule" and make sure to select the "Deals" module.

→ Give your workflow rule a name (e.g., "Lead to Deal").

→ Set the trigger for the workflow: When a “Record Action” is “Created.”

→ In the Conditions step, select “All Deals.”

→ Under “Instant Actions”, select “Webhook.”

→ Give your webhook a name (e.g., "Lead to Deal").

→ In the URL To Notify field, enter this exact URL https://referral-factory.com/zoho/webhook

→ In the Body section, select “Form-Data” under the “Type” dropdown.

→ Add 2 Module Parameters:

→ Click “Save and Associate.”

→ Save your workflow rule.

→ Return to the Zoho Setup Page.

→ Under “Automation,” select "Workflow Rules."

→ Click on "Create Rule" and make sure to select the "Contacts" module.

→ Give your workflow rule a name (e.g., "Contact Field Update").

→ Set the trigger for the workflow: When a “Record Action” is “Edited.”

→ In the next step, select "Specific Field Gets Modified," choose the field you would like to use to trigger the qualification, and select "When Any Value Changes."

→ In the Conditions step, select “All Contacts.”

→ Under “Instant Actions”, select “Webhook.”

→ Give your webhook a name (e.g., "Contact Field Update").

→ In the URL To Notify field, enter this exact URL https://referral-factory.com/zoho/webhook

→ In the Body section, select “Form-Data” under the “Type” dropdown.

→ Add 2 Module Parameters:

→ Click “Save and Associate.”

→ Save your workflow rule.

→ Return to Referral Factory and map the fields using the dropdown select options. If a recently created Zoho field is unavailable for selection, click the refresh button.

→ You also have the option to define any default fields for when the Lead/ Contact is created inside Zoho.

→ You also have the option to attach information about the person who made the referral. Remember that you may need to create custom fields inside Zoho to house this data.

→ Choose whether Referral Factory should update existing Leads/Contacts. Please note that choosing to update existing contacts could override data inside Zoho. Your choice will also affect whether existing Leads/Contacts will qualify so please select carefully.

Once you have setup your integration, here are some steps you can follow to make sure your integration is working correctly.

→ 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 Zoho. We recommend using plus addressing to make sure that each email address is unique and easily searchable. For example, [email protected].

Once you have your referral link you can either use one of the share icons to share your referral link or click "Copy Link" and open your referral link in a different browser

→ Once you have opened the referral link generated for the Person Referring, enter your details and sign up as the Person Invited.

→ 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 Zoho. We recommend using plus addressing to make sure that each email address is unique and easily searchable. For example, [email protected].

→ Check that the Person Invited is created in the Users tab inside Referral Factory.

→ Check that the Lead/ Contact for the Person Invited is created in Zoho with all the data you have chosen to map across. Note that it can take up to 30 minutes for the data to pass from Referral Factory to Zoho.

→ Update the Lead/Contact of the Person Invited inside Zoho as per the qualification settings you configured.

→ 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 Zoho to Referral Factory.

​