Why aren’t the filters and columns I added in the old Smart Views UI reflected in the new UI after switching?

When transitioning to the new UI, all data, including tabs, filters, and columns, is initially synchronized. However, subsequent customizations made by the user will not be synced. You’ll need to add filters and columns separately in the new UI.

How to Configure the Refresh Interval in Smart Views?

To configure the refresh interval in Smart Views, you must be the Admin of your LeadSquared account.

  1. Navigate to Settings>Profile>Advanced Configuration.
  2. Alongside Configure Smart Views, click Configure. You can configure the refresh interval over here.

LeadSquared - Configure Refresh Interval in Smart Views Tabs

Task Timer in LeadSquared Mobile App

1. Feature Overview

Field Sales Users can track the time spent on each task to record their activities on the mobile app accurately. This eliminates the need for users to add multiple activities for a single lead. With these recordings, managers can get insight into optimizing users’ daily plans. This setting is available for both Appointments and To-Dos.

 

2. Prerequisite

You must install the latest version of the LeadSquared Mobile App in your mobile device.

 

3. Enable Task Timer

To enable task timer for Appointments –

  1. Navigate to My Profile>Settings>Leads>Configure Task Types>Appointments.
  2. Under Other Details, alongside Timer in Mobile App, select Enable.
  3. Click Save and Close.

To enable task timer for To-Dos –

  1. Navigate to My Profile>Settings>Leads>Configure Task Types>To-Dos.
  2. Under Other Details, alongside Timer in Mobile App, select Enable.
  3. Click Save and Close.

LeadSquared - Enable Task Timer for Appointments and To-Dos

 

4. Task Timer on Mobile App

Once you’ve enabled Task Timer, a Start button will be displayed on task cards on the mobile app. Once you tap it, the timer will start recording and a Mark Complete button will be displayed. Both these buttons are disabled for other tasks (across all task views) until the current one is marked complete. If the time taken to complete the task is within the allotted task duration, it will be displayed in green. If the user exceeds the allotted duration, the time taken will be displayed in red. A sticky nav bar at the bottom of the page displays details of the started task for quick access.

The timer runs in the background, and button disablement applies across all task views. The task’s Start status and timer will be retained through app kills, device restarts, and offline periods. Tapping Mark Complete will stop the timer and update the server. If a form is associated with the task, the timer will stop upon form submission. Reopening a completed task will reset the Start button.

Once you’re done with the task, your task duration will be recorded on the Task Details page.

Note:

  • Geofencing is available for both Start and Mark Complete buttons.
  • This setting is also supported on My Trips.
  • Users with iOS devices will be able to view a live tracker for their current task on the notifications bar. By tapping on this notification, users will be redirected to the Task Details page.
  • Users’ task duration will not be available on the web app. To receive this data on the web app via curated reports, please write to support@leadsquared.com.

LeadSquared - View Lead Details on Plans

Any Questions?

We’d love to answer your questions or hear your unique use cases. Feel free to share your experiences in the comments section below.

Triggers in Account Automation

A trigger is the starting point of your automation. You can start an automation when –

  • A New Account is Added
  • An Account is Updated
  • A New Activity is Posted on an Account
  • An Activity is Updated on an Account

If you’re new to account automation, see How to Create an Account Automation.

account triggers

 

New Account

This option triggers your automation when a new account is created. Here are some examples of use cases you can automate –

  • Update an account field when a new account is added.
  • Notify an account owner when a new account is added.

Once you select the New Account trigger, choose an Account Type and set Additional Conditions.

new account trigger

Note: You can also set exit conditions to remove an account from the automation.

For example, if you want accounts from a certain account field (say, City) to enter your automation, you could set it up using the additional conditions.

account criteria

 

Account Update

This option triggers your automation when an account is updated (account field is changed). Here are some examples of use cases you can automate –

  • Notify an account owner to take action when the account stage changes from prospect to opportunity
  • Notify users when stakeholder meetings, renewals or other important activities are posted on accounts.

Similarly, when you select the Account Update trigger, you’ll have to select an Account Type and add Additional Conditions.

account update trigger

Note: The Run only once per account checkbox lets you run the automation for the account only once (for example, the account will enter the automation when the stage changes the first time. Subsequent stage changes will not trigger the automation again).

 

New Activity on Account

Use this feature to trigger an automation when a new activity is posted on an account. Here are some examples of how you can use this trigger –

  • Change the account stage to say, ‘Opportunity’ when a ‘Proposal Sent’ activity is posted.
  • Notify the account owner when a new ‘Stakeholder Meeting’ activity is posted.

Navigate to the Activity Trigger tab, then click New Activity on Account.

new account activity trigger

Choose the Account Type and Activity Type from the respective drop-downs. Click the +Add another activity link to add more activities. If you choose multiple activities, the automation will trigger when any one of the activities are posted.

account activity new

 

Activity Update on Account

This option lets you trigger an automation when an account activity is updated. For example, you can trigger an automation when –

  • The date of a ‘Stakeholder Meeting’ activity is changed. In this case, you can set your automation up to notify the account owner of the new date.
  • Notify the account owner when the status of a ‘Renewal Activity’ has changed from say, ‘Contract Submitted’ to ‘Payment Completed’.

activity update trigger

Choose the Account Type, Activity Type, Activity Field (the automation will trigger based on an update in this field).

update account trigger

 

Next Steps

Now that you’ve learned how to set up an account based automation trigger, explore the documentation for

 

Any Questions?

Was this article helpful? Let us know your doubts in the comments section below.

Large Exportable Reports

1. Feature Overview

The Large Exportable Reports (LER) feature can be used to export large data sets from LeadSquared, for example, large volumes of lead, activity, and opportunity data.

LER overview

 

2. Prerequisites

  • To enable Large Exportable Reports, reach out to your account manager, or contact support@leadsquared.com.
  • You must have access to the reports you’re exporting.
  • By default, each account can export 5 reports a day. To increase the default limit, get in touch with your account manager, or contact support@leadsquared.com.

 

3. Large Exportable Reports

Navigate to Reports>Reports Home, and under Tags, select Large Exportable Reports.

LER nav

At present, only the following Large Exportable Reports are available –

Report Description
Activity Count by Leads To get the activity distribution of leads across the selected activities for the selected time range.
Activity list by Leads Download a list of activities by leads
Activity list by Leads (All Fields) An exportable, downloadable version of the activity list by leads, including all custom fields.
Activity List by Opportunity
Report to download activity details on opportunities along with lead and opportunity fields
All Activities by Opportunity
Report to download activity details of multiple activity types on opportunities, including lead and opportunity fields.
All Leads
Download a large number of leads with specific fields in a given date range.
All leads with filters
An exportable version of all leads reports with the source filter.
Check-in and Check-out History
Download all user check-in and check-outs.
Day Attendance Report This report allows administrators and managers to download attendance reports for a day.
Large Exportable Report Request History
See the list of all export requests made in your account in this report.
Lead Stage Change Analysis This report helps you export a large data set of lead-owner-wise lead stage change analysis from a given stage to any other stage in a selected period.
Lead Stage Change History
This Report lets you download the lead stage history.
Leads Not Contacted
This report helps you export a large data set of leads generated in a time-period that haven’t been contacted by your sales team.
Leads with No Opportunities To analyze Leads with no opportunities.
Leads with pending Tasks Exportable/downloadable version of leads with pending tasks.
Opportunities with No Tasks
Analyse opportunities with no tasks.
Opportunity Master Data
This report lets you download a large number of Opportunities with specific fields in a given date range.

Next, follow the steps below to export a report –

  1. Select a Large Exportable Report.
  2. Apply filters, select fields, and the date range for the data.
  3. Click View Sample Output to get a snapshot of the data (this is a sample and will not include all the data).
  4.  In the Report Recipient field, enter the email address to which the report will sent.
  5. Click Run and Email.
  6. Next, click Submit Report.

Note: To ensure your exported report contains accurate data

  1. Apply filters before exporting.
  2. Click View Sample Output to preview the data. Skipping this may result in incorrect data.
  3. Click Run and Email to generate and download the report.
LER export

You will receive the link to download the report on the email address you’ve specified on Report Recipient.

Download report

If you select Large Exportable Report Request History report, you can find all the reports that have been exported. You can download individual reports from here as well.

LER export history

 

4. FAQs

1. Why Are Fewer Leads Showing Up in My Export File Compared to the Report UI?

  • Issue: If the number of leads in your export file is less than what appears in the report UI, it’s likely due to the export limit.
  • Explanation: There is a limit of 10,000 records that can be exported in one go from any report. If the report is not marked as “Large Exportable,” the maximum number of leads you can export is 10,000. This limit cannot be increased.
  • Alternatives:
    • Use Large Exportable Reports – As described in this article, these allow exporting more data at once.
    • Export in Batches – Split your report and export in batches where the number of leads does not exceed 10,000 per batch.

2. What is the Default Limit for Exports in LeadSquared?

The default limit for large exports is 5 per account. This limit applies to the entire customer account, not to individual users.

3. Why do Large Exportable Reports take time to complete?
Large Exportable Reports are processed sequentially in a queue shared across all customers. Completion time varies depending on report size, queue volume, and the request time.

4. How can I get Large Exportable Report data faster?

  • Download off-hours: Try downloading reports during non-business hours for faster processing.
  • Batch Job Approach: For regular reports needed during business hours, consider setting up a Batch Job. This fetches report data independently (without the shared queue) and transforms it into an Excel file, which can be scheduled and sent directly to a designated point of contact.

 

Any Questions?

Did you find this article helpful? Please let us know any feedback you may have in the comments section below. We’d love to hear from you and help you out!

Facebook/Instagram Lead Ads Connector (v2)

1. Feature Overview

The LeadSquared Facebook/Instagram Lead Ads connector sets up a seamless transfer of your lead data from Facebook Ads and Instagram Ads accounts to your LeadSquared account. It allows you to track all your leads from Facebook in real-time, by syncing your Facebook LeadGen form with LeadSquared. This removes the need to constantly download a CSV file from Facebook, and upload it to LeadSquared.

To know more about the connector, please click here.

Note:

  • You must have an active Facebook ads page with a LeadGen form on it. To know more, please refer to Facebook Instant Forms.
  • By default, you can sync (add) up to 50 forms from your Facebook Ads account with your LeadSquared account. If you want to increase the limit to more than 50 forms, contact your account manager, or write to support@leadsquared.com.
  • To enable lead data transfer between Instagram Ads and LeadSquared, you must link your Instagram Ads account to your Facebook Ads account. To know more, please refer to Add or remove an Instagram account from your Facebook Page and Add an Instagram Account to Your Business Manager.
    • Once your accounts are linked, you must select the Instagram account every time you create a new Facebook ad. This ensures that your ad is displayed across Facebook and Instagram, and lead capture takes place in both places.

LeadSquared Facebook Instagram Integration

 

2. Prerequisites

 

3. How it Works

To push leads from LeadSquared to your Facebook/Instagram Ads account, using the Facebook/Instagram Lead Ads connector, complete the following steps –

  1. Install the Facebook/Instagram Lead Ads Connector
  2. Connect your Facebook and Instagram Ad accounts to LeadSquared
  3. Connect your Ad Pages to LeadSquared
  4. Map the default Facebook LeadGen form fields to the corresponding LeadSquared lead fields
  5. Connect your Facebook LeadGen form to LeadSquared
    1. Link the custom form fields to the corresponding LeadSquared lead fields
    2. If required, link the marketing fields to LeadSquared lead fields
    3. If required, link the form tracking parameter to a LeadSquared lead field
    4. Create a test lead on Facebook, and ensure the lead data is pushed to LeadSquared
    5. Activate the LeadGen form to transfer lead data from Facebook to LeadSquared

 

4. Install the Connector

To install the Facebook/Instagram Lead Ads connector on your account –

  1. From the main menu, navigate to Apps>Apps Marketplace.
  2. Search for Facebook/Instagram Lead Ads, and click Install.
    • Alternatively, you can find the connector on the left panel, under Online Ads.
  3. Once the connector is installed, hover your cursor over the settings icon, and click Configure.
  4. On the Configure Facebook/Instagram Lead Ads pop-up, from the Select Role dropdown, choose the user roles for which you want to give connector configuration and actions permission.
    • If you choose to not give permissions to other user roles, then skip this step, and directly click Save.
  5. Once you’re done, click Save. The connector is successfully installed.

LeadSquared Facebook Instagram Integration

 

5. Connect Ad Accounts

Once the connector is installed, connect your Facebook Ads account(s) to LeadSquared.

  1. Navigate to Apps>Facebook/Instagram Lead Ads.
  2. On the Manage Accounts & Pages tab, click Connect Accounts, and then click Login with Facebook.
  3. On the pop-up, log in to your Facebook Business account.
  4. On the pop-up, select all the Facebook ad pages linked to your Facebook Business account, and click Next.
  5. Ensure all the permissions are granted, and then click Done.
  6. Then, on the You’ve now linked LSQ Lead Ads Connector to Facebook pop-up, click OK.
  7. On the Connect Account pop-up, you can see that the Facebook Business Account is now successfully linked to LeadSquared.

Note: You can connect multiple Facebook Business Accounts using the steps given above, by clicking the Connect Accounts button.

LeadSquared's Facebook Lead Ads Connector

 

6. Connect Pages

Once you’ve connected the Facebook Business account(s), from the list of Ad Pages, choose the Pages you want to sync with LeadSquared.

  1. On the Connect Account pop-up, click Next.
  2. On the Select Page(s) to be added pop-up, against the Ad Page you want to link, check the Checkbox checkbox.
  3. Then, click Connect.
  4. To view the page(s) that you have added, click Pages. Here, you can view all the Ad Pages you have connected to LeadSquared.
  5. Once you have connected the Ad Pages to LeadSquared, click Next.

LeadSquared's Facebook Lead Ads Connector

To connect pages across multiple Facebook Business accounts –

  1. On the Pages screen, click the Connect Pages button.
  2. From the Select Account pop-up, select the Facebook Business Account from which you want to connect Ad Pages.
  3. The other steps remain the same as listed above.

LeadSquared's Facebook Lead Ads Connector

 

7. Default Field Mapping

After you’ve connected an Ad Page, you must then map the Facebook LeadGen form fields present on that page, to the corresponding LeadSquared lead fields.

Note: To avoid errors, ensure each Facebook form field is uniquely mapped to a corresponding LeadSquared field.

7.1 Marketing Fields

Every Facebook form has custom marketing data (like Form Id, Ad Id, Campaign Id etc.), and this data is present within Marketing Fields. All the marketing details are captured as an activity in LeadSquared, but if you want to store this data on the Lead Details page, then you can map the Facebook form fields to any LeadSquared lead field or custom field. This data can be used to compare two or more forms, see how efficient each form is, and so on.

LeadSquared's Facebook Lead Ads Connector

Note: By default, Campaign Name is mapped to the Source Campaign lead field. To map the other fields, please refer to the steps below.

By default, when a Facebook LeadGen form submission takes place (and when a new lead is created or updated in LeadSquared), the marketing fields are captured as an activity and posted on the Lead Details page. The activity is called Facebook Lead Ads Submissions, and it contains the details of all the marketing fields (such as Form ID, Ad Set ID, Campaign ID, etc.).

LeadSquared's Facebook Lead Ads Connector

7.2 Default Field Types

Facebook has a set of default lead capture fields, which are common across all their forms. You must map these lead capture fields to the corresponding LeadSquared lead fields. This mapping will reflect across all the Facebook LeadGen forms you connect with LeadSquared.

Note: Only default Facebook fields show up here. If you have created custom fields, it will show up in the next step, under Activate Form.

To map the fields –

  1. Map each Field Type (Facebook LeadGen Form field) to the relevant LeadSquared lead field, by selecting the field from the Lead Field dropdown options.
    • If you choose to not map a particular field, then choose None from the dropdown options.
  2. Some of the Field Type fields are automatically mapped to a LeadSquared lead field. If the mapping is accurate, then you can let it be as such.
  3. The data type for the LeadSquared Lead Field that you’ve selected is listed under Lead Field Data Type. This will ensure that you’re mapping the Facebook form field to the correct data type.
  4. Once you’ve mapped all the fields, click Save and Next.

LeadSquared's Facebook Lead Ads Connector

 

8. Connect LeadGen Form

To send lead data from Facebook to LeadSquared, you must link an active Facebook LeadGen form to LeadSquared. The field mapping you completed in the previous step will reflect here by default.

Note: An active form is a form that’s less than 90 days old. If the form is older than that, please create a duplicate form, and link that to LeadSquared.
  1. On the LeadGen Forms tab, click Connect LeadGen Form(s).
  2. On the Sync Active Forms pop-up, select the Account and Page that contains the form you’re looking to link.
  3. Against Created On, filter by the date range during which the form was created.
  4. Then, enter the form name in the Search Forms search box.
  5. Against the form you’re looking to connect, check the Checkbox checkbox, and click Connect Forms.
  6. Your form is now synced to LeadSquared.

LeadSquared's Facebook Lead Ads Connector

8.1 Activate Form – Questions

You must map custom LeadGen form fields (if they are present in the form) to the corresponding LeadSquared lead fields. To learn how to create custom lead fields in LeadSquared, see How to Create Custom Lead Fields.

  1. On the LeadGen Forms screen, click the Activate button.
    • Alternatively, if there are unmapped fields that need to be mapped, then click the hyperlink under Mapping.
  2. On the Activate Form pop-up, on the Questions tab, if there are unmapped custom fields, map it to the corresponding LeadSquared lead field from the Lead Field(s) dropdown.
    • To disable a Facebook form field, and not capture that data in the lead creation process, you can leave the lead fields blank, or you can disable the Zoom slider.
  3. Once you’re done, click Save Changes & Next.

LeadSquared's Facebook Lead Ads Connector

8.2 Activate Form – Marketing Fields

On this screen, you can choose to store the marketing data (Form Id, Campaign Id, etc.) present in the form’s Marketing Fields in your LeadSquared lead fields.

  1. Against the Form Field(s), from the Lead Fields dropdown, choose the lead field in which you want to store the marketing data.
    • If you do not wish to store the data in your lead fields, you can leave the lead fields blank, or you can disable the Zoom slider.
  2. Once you’re done, click Save Changes & Next.

LeadSquared's Facebook Lead Ads Connector

8.3 Activate Form – Tracking Parameters

If you’ve added tracking parameters to your Facebook form, those parameters will show up on this screen. You can choose to store the default tracking parameter value in a lead field. This will help you identify which leads have been created through the tracking parameter (source) that you have listed.

  1. Against the Default Value, from the Lead Fields dropdown, choose the lead field in which you want to store the tracking parameter data.
    • If you do not wish to store the data in your lead fields, you can leave the lead fields blank, or you can disable the Zoom slider.
  2. Once you’re done, click Save Changes & Next.

LeadSquared's Facebook Lead Ads Connector

Note: To know how to set-up tracking parameters on your Facebook form, please refer to Set up tracking parameters for your lead ads.

8.4 Test Lead

To create a test lead through Facebook, navigate to Lead Ads Testing Tool. To know more, please refer to Facebook Lead Ads Testing Tool.

Once you’ve created a test lead, to know if the test lead data is successfully pushed to LeadSquared –

  1. On the Facebook Lead Ads Connector page, navigate to the Logs & Reports tab.
  2. Select the Account, Page and Form in which you created the test lead.
  3. Change the date range to Today. In a couple of minutes, you’ll then be able to view the test lead that was created.
  4. If the test lead you created has been successfully pushed to LeadSquared, you can view the details here.
  5. Then, go back to the Activate Form pop-up, and on the Test Lead tab, click Save Changes & Next.

LeadSquared's Facebook Lead Ads Connector

Note: Once the test lead is visible on the Logs & Reports tab, click the Lead ID link, or navigate to the Manage Leads page to confirm that the test lead and all the lead data has been successfully captured by LeadSquared.

LeadSquared's Facebook Lead Ads Connector

8.5 Activate Form Sync

Once you have created a test lead, and confirmed that the test lead is being pushed to LeadSquared, you must activate the form. To do this, click Activate Form. Once the form is activated, the Sync Status will change to Active.

Your form can now actively capture leads from Facebook, and send lead data to LeadSquared.

LeadSquared's Facebook Lead Ads Connector

8.6 Additional Actions

You can perform the following additional actions on the LeadGen tab.

  • To deactivate a LeadGen form but retain the form configuration, under Actions, click Deactivate.
  • To delete a LeadGen form, under Actions, click the icon.
  • To configure additional settings, under Actions, click LeadSquared's Facebook Lead Ads Connector. On the Additional Configuration pop-up, you can configure the following settings –
    • Lead Source – Select the source you want to enter in the Lead Source lead field for all the leads generated through this form.
    • Add lead to list – If you want to add all the leads generated through this form to a lead list, then select the lead list from the dropdown. To know more, see How to Create a Lead List.
    • Search By – If required, set a primary search key (e.g., Email Address, Mobile Number, etc.) for all the leads generated through this form.
    • Secondary Search By – If required, set a secondary search key for all the leads generated through this form. This is a fall-back option, for a situation where the primary search key value is not provided by the lead.

LeadSquared's Facebook Lead Ads Connector

 

9. Notification Settings

There are various errors (e.g., “Failed to create activity”, “Invalid Phone Format”, etc.) you might encounter when using this connector, which may temporarily break the lead capture process. To fix these errors, please refer to the Errors section under Troubleshooting – Other Issues.

If required, these errors can be consolidated and emailed to you as a daily report. These reports will provide a view of all the errors captured across the Facebook forms linked to your pages. You can add up to 10 LeadSquared users to receive the error reports.

LeadSquared Facebook Integration

To receive these reports –

  1. Navigate to the Notification Settings tab, and enable the Slider slider.
  2. From the Select Recipients dropdown, add the list of LeadSquared users who can receive the reports.
    • These reports will be sent to the email Ids configured in your LeadSquared accounts.
  3. Then, select the time you want to receive these reports. The errors captured over the past 24-hours (00:00-23:59 GMT) will be sent at the time you have selected.
  4. Once you’re done, please click Save & Next.
Note: Once configured, you will begin receiving email reports from the next day, at the selected time.

LeadSquared Facebook Integration

 

10. Logs & Reports

10.1 View Logs

Here, you can view the lead request logs received by LeadSquared for new leads, updated leads,  lead capture error, and unprocessed leads, for each LeadGen form. Select the Account, Page and Form for which you want to view the logs. On these screens, you can filter logs by date range, Lead Detail Response and Lead Capture Logs. You can also search for a lead using the LeadGen ID.

  • New Leads – All the new leads that have been pushed to LeadSquared.
  • Leads Updated – Existing leads’ whose lead details have been updated through this Facebook form.
  • Errors – Leads that haven’t been pushed to LeadSquared, because of an error during lead capture. The reason for this error is listed under Status Reason. Once the error is rectified, to capture the lead details, under Actions, click the Refresh icon.
  • Unprocessed – Certain leads remain unprocessed due to the Facebook Business account being inactive, or due to permissions-related issues. Once you’ve rectified these errors, click Process Leads Now. This will process all the leads in bulk. You can perform this action only once every 24-hours.

LeadSquared's Facebook Lead Ads Connector

10.2 Sync Missing Leads

In instances when lead data is not pushed from Facebook to LeadSquared (for e.g., when updated Facebook T&C has not been accepted, when the annual Data Use Checkup developer policies are not accepted, when Facebook servers are down, when the API is broken, etc.), you can manually fetch the data once all the issues are rectified and all the policies are accepted. This will capture and sync the lead data to specific lead fields within LeadSquared. To do this –

  1. Navigate to the Logs & Reports section.
  2. Select the Account, Page and Form within which leads have not been synced.
  3. Click the Sync Manually button.
  4. On the Sync Missing Lead(s) pop-up, enter the date range for which leads have not been synced. The date range must not exceed the last seven days.
  5. Once you’ve selected the date range, click Sync. Missed lead data from Facebook will be synced to the relevant lead fields in LeadSquared.

Note:

  • Manual sync cannot be performed at the account level. It can only be performed on the form level, so please select a form in order to carry out a manual sync.
  • If you want to sync missed leads for a date range that exceeds the last seven days, please reach out to your account manager, or write to support@leadsquared.com.

LeadSquared's Facebook Lead Ads Connector

 

11. Troubleshooting

Facebook Lead Sync Fails Due to Terms and Conditions

  • Issue: Leads are not syncing from Facebook because of terms and conditions not being accepted.
  • Root Cause: The same Facebook Ad Account is authenticated by multiple users, but only one accepted Facebook’s Terms and Conditions.
  • What You Need to Know:
    • Only the user who accepted the Facebook Lead Ads Terms and Conditions can push leads.
    • If another user re-authenticates the same Ad Account without accepting the terms, lead sync will fail.
    • All users linked to the Ad Account must accept the terms to avoid sync issues.
    • Avoid re-authenticating the same Ad Account with multiple users unnecessarily.
    • Once authenticated, other LSQ users can sync audiences under the account without needing to re-authenticate.

Tip: Always verify that the authenticating user has accepted the terms at Facebook’s Terms Page.

2. Full Control Permissions

When connecting your Facebook Business Account, you must ensure all permissions are granted, or you may get one of the following errors –

  • On the Manage Accounts & Pages tab, the Subscription Status will show as Failed. This means that leads won’t be pushed to LeadSquared.
  • If a user tries to send a test lead using the Facebook Ad Page link, the ad page won’t be available.

To rectify these errors, and to grant the Manage Page Permission –

1.1 Verify if Users have Manage Page Permission

  1. On your Facebook Business Account page, from the left-panel, click Settings, and then click Business settings.
  2. On the Business settings screen, under Accounts, click Pages.
  3. Under Pages, select the page that you have added to LeadSquared.
  4. Then, click on the user profile for which you want to check if permissions are granted, and scroll down to Full control.
  5. Against Everything, ensure the LeadSquared's Facebook Lead Ads Connector slider is enabled.

LeadSquared Facebook

1.2 Grant Manage Page Permissions to Users

If the Full Control permissions are not enabled for a user –

  1. On your Facebook Business Account page, from the left-panel, click Settings, and then click Business settings.
  2. On the Business settings screen, under Users, click People.
  3. Under People, in the search box, click Add, and on the Invite People pop-up, enter the email address of the users you want to grant the permissions to.
  4. Then, on the Assign Access pop-up, select the page for which you want to grant the Manage Page permission, and click Invite.
  5. Once the user accepts the invitation they have received, they’ll have access to the page.

LeadSquared Facebook

2. Lead Access Permission

If the Lead Access setting is not enabled, your lead transfer will not get processed in LeadSquared. Under Logs & Reports, you will get a “100 Bad Request error”, and the leads will reflect as Unprocessed. To rectify this error, you must grant Lead Access permission.

  1. On your Facebook Business Account page, from the left-panel, click Settings, and then click Business settings.
  2. On the Business settings screen, under Integrations, click Lead Access.
  3. Select the page you have added to LeadSquared.
  4. On the page tab, under People, click the Assign People button.
  5. On the Add People and set permissions pop-up, select the users to whom you want to grant Lead Access permission.
  6. Once you’ve selected the users, click Assign. Your users can now access your leads’ information.

LeadSquared's Facebook Lead Ads Connector

3. Assigned CRM Set-Up

If the Assign CRM setting is not enabled, you will not receive lead data, or existing lead updates, in real-time. To enable this setting –

  1. On your Facebook Business Account page, from the left-panel, click Settings, and then click Business settings.
  2. On the Business settings screen, under Integrations, click Lead Access.
  3. Select the page you have added to LeadSquared.
  4. On the page tab, under CRMs, click the Assign CRM button.
    • Ensure that the LSQ Lead Ads Connector app is listed under Apps. If it’s not listed, then please authenticate the connector again on LeadSquared.
  5. On the Add CRMs and set permissions pop-up, you will see a list of all the CRMs that are connected to your Facebook Page, along with LSQ Lead Ads Connector.
  6. Against LSQ Lead Ads Connector, click the checkbox, and then click Assign.

LeadSquared's Facebook Lead Ads Connector

4. App Permissions

When connecting your Facebook Business Account to LeadSquared, if any of the following permissions were not enabled (in step 5. Connect Ad Accounts), then lead data transfer will not take place successfully –

  • Show a list of the Pages you manage
  • Access leads for your Pages
  • Read content posted on the Page
  • Manage accounts, settings and webhooks for a Page
  • Create and manage ads for your Page

To enable seamless lead transfer, you must re-authenticate the account in Facebook Lead Ads Connector by providing all the permissions. To do this –

  1. Log in to your Facebook account, and navigate to Settings & Privacy>Settings.
  2. From the left-panel, click Business Integration.
  3. Then, select the LSQ Lead Ads Connector, and click View and Edit to enable the permissions.
  4. Once you’re done, click Save.

LeadSquared's Facebook Lead Ads Connector

5. Other Issues

Apart from the ones listed above, you might encounter other issues when working on this connector. These issues will be listed on the Logs & Reports tab, under the Errors section or the Unprocessed section.

LeadSquared Facebook connector

Under the Errors section, the following issues are listed –

Errors Resolutions
Either form is inactive or not saved
  1. Please navigate to Facebook/Instagram Lead Ads>LeadGen Forms.
  2. Select your Account and Page from the respective dropdowns.
  3. Then, for the form that’s saved as a Draft, click the Activate button.
  4. Once the form is in the Active state, navigate to Logs & Reports>Errors, and click the Refresh Refresh button. The form will now start capturing leads.
Failed to create activity The activity will be created only when the Facebook Lead Ads Submission activity type is Active. To ensure this –

  1. Please navigate to My Profile>Settings>Leads>Custom Activities & Scores.
  2. From the Show dropdown, filter by Inactive.
  3. Against the Facebook Lead Ads Submissions activity, click the LeadSquared Facebook connector icon. The activity is now Active.
  4. Once this is rectified, navigate to Logs & Reports>Errors, and click the Refresh button.
Attribute “CreatedOn” is ReadOnly. Cannot update the attribute. A read-only LeadSquared field cannot be updated with any other value. Please select a different field on the Default Mapping tab, as well as on the LeadGen Forms mapping tab.
Once this is rectified, navigate to Logs & Reports>Errors, and click the Refresh button.
Invalid Phone Format Invalid phone format received, no action required from your end.
Invalid Data Invalid data sent from Facebook. Please check the Logs & Reports tab for more details.
Phone number should be of at least 7 digits Invalid phone format received, no action required from your end.
Attribute “ProspectActivityDate_Min” cannot be updated Default and LeadGen Form mapping is not allowed with system fields. Please select a custom field, and map it to either form.
Once this is rectified, navigate to Logs & Reports>Errors, and click the Refresh button.
Invalid Owner Id Default and LeadGen Form mapping is not allowed with system fields. Please select a custom field, and map it to the form.
Once this is rectified, navigate to Logs & Reports>Errors, and click the Refresh button.
A Lead with the same email Id/phone number already exists Duplicate lead received, no action required.
Either of FirstName, LastName, EmailAddress, Phone, Mobile, TwitterId, FacebookId, LinkedInId, SkypeId, GTalkId, GooglePlusId is required. Cannot create Lead A primary lead identifier is missing. Please ensure that at least one lead identifier is mapped to the Default and/or the LeadGen Form.
Once this is rectified, navigate to Logs & Reports>Errors, and click the Refresh button.
There was an error processing the request. Please contact administrator. Please navigate to Logs & Reports>Errors, and retry the lead capture process.
503 Service Unavailable Please navigate to Logs & Reports>Errors, and retry the lead capture process.

Under the Unprocessed section, the following issues are listed –

Unprocessed Reasons Resolution
Error validating access token: The session has been invalidated because the user changed their password or Facebook has changed the session for security reasons. Facebook Authentication has either expired or is missing. Please authenticate the Facebook Ad account that’s linked to your LeadSquared account, and ensure that the required permissions (Manage Leads, CRM Access, Lead Access, etc.), are intact. To know how to rectify this, please refer to the Troubleshooting steps listed above.
Once this is rectified, navigate to Logs & Reports>Unprocessed, and click the Refresh button.
Unsupported get request. Object with ID ‘771XXXXXXX0’ does not exist, cannot be loaded due to missing permissions, or does not support this operation. Facebook Authentication has either expired or is missing. Please authenticate the Facebook Ad account that’s linked to your LeadSquared account, and ensure that the required permissions (Manage Leads, CRM Access, Lead Access, etc.), are intact. To know how to rectify this, please refer to the Troubleshooting steps listed above.
Once this is rectified, navigate to Logs & Reports>Unprocessed, and click the Refresh button.
The user must be an administrator, editor, or moderator of the page in order to impersonate it. If the page business requires Two Factor Authentication, the user also needs to enable Two Factor Authentication. Please ensure that the user connected to this page has admin access. You can grant admin access from your Facebook account, by navigating to Page Settings.
Once this is rectified, navigate to Logs & Reports>Unprocessed, and click the Refresh button.

 

12. FAQs

1. If you’ve changed your Facebook account’s password, what should you do on this connector?
Users who’ve changed their passwords must reconnect their Facebook account, along with all the pages to this connector. Until this is done, the connector will stop working as intended.

2. If you’re unable to see all the lead details on this connector, what can you do to fix it?
One of the reasons could be that you don’t have Admin access to the Facebook account, or the page you’ve connected to the connector. To know more, refer to Information included when you download your leads and Ad account permissions by role.

3. Why aren’t my users’ pages getting listed in the connector?
After a user’s page is migrated to the New Pages experience in Meta, to ensure their pages are listed in the connector, the user must be listed under Manage>Professional Dashboard>Your Tools>Page access>People with Facebook access. This can be verified at https://www.facebook.com/

LeadSquared Facebook

When the user’s name is not available under People with Facebook access, the Page will not be listed in the connector. Suppose a user (e.g., John) isn’t listed under People with Facebook access, any other user (e.g., Paul) that’s listed on this page must log in to their (Paul’s) Facebook account (https://www.facebook.com/), and navigate to Page Access, and over here, they should add and grant full access to the user (John).

LeadSquared Facebook

Then, the user (John) will get an invite notification, to access the page, on their Facebook account. They must click on the notification, and then click Review Invitation. Once they Accept the invite, they’ll have access to the page.

Facebook LeadSquared Integration

Once they accept it, they’ll (John) need to navigate to New Page experience>Page access>People with Facebook access, and verify if they have access to the page. Once they have access, the issue is resolved. In case none of the users in your organization are listed under the People with Facebook access, as an Admin, you can give full page access to any of the users in your organization. Then, follow the steps listed above to give them access to the page. To know more, refer to About the new Pages experience on Facebook.

4. Status: 190 Bad Request

  • Issue: Leads from Facebook Lead Ads are not being pushed to LeadSquared, and users are seeing a “190 Bad Request” error, with the following error message “You cannot access the app till you log in to www.facebook.com and follow instructions given.”
  • Cause: This issue occurs due to security checkpoints at Meta’s (Facebook’s) end, which may result in the user’s account being temporarily locked. This can prevent successful lead push from Facebook Lead Ads to LeadSquared.
  • Solution: To resolve this issue, the user must reach out to Meta’s support team to get their account unblocked. Once the account is unblocked, the leads should start flowing into LeadSquared again, resolving the Bad Request error and allowing for successful processing of unprocessed leads.

LeadSquared Meta (Facebook) Integration

 

Any Questions?

Did you find this article helpful? Please let us know any feedback you may have in the comments section below. We’d love to hear from you and help you out!

Create an Incentive Program

1. Feature Overview

Use LeadSquared’s Incentives feature to set up program criteria and rewards to incentivize your sales teams. Once set up, LeadSquared will track and automatically calculate payouts based on each sales rep’s achievements toward their targets. Once the rewards have been calculated, managers can review and approve or reject the rewards through the Incentives dashboard.

 

2. Prerequisites

  • Only Admins can create an incentive program.
  • To create an incentive program through Rulesets, you must have a published Ruleset.
  • To create an incentive program through Goals, you must have a published Goal.
  • Ensure that the Organization Hierarchy for your organization is set up.

 

3. How it Works

As an example, consider a team of 6 people. Kevin is the Admin and Splinter is the Sales Manager. The Sales Users are Donatello, Leonardo, Michelangelo, and Raphael.

incentives hirar

Kevin can set up an Incentive program for the Sales Users based on certain Program Criteria (for example, revenue generated, leads generated, etc.). If they satisfy the criteria, their rewards will be calculated and sent to Splinter and Kevin for approval.

incentive end calc show

There are 2 ways to create an incentive program –

  1. Through Rulesets
  2. Through Published Goals

Rulesets are the fundamental building blocks from which you can build Goals and Incentive programs. If you’re already using LeadSquared’s Goals feature, you can build incentive programs directly on published goals (where you just need to define the rewards and payouts for the sales reps).

You can also build an incentive program from scratch, by first creating a new ruleset (where you define and measure the required sales performance metrics) and then creating the incentive program (where you define the rewards and payouts).

To create an incentive program –

  1. On the Incentives page, click on Create a Program and enter the program details.
  2. Select the Rulesets, Calculation type, and Program duration.
  3. Next, select the users you would like to incentivize. If you have chosen to build the program on top of a Goal, the users from the Goal will be automatically inherited into the incentives program.
  4. Select the approvers for the incentive program.
  5. Set up the Program Criteria and Rewards for the users.
  6. Publish the program.

 

4. Create an Incentive Program Through Rulesets

Navigate to Ace>Incentives>Manage Program>Create Program.

Ace Incentives nav

Enter a Program Name and Program Description. Once done, click Create.

Incentives name description

You can upload a document that further details the incentive program by clicking Choose File – it can be a policy document, sales deck, presentation, etc. This step is optional. To proceed without an attachment, click Proceed Without Attachment.

Incentives additional info without attachments

 

5. Configure the Program Attributes

Here, you’ll select a Ruleset that will later be used to define the rewards. For example, if you select a ‘Revenue’ rule set here, the rewards will be calculated on the revenue metric defined in your ruleset.

Click Select Rulesets. You can select up to 5 Rulesets. Once done, click Use Selected Rulesets.

Note: Rulesets are used to define and measure a variety of sales performance metrics. To learn more, see How to Create a Ruleset.

Incentives select rulesets

Next, you must select a Calculation Type.

incentives rollup vs non rollup

  • Roll Up – In a Roll Up calculation, the result will be the summation of the achievements of the entire team in the hierarchy.
    • For Example, the reward is paid out to the users based on the total revenue generated by the entire team.
  • Non Roll Up – In a Non Roll Up calculation, the result will depend only on the individual achievements of the users.
    • For example, the reward is paid out to the users based on the revenue generated individually.

incentives non roll up

Set the Program Duration.

  1. Select the Program Cycle – The total reward will be calculated based on the completion of each cycle. For example, if you want to reward users based on their daily achievements, select Daily.
  2. Select the First Cycle Date Range – Select the start date for the program.
  3. Select the Last Cycle Date Range – Select the end date for the program.

Note:

  • If you select Weekly as your Goal Cycle duration –
    • By default the starting day of the week is Monday. This cannot be changed to a different day.
    • You can set the Cycle Start Date to Monday for the present week, even if your current day is Wednesday.
  • If you select Monthly as your Goal Cycle duration, you can set the Cycle Start Date to any day in the current month only. For example, if the current date is 10th February, you can set the Cycle Start Date to 1st February (but not 25th January).
  • The maximum Goal Cycle duration for –
    • Daily is 700 Goal Cycles.
    • Weekly is 104 Goal Cycles.
    • Biweekly is 52 Goal Cycles.
    • Monthly is 24 Goal Cycles.
    • Quarterly is 10 Goal Cycles.
    • Yearly is 16 Goal Cycles.
    • Custom is 700 Days (to configure a Custom Cycle for the Incentive Program, refer to this article).

In the following example, the Incentive Program will have a Daily Program Cycle. The First Cycle of the program will start and end on the 1st of February. On completion of the first cycle, the rewards (if any) can be disbursed. The program will repeat until its Last Cycle, which is on the 11th of May.

incentives program duration

Select the number of Buffer Days for each Cycle. Buffer Days lets users edit or revise their tasks and activities in the event of a missed deadline, resulting in more accurate reward calculations.

Note:

  • Daily, Weekly, and Biweekly cycles can have buffer days from 0 to 30 days.
  • Monthly, Quarterly, and Yearly cycles can have buffer days from 0 to 90 days.

incentives buffer days

Click Save & Next to move to the next stage.

incentives attributes save

 

6. Select the Program Users and Approvers

Program users are sales users eligible for the incentives. Approvers are usually team leads and sales managers (or someone higher up in the organization hierarchy) who can edit, reject or approve the incentive.

Select a cycle through the dropdown and add the users who will be part of the program.

Note: You can add different users to each cycle. So for example, you can add John and Frank to the first cycle and add John and Sally to the next cycle.

incentives select users

You can also copy the users to different cycles –

  1. Click Copy Users to Selected Cycles.
  2. You can click on the Filter option to select a specific year you want to copy to.
  3. Next, select the cycles where the users will be added – you can select individual cycles or all cycles.
  4. Once done, click Copy Users to Selected Cycles.

Incentives copy users

Note: You can also import users through an Excel file. To do this, click Add Users Using Excel. You can use the Sample File to add the users.

incentives excel import

Next, you must select the user(s) who will be responsible for approving the rewards once they are calculated –

  1. Click Edit to select the approvers.
  2. You can change the Stage 1 approver by clicking the Change button.
  3. Enter the name or email address of the approver.
  4. Click on Add Stage + if you would like to add an additional approver.
  5. Once done, click Save & Next.

Note:

  • You can have a minimum of 1 and a maximum of  3 approvers.
  • The reward approval must pass through all stages of approvers.
  • An approver in a higher stage can override a decision made by the approver in a previous stage.
    • For example, if a Stage 1 approver has rejected a payout, the Stage 2 approver can override and approve the payout.
  • Admin users can approve or reject rewards on behalf of all the assigned approvers.

incentives approvers

 

7. Set Up the Program Criteria and Rewards

Each cycle can have a different Program Criteria. For example, you can define a 0.5% commission on the first cycle and a 1% commission on the next cycle.

To add a criteria, click + Add Program Criteria. Next, click on Add Condition.

Note: To learn how to create Criteria’s & Reward’s through the Incentive Formula Builder, refer to this article.

Incentives add criteria

Add a condition –

  1. Select a Ruleset for the condition
  2. Select the conditional operator.
  3. Enter the desired value.
  4. Click Add Conditions.
  5. To add an additional condition, click on the additional condition icon icon.
Note: You can create up to 10 conditions in a Program Criteria.

In the following example, we have added 2 conditions. To achieve Condition 1, the user must generate revenue between Rs. 1 Lakh and 1.5 Lakhs. And to achieve Condition 2, the user must generate between 5 and 10 leads.

Incentives criteria single

Once you have set up the conditions, you must set a Condition Pattern. It can be either an AND or an OR operator.

Operator Description
AND To receive an award all conditions wrapped with an AND operator must be satisfied.
OR To receive an award either one condition wrapped with an OR operator must be satisfied.

In the following example, we have selected an AND operator. Hence, both condition 1 and condition 2 must be met to satisfy Program Criteria A.

Incentives conditional pattern

Next, you can configure Rewards

  1. Click Add Reward.
  2. Select the reward calculation.
  3. Enter the reward value.
  4. Select a Ruleset if the reward value is dependent on a particular Ruleset.
  5. Click Add Reward.
  6. To add an additional reward, click on the additional condition icon icon.
Reward Calculation Description Example
Fixed The reward is a fixed amount. A fixed payout of Rs. 1000
Percentage The reward is a percentage of the achievement generated by the user. 5% of the total revenue generated by the user.
Percentage Slab The reward is a specific percentage in a slab. For revenue between Rs. 1 Lakh and Rs. 2 Lakhs –

  1. The user will get a reward of 5% of the revenue if they have generated between Rs. 1 Lakhs and Rs. 1.5 Lakhs.
  2. Addtionally, the user will get a reward of 6% of the revenue if they have generated between Rs. 1.5 Lakhs and Rs. 2 Lakhs.
Multiplier The reward is a multiple of the achievement generated by the user. For each lead generated, the user will get Rs. 100.
Multiplier Slab The reward is a specific multiplier in a slab. For leads generated between 1 and 10 –

  1. The user will get a reward of Rs. 100 for each lead they have generated between 1 and 5 leads.
  2. Additionally, the user will get Rs. 200 for each lead they have generated between 5 and 10.
Note: You can create up to 10 rewards in a Program Criteria.

In the following example, we have set up 2 rewards. Reward 1 is a percentage slab of 5% and 6% for revenue generated between Rs. 1 Lakh and 1.5 Lakhs. And Reward 2 is a multiplier of Rs. 100 for each lead generated between 5 and 10. Each time a user meets the conditions of Program Criteria A, the rewards are calculated.

incentives rewards 3

You can also configure Custom Rewards for your users, such as vouchers, travel experiences, gadgets, and more. To do this, first create a custom reward by navigating to the ACE Settings page and selecting Custom Rewards. Once created, the reward will be available for selection in the Rewards section when configuring your incentive program.

configure custom rewards for incentive program

If you would like to add additional incentives for the users, you can add an additional program criteria which can be triggered once Progam Criteria A is met. The steps are the same as above.

Incentives program criteria b

Click Publish to publish the incentive program.

Incentives publish

 

8. Create an Incentive Program Through Goals

If you have a Goal set up for your organization or team, you can also build an Incentive Program for it –

8.1 Program Attributes

  1. In the Attributes section, set up the Rulesets, Calculation Type, and Program Duration (refer to section 5 for a detailed walkthrough of the Attributes setup).
  2. Toggle the switch incentives through programs yes for Do You Want To Add Goals To The Program?
  3. Click Select Goals.
  4. The Goals matching the program attributes will be shown.
  5. Select the Goals for the incentive program.
  6. Click Use Selected Goals.
  7. Click Proceed.
Note: You can select multiple Goals in an incentive program.

Incentives through goals

 

8.2 Users & Approvers

The users are automatically inherited from the Goal. To make any changes to the user list, you will need to edit the list in your Goal configuration.

Note: Refer to section 7 to set up Criteria & Rewards.

incentives goals 2

 

Next Steps

The View and Manage Incentives article will show you how to view the Incentive calculations, approve payouts, and manage the progress of the Incentive program.

 

Any Questions?

Did you find this article helpful? Please let us know any feedback you may have in the comments section below. We’d love to hear from you and help you out.

How Can I Switch Back to LeadSquared’s Legacy UI?

Note: This option is unavailable in the NextGen experience and will not be visible to customers who have been transitioned to NextGen.

If you’ve enabled the latest LeadSquared UI on the Manage Leads, Manage Opportunities, Smart Views and Lead Details pages –

To change back to LeadSquared’s old User Interface (UI), on the top right corner of any of these screens, click Switch Back.

LeadSquared - Switch to Old UI

How to Embed Videos in Landing Pages

1. Feature Overview

This article will help you add external videos on LeadSquared Landing Pages. You can link audio, video, and slide shows hosted outside LeadSquared by providing the embedded HTML code.

 

2. Prerequisites

You should be an Administrator or Marketing User of your LeadSquared account.

 

3. Procedure

For instance, let’s consider adding a YouTube video on the Landing Page –

  1. On the Landing Page Builder, add a media block by clicking on the media icon  icon.
  2. Copy the HTML iframe from YouTube for the respective video.
  3. Hover your mouse over the media block settings and click Edit.
  4. Paste the HTML iframe.
  5. Click Save.

Add Video

 

Any Questions?

Did you find this article helpful? Please let us know any feedback you may have in the comments section below. We’d love to hear from you and help you out!

Approvals Connector

1. Feature Overview

Leadsquared’s Approvals Flow Connector lets Admins set up seamless approval workflows between users and their respective managers, based on specific criteria. For example, an Admin can configure conditions necessitating approval for loan applications exceeding a threshold. In such cases, when a user inputs an amount surpassing this threshold, the relevant manager(s) will receive notifications, allowing them to either approve or reject the loan application.

 

2. Prerequisites

  • You must be the Administrator of your LeadSquared account to install and configure this connector.
  • This is a paid connector. To enable it, reach out to your account manager, or write to support@leadsquared.com.
  • You must enable Lead Sharing. To enable this, contact support@leadsquared.com.
  • You must enable Opportunity Sharing on the Advanced Configuration page.
  • To use the Approvals feature on Opportunities, you must install the Custom Opportunity Tab connector. The Approval request will appear in the custom Opportunity tab.

 

3. UseCase

The Approvals feature can be used across industries –

Industry Use-case
Manufacturing
  • Discount approval in quotations
  • Reseller credit limit approval
Lending
  • Loan approval before disbursement
  • Deviation approval
Education
  • Document verification and approval
Generic
  • Expense approval

Example Use-case

In this article, we’ll set up an Approval Flow based on the following use case –

The Approval Flow triggers whenever the requested Rate of Interest on a home loan application from Bangalore is below 8.5%. The system will first notify the user’s L1 manager, and then the L2 manager of the approval request. If both managers approve the application, the Home Loan Status is marked as Won (or approved). Conversely, if either manager rejects the application, the Home Loan Status is marked Lost (or rejected).

Approval flow

 

4. Install and Configure Approvals Connector

Follow these steps to install and configure the Approval Flow Connector –

4.1 Install the Connector

  1. Navigate to APPS>Apps Marketplace and search for Approvals.
    • Alternatively, you can also find the App under the Generic Integration sub-category.
  2. Click Install.

Approvals Nav

4.2 Configure the connector

You can configure the following settings –

4.2.1 Deviation Tagging

Note: This option is only relevant for Loan Origination System (LOS) features. Customers who aren’t using this feature can ignore this setting.

When enabled, users can tag a flow as either an Approval or a Deviation. In lending processes, deviations occur when a loan application doesn’t meet one or more standard criteria (e.g., age, credit score, etc.) but is still eligible for review and approval. Tagging a flow as a Deviation helps lenders track and process such cases separately.

4.2.2 Opportunity-Level Approvals (Custom Opportunity Tab Requirement)

To use the Approvals feature on Opportunities, you must install the Custom Opportunity Tab connector. The Approval request will appear in the custom Opportunity tab.

Once you install the connector, obtain the Connector ID of this tab and enter the ID in this page (Contact support@leadsquared for help).

approvals configure screen

 

5. Create and Configure Approval Flows

Follow these steps to create and configure your Approval Flows –

5.1 Enter Basic Details about the Approval Flow

  1. Navigate to APPS>Approval Flows.
  2. Click + Add New Approval.
  3. Approval Flow Name – Give your Approval Flow a name.
  4. Approval Type – Select either Approval or Deviation (Deviation is relevant only for the Loan Origination System feature).
  5. Trigger Entity – Select a Trigger Entity from these options –
    • Leads – Select this option to trigger the Flow on Leads.
    • Opportunities – Select this option to trigger the Flow on Opportunities.
      • Opportunity Type – Select the Opportunity Type.
      • Primary Field – Only changes made to this field will trigger an approval, provided the other conditions are met.
      • Requestor – It lists all custom user-type fields from Opportunity Type (e.g., Sales User, Credit User, Operations User). Whatever value exists in that field during the trigger becomes the requester. If the field is not selected, then default requester is the Opportunity Owner.
    • Activities – Select this option to trigger the Flow on Activities.
      • Activity Type – Select the Activity Type.
      • If the chosen Activity is linked to an Opportunity, then select the respective Opportunity Type (this step is optional).
  6. Primary Trigger Field – Once you’ve selected a Trigger Entity, you must select a Trigger Field within that Entity. The Approval Flow will trigger based on the value entered into this field.
  7. Approval Trigger On – Decide when to activate this flow –
    • Record Creation – When lead details are initially created.
    • Record Edit – When the details are edited post-lead creation.
    • You can choose to select both of the above options.
  8. Description – Give a brief description of the Approval flow; this step is optional.
  9. Allow Discasrding a Request – Discard lets approvers close an approval request without approving or rejecting it. If multiple approvers exist, the first person to discard ends the flow.

create flow with basic details

5.2 Add Rules to Your Approval Flow

Click on the + Add Rule button and enter the following details on the Approval Rule –

  1. Rule Name (mandatory step) – Give your Rule a name.
  2. Primary Trigger Condition (mandatory step) – Choose a condition that compares the value in the Primary Trigger Field (from the earlier section) with a specific threshold triggering the Approval Flow. For example, if the primary Trigger Field, Rate of Interest, is Less Than 8.5, the Approval Flow will be triggered.
  3. Additional Conditions (optional step) – Specify one or more additional conditions that must be met to trigger the Approval flow. You can specify if all the additional conditions must be met, or if any one condition should be met. For example, City Equals To Bangalore. You can create a maximum of 10 additional conditions in a rule.
  4. Approver Matrix (mandatory step) – Select the Approvers for the flow, with a maximum limit of 6 approvers.
    • Level Managers – A Level 1 Manager is the immediate manager of the user as described in the Manage Users page. A Level 2 Manager is the manager of the Level 1 Manager, and the hierarchy continues accordingly until Level 6.
    • Specific users – Specific users on LeadSquared.
    • Teams & Sales Group – When you select a Team or Sales Group as an approver, you’ll see a new field called Assignment Method, which lets you choose one of the following options:
      • All Users – The request is sent to all users in the selected Team or Group. Any member can self-assign and approve the request.
      • As per Hierarchy – The system automatically assigns the request to the relevant user based on their reporting hierarchy.
        • For example, if the approver is set to the CXO Team, the system checks the requester’s reporting structure and assigns the request to the CXO who falls within that hierarchy. This is useful when user hierarchies differ across departments or when the exact approver level (L1, L2, etc.) may vary.
    • User Fields – It lists all custom user-type fields from the Opportunity Type. Whatever value exists in the user field at the time the request is triggerd will be the approver.
  5. Default Approver (mandatory step) – Specify a default Approver. A request will get assigned to the default approver if an approver is not found at any level as per the Approver Matrix.
  6. Once done, click Save.
Note: You can create a maximum of 10 rules. Each rule can have a different approval matrix. For example, you can create a separate Approval Matrix when City Equals To Bangalore and City Equals Chennai.

create a rule

Note: In the Primary Trigger Condition and Additional Conditions, you have the option to compare values between two fields by selecting the Field option. For example, you can compare a fixed Rate of Interest field with a Desired Rate of Interest field to establish specific trigger criteria for the flow.

Approvals field comparison

5.3 Final Approval and Rejection Action

In this step, we will specify the resulting action when the manager(s) approve or reject the Approval Request.

5.3.1 Final Approval Action 

If the request is approved, then under Action Type, we will select the Home Loan Status field and select the Action Value as Won.

5.3.2 Final Rejection Action 

If the request is rejected, then under Action Type, we will select the Home Loan Status field and select the Action Value as Lost.

Once done, click Save & Publish.

Approvals final action

 

6. Approval Flow

When a user triggers the Approval Request, the approver(s) will receive a notification on the LeadSquared platform and through email to approve or reject the request. Approvers can take one of three actions, depending on their role and configuration:

  • Approve or Reject
  • Forward Approval
  • Assign to Me
  • Return Request
  • Discard Request

6.1 Approve or Reject an Approval Request

When a user triggers an approval flow, the assigned approver(s) receive a notification within the LeadSquared platform and via email to act on the request.

To review and take action:

  1. Navigate to Apps>Approval Requests.
  2. You’ll see all requests categorized as Pending, Approved, or Rejected.
  3. On a pending request, click Approve or Reject.
  4. Add a remark and click Submit.

Approval Flow Behavior:

  • If a first-level approver rejects the request, it’s closed and no further approvers are notified.
  • If a first-level approver approves, the next approver in the flow is notified to review it.

approving a request

Note: The Approval request can also be approved or rejected through the Approvals tab on the Opportunity Details page.

approve or reject flow from approvals tab

6.2 Forward an Approval Request

Approvers can forward an approval request to another user when the request requires review or action from someone else.

To forward a request:

  1. In the More dropdown, select Forward on a pending request.
  2. Select the user to whom you want to forward the request.
  3. Add a remark explaining the reason for forwarding.
  4. Click Submit.

Once forwarded, the selected user becomes the active approver for that request. The original approver can still view the request status but cannot take further action unless it’s reassigned.

forward an approval request

6.3 Assign to Me (for Team or Sales Group Approvals)

When an approval flow is configured to assign requests to All Users within a Team or Sales Group, the request appears in every member’s Approval Requests list.

Any member can take ownership by clicking Assign to Me.

Behavior details:

  • Once a user clicks Assign to Me, the request is locked for that user, and other members see a message like:
    “<User Name> has self-assigned this request.”
  • The assigned user can either Approve, Reject, or Assign Back to Team if they want to return it to the group pool.
  • After being assigned back, the request becomes visible and available for self-assignment to all team or group members again.

assign to me flow

6.4 Return a Request

Return is an action that lets approvers send the request back to the requester instead of rejecting it.

Typical Use Cases

  1. Correction Required
    • Loan amount incorrectly entered (e.g., 1 Cr 10L vs 1 Cr 1L). Approver returns with remark: “Correct loan amount.”
  2. Modification on rates
    • Customer wants 9.8% ROI.  But the business needs the interest to be at 10%, so the Approver returns stating: “Update ROI to 10%.”

return the approval request

Once corrected, requester clicks Resend, and the request goes back to the previous approver.

resend after update

6.5 Discard a Request

Discard lets approvers close an approval request without approving or rejecting it. If multiple approvers exist, the first person to discard ends the flow.

discarding the request

Note: To view the record or details about the Approval Request, you can click on the lead name.

approval record

 

7. Re-Evaluate Approvals and Deviations

The Re-evaluate option allows users to validate whether the approvals or deviations currently triggered on an opportunity are still relevant based on the latest rules.

Use case

Over time, admins may:

  • Modify approval/deviation rules
  • Delete rules
  • Add new conditions
  • Change thresholds

For example, a customer had agreed for a loan of Rs. 50,00,000 but re-estimates and comes back with a request of Rs. 55,00,000

This can cause existing approval requests on an opportunity to become obsolete, incorrect, or missing. The Re-evaluate button ensures that the opportunity always reflects the correct and updated approval flow.

Impact

  • Maintains data accuracy when rules are edited.
  • Prevents approvers from seeing outdated or invalid requests.
  • Ensures that all approvals on an opportunity match the latest business policies.
  • Reduces manual cleanup when rules evolve.

How It Works

From the Approvals tab on an opportunity, users can click Re-evaluate.

When re-evaluation is triggered, the system performs the following automatically:

1. Deletes obsolete items

Any approval requests or deviation-based approval activities that are no longer valid (due to rule change or rule deletion) are removed.

2. Regenerates correct activities

If new or updated rules are now applicable, the system:

  • Creates fresh approval requests
  • Creates linked approval activities

3. Ensures rule accuracy

The updated set of approvals now reflects the current active approval rules and conditions.

approvals re-evaluate

 

8. Approval Request Summary

By default, the request summary displays the field defined in the Primary Field/Condition. However, you can add more fields by navigating to the Approval Flow, clicking Options>Request Summary, and selecting the additional fields you want to include.

Approval request summary

 

9. Approval Summary

Once an Approval Flow is Published, you can navigate back to the Approval flow to view the flow’s summary, make changes, unpublish, or rename the flow.

Approval Flow Summary

 

10. Enable Approvals on the LeadSquared Mobile App

Approvals can also be accessed and managed directly from the LeadSquared Mobile App. Follow the steps below to enable the Approvals section on mobile.

1. Add the Approvals Screen in CASA

The Approvals module for mobile is configured through CASA, not directly from the mobile app.

To make Approvals visible on mobile:

  1. Navigate to CASA.
  2. Create or Edit a Menu.
  3. Create a New Tab on the Bottom or Side Navigation.
  4. Configure the following
    • Icon – Select an appropriate icon for the app
    • Label – Enter the label/name for the tab
    • Navigate To – Select the External option
    • Launch – Copy and paste one of the following URL based on your region:
      • India Region
        https://apv-ui.lending.leadsquared.com/approvalRequestDashboard?X-LSQ-AccessKey=@{User:AccessKey,}&X-LSQ-SecretKey=@{User:SecretKey,}&userId=@{User:UserId,}&userFullname=@{User:FullName,}&orgShortCode=@{Account:ShortCode,}&X-LSQ-Mobile-AuthKey=@{User:DynamicToken,}&X-LSQ-Mobile-RegionId=@{User:RegionId,}
      • Singapore Region
        https://apv-ui-sgp.lending.leadsquared.com/approvalRequestDashboard?X-LSQ-AccessKey=@{User:AccessKey,}&X-LSQ-SecretKey=@{User:SecretKey,}&userId=@{User:UserId,}&userFullname=@{User:FullName,}&orgShortCode=@{Account:ShortCode,}&X-LSQ-Mobile-AuthKey=@{User:DynamicToken,}&X-LSQ-Mobile-RegionId=@{User:RegionId,}
  5. Publish the changes.

Once published, the Approvals option becomes available in the mobile app for all users.

setting up new tab in casa for approvals

2. Log in to the LeadSquared Mobile App

After publishing:

  1. Open the LeadSquared Mobile App.
  2. Log in with your regular credentials.
  3. You will now see Approval Requests in the navigation (based on where you added it).

navigating to approval flow on mobile

3. Mobile Capabilities

Approvers can perform all approval actions directly from the mobile interface, including:

  • Approve
  • Reject
  • Forward
  • View approval trail
  • Return or discard (where applicable)

This ensures that approval workflows continue smoothly even when users are away from the web platform.

approving a request on mobile

 

Any Questions?

Did you find this article helpful? Please let us know any feedback you may have in the comments section below. We’d love to hear from you and help you out!

Opportunity Management – Feature Guide

1. Feature Overview

Opportunities in LeadSquared represent your potential deals (for e.g. – cross-sells, up-sells, and other sales opportunities).

Let’s take the example of an insurance company. John Doe has an existing health insurance policy, and he’s shown interest in opting for other insurance policies, such as term insurance, motor insurance and home insurance. The policies he’s shown an interest in are opportunities.

You can now create multiple opportunities on John Doe, to represent term insurance, motor insurance and home insurance. Each of these opportunities will represent different sales opportunities (cross-sells and up-sells). Each opportunity type can be treated as a separate sales pipeline, where you can define different rules and processes (different fields, stages, activities, tasks and automations). Which means, the process you have in place to sell a term insurance policy can be different from the one you have in place to sell a home insurance policy. Your sales users,  from the term, motor and home insurance verticals, can work simultaneously on John Doe to convert the deal.

Here are a few more examples –

Industry Examples of Opportunities
Online Education A student enrolled for a course on AI, also shows interest in Data Analysis, Machine Learning and Python. The courses he’s shown interest in are opportunities.
Schools and Universities Parents who have two kids, and want both their kids to be admitted in different classes in the same institution. Each of the two kids represents two separate opportunities for the institution.
Loans A customer who has an existing home loan, is also looking to take a personal loan and car loan. The loans he’s shown interest in are opportunities.
Credit Cards A customer who has a Gold credit card has shown interest in upgrading to a Platinum credit card. This up-sell represents an opportunity for the credit card lender.

Here are some of the feature highlights of opportunities in LeadSquared –

Opportunity_2

Opportunity_3

 

2. Prerequisites

  • You must be the Administrator of your LeadSquared account.
  • To enable opportunities in your account, please write to support@leadsquared.com

 

3. Getting Started

3.1 Opportunity Configuration

After enabling opportunities in your account, you must configure opportunities types –

  1. From the main menu, navigate to My Profile>Settings>Opportunities.
  2. Under the Opportunity Types tab, click Create.
  3. Under Create Opportunity Type, you’ll have three tabs – Basic Details, Field Configuration and Form Configuration.

To know more about how to configure opportunities, please refer to Opportunity Configurations.

Opportunities

3.2 Opportunity Management

Once you configure and create different opportunity types, it’ll show up on the Opportunities Management page. On this page, you can perform various actions, such as how to add opportunities to leads, how to perform bulk and grid updates, how to export opportunities and reset filters. To access the Opportunity Management page, from the main menu, navigate to Leads>Manage Opportunities>Opportunity Type. To know more, please refer to Opportunity Management.

3.3 Opportunity Details

To view various details on an opportunity type, click on the opportunity to access the Opportunity Details page. On this page, you can add details pertaining to the opportunity, add activities, tasks and notes to the opportunity, and track the opportunity to completion. To access the Opportunity Details page –

  1. From the main menu, navigate to Leads>Manage Opportunities>Opportunity Type.
  2. Under Enquiry, click any existing opportunity. This will open the Opportunity Details page.

To know more, please refer to Opportunity Details. To customise your Opportunity Details page, refer to Opportunity Details View Customization.

Opportunity Details

 

4. Related Articles

To know more about opportunities in detail, you can refer to the following articles –

Opportunity Configuration Add and configure opportunities for your organization.
Manage Opportunities Add opportunities to leads, import opportunities and perform other actions on the leads.
Opportunity Details Add activities, tasks and notes, and track them on an opportunity.
Duplicate Detection Set automations and rules to detect and remove duplicate leads.
Opportunity Permissions Configure and grant opportunity permissions to your users across role level, sales groups and permission templates.
Import Opportunities Import opportunities to LeadSquared through a CSV file.
Export Opportunities Export opportunities to a CSV file.
Opportunity Card Customization Customize the Opportunity Card to only show specific opportunity and lead fields (e.g., Opportunity Name, Expected Deal Size, etc.) to your users.
Custom Opportunity Actions Connector Create and add custom actions on opportunities.
Custom Opportunity Tab Connector Create and add custom tabs on opportunities.
Adding Custom Field Sets to Opportunities Associate Custom Field Sets with Opportunities.
Opportunity Integrations in Telephony Integrate telephony providers with Opportunities.
Opportunity Management APIs Access APIs to create, retrieve, update and delete opportunities, and related resources (duplicate activities, opportunity notes, etc.).

You can use advanced features like creating automations, agent pop-up for phone call integration, etc., on your opportunities.

 

5. Opportunities on Mobile

From the LeadSquared Android or iOS mobile app, you can add new opportunities, update existing opportunities, and add opportunities to leads.

Note: To access opportunities on mobile, forms must be enabled for mobile. To know more, please refer to Forms and Processes on Mobile.

Once you’ve enabled Opportunities on the web application, it is automatically enabled on your mobile app as well. To change the position of the Opportunities option on your mobile navigation menu, navigate to My Profile>Settings>Mobile App>Mobile Navigation.

MU_04_09_1

5.1 View Opportunities

To view the available opportunities, tap the Hamburger icon, and then tap Opportunities. All the opportunity types in your account will be listed on the Opportunities screen.

Android

5.2 Add Opportunities from the Opportunities Screen

To add an opportunity from the Opportunities screen –

  1. Tap the Hamburger icon, and then tap Opportunities.
  2. On the Opportunities screen, from the list of available opportunities, tap the opportunity type under which you want to add a new opportunity, and then tap Add Opportunity.
  3. On the Add Opportunity screen, from the Associated Lead dropdown, select the lead to whom you want to add the opportunity.
  4. Fill in the other necessary fields.
    • From the Owner, dropdown, you can assign the opportunity to any user within your organization.
  5. Once you’re done, tap Submit.

Opportunities Mobile_1

5.3 Add Opportunities from the Lead Details Screen

To add an opportunity from the Lead Details screen –

  1. Tap the Hamburger icon, and then tap Leads.
  2. On the Lead List screen, tap the lead on whom you want to add the opportunity.
  3. On the Lead Details screen, then navigate to the Opportunities tab, and click the Call Recording icon.
  4. On the Opportunity form screen, enter the required details.
  5. Once you’re done, click Submit.

Opportunities Mobile_2

5.4 Actions

The following actions can be performed on the Opportunities page –

  • Swipe – By swiping an existing opportunity card from right-to-left, you’ll be able to add Activities and Tasks directly from the Opportunites page.
  • Long Press – By long-pressing an existing opportunity card, you’ll be able to call, send an SMS and/or send an email to the lead, along with updating the opportunity owner to a different user within your organization.

Opportunities Mobile_3

 

6. FAQs

 

Any Questions?

Did you find this article helpful? Please let us know any feedback you may have in the comments section below. We’d love to hear from you and help you out!

Integrate Flostack with UDS

1. Feature Overview

The FloStack–UDS integration lets you automatically sync key lead interactions—such as appointments, reschedules, cancellations, callback requests, and microsite information—from FloStack into LeadSquared.

All FloStack actions are pre-configured in UDS, so you only need to authenticate and complete field mappings. Once configured, new appointment bookings, updates, and microsite events flow directly into LeadSquared without any manual intervention.

The integration ensures that:

  • Leads created or updated in FloStack are reflected accurately in LeadSquared
  • Appointment lifecycle events stay in sync (create, update, cancel)
  • Callback requests raised on FloStack become actionable tasks
  • Personalized FloStack microsites can be stored on the lead record
  • Lead assignment configured inside FloStack is automatically pushed to LeadSquared

This helps admissions, counseling, or sales teams engage leads quickly and consistently, using the same data generated from FloStack’s routing and booking journeys.

How the Integration Works

FloStack sends data to UDS each time a relevant event occurs.

UDS then:

  1. Identifies the lead using the configured unique field
  2. Selects the appropriate action
  3. Creates/updates the Lead, Activity, or Task based on mapping
  4. Processes the sync in real time.

 

2. Available Pre-Configured UDS Actions

Once you search for “FloStack” in the UDS App, you will see the following actions already configured:

  • Create Appointments 
  • Update Appointments 
  • Cancel Appointments 
  • Call Back Request
  • Microsite Creation & Lead Owner Assignment

Each action serves a specific use case in the FloStack workflow.

flostack uds overview

 

3. Create Appointments

3.1 What this action does

Captures appointment bookings from FloStack microsites and creates corresponding LeadSquared records.

Triggered When

A user books a new appointment on a FloStack microsite.

3.2 Basic Settings & Authentication

Enter the following details –

Field Description
Lead Source Enter the lead source through which the leads were captured (e.g., Flostack). This detail will appear on the Lead Details page under Lead Source.
Default Country Code Select a default country code. If the lead’s mobile number is captured without a country code, the default country code is added to the lead’s mobile number.
Select Time Zone The time zone of your Flostack account.
Lead Capture Primary Search By Criteria To avoid duplicate lead creation, select one unique lead field (e.g., mobile number/email) as the search key. Leads will be searched by the value mapped to this field. If a matching lead is found, it will be updated. Otherwise, a new lead will be created. To know how to mark a LeadSquared lead field as unique, please refer to How to Make a Custom Field Unique.
Lead Capture Secondary Search By Criteria If lead identification and capture through the primary Search By criteria fails, the system will reattempt using the secondary Search By criteria.
Select User to Notify on Failure If there’s an error in fetching leads, the selected user will receive a failure message via email. Choose a user from the list of available users in your LeadSquared account.To know more about the type of errors, please refer to Error Notifications.
Enable Notification Enable the Checkbox checkbox to ensure notification emails are sent to the selected user when there’s a failed query.

Supports custom unique fields and composite keys (email + phone) as search keys. Once you’re done entering all the details, click Save.

3.2 Configuration Breakdown

  • Lead/Contact Entity
    • Sync Behavior: The Capture (Create and Update existing record) behavior is recommended. LeadSquared will search for an existing lead (by email/phone). If not found, it creates one.
    • Edit Mapping: Use this to map FloStack appointment fields (name, phone, email, UTM parameters, custom attributes, etc.) to LeadSquared Lead fields.
  • Task Operations
    • Create Task: Enabled. Creates an appointment task for the lead owner based on FloStack details (date, time, meeting type).
    • Edit Mapping: Task mappings for standard appointment tasks are preloaded. Use the Edit Mapping to view mappings, but note these mappings are locked in the default packaged action.
    • Note:
      • To change task schema or add fields, clone the app and edit the clone.
      • FloStack sends a Meeting ID, UDS uses this to relate tasks to activities for updates/cancels.
  • Activity Entity
    • Activity Type(s) Definitions: Alongside FloStack Appointment, click Create Activity.
    • Sync Behaviour Options: The Create + Update (recommended) – UDS creates an “Appointment” activity and updates it on subsequent events.
    • Edit Mapping: Map incoming appointment attributes to the Activity fields. You can add custom activity mappings.

flostack create appointments

 

4. Update Appointments

4.1 What this action does

Updates existing appointment records in LeadSquared when the appointment is modified (rescheduled, advisor changed, etc.) from FloStack.

Triggered When
A user reschedules or edits an existing appointment on a FloStack microsite.

4.2 Basic Settings & Authentication

Enter the following details –

Field Description
Lead Source  This detail will appear as Update Appointments from Flostack on the Lead Details page under Lead Source.
Default Country Code Select a default country code. If the lead’s mobile number is captured without a country code, the default country code is added to the lead’s mobile number.
Select Time Zone The time zone of your Flostack account.
Lead Capture Primary Search By Criteria To avoid duplicate lead creation, select one unique lead field (e.g., mobile number/email) as the search key. Leads will be searched by the value mapped to this field. If a matching lead is found, it will be updated. Otherwise, a new lead will be created. To know how to mark a LeadSquared lead field as unique, please refer to How to Make a Custom Field Unique.
Lead Capture Secondary Search By Criteria If lead identification and capture through the primary Search By criteria fails, the system will reattempt using the secondary Search By criteria.
Select User to Notify on Failure If there’s an error in fetching leads, the selected user will receive a failure message via email. Choose a user from the list of available users in your LeadSquared account.To know more about the type of errors, please refer to Error Notifications.
Enable Notification Enable the Checkbox checkbox to ensure notification emails are sent to the selected user when there’s a failed query.

Supports custom unique fields and composite keys (email + phone) as search keys. Once you’re done entering all the details, click Save.

4.3 Configuration Breakdown

  • Lead/Contact Entity
    • Sync Behavior: Do Nothing is recommended. Lead creation/update is not required since the lead already exists.
  • Task Operations
    • Get Task ID: Enabled. Performs an advanced search to locate the appointment task using the Meeting ID.
    • Update Task: Enabled. Applies updated appointment details (new time, rescheduled date, status changes).
    • Note:
      • To change task schema or add fields, clone the app and edit the clone.
  • Activity Entity
    • Activity Type(s) Definitions: Alongside FloStack Appointment, click Create Activity.
    • Sync Behavior Options:Update only existing record is recommended. Updates the same activity created during appointment creation.
    • Edit Mapping: Map incoming appointment attributes to the Activity fields. You can add custom activity mappings.

flostack update appointments

 

5. Cancel Appointments

5.1 What this action does

Marks appointments as cancelled in LeadSquared when a prospect cancels via the FloStack microsite.

Triggered When
A user cancels a previously booked appointment.

5.2 Basic Settings & Authentication

Enter the following details –

Field Description
Lead Source  This detail will appear as Update Appointments from Flostack on the Lead Details page under Lead Source.
Default Country Code Select a default country code. If the lead’s mobile number is captured without a country code, the default country code is added to the lead’s mobile number.
Select Time Zone The time zone of your Flostack account.
Lead Capture Primary Search By Criteria To avoid duplicate lead creation, select one unique lead field (e.g., mobile number/email) as the search key. Leads will be searched by the value mapped to this field. If a matching lead is found, it will be updated. Otherwise, a new lead will be created. To know how to mark a LeadSquared lead field as unique, please refer to How to Make a Custom Field Unique.
Lead Capture Secondary Search By Criteria If lead identification and capture through the primary Search By criteria fails, the system will reattempt using the secondary Search By criteria.
Select User to Notify on Failure If there’s an error in fetching leads, the selected user will receive a failure message via email. Choose a user from the list of available users in your LeadSquared account.To know more about the type of errors, please refer to Error Notifications.
Enable Notification Enable the Checkbox checkbox to ensure notification emails are sent to the selected user when there’s a failed query.

Supports custom unique fields and composite keys (email + phone) as search keys. Once you’re done entering all the details, click Save.

5.3 Configuration Breakdown

  • Lead/Contact Entity
    • Sync Behavior: Do Nothing is recommended. No lead updates are required for cancellations.
  • Task Operations
    • Get Task ID: Enabled. Retrieves the appointment task mapped to the Meeting ID.
    • Cancel Task: Enabled. Cancels the appointment task for the lead owner.
    • Edit Mapping: Task mappings for cancellation are preloaded/locked. Clone the app to edit mappings.
  • Activity Entity
    • Activity Type(s) Definitions: Alongside FloStack Appointment, click Create Activity.
    • Sync Behavior: Create and Update record is recommended. Update the original appointment activity status to “Cancelled” and also capture any cancellation event as an activity if you want a separate audit trail.
    • Edit Mapping: Map cancellation reason, cancelled timestamp, and any notes to activity fields.

flostack cancel appointments

 

6. Call Back Request

6.1 What this action does

Creates a callback task and logs an activity whenever a prospect requests a callback from the FloStack microsite.

Triggered When
A user clicks “Request Callback” or submits a callback form on a FloStack microsite.

6.2 Basic Settings & Authentication

Enter the following details –

Field Description
Lead Source  This detail will appear as Flostack Call Back Request on the Lead Details page under Lead Source.
Default Country Code Select a default country code. If the lead’s mobile number is captured without a country code, the default country code is added to the lead’s mobile number.
Select Time Zone The time zone of your Flostack account.
Lead Capture Primary Search By Criteria To avoid duplicate lead creation, select one unique lead field (e.g., mobile number/email) as the search key. Leads will be searched by the value mapped to this field. If a matching lead is found, it will be updated. Otherwise, a new lead will be created. To know how to mark a LeadSquared lead field as unique, please refer to How to Make a Custom Field Unique.
Lead Capture Secondary Search By Criteria If lead identification and capture through the primary Search By criteria fails, the system will reattempt using the secondary Search By criteria.
Select User to Notify on Failure If there’s an error in fetching leads, the selected user will receive a failure message via email. Choose a user from the list of available users in your LeadSquared account.To know more about the type of errors, please refer to Error Notifications.
Enable Notification Enable the Checkbox checkbox to ensure notification emails are sent to the selected user when there’s a failed query.

Supports custom unique fields and composite keys (email + phone) as search keys. Once you’re done entering all the details, click Save.

6.3 Configuration Breakdown

  • Lead/Contact Entity
    • Sync Behaviour: Create + Update is recommended. Callback requests often originate from prospects who may not yet exist in CRM; create if new, update if existing so the task is associated with correct lead.
    • Edit Mapping: Map contact info, preferred callback time window, page source, and any form fields to Lead fields.
  • Task Operations
    • Create Task: Enabled. Creates a Callback task for the owner.
    • Edit Mapping: Default callback task mappings are preloaded and locked. To add/modify task fields, clone the app and edit the clone.
  • Activity Entity
    • Activity Type(s) Definitions: Alongside FloStack Call Back Request, click Create Activity.
    • Sync Behaviour: Create only is recommended. Every callback event triggers a new activity.
    • Edit Mapping: Map callback metadata: timestamp, preferred time, reason, page URL, UTMs, etc.

flostack call back request

 

7. Microsite Creation & Lead Owner Assignment

7.1 What this action does

Updates lead records with:

  • A personalized FloStack microsite URL
  • The assigned lead owner (as routed by FloStack)

Typical use cases

  • Website form leads entering FloStack journeys
  • Walk-in or call leads where you later want to send a personalized microsite
  • Automations that require the Microsite URL field (e.g., email/SMS triggers)

You can configure automations in LeadSquared to instantly send the personalized microsite link to the lead.

7.2 Basic Settings & Authentication

Enter the following details –

Field Description
Lead Source  This detail will appear as Flostack: Microsite Link Generated on the Lead Details page under Lead Source.
Default Country Code Select a default country code. If the lead’s mobile number is captured without a country code, the default country code is added to the lead’s mobile number.
Select Time Zone The time zone of your Flostack account.
Lead Capture Primary Search By Criteria To avoid duplicate lead creation, select one unique lead field (e.g., mobile number/email) as the search key. Leads will be searched by the value mapped to this field. If a matching lead is found, it will be updated. Otherwise, a new lead will be created. To know how to mark a LeadSquared lead field as unique, please refer to How to Make a Custom Field Unique.
Lead Capture Secondary Search By Criteria If lead identification and capture through the primary Search By criteria fails, the system will reattempt using the secondary Search By criteria.
Select User to Notify on Failure If there’s an error in fetching leads, the selected user will receive a failure message via email. Choose a user from the list of available users in your LeadSquared account.To know more about the type of errors, please refer to Error Notifications.
Enable Notification Enable the Checkbox checkbox to ensure notification emails are sent to the selected user when there’s a failed query.

Supports custom unique fields and composite keys (email + phone) as search keys. Once you’re done entering all the details, click Save.

7.3 Configuration Breakdown

  • Lead/Contact Entity
    • Sync Behaviour: Capture (Create and Update existing record) is recommended. Ensures leads entering through FloStack microsites are added/updated.
    • Edit Mapping: Map microsite URL, owner email, and other custom metadata to Lead fields.
  • Activity Entity
    • Activity Type(s) Definitions: Alongside Flostack Microsite URL Generated, click Create Activity.
    • Sync Behaviour: Create + Update is recommended. Create activity on microsite generation and update if the microsite is re-generated or modified.
    • Edit Mapping: Map microsite metadata to activity fields.

flostack microsite creation and lead owner assignment

 

8. Configuration in FloStack

Navigate to Settings>Workspace Settings>Integrations in FloStack, select LeadSquared and enter:

  • Your LeadSquared Host URL, Access Key, and Secret Key
  • UDS Webhook URLs
    • Create Lead (Microsite Creation & Lead Owner Assignment Webhook URL)
    • Create Meeting (Create Appointments Webhook URL)
    • Update Meeting (Update Appointments Webhook URL)
    • Cancel Meeting (Cancel Appointments Webhook URL)
    • Request Callback (Call Back Request Webhook URL)

This configuration will allow FloStack to trigger the corresponding UDS actions.

uds integration with flostack

 

Any Questions?

Did you find the content in this article helpful? Feel free to leave doubts/questions in the comment section below. We’ll get back to you as soon as possible.

Lead 360 – Feature Guide

1. Feature Overview

With Lead 360, you can fully customize the Lead Details Page on the LeadSquared Mobile App (including fields, details, and actions). This feature is available when Casa is enabled on your account and helps you build comprehensive Lead Details Pages that give users a clear view of each lead’s journey.

  • Configure the page layout with either widgets or tabs, allowing you to present lead data in a more visual way.
  • Preview the page in real time before publishing it.
  • Create and assign different Lead Details views to specific teams.
Note: If Casa is not enabled, you can still customize the Lead Details Page using the Details Customization setting on the LeadSquared Web App, but with limited functionality compared to Lead 360.

Leadsquared - Lead 360          Leadsquared - Lead 360           Leadsquared - Lead 360

 

2. Prerequisites

  • This feature is available only if Casa is enabled on your account. To enable Casa, reach out to support@leadsquared.com.
  • You must be an Admin to configure the Lead Details Page using Lead 360.

 

3. How It Works

With Casa enabled, the Lead 360 page brings together all lead information in a single, customizable view on the LeadSquared Mobile App. It is made up of three main components:

  • Quick View Card – Displays key identifiers, fields, and quick actions at the top of the page for instant context.
  • Page Layout – Organizes detailed lead interactions. You can choose between:
    • Classic Menu Tabs (a tab-based layout for tasks, activities, notes, etc.)
    • Custom Landing Page (a widget-based layout with tile or detailed views).
  • Actions Panel – Lets you add and arrange actions (e.g., call, email, WhatsApp) for faster engagement.

Once configured, you can preview your layout and then publish it either as the default view for all users or assign it to specific teams.

 

4. Access Lead 360

  1. On your LeadSquared Web App, navigate to Apps>Casa.
  2. From the left menu, select Lead 360 under Mobile.
  3. On the Lead 360 Configurations page, select Create New.

Leadsquared - Lead360

 

5. Customize the Quick View Card

The Quick View Card appears at the top of the page and can be customized to show key lead details. This helps users quickly identify and act on important information. In the example given below –

  • Identifier –  First Name and Last Name of the lead
  • Fields – Role, Lead Stage, Division, Department
  • Quick Actions – Share Lead, Directions, Email Lead, Call Lead

Leadsquared - Lead 360

To configure the quick view card –

1. Select Identifier – Choose the best identifier for your business use case (e.g., Name, Email).

  • Click the Click To Add Field button to add the identifier for the leads.
  • In the Add Lead Identifier panel, you can add upto 4 preferred identifiers and click Add. For a particular lead, if the first preference is unavailable, the system will display the next available field.
  • Click the Leadsquared - Lead 360 edit icon if you want to make changes to your identifier fields.

Note:

  • First A and First B are identifier fields that are displayed together. For example, you can select First Name and Last Name, or First Name and Email. The two chosen fields will appear side by side.
  • You must add at least 2 identifier fields (First A and Fourth mandatorily).

Leadsquared - Lead 360

2. Display Fields – Show up to 4 lead fields on the card

  • Search and select the relevant fields from the All Fields panel.
  • To remove a field, click the Leadsquared - Lead 360 delete icon alongside the relevant field.

Leadsquared - Lead 360

  • Enable the Show in List Card toggle to display the configured fields in the Smart Views and Lead list pages.

Leadsquared - Lead 360

3. Configure Quick Actions – Configure up to 4 actions from the given options

  • Under Card Actions, hover over the widgets to view their labels. The actions are Call, SMS, WhatsApp, WhatsApp Business, Email, Star, Change Stage or Directions.
  • Select the relevant actions you want to display in the card.
  • To remove a quick action, hover over the added widget and click the Leadsquared - Lead 360 delete icon.

Leadsquared - Lead 360

  • Enable the Show in List Card toggle to display the configured actions in the Smart Views and Lead list pages.

Leadsquared - Lead 360

 

6. Configure the Page Layout

You can customize the main Lead Details Page to display key interactions with the lead. You can configure the page in two ways:

  • Classic Menu Tabs – Display lead information in a tabbed layout.
  • Custom Landing Page – Use widgets for a more visual layout.

Select Page from the leftmost panel. On the Create Page panel, hover over Custom Landing Page or Classic Menu Tabs to preview how your configured page will appear with each option.

Leadsquared - Lead 360

6.1 Configure Classic Menu Tabs

You can add both system and custom tabs to the page. Once added, you can scroll horizontally to navigate between them. In the example below, the configured tabs include Tasks, Details, Activities, etc.

Leadsquared - Lead 360

To configure Classic Menu Tabs –

  1. Click the arrow in the Classic Menu Tabs box on the Create Page panel.
  2. From the Menu Items list, select the relevant tabs. The available tabs are Activities, Tasks, Notes, Documents, Social Profile, About and Approvals.

Leadsquared - Lead 360

To add a custom link as a tab –

  1. Click Add Custom Menu.
  2. On the right side Custom Menu panel, enter a name for the tab and the link. Then, click Add.

Leadsquared - Lead 360

Click the Try Widgets button to configure the page using widgets instead of tabs.

Note: If you navigate to the Widgets page from the Classic Menu Tabs page, the changes you made to the Page section will not be retained.

Leadsquared - Lead 360

6.2 Custom Landing Page

You can add widgets from the available options or create custom widgets. You can choose to display the widgets in the Tile or Detailed view. The widgets can be configured with either an icon or an image. All widgets appear below the lead card, and tapping one navigates to the relevant screen (e.g., tapping an Opportunity widget opens the Opportunity List).

In the example shown, the image on the left is configured with Tile View while the image on the right is configured with Detailed View. This is described in the section below.

Leadsquared - Lead 360         Leadsquared - Lead 360

To configure widgets –

  1. Click the arrow in the Custom Landing Page box on the Create Page panel.
  2. Click the plus icon alongside the relevant item in the left side widgets panel.
  3. On the configuration panel that opens on the right side –
    • Enter a name or label for the widget.
    • Select the Widget Type.
      • Tile View – The widgets are displayed as tiles with an icon or an image (you can upload the relevant image from your device)
      • Detailed View – Each widget shows the three most recently modified entities
    • Configure the widget as required and click Save.

Leadsquared - Lead 360

To add a custom link as a widget –

  1. Click Add Custom Widget.
  2. On the right side Custom Menu panel, enter a name for the widget and configure the Widget Type as required.
  3. Enter the relevant link and click Save.

Leadsquared - Lead 360

 

7. Set Up Actions

You can quickly add and rearrange actions as required to engage with leads. Select Actions from the leftmost panel and begin customizing. In the example given below, the configured actions are Call, SMS, Update Location, Add Notes and Add Activity.

Leadsquared - Lead 360

To configure the Actions –

  1. Select the relevant items from the left side Actions panel. The action is directly added to the page.
  2. To edit the name and icon of an action, hover over the relevant action on the right side Quick Actions panel and click the Leadsquared - Lead 360 edit icon and make the relevant changes.
  3. To delete an action, hover over it and click the Leadsquared - Lead 360 delete icon.
  4. Once you’ve added all the necessary actions, you can rearrange them through a drag and drop action using the Leadsquared - Lead 360 icon.

Leadsquared - Lead 360

 

8. Preview & Publish the Details Page

Once you’ve configured the details page, you can enable the Preview Mode toggle to view the card, tab, and action arrangement. If you’re satisfied, you can Publish it as the default view or assign it team-wise.

Leadsquared - Lead 360

 

Any Questions?

Did you find this article helpful? Please let us know any feedback you may have in the comments section below. We’d love to hear from you and help you out!

Wildcard Search Limitations

1. Feature Overview

Advanced searches performed with wildcard operators (Contains, Does not contain, Starts with, and Ends with) on fields with 500 characters or more (for example, Lead and Activity Notes fields) are rate-limited to prevent performance issues on your LeadSquared account. By default, the rate limit is 3 wildcard searches per minute per user in the account. If the number of wildcard searches exceeds this limit, users will see the errors documented below while using the advanced search feature.

What is Wildcard Search?

Wildcard search refers to the advanced search functionality in LeadSquared that allows users to search fields with 500 characters or more using operators such as Starts with, Ends with, Contains, and Does Not Contain.

What is the Rate Limit?

Wildcard searches are rate limited at 3 searches per user per minute. This limit ensures optimal system performance and prevents misuse of the wildcard search feature.

How Does This Impact Users?

  1. If a user exceeds the limit of 3 searches per minute, they’ll receive a message with a helpful link to learn more about wildcard searches on the respective page.
  2. Users will not be able to perform bulk operations, such as Bulk Update or Export etc, when wildcard search is applied on Manage Lead/Opportunity/Activities and Smart Views grids.
  3. Users will be unable to create Dynamic and Refreshable lists with wildcard conditions.

 

2. Wildcard Search Limitations

Rate limits are applied on all pages with Advanced Search –

Note:

  • Users cannot perform bulk actions across pages (such as Export, Bulk Update, Add to List, Bulk Add Activity, etc.) filtered via wildcard operators in Advanced Search.
  • Users cannot create dynamic or refreshable lists with wildcard operators.
  • These limitations only apply to fields with 500 characters or more.

LeadSquared - Wildcard Rate Limiting

 

3. Bulk Actions on WildCard Advanced Searches

As mentioned, when you try to perform an advanced search using a wildcard operator on a field with 500 characters or more, you won’t be able to use bulk actions such as Export, Bulk Update, Add to List, etc.

In this example. we’re performing a ‘Does Not Contain’ advanced search on the ‘Notes’ field. After getting the results, when we try to export the leads, as a result of the wild card rate limits, we encounter the error – “You cannot ‘Export Leads’ with wildcard operators within advanced search”.

Note: If you’re storing notes/data that’s less than 200 characters, we suggest using a custom text type field instead of the lead/activity notes in order to avoid this limitation.

LeadSquared Advanced Search Rate Limits

 

Any Questions?

Did you find this article helpful? Please let us know any feedback you may have in the comments section below. We’d love to hear from you and help you out!

Manage Plans on the Mobile App

1. Feature Overview

Journeys enables all sales users to create a Plan (Beat Plan, PJP etc.) in just two simple steps by defining the plan duration (i.e. Start Date & End Date) and adding the relevant leads. Users can also send plans for approval to their respective managers if required. Once a plan is published or approved, the configured To-Dos will be created against the added leads. The plan execution can then be tracked through My Trips, Tasks, Task Smart Views, etc., on the LeadSquared mobile app. 

This article explains how you can create, edit and approve plans through the LeadSquared mobile app.

LeadSquared - journeys

 

2. Prerequisites

  • Journeys must be configured on the web app. To know more, refer to Setting up Journeys on the Web App.
  • Journeys must be added to the side navigation menu on the mobile app.

 

3. How It Works

Admins must first enable and configure Journeys on the Web application. Once configured, sales users can create plans on the mobile app and submit them for approval to their managers, if required. Users can access all published plans on the My Plans page.

Once managers approve the plans, it will be reflected on the following pages on the mobile app –

Users can then follow their plans while performing their assigned tasks.

 

4. Create Plans

  1. From the dashboard, tap LeadSquared - Mobile app menu. On the side menu, under Journeys, tap My Plans.
  2. To create a new plan, tap Create plan icon.
  3. Under Select Date Range, tap calendar icon to select your start and end dates on the calendar.
    • Start Date – The start date of the planned period, starting from the current date and extending up to 90 days.
    • End Date – The end date of the planned period, extending up to 31 days from the selected start date.
  4. If admins have enabled Default Plan Duration, users will be designated a range of days in a plan. When a user selects a start date, the app auto-fills the end date based on the admin-set duration. The user can adjust the end date unless Force Duration is enabled, making it non-editable.
  5. Under Working Days, select your official working days. By default, the working days are set based on the user’s Workday Template. If Force Workday Template is enabled on the Journeys Settings, you cannot modify the workdays in a plan duration.
  6. Under Create Plan With, you can choose to create this plan by searching for leads manually or using a pre-existing lead template. Once you select the relevant option, tap Next.
  7. On the relevant date, a number denoting the leads already assigned to the user on that particular day is displayed. The number mentioned above each date represents the number of tasks assigned (task load). Tapping the number will open a popup with a list view of the existing tasks.

4.1 Create Plans with Leads

  1. Alongside each date, tap Dotted add icon. Any holiday falling within the plan duration will automatically be blocked. However, you can click Dotted add icon alongside the date to add leads.
  2. To add leads, alongside the relevant lead, tap Black add icon.
    • Only the leads accessible to the logged-in user will be available for planning. Leads will be displayed based on the configured lead access hierarchy.
    • To request your manager for a joint meet with a lead you’ve added, enable the toggle beside Joint Meet.
  3. Search for leads on the search box. To filter your leads, tap Filter icon.
  4. If Define Quota is enabled, admins can set a defined minimum number of leads that a user can cover each day. If Force Minimum Quota is enabled, all users must comply to a standard minimum number of  leads. If users haven’t met the minimum lead quota, the system blocks plan submission and notifies them.
  5. Tap Next. You will now receive a summary of your plan with the total number of tasks and unique leads you’ve added. Once you’ve reviewed it, tap Submit For Approval or Publish.

Note:

  • You can add more leads to your plan till you meet the daily quota configured by your Admin. If no quota has been assigned, you can add up to 40 leads to your plan in one day.
  • To preview the plans you’ve created, on the side menu, under Journeys, tap My Plans. Then, tap the plan you wish to view.
  • If Approvals are disabled in your account, the plans will get published immediately.
  • If Approvals are enabled in your account, the plans will get published once your Manager approves them.

Leadsquared -Journeys

4.2 Create Plans with Lead-Based Smart Views

Create plans focusing on the most relevant leads by choosing from Lead-Based Smart Views or Lead Types.

  1. Alongside each date, tap Dotted add icon. Any holiday falling within the plan duration will automatically be blocked. However, you can click Dotted add icon alongside the date to add leads.
  2. Click All Leads dropdown to view Lead-Based Smart Views or Lead Types.
  3. Select the relevant Smart Views.
  4. To add leads from the specific Smart Views, alongside the relevant lead, tap Black add icon.
  5. Click Next to view a summary of your Plan. Once you’re done, click Submit for Approval or Publish.

Leadsquared - Lead Based Smart Views

4.3 Create Plans with Lead Templates

  1. Alongside each date, tap Dotted add icon. Any holiday falling within the plan duration will automatically be blocked. However, you can click Dotted add icon alongside the date to add leads.
  2. Tap on the relevant lead template to select it. Once selected, you can tap on the template to view the leads added.
    • On this card, to remove a lead from the plan, alongside the lead, uncheck the box.
    • To create a joint meeting for a particular lead, alongside the lead, enable the Joint Meet toggle. Once you’re done, click Save.
  3. Click Next to view a summary of your Plan. Once you’re done, click Submit for Approval or Publish.

LeadSquared - Create Plans using Templates on Mobile App

 

5. Block Days on the Plan

Block specific days or even half days (first half or second half) on your plans for planned leave or official activities. Blocked days will be displayed to your manager, allowing them to view and approve the plan with this information. To block a day on the plan –

  1. From the dashboard, tap LeadSquared - Mobile app menu. On the side menu, under Journeys, tap My Plans.
  2. To create a new plan, tap Create plan icon.
  3. Under Select Date Range, tap calendar icon to select your start and end dates on the calendar. Under Working Days, select your official working days.
  4. Under Create Plan With, you can choose to create this plan by searching for leads manually or using a pre-existing lead template. Once you select the relevant option, click Next. Tap Next.
  5. Alongside the date you wish to block, tap Dotted add icon. On the top right corner of the page, tap Block Day.
  6. Select your reason for blocking the day (Leave, Meeting, Training, Holiday, etc.). Then select if you want to block the Full Day, First Half or Second Half.
  7. Proceed adding leads on the other days of the plan and save it. If you’ve blocked half-day, you can still add leads to the rest of the day. You can view your blocked days on the plan preview.
Note: If you’ve already added a few leads for the day and then tap on Full Day blocking, the system will remove all the selected leads and override the selection with the block day reason selected. If the user deletes the block day later, the user will have to start adding the leads from the beginning. However, with First Half or Second Half blocking, the leads remain in the plan.

leadsquared - Day Blocking on Journeys

 

 

6.Manage Lead Templates on Mobile App

6.1 Create and View Templates

    1. From the dashboard, tap LeadSquared - Mobile app menu. On the side menu, under Journeys, tap My Templates.
    2. Tap the Leadsquared - Journeys Add Template icon.
    3. Fill in the relevant details in the popup and select the leads to be added in the template.
  1. You can view all the available lead templates on this page.
  2. To view the leads on the template, tap the lead template.
  3. On this pop-up, to view a lead’s details, tap the lead name.
Note: If you try to add more than 40 leads, you’ll receive a toast message indicating the limit has been reached.

Leadsquared - Journeys

6.2 Edit & Delete Templates

You can edit and delete templates that you’ve created directly from the mobile app. However, templates that are created by someone else and assigned to you cannot be modified. To edit your templates –

  1. Once you’ve navigated to My Templates, tap on any template you’ve created.
  2. Tap Edit Template to update template details or task assignments.
  3. Once done, tap Save to apply your changes.

Leadsquared - Journeys

To delete your templates –

  1. From the Template Preview Page, tap the Delete icon.
  2. Confirm the deletion in the popup “Are you sure you want to delete this template? This action cannot be undone.” The template will be deleted.

Leadsquared - Journeys

 

7. Clone Plans

You can clone existing Approved or Published plans to reduce the time and effort of creating new plans. All scheduling patterns are copied forward, saving you time when recurring plans are needed. However, you can modify the date range and leads if required. To clone a plan –

  1. Open your ideal Approved or Published plan from My Plans on the LeadSquared Mobile App. You can view the status and the summary of the full plan.
  2. Tap the Leadsquared - Journeys Clone Plan icon on the top right corner of the screen.
  3. Customize the plan as required with the date range. You can either stick to the same date range of the original plan or modify it. Tap Next.
  4. View all the leads added to the original plan and modify the plan if required. Tap Next.
  5. View the summary of the plan and tap Submit for Approval if everything looks good.

Leadsquared - Journeys

 

8. Approve Plans

Managers can approve/reject their users plans on the mobile app –

  1. From the dashboard, tap LeadSquared - Mobile app menu. On the side menu, under Journeys, tap My Approvals.
  2. Tap the relevant plan. You will now see a summary of the plan created.
    • To bulk approve plans, long press a plan card. Then, select all the other plans you wish to bulk approve.
    • For plans containing Joint Meetings, a confirmation pop-up will appear, providing options to cancel or proceed with approval.
    • Upon confirming, the selected plans will be approved, and the associated Joint Meet Tasks and other Journey Tasks will be created for both the approver and the requester. 
  3. Alongside the dates added in the plan, the number of leads added for that day will be displayed. Tap on these leads to view the details of the leads added. You can also choose to opt out of Joint Meetings here by sliding the Joint Meet toggle.
  4. The number mentioned above each date in the pending plans represents the number of tasks assigned (task load). Tapping the number will open a popup with a list view of the existing tasks.
  5. To approve or reject the plan, on the bottom of the page, select the relevant option. While rejecting a plan, enter a comment and tap Reject.

Note:

  • Expired plans cannot be selected in bulk to ensure that only active plans are processed.
  • Plans must be approved/rejected on or before their start date. For instance, if a user’s plan begins on February 3rd, the manager must approve it by that date at the latest. If no action is taken by the 3rd, the plan will expire. If Auto-Approval is enabled by the admin in the Journeys settings, the pending plans will be approved automatically on the day of the plan.

Leadsquared - Journeys

 

9. Edit Pending or Approved Plans

Pending or approved plans submitted by your users can be edited to add or remove leads, block a day or revoke a user’s holiday.

Note: While editing a plan, you can select the most relevant leads by choosing from Lead-Based Smart Views.

9.1 Edit Pending Plans

You can edit plans that are pending for approval to ensure that the user’s plan is optimized.

  1. Navigate to My Plans on Journeys.
  2. Select the relevant plan marked with Pending status.
  3. Tap Leadsquared - Journeys and you will be redirected to the Edit Plan page.
  4. Here, you can make the relevant changes to the plan and click Update Plan.

Leadsquared - Journeys

9.2 Edit Approved Plans

Alternatively, Admin, Sales Manager, Reporting Manager or Sales Group Manager can edit the Pending as well as Approved plans.

  1. Navigate to My Approvals on Journeys.
  2. Select the relevant plan.
  3. Tap Leadsquared - Journeys and you will be redirected to the Edit Plan page.
  4. Here, you can make the relevant changes to the plan and click Update Plan.

Leadsquared - Journeys

 

10. Use Plans on Mobile

Once you’ve created your plans, you can view them on the My Plans page. On the right side of each plan, a message will be displayed to indicate whether the plan has been approved, rejected or pending for approval. Once the plan is published, the To-Do Tasks for journeys will be created immediately based on the plan. The To-Dos created will immediately be reflected on the following pages –

LeadSquared - Using Journeys on Mobile

 

11. Notifications

To receive notifications on your mobile, you must enable Notifications in your phone settings. Notifications are sent when –

  • A Reporting Manager or Sales Manager receives a plan for approval from a user.

Leadsquared - Pending Approval

  • Your plan is approved or rejected from the LeadSquared Web App or Mobile App.

Leadsquared - Plan Approved

  • Your manager or admin has assigned a plan to you from the LeadSquared Web App or Mobile App.

Leadsquared - Plan Assigned

 

Any Questions?

We’d love to answer your questions or hear your own unique use cases. Feel free to share your experiences in the comments section below.

Automation Reports

1. Feature Overview

Once you’ve published an automation, you can check its performance in real-time by accessing the automation report. You’ll get insights into leads who’ve –

  • Entered the automation.
  • Transitioned through the various steps (action cards) or taken a certain course of action.
  • Exited the automation successfully or stalled at a certain step.

You can use this real-time feedback to tailor your automations to ensure you’re reaching your goals.

Automation Report Page

Note: This report shows the performance of the entire Automation. You can also check how an Automation has executed on a specific Lead, Opportunity, or Account through –

 

2. Accessing the Automation Report

To access the report –

  1. From your dashboard, navigate to Marketing>Automation.
  2. In the automation listing grid, hover the mouse over the wheel icon alongside the automation you want to view the report for, then click View Report.
Note: You can only view reports for published automations.

Automation Report Navigation

 

3. Report Insights

The left side of the automation report page tells you how many unique leads have entered your automation based on the trigger you’ve set. It shows you how many leads have exited or transitioned through the steps or stages and also gives you the created on and published on date and time of the automation.

You can also apply date filters to view leads entering or transitioning through the automation within a specific time frame.

Note: The Exit Actions Completed metric counts only those leads who reached the final step of the automation. If a lead exited early due to a condition or another exit path, they will not be counted here.

report details

You can also view metrics on each automation card and the specific leads at a certain stage of the automation. To do so, click the graph icon alongside the automation card. Then click View Leads to see the list of leads who are at that particular step in the automation –

View List of Leads

 

4. Export Lead List for an Automation Card

To view and export the list of leads that have entered a specific card in a published automation –

  1. Navigate to the published automation, hover your cursor over LeadSquared - Settings icon, and click View Report.
  2. On the automation card for which you want to view the list of leads, click the bar graph icon Automation Report Icon, and then click View Leads.
  3. On the Automation_ Report Details page, hover your cursor over , and click Export Leads.
    • If needed, you can select specific leads to export by clicking the checkbox Checkbox next to their names.
  4. On the Export Leads pop-up, select the lead fields you want to export, and click Export.
  5. To view the export status, on the Export Report pop-up, click “here”. This will redirect you to the Request History page.
  6. Once the export request status is successful, hover your cursor over LeadSquared - Settings icon, and click Download Lead Export. You can view the lead list that was exported.

Note:

  • The card-wise list of leads, opportunities and accounts in the automation report will only store data for the previous 90 days. This applies to ‘User’ and ‘At Regular Interval’ automations as well.
  • The count of leads that entered each card will still be visible after 90 days. The lead list, however, will not display data prior to the last 90 days.

LeadSquared Automation Report

 

5. Email Reports

You can view email reports for automations that contain Send Email action cards –

Email Automation Card

The report gives you detailed information on your emails, including delivery rates, bounce rates, open rates, click rates and lots more.

You’ll see the View Email Report option for these automations when you hover the mouse over the wheel icon alongside the automation on the grid.

View Automation Email report

 

6. Export Lead List from an Email Report

To export the lead list from the Email Report –

  1. Navigate to the published automation, hover your cursor over LeadSquared - Settings icon, and click View Email Report.
  2. Click , and select the date range for which you want to export the leads.
  3. Then, hover your cursor over , and click Export Leads.
    • If needed, you can select specific leads to export by clicking the checkbox Checkbox next to their names.
  4. On the Export Leads pop-up, select the lead fields you want to export, and click Export.
  5. To view the export status, on the Export Report pop-up, click “here”. This will redirect you to the Request History page.
  6. Once the export request status is successful, hover your cursor over LeadSquared - Settings icon, and click Download Lead Export. You can view the lead list that was exported.
Note: The lead list will not show data prior to the last 90 days.

LeadSquared Automation Report

 

7. Lead, Opportunity, and Accounts Automation Reports

The Lead, Opportunity, And Automation-Level Automation Report displays how an Automation has executed on a specific lead, opportunity, or account. The report provides a timestamp for when each event was triggered and the completion time of each action card, and the resulting outcomes.

7.1 Lead Automation Report

To access the automation report for a particular lead –

  1. Navigate to Leads>Manage Leads>Lead Details Page.
  2. Under the Lead Actions menu, click Automation Report.
  3. All Automation executed on the lead will be displayed; open a report by clicking View Report.

lead report nav

The basic details about the lead are provided on the left side of the report page. You will also find links to the Lead Details page and to view the entire Automation Report.

report left info

On this drop-down, all Automation executed on the respective lead will be displayed.

dropdown automation

You can click on the info icon next to the trigger and action cards to see how the Automation was executed on the lead at each stage.

card details

7.2 Opportunity Automation Report

To access the automation report for a particular Opportunity-

  1. Navigate to Leads>Manage Opportunities>Opportunity Type>Opportunity Details Page.
  2. Under the Actions menu, click Automation Report.
  3. All Automation executed on the Opportunity will be displayed; open a report by clicking View Report.

opp report nav

The basic details about the Opportunity are provided on the left side of the report page. You will also find links to the Opportunity Details pageLead Details page, and the link to the entire  Automation Report.

details

On this drop-down, all Automation executed on the respective Opportunity will be displayed.

more automations

You can click on the info icon next to the trigger and action cards to see how the Automation was executed on the Opportunity at each stage.

each card automation

7.3 Account Automation Report

To access the automation report for a particular Account-

  1. Navigate to Leads>Manage Accounts>Account Type>Account Details Page.
  2. Under the Actions menu, click Automation Report.
  3. All Automation executed on the Account will be displayed; open a report by clicking View Report.

Account report nav

The basic details about the Account are provided on the left side of the report page. You will also find links to the Accounts Details page, and the link to the entire Automation Report.

accounts details

On this drop-down, all Automation executed on the respective Account will be displayed.

different automations

You can click on the info icon next to the trigger and action cards to see how the Automation was executed on the Account at each stage.

account card details

 

8. Troubleshooting

Unable to Create Opportunity via Automation

  • Issue: Why am I getting the following error message when I try and create an opportunity via automation – “Duplicate detection engine failed marked opportunity duplicate but failed to return conflicted Opportunity Id. Failure message: field value for field name: ‘mx_custom_19’ of datatype: ‘String’ is mandatory”.
  • Root Cause: The issue occurs because the option to Enable comments on status change is enabled in the Opportunity type configuration. Due to this, the ‘Comment’ field which is “mx_custom_19” is mandatory, and you must add a comment when changing the status of the opportunity. “mx_custom_19” is a system-reserved field used to capture comments on stage changes under “Opportunity Status.”
  • Solution: To resolve the issue –
    • Provide a value for the ‘Comment’ field while creating the opportunity through automation.
    • If you don’t want to mandate comments on status changes for the opportunity, disable the Enable comments on status change setting for the Opportunity Type.

LeadSquared Opportunity Management

 

9. FAQs

What does “Exit Actions Completed” mean in the Automation Report?

The Exit Actions Completed count in the Automation Report refers to leads who have successfully completed all steps in the automation, reaching the final card.
This is not the same as the Remove Leads from Automation condition set in the trigger. That condition is used to stop a lead from entering or progressing further in the automation based on specific criteria. It does not contribute to the “Exit Actions Completed” number.

 

Why is the number of leads in “Exit Actions Completed” lower than the number who entered the automation?

Not all leads who enter an automation will reach the final step. The Exit Actions Completed metric only counts leads who completed the entire flow and reached the last step. If a lead exits the automation earlier, due to a conditions set in the trigger, in other condition cards, or via another exit path, they will not be counted in this metric.

Why can’t I see the automation report for a specific lead or opportunity? / Automation report missing for lead or opportunity / Can’t find triggered automation for a lead

If you’re unable to find the automation report for a specific lead or opportunity, it’s usually due to one of the following reasons:

  • Mismatch in trigger type and details page
    Automations are triggered either by leads or by opportunities:

    • If the automation has a lead-based trigger, its report will appear on the Lead Details page.
    • If it has an opportunity-based trigger, it will appear on the Opportunity Details page.
      Check that you’re viewing the report on the correct entity page.
  • Data older than 90 days is not retained
    Automation reports are only available for automations that were triggered in the last 90 days from today. If the automation ran before that, its report will no longer be visible.

 

Any Questions?

Do you have questions or issues with the content of this article? Let us know in the comments section below. We’ll get back to you ASAP!

Automation Usage Report

1. Feature Overview

The Automation Usage Report gives you a report of all the automations that have been executed. The Automation Usage Report also displays the number of executions in each automation and the total number of executions in all automations. You can filter these automations by their date range to view the reports of automations executed during a specific time period.

Note: For more details on automations, see –

 

2. Prerequisite

You must be the Administrator of your LeadSquared account.

 

3. Automation Usage Report

Navigate to Workflow>Automations and under Related Settings, click Automation Usage Report.

  • To view the report of automations created within a particular date range, next to Date Range, click the dropdown.
  • You can view the execution count of the automations in thousands (K), lakhs (L), millions (M) and crores (Cr). To select the relevant count, click the dropdown next to Execution Count In.
  • Your top 5 automations within the selected date range are displayed as a pie chart based on their execution count.
  • A list of all your published automations are displayed below the pie chart.
  • You can view the reports
    • Automation-wise – This view displays a list of all the executed automations within the selected date range. To view a day-wise list of the executions, click on the arrow before the automation name. To view a specific automation, click on the name of the automation.
    • Day-wise – This view displays all the dates when automations were executed and the total number of executions on that day. To view the automations executed on a particular day, click on the relevant date. To view a specific automation, click on the name of the automation. You can arrange the dates in ascending or descending order.
  • To export the Automation Usage Report for a particular date range, click Export. The exported file will display the Automations, their execution count, and the dates when they were executed. The date field will follow the same format (mm/dd/yyyy or dd/mm/yyyy) set in the user’s device.

LeadSquared - automation usage report

 

4. FAQs

What is an automation execution?

Each trigger and action executed within an automated workflow (automation) is an automation execution. An example of a trigger within an automation is ‘New Lead Created’, ‘New Activity Created on Lead’ and an action executed within an automation can be ‘Update Lead’, ‘Send Email’, ‘Send SMS’, ‘Add Activity’, ‘Create Task’ etc. For instance, if an automation is created to send an email to every new lead created, New Lead Created will be the trigger for the automation and Send Email will be the action executed.

LeadSquared - Executions in Automation

How is automation execution calculated?

If one lead goes through an automation with five automation cards (each card represents a particular action within an automation), then five automation executions are counted. Similarly, if hundred leads go through the same automation with five cards then five hundred automation executions are counted. Let’s consider the example used in the FAQ above. If one lead goes through this automation, both the trigger and action cards are executed and hence, there are 2 automation executions. If 50 leads go though this automation, then the trigger and action cards are both executed 50 times each and hence, there are 100 automation executions.

 

Any Questions?

Did you find this article helpful? Please let us know any feedback you may have in the comments section below. We’d love to hear from you and help you out!

ACE Dashboard

1. Feature Overview

The Ace Dashboard serves as a central hub for tracking key performance metrics across all Goals, Incentives, and Leaderboards within the ACE suite. It provides a comprehensive, real-time view of individual and team performance, ensuring managers and users can easily track progress without navigating multiple sections.

ACE Dashboard overview

 

2. Prerequisites

 

3. Dashboard Functionalities

Navigate to Ace>Dashboard to view the Ace Dashboard.

Navigate to ace dashboard

Note: The Dashboard feature can be enabled or disabled from the settings page.

enable or disable ace dashboard

3.1 Hierarchy & User Reports

Managers can directly access their direct reports from the dashboard by clicking the direct reportees icon icon, this eliminates the need to navigate to Manage Users to check the hierarchy. Clicking on a team member’s name expands their detailed performance view, including:

  • Goals (Target vs. Achievement breakdown)
  • Incentives (Eligible vs. Approved payouts)
  • Leaderboard standing (User’s rank comparison)

ace dashboard user hierarchy

3.2 Dashboard Widgets

The ACE dashboard consists of multiple widgets that provide detailed insights into various performance aspects. Users can add, remove, or rearrange these widgets based on their requirements.

To edit the Dashboard –

  1. Click the icon.
  2. Toggle the Edit Page Layout option.
  3. Select ace dashboard manage widgets Manage Widgets.
  4. Select any widget to show on the dashboard.
    • Additionally, you can toggle the Display on Mobile option to display the widgets on the mobile app as well.
  5. You can save the dashboard for yourself or, if you’re an admin or manager, save it for all users in your hierarchy.
    • When selecting Save to All Users, you can either –
      • Save as Default – Set this configuration as the default for all users. Users can apply the changes by clicking Reset to Default in their dashboard settings.
      • Apply Changes Instantly – Instantly overwrites all user preferences with this configuration. Users will see the updated dashboard without needing to reset.
Note: The ACE Dashboard is also available to view on the LeadSquared Mobile App, but some widgets might not be available on the mobile view.

rearrange widgets and add widgets

3.2.1 Access & Permissions

  • Users: Can view only the My Achievement section, which focuses on their personal progress.
  • Admins & Managers: Have access to both My Achievement and Team Achievement, allowing them to view, compare, and manage performance across their reporting hierarchy.

ace dashboard team vs my achievement

 

4. Manage Widgets for My Achievement

The My Achievement section shows widgets that are accessible to Admins, Managers, and Users to track their personal progress.

All the available widgets in this section are listed below.

4.1 Total Pending Approval Widget

View the total pending approval incentives across all programs, along with the trend from last month.

 

4.2 Total Pending Payout Widget

View the total pending payout incentives across all programs, along with the trend from last month.

 

4.3 Total Earned Incentive Widget

View the total pending payout incentives across all programs, along with the trend from last month.

 

4.4 User Details Widget

User details include the goals, incentives, and leaderboard you are part of.

 

4.5 Goal Breakdown Widget

Automatically breaks down goals by cycle. Users can hover over data points for milestone progress, viewing current achievements, required progress, and remaining effort.

 

4.6 Ruleset Association Widget

Get a rapid overview of associated goals, incentive programs, and leaderboards according to the selected ruleset, with more useful details.

 

4.7 Compare Goals Widget

Easily compare multiple goals with the same cycle type. Access average, and required achievement details for convenient comparison.

 

4.8 Milestone View for Goal Widget

With quick view, you can easily access daily targets and required run rate information presented in a gamified interface.

 

4.9 Leaderboard Cycle Comparison Widget

Compare your rank and achievement details with other cycles from the same leaderboard and view trend details.

 

4.10 Incentive Cycle Comparision Widget

Compare your reward details with other cycles from the same incentive program and view trend details.

 

4.11 Goal Cycle Comparision Widget

Compare your achievement details with other cycles from the same goal and view trend details.

 

4.12 Incentive Rewards Overview Widget

Compare the monetary and non-monetary rewards of each incentive program you are part of.

 

4.13 Payout Trend Widget

Track your total payout trend for the selected and previous time periods across all incentives and leaderboards.

 

4.14 My Incentive Program Widget

Add an incentive program that is important to you and stay updated with eligible details and smart insights for the same.

 

4.15 Achievement v/s Incentive Calculation Widget

View achievement details for each metric within a single program, including the number of criteria achieved and the calculated incentive.

 

4.16 My Goals Widget

Access goal details and find out when they’re ending, whether it’s today, this week, this month, or next month.

 

4.17 Smart Insights Widget

Delivers real-time performance alerts, showing target gaps, required sales to meet goals, and peer comparisons (e.g., “Most team members have achieved X%, you are behind by Y%”). Encourages proactive goal completion with timely nudges.

 

5. Manage Widgets for Team Achievement

The Team Achievement section shows widgets that are accessible to Admins and Managers to track their team’s progress.

All the available widgets in this section are listed below.

5.1 Total Pending Approval Widget

View the total pending approval incentives across all programs, along with the trend from last month.

 

5.2 Total Pending Payout Widget

View the total pending payout incentives across all programs, along with the trend from last month.

 

5.3 Total Earned Incentive Widget

View the total pending payout incentives across all programs, along with the trend from last month.

 

5.4 Goal Breakdown Widget

Break down large goals into milestones and track your progress with daily targets and required run rate information to stay on track.

 

5.5 Ruleset Association Widget

Shows all Goals, Incentives, and Leaderboards linked to a rule set, helping managers understand target and reward structures within a specific policy.

 

5.6 Milestone View for Goal Widget

With quick view, you can easily access daily targets and required run rate information presented in a gamified interface.

 

5.7 Achievement v/s Incentive Calculation Widget

View achievement details for each metric within a single program, including the number of criteria achieved and the calculated incentive.

 

5.8 Smart Insights Widget

Delivers real-time performance alerts, showing target gaps, required sales to meet goals and peer comparisons. Encourages proactive goal completion with timely nudges.

 

5.9 Goals Overview

Shows all active goals for a user or team in one view, enabling managers to sort by performance and compare up to five goals side by side, reducing manual progress checks.

 

5.10 Goals Contribution

Quickly access information about goal contributions from both you and your team in a convenient view.

 

5.11 Leaderboard View Widget

View your rank and achievement details, along with the top 3 performers of a leaderboard. Pin any 3 leaderboards to receive real-time updates.

 

5.12 Goal User Comparision Widget

Compare the goal achievements of up to 5 users and track trends to identify who is lagging behind and who is performing the best.

 

5.13 Incentive Trends for User Widget

Compare the calculated incentives of up to 5 users and track trends to identify who is receiving more or less incentive in each cycle.

 

5.14 Eligible vs. Approved vs. Paid Out Widget

Compare the eligible, approved, and paid-out incentives across each cycle for any incentive program (e.g., eligible for $100, approved for $80, paid $50).

 

Any Questions?

Did you find this article helpful? Please let us know any feedback you may have in the comments section below. We’d love to hear from you and help you out!

Ameyo Preview Dialing Connector

1. Feature Overview

This connector transfers lead data in real-time from your LeadSquared account to your Ameyo account.

 

2. Prerequisites

  • You must be the Administrator of your LeadSquared account.
  • You must have an active Ameyo account.
  • This is a paid feature. To enable it, reach out to your account manager, or write to support@leadsquared.com.

 

3. How it Works

To push leads from LeadSquared to your Ameyo account, set up the Push data to Ameyo connector. Once configured, activate the connector sync.

During configuration, a webhook URL is generated in LeadSquared. Copy this URL and use it to configure an automation in your LeadSquared account. This automation will automatically push lead data from your LeadSquared account to your Ameyo account.

 

4. Installation

You must first install and configure the Ameyo connector.

  1. Navigate to Apps>Apps Marketplace.
  2. Search for Push data to Ameyo, and click Install.
    • Alternatively, you can find the connector on the left panel, under Telephony.
  3. Once installed, hover your cursor over , and click Configure.

4.1 Configure the connector

Once you’ve installed the connector, on the Configure Ameyo pop-up, configure the connector access for the non-Admin users in your account. Only users with access granted can view and access the connector under the Apps menu.

  1. Select if you want to grant Connector Access that’s Based on Role or Advanced (User Level).
    • Based on Role – From the Specify Roles dropdown, select the LeadSquared user roles that can use the connector.
    • Advanced (User Level) – In the Advanced (User Level) dropdown, choose a user boolean field. The user’s access to the connector is determined by the value in the selected boolean field. For example, for the user Sam, if the “Is Employee” boolean user field contains the value “Yes”, Sam can access the connector.
  2. Once you’re done, click Save Details. To continue the configuration, refer to the below sections.
Note: By default, all Admin users will have access to the connector.

 

 

5. Admin Configuration

To continue the connector configuration, navigate to Apps>Push data to Ameyo.

Ameyo LeadSquared integration

5.1 Basic Settings

Enter the following details –

Property Description
Hash-Key Pass your Ameyo account credentials.
Policy Name
Host
Lead Source Enter the lead source through which the leads were captured (e.g., Ameyo, email campaign, etc.). This detail will be displayed on the Lead Details page, under Lead Source.
Default Country Code If the lead’s mobile number is captured without a country code, the default country code that’s selected from the dropdown will be added to the lead’s mobile number.
Select Time Zone The time zone followed in your Ameyo account.
Lead Capture Search By Criteria To avoid duplicate leads, you must select one unique lead field (e.g., email Id, mobile number, PAN number, etc.) as the search key. This is used to identify the leads pushed from Ameyo.

To know how to mark a LeadSquared lead field as unique, please refer to How to Make a Custom Field Unique.

Lead Capture Secondary Search By Criteria If lead identification and capture through the primary Search By criteria fails, it will be re-attempted using the secondary Search By criteria.
Select User to Notify on Failure If there is an error in fetching leads, the selected user will receive a failure message via email. You can select a user from the list of all the users available in your LeadSquared account.

To know more about the type of errors, please refer to Error Notifications.

Enable Notification To ensure notification emails are sent to the selected user when there’s a failed query, enable the Checkbox checkbox.

Once you’ve entered all the details, click Save & Next.

 

5.2 Entity Options

Define the sync behavior of the connector when leads are captured.

5.2.1 Lead/Contact Entity
Since this connector pushes lead data from LeadSquared, the Sync Behaviour is by default set to Do Nothing. It is recommended you don’t change this to any other setting.

5.2.2 Mapping

On the Edit Mapping for Ameyo screen, the Ameyo system fields mapped to the corresponding LeadSquared lead fields are visible. This mapping is carried out by default. If required, you can change or update the default field mapping.

  • To provide a default value for any field, click  , enter the value under Default Value, and click Google.
    • If the data provider doesn’t send data for any lead field, then the default value will get assigned to that specific field. But if the field already has an existing value, then the default value will be ignored.
  • To disable lead data capture for any field, disable the Zoom slider.
  • You can also mark and update a unique lead field as the search key from this screen, by clicking unique icon

Once you’re done, click Save & Next.

Ameyo LeadSquared integration

 

5.3 Generate Webhook URL

A custom webhook URL is generated after providing basic details and completing field mapping. Copy this webhook URL and use it to create an automation that will transfer lead data to your Ameyo account.

After you’ve set up the webhook, click More Actions, and enable the sync job. This ensures that through the webhook, lead data from Ameyo is pushed to LeadSquared.

Note: To view logs of all the sync jobs that have taken place, from the More Actions dropdown, click View Logs.

Ameyo LeadSquared integration

 

6. Create an Automation

Use the Webhook URL to create an automation that send lead data to Ameyo.

  1. Navigate to Workflow>Automation, click Create Automation, and select a relevant trigger. We’re going with the New Lead trigger.
  2. Click Add Automation, and under Custom, click Webhook.
  3. On the Webhook pop-up, enter the following details –
    • Name – Enter a relevant name for the webhook. We’re calling it “Ameyo Lead Transfer Activity”.
    • URL – Select the method as https://, and paste the connector’s webhook URL that was generated in the previous step. Ensure you remove “https://” from the URL.
    • Content Type – Select application/json.
    • Save Response – You can select either Yes or No.
    • Custom Headers – You can skip this.
    • Notify on Failure – Select which user you want to notify if the webhook fails.
    • Retry Count – The number of times you want to retry when the webhook fails.
  4. Once you’re done, click Save, and then click Publish.
Note: To know more about the Webhook action, refer to User Automation Actions – Webhook.

Ameyo LeadSquared integration

 

7. View Logs

Here, you can view logs of all the sync jobs that have taken place. View New Events (New Leads), Updated Events (Updated Leads), and Errors (when transferring leads).

  1. Navigate to Apps>Ameyo.
  2. From the More Actions dropdown, click View Logs.
  3. You can filter the logs by selecting a date range (Today, Last 7 Days, This Month, and Last Month), by selecting the Job Status (“All”, “Success” and “Failure”), and by selecting the Sync Status (All, Error, and Success).
  4. You can view the sync status of the following events –
    • New Events – List of all the new leads that have been created in LeadSquared during the selected date range.
    • Updated Events – A list of all the –
      • Duplicate leads that were created with the same Search by Criteria value (e.g., with the same Email Id, Mobile Number, etc.).
      • Leads that previously contained errors, which were fixed and synced successfully.
    • Failed – The list of leads that have not been captured due to mapping errors (e.g., when a boolean field is mapped to an integer field, etc.).
  5. To view the Sync Response details, under Request ID/Sync Job ID, click the Id.
    • Under the right panel, you can view the response status, the API URL, the request, and the response.
    • The successful responses will contain the details of the leads that have been pushed from Ameyo.
    • To view the lead capture response under Sync API Response, Leads Updated and Errors in Leads, click Information.

Note:

  • For a response that contains an error, the reason for the error is listed in the response. Once you fix it, you can click the Retry button to perform the sync again.
  • The current Lead Sync Behaviour will reflect in the Logs screen. This will help identify the sync that’s used (Capture or Update) for the selected Request/Sync Job Id.

google forms view logs

 

8. Other Actions

You can edit or delete the Ameyo connector instance that you created. To do this –

  1. Navigate to Apps>App Marketplace, and search for Ameyo.
  2. Alongside the Ameyo connector, hover your cursor over .
  3. From the list of options, you can perform the following actions –
    • Edit Configuration
    • Disable Configuration
    • Remove Configuration

Ameyo LeadSquared integration

 

9. View Reports

You can view the total number of leads that have been pushed by Ameyo, by referring to the Lead Source report. To know more, please refer to How to track the source of your Leads using Lead Source Report?

 

Any Questions?

Did you find this article helpful? Please let us know any feedback you may have in the comments section below. We’d love to hear from you and help you out!

Mark Copy v2.0 Connector

1. Feature Overview

When conducting business interactions via email clients like Gmail, Outlook, and Apple email, capture the sender and recipient details as leads in LeadSquared through the Markcopy Connector. This connector captures the “From Email Address” and “To Email Address”, and posts the email as an activity in your LeadSquared account.

Note: If you’re using the older version of the Mark Copy connector, it is mandatory to migrate to the latest version since support for the previous version has been discontinued. To migrate, contact your account manager, or write to support@leadsquared.com.

 

2. Prerequisites

  • You must be the Administrator of your LeadSquared account to install and configure this connector.
  • This is a paid connector. To enable it, reach out to your account manager, or write to support@leadsquared.com.

 

3. How it Works

In LeadSquared

This connector effortlessly captures lead details from your emails without requiring an elaborate setup process. Once connector access is enabled on your account, install and configure the connector. Once the connector is enabled, an email ID is generated.

In your email client (Gmail, Outlook, etc.)

For outbound emails, include this email ID in the CC or BCC fields in your email client when sending emails to your leads. For inbound emails, create an auto-forward rule in your email client to forward these emails to the generated email ID. This process captures lead details and posts the email as an activity in your LeadSquared account.

 

4. Install the Connector

  1. Navigate to Apps>Apps Marketplace.
  2. Search for Mark Copy Connector v2.0, and click Install.
    • Alternatively, you can find the connector on the left panel, under Email.
  3. Once installed, hover your cursor over , and click Configure.

 

5. Configure the Connector

Once you’ve installed the connector, on the Mark Copy Connector v2.0 pop-up, configure the connector access for the non-Admin users in your account. Only those users for whom access is granted can view and access the connector (under the Apps main menu).

  1. Select if you want to grant Connector Access that’s Based on Role or Advanced (User Level).
    • Based on Role – From the Specify Roles dropdown, select the LeadSquared user roles that can use the connector.
    • Advanced (User Level) – From the Advanced (User Level) dropdown, select a user boolean field. Based on the value entered in the selected boolean field, the user can access the connector (e.g., for the user Sam, if the “Is Employee” boolean user field contains the value “Yes”, then this user can access the connector).
  2. Once you’re done, click Save Details. To continue the configuration, refer to the below sections.
Note: By default, all Admin users will have access to the connector.

Mark Copy LeadSquared integration

 

6. Admin Configurations

To continue the connector configuration, navigate to Apps>Mark Copy Connector v2.0.

Mark Copy LeadSquared integration

6.1 Basic Details

Enter the following details –

Property Description
Lead Source Enter the lead source through which the leads were captured (e.g., Mark Copy, email campaign, etc.). This detail will be displayed on the Lead Details page, under Lead Source.
Default Country Code If the lead’s mobile number is captured without a country code, then the default country code that’s selected from the dropdown will be added to the lead’s mobile number.
Select Time Zone The time zone followed in your Mark Copy account.
Lead Capture Search By Criteria To avoid creating duplicate leads, you must select one unique lead field (e.g., email Id, mobile number, PAN number, etc.) as the search key.

To know how to mark a LeadSquared lead field as unique, please refer to How to Make a Custom Field Unique.

Lead Capture Secondary Search By Criteria If lead identification and capture through the primary Search By Criteria fails, it will be re-attempted using the secondary Search By Criteria.
Select User to Notify on Failure If there is an error in fetching leads, the selected user will receive a failure message via email. You can select a user from the list of all the users available in your LeadSquared account.

To know more about the type of errors, please refer to Error Notifications.

Enable Notification To ensure notification emails are sent to the selected user when there’s a failed query, enable the Checkbox checkbox.

Once you’re done entering all the details, click Save & Next.

 

6.2 Mapping

Once you’re done with the basic settings, click Entity Options. By default, all the Mark Copy fields are mapped to the corresponding LeadSquared lead fields. You’ll have to complete two steps here –

  1. Activity Type(s) Definitions* – Alongside Email Sent – MCC and Email Received – MCC, click the Create Activity button.
  2. Edit Mapping – Alongside each action (Activity Entity and Lead/Contact Entity) click the Edit Mapping button to verify if the field mapping is accurate. Once verified, click Save & Close. This step is mandatory.
    If required, on the Edit Mapping pop-up, you can edit the field mapping –

    • To edit the Mark Copy mapping field name, click  , and under Mapping Key, edit the field name.
    • To change the LeadSquared lead field to which the Mark Copy field is mapped, click  , and from the Lead Field dropdown, select the new lead field.
    • To mark a unique lead field as the search key, click unique icon.
    • To disable an existing field mapping, alongside the field, disable the slider Zoom.
    • Click the Update if Empty checkbox if you don’t want to update the value of a field every time the sync takes place.
      • This is helpful to prevent re-updating important/sensitive identification-related fields like Social Security Numbers, PAN Card numbers, etc.
    • To map an additional field, click the Add Custom button, and add the new mapping field details.
    • If you want to capture any additional responses as part of the activity that’s posted on the lead, alongside Activity Entity, click Edit Mapping, and add the response on the Default Mapping for Activity pop-up.

Once you’re done, click Save & Next.

Note:

  • *Ensure you complete the Create Activity steps first, and only then complete the Edit Mapping steps.
  • You must mandatorily verify the mapping for Lead/Contact Entity, and Activity Entity, and click Save & Close for each action type, to complete the Mapping.
  • When an email sent/received activity is posted, an automatic corresponding invalid activity is generated. This occurs because the email activity can only be categorized as either email sent or email received, and not both. Since both activities are triggered by the movement of the email, the invalid activity is posted. You can ignore this, and it doesn’t impact the connector’s functionality.

Mark Copy LeadSquared integration

 

6.3 Mark Copy – Configuration

Click More Actions, and enable the sync job. Once enabled, under How to extract information from Email, a custom email ID is generated for your account.

Copy this ID and utilize it to capture lead details in your LeadSquared account.

  • For inbound emails, set up an auto-forward rule to send these mails to the generated email ID.
  • For outbound emails, paste this email ID in the CC or BCC fields.

This process captures lead details and posts the email as an activity in your LeadSquared account.

 

7. Steps in your Email Client

Complete the following steps in your email client account (Outlook, Gmail, etc.) –

7.1 To Capture Inbound Emails as Leads

  1. Set up an auto-forward rule in your email client to send a copy of the email to your Mark Copy email ID.
  2. The sender becomes a lead, and the email is recorded as a Lead Activity.

7.2 To Capture Outbound Emails as Leads

  1. Paste the Mark Copy email ID in the CC or BCC of your outbound emails.
  2. The recipients in the “To” field become leads, and the email is recorded as a Lead Activity. Note that addresses in CC or BCC are not considered for lead creation.
  3. Emails sent using Mark Copy are not trackable, meaning open and click events on such emails are not captured.
  4. If a recipient’s reply is copied to the Mark Copy email ID, the reply is also captured as a Lead Activity in LeadSquared.

LeadSquared Mark Copy Connector

 

8. View Activities

To view the email activity, navigate to Leads>Manage Leads, and click on the lead where the activity is posted. On the Lead Details page, view the activity under the Activity History tab.

LeadSquared Mark Copy Connector

 

9. View Logs

Here, you can view logs of all the sync jobs that have taken place.

  1. Navigate to Apps>Mark Copy, and click More Options, and then click View Logs.
  2. You can filter the logs by selecting a date range (Today, Last 7 Days, This Month, and Last Month), by selecting the Job Status (“All”, “Success” and “Failure”), and by selecting the Sync Status (All, Error, and Success).
  3. You can view the sync status of the following events –
    • New Events – List of all the new payment activities posted in your account.
    • Errors – The list of unsuccessful payment activities that have not been captured due to mapping errors (e.g., when a boolean field is mapped to an integer field, etc.).
  4. To view the Sync Response details, under Request ID/Sync Job ID, click the Id.
    • Under the right panel, you can view the response status, the API URL, the request, and the response.
    • The successful responses will contain the details of the leads that have been pushed by MarkCopy.
    • To view the lead capture response under Sync API Response, Leads Updated and Errors in Leads, click Information.

Note:

  • For a response that contains an error, the reason for the error is listed in the response. Once you fix it, you can click the Retry button to perform the sync again.
  • The current Lead/Activity Sync Behaviour will reflect in the Logs screen. This will help identify the sync that’s used (Capture or Update) for the selected Request/Sync Job Id.

google forms view logs

 

10. Other Actions

You can edit or delete the Mark Copy connector that you created. To do this –

  1. Navigate to Apps>Apps Marketplace and search for the Mark Copy connector.
  2. On the Mark Copy connector, click Settings.
  3. From the list of options, you can perform the following actions –
    • Edit Configurations
    • Disable the connector
    • Remove the connector

LeadSquared Mark Copy Connector

 

11. View Reports

You can view the total number of leads that have been pulled from Mark Copy, by referring to the Lead Source report. To know more, please refer to How to track the source of your Leads using Lead Source Report?

 

Any Questions?

Did you find this article helpful? Please let us know any feedback you may have in the comments section below. We’d love to hear from you and help you out!

Push Data to CleverTap

1. Feature Overview

This connector transfers lead data in real time from your LeadSquared account to your CleverTap account.

 

2. Prerequisites

  • You must be the Administrator of your LeadSquared account.
  • You must have an active CleverTap account.
  • This is a paid feature. To enable it, reach out to your account manager, or write to support@leadsquared.com.

 

3. How it Works

To push leads from LeadSquared to your CleverTap account, set up the Push data to CleverTap connector. Once configured, activate the connector sync.

During configuration, a webhook URL is generated in LeadSquared. Copy this URL and use it to configure an automation in your LeadSquared account. This automation will automatically push lead data from your LeadSquared account to your CleverTap account.

 

4. Installation

You must first install and configure the CleverTap connector.

  1. Navigate to Apps>Apps Marketplace.
  2. Search for Push data to CleverTap, and click Install.
    • Alternatively, you can find the connector on the left panel, under Marketing.
  3. Once installed, hover your cursor over , and click Configure.

4.1 Configure the connector

Once you’ve installed the connector, on the Configure CleverTap pop-up, configure the connector access for the non-Admin users in your account. Only users with access granted can view and access the connector under the Apps menu.

  1. Select if you want to grant Connector Access that’s Based on Role or Advanced (User Level).
    • Based on Role – From the Specify Roles dropdown, select the LeadSquared user roles that can use the connector.
    • Advanced (User Level) – In the Advanced (User Level) dropdown, choose a user boolean field. The user’s access to the connector is determined by the value in the selected boolean field. For example, for the user Sam, if the “Is Employee” boolean user field contains the value “Yes”, Sam can access the connector.
  2. Once you’re done, click Save Details. To continue the configuration, refer to the below sections.
Note: By default, all Admin users will have access to the connector.

Clevertap LeadSquared integration

 

5. Admin Configuration

To continue the connector configuration, navigate to Apps>Push data to CleverTap.

Clevertap LeadSquared integration

5.1 Basic Settings

Enter the following details –

Property Description
CleverTap Account ID Pass your CleverTap account credentials.
CleverTap Passcode
Lead Source Enter the lead source through which the leads were captured (e.g., CleverTap, email campaign, etc.). This detail will be displayed on the Lead Details page, under Lead Source.
Default Country Code If the lead’s mobile number is captured without a country code, the default country code that’s selected from the dropdown will be added to the lead’s mobile number.
Select Time Zone The time zone followed in your CleverTap account.
Lead Capture Search By Criteria To avoid duplicate leads, you must select one unique lead field (e.g., email Id, mobile number, PAN number, etc.) as the search key. This is used to identify the leads pushed from CleverTap.

To know how to mark a LeadSquared lead field as unique, please refer to How to Make a Custom Field Unique.

Lead Capture Secondary Search By Criteria If lead identification and capture through the primary Search By criteria fails, it will be re-attempted using the secondary Search By criteria.
Select User to Notify on Failure If there is an error in fetching leads, the selected user will receive a failure message via email. You can select a user from the list of all the users available in your LeadSquared account.

To know more about the type of errors, please refer to Error Notifications.

Enable Notification To ensure notification emails are sent to the selected user when there’s a failed query, enable the Checkbox checkbox.

Once you’ve entered all the details, click Save & Next.

 

5.2 Entity Options

Define the sync behavior of the connector when leads are captured.

5.2.1 Lead/Contact Entity
Since this connector pushes lead data from LeadSquared, the Sync Behaviour is by default set to Do Nothing. It is recommended you don’t change this to any other setting.

5.2.2 Mapping

On the Edit Mapping for Clevertap Call back disposition screen, the CleverTap system fields mapped to the corresponding LeadSquared lead fields are visible. This mapping is carried out by default. If required, you can change or update the default field mapping.

  • To provide a default value for any field, click  , enter the value under Default Value, and click Google.
    • If the data provider doesn’t send data for any lead field, then the default value will get assigned to that specific field. But if the field already has an existing value, then the default value will be ignored.
  • To disable lead data capture for any field, disable the Zoom slider.
  • You can also mark and update a unique lead field as the search key from this screen, by clicking unique icon

Once you’re done, click Save & Next.

Clevertap LeadSquared integration

5.3 Generate Webhook URL

A custom webhook URL is generated after providing basic details and completing field mapping. Copy this webhook URL and use it to create an automation that will transfer lead data to your CleverTap account.

After you’ve set up the webhook, click More Actions, and enable the sync job. This ensures that through the webhook, lead data from CleverTap is pushed to LeadSquared.

Note: To view logs of all the sync jobs that have taken place, from the More Actions dropdown, click View Logs.

Clevertap LeadSquared integration

 

6. Create an Automation

Use the Webhook URL to create an automation that send lead data to CleverTap.

  1. Navigate to Workflow>Automation, click Create Automation, and select a relevant trigger. We’re going with the New Lead trigger.
  2. Click Add Automation, and under Custom, click Webhook.
  3. On the Webhook pop-up, enter the following details –
    • Name – Enter a relevant name for the webhook. We’re calling it “CleverTap Lead verification Activity”.
    • URL – Select the method as https://, and paste the connector’s webhook URL that was generated in the previous step. Ensure you remove “https://” from the URL.
    • Content Type – Select application/json.
    • Save Response – You can select either Yes or No.
    • Custom Headers – You can skip this.
    • Notify on Failure – Select which user you want to notify if the webhook fails.
    • Retry Count – The number of times you want to retry when the webhook fails.
  4. Once you’re done, click Save, and then click Publish.
Note: To know more about the Webhook action, refer to User Automation Actions – Webhook.

Clevertap LeadSquared integration

 

7. View Logs

Here, you can view logs of all the sync jobs that have taken place. View New Events (New Leads), Updated Events (Updated Leads), and Errors (when transferring leads).

  1. Navigate to Apps>CleverTap.
  2. From the More Actions dropdown, click View Logs.
  3. You can filter the logs by selecting a date range (Today, Last 7 Days, This Month, and Last Month), by selecting the Job Status (“All”, “Success” and “Failure”), and by selecting the Sync Status (All, Error, and Success).
  4. You can view the sync status of the following events –
    • New Events – List of all the new leads that have been created in LeadSquared during the selected date range.
    • Updated Events – A list of all the –
      • Duplicate leads that were created with the same Search by Criteria value (e.g., with the same Email Id, Mobile Number, etc.).
      • Leads that previously contained errors, which were fixed and synced successfully.
    • Failed – The list of leads that have not been captured due to mapping errors (e.g., when a boolean field is mapped to an integer field, etc.).
  5. To view the Sync Response details, under Request ID/Sync Job ID, click the Id.
    • Under the right panel, you can view the response status, the API URL, the request, and the response.
    • The successful responses will contain the details of the leads that have been pushed from CleverTap.
    • To view the lead capture response under Sync API Response, Leads Updated and Errors in Leads, click Information.

Note:

  • For a response that contains an error, the reason for the error is listed in the response. Once you fix it, you can click the Retry button to perform the sync again.
  • The current Lead Sync Behaviour will reflect in the Logs screen. This will help identify the sync that’s used (Capture or Update) for the selected Request/Sync Job Id.

google forms view logs

 

8. Other Actions

You can edit or delete the CleverTap connector instance that you created. To do this –

  1. Navigate to Apps>App Marketplace.
  2. Search for CleverTap.
  3. Alongside the CleverTap connector, hover your cursor over .
  4. From the list of options, you can perform the following actions –
    • Edit Configuration
    • Disable Configuration
    • Remove Configuration

Clevertap LeadSquared integration

 

9. View Reports

You can view the total number of leads that have been pushed by CleverTap, by referring to the Lead Source report. To know more, please refer to How to track the source of your Leads using Lead Source Report?

 

Any Questions?

Did you find this article helpful? Please let us know any feedback you may have in the comments section below. We’d love to hear from you and help you out!

Automation Failure Report

1. Feature Overview

The Automation Failure Report gives you details on why your automation failed and displays all the action cards that failed in an automation. You can view the reason for failure and retry these cards after making the relevant changes. You can also view the entity-level automation summary directly from this page. To know more about Automation, refer to Automation – Feature Guide.

Note: The Automation Failure Report will not display leads that have been deleted or merged.

 

2. Prerequisite

You must be the Administrator of your LeadSquared account.

 

3. Automation Failure Report

To view the Automation Failure Report –

  1. Navigate to Workflow>Automation.
  2. Under Related Settings, select Automation Failure Report.
  3. On this page, you can view all the failed automations. To filter the reports based on a date range, click the dropdown next to Date Range.
  4. To view the failed cards in the automation and the reason for failure, click the automation.
  5. To retry all the failed cards in the automation, alongside the name of the automation, hover your cursor on LeadSquared. Then, click Retry All.
  6. To retry a specific failed card in the automation, alongside the card, click Retry Icon.
  7. To view the entity for which the automation failed, click on the entity. You will be redirected to the entity level report of the automation. On this page –
    • To view the reason for failure of execution, on the failed card, click information.
    • To retry the failed card in the automation, click retry icon.

Note:

  • In the Entity Level Automation Report – 
    • Green arrows between the cards denote successful execution of the card.
    • Dotted lines between the cards denote that the execution is still under progress.
    • Red arrows between the cards denote failed execution of the card.
  • Once you retry the failed card, if they’re successful, they will be removed from the failure report.

LeadSquared - Automation failure report

 

4. Enable Email Notifications on Automation Failure

Notify relevant users through email when the automation fails. An email notification is sent to selected users on the first failure of a particular automation per day. To enable this setting –

  1. Navigate to My Profile>Settings>Profile>Advanced Configuration.
  2. Search for the Enable Email Notification on Automation Failure setting.
  3. Alongside this setting, click Configure.
  4. To filter the available users based on their role, alongside Filter By Role, click the dropdown.
  5. Select the relevant users under Available Users and click Right Arrow.
  6. To unselect any users from being notified, click their name under Users to be Notified and click Left Arrow icon.
  7. Click Save.

Note: Upto 20 users can be selected as the recipients for the Automation Failure Notification.

LeadSquared - Enable User Notification on Failed Automation

 

FAQs

Why does the Automation failure report show “Error in Evaluating multi If/Else due to datatype mismatch“.
If a field used in the Multi If/Else condition is later removed from Activity Fields in settings but is still referenced in the automation, the automation will fail at the If/Else card. Check if any fields used in the If/Else condition have been deleted from Activity Fields. If found, update or remove them from the automation to resolve the issue.

 

Any Questions?

Did you find this article helpful? Please let us know any feedback you may have in the comments section below. We’d love to hear from you and help you out!

Create Leaderboards

1. Feature Overview

Use LeadSquared Leaderboards to increase the overall productivity and revenue of your organization. The Leaderboards feature revolves around gamification – mundane tasks like calling prospects, setting meetings, and closing deals turn into fun activities for your sales users. Based on the criteria and targets you have set (for example, revenue targets), your users will be ranked against each other on their achievements and can be rewarded based on their final ranks.

overview main

 

2. Prerequisites

  • Only Admins can create Leaderboards.
  • To create Leaderboards through Rulesets, you must have a published Ruleset.
  • To create Leaderboards through Goals, you must have a published Goal.
  • Ensure that the Organization Hierarchy for your organization is set up.

 

3. Create Leaderboards Through Rulesets

  1. Navigate to Ace>Leaderboard>Manage Leaderboard>Create Leaderboard.
  2. Enter a Program Name and Program Description. Once done, click Create.

create

 

4. Configure the Leaderboard Attributes

Here, you’ll select a Ruleset that will later be used to define the rewards. For example, if you select a ‘Revenue’ rule set here, the rewards will be calculated on the revenue metric defined in your ruleset.

Click Select Rulesets. You can select up to 5 Rulesets. Once done, click Use Selected Rulesets.

Note: Rulesets are used to define and measure a variety of sales performance metrics. To learn more, see How to Create a Ruleset.
leaderboard select ruleset

Next, you must select a Calculation Type.

incentives rollup vs non rollup

  • Roll Up – In a Roll Up calculation, the result will be the summation of the achievements of the entire team in the hierarchy.
    • For Example, the reward is paid out to the users based on the total revenue generated by the entire team.
  • Non Roll Up – In a Non Roll Up calculation, the result will depend only on the individual achievements of the users.
    • For example, the reward is paid out to the users based on the revenue generated individually.

leaderboard calculation type

Set the Leaderboard Duration.

  1. Select the Leaderboard Cycle – The total reward will be calculated based on the completion of each cycle. For example, if you want to reward users based on their daily achievements, select Daily.
  2. Select the First Cycle Date Range – Select the start date for the leaderboard program.
  3. Select the Last Cycle Date Range – Select the end date for the leaderboard program.

Note:

  • If you select Weekly as your Leaderboard Cycle duration –
    • By default the starting day of the week is Monday. This cannot be changed to a different day.
    • You can set the Cycle Start Date to Monday for the present week, even if your current day is Wednesday.
  • If you select Monthly as your Leaderboard Cycle duration, you can set the Cycle Start Date to any day in the current month only. For example, if the current date is 10th February, you can set the Cycle Start Date to 1st February (but not 25th January).
  • The maximum Goal Cycle duration for –
    • Daily is 700 Goal Cycles.
    • Weekly is 104 Goal Cycles.
    • Biweekly is 52 Goal Cycles.
    • Monthly is 24 Goal Cycles.
    • Quarterly is 10 Goal Cycles.
    • Yearly is 16 Goal Cycles.
    • Custom is 700 Days (to configure a Custom Cycle for the Leaderboard, refer to this article).

In the following example, the Leaderboard Program will have a Daily Cycle. The First Cycle of the program will start and end on the 15th of May. On completion of the first cycle, the rewards (if any) can be disbursed. The program will repeat until its Last Cycle, which is on the 22nd of August.

leaderboard cycle

Select the number of Buffer Days for each Cycle. Buffer Days let users edit or revise their tasks and activities in the event of a missed deadline, resulting in more accurate reward calculations.

Note:

  • DailyWeekly, and Biweekly cycles can have buffer days from 0 to 30 days.
  • MonthlyQuarterly, and Yearly cycles can have buffer days from 0 to 90 days.

leaderboard buffer days

Click Save & Next to move to the next stage.

leaderboard save next 1st

 

5. Select the Leaderboard Users and Approvers

Program users are sales users eligible for the incentives. Approvers are usually team leads and sales managers (or someone higher up in the organization hierarchy) who can edit, reject or approve the incentive.

There are three ways to add your users –

Note: You can add different users to each cycle. So for example, you can add John and Frank to the first cycle and add John and Sally to the next cycle.

1. Type of Selection

Select a cycle through the dropdown and add the users who will be part of the program.

leaderboard select users

 

2. Add Users Using Excel

You can import users through an Excel file. To do this, click Add Users Using Excel. You can use the Sample File to add the users.

leadboards add users excel

3. Create Leaderboard Groups

You can also add users by selecting user attributes to create Leaderboard Groups. For example, you can create two Leaderboard Groups by selecting the users’ Sales Regions.
  1. Click Create Leaderboard Groups.
  2. Select the User Attribute you want to group the users by.
  3. Add the users from the User Attribute that you have selected. You need a minimum of two groups.
  4. Click Done.
Note: It is not possible to have different User attributes for different Leaderboard cycles.
leaderboard user groups

Next, you can copy the users that you have added to different cycles –

  1. Click Copy Users to Selected Cycles.
  2. You can click on the Filter option to select a specific year you want to copy to.
  3. Next, select the cycles where the users will be added – you can select individual cycles or all cycles.
  4. Once done, click Copy Users to Selected Cycles.

leaderboard copy users to different cycles

Now, you must select the user(s) who will be responsible for approving the rewards once they are calculated –

  1. Click Edit to select the approvers.
  2. You can change the Stage 1 approver by clicking the Change button.
  3. Enter the name or email address of the approver.
  4. Click on Add Stage + if you would like to add an additional approver.
  5. Once done, click Save & Next.

Note:

  • You can have a minimum of 1 and a maximum of  3 approvers.
  • The reward approval must pass through all stages of approvers.
  • An approver in a higher stage can override a decision made by the approver in a previous stage.
    • For example, if a Stage 1 approver has rejected a payout, the Stage 2 approver can override and approve the payout.
  • Admin users can approve or reject rewards on behalf of all the assigned approvers.

leaderboard add approvers

 

6. Set Up Rewards and Targets

6.1 Minimum Achievement Target

Set a Minimum Achievement Target. Rank Based Rewards and Group Rewards will only be disbursed when they reach the target. This step is optional and it can be left blank.

leaderboard minimum target

6.2 Winners & Trophies

Select the winning ranks for the award trophies.

leaderboards winner config

6.3 Group Target

You can now set the Group Target and Reward. If the team as a whole reaches the defined target, then they will be eligible for a reward.

  1. Enter a target.
  2. Toggle Mandatory Group Target leaderboard toggle to make the target mandatory – if the Group Target is not met, then Leaderboard winners will not receive their group and rank rewards.
  3. Next, you can configure Rewards
    1. Click Add Reward.
    2. Select the reward calculation.
    3. Enter the reward value.
    4. Click Add Reward.
    5. To add an additional reward, click on the leaderboard add reward icon.
Reward Calculation Description Example
Fixed The reward is a fixed amount. A fixed payout of Rs. 1000
Percentage of Achievement The reward is a percentage of the achievement generated by the user. 5% of the total revenue generated by the user.
Multiplier The reward is a multiple of the achievement generated by the user. For each lead generated, the user will get Rs. 100.

leaderboard group target

6.4 Tie Breaker

If multiple users have reached the same target, and you would like to reward only one, then you can consider configuring a Tie Breaker. For now, this configuration has the Fastest Achiever option – the user who reaches their target first will take the rank.

leaderboard tie breaker

6.5 Rank Based Rewards

Next, you can set the rank-based rewards based on the Leaderboard. You can set the reward for –

  • Individual Rank – You can configure the rewards for each rank individually.
  • Multiple Ranks – You can configure the rewards for a range of ranks.

Once you have selected a rank, you can add the rewards –

Reward Calculation Description Example
Fixed The reward is a fixed amount. A fixed payout of Rs. 1000
Percentage of Achievement The reward is a percentage of the achievement generated by the user. 5% of the total revenue generated by the user.
Multiplier The reward is a multiple of the achievement generated by the user. For each lead generated, the user will get Rs. 100.

leaderboard rank awards

You can also configure Custom Rewards for your users, such as vouchers, travel experiences, gadgets, and more. To do this, first create a custom reward by navigating to the ACE Settings page and selecting Custom Rewards. Once created, the reward will be available for selection in the Rewards section when configuring your Leaderboard.

configure custom rewards on leaderboard

6.6 Compare KPIs

Leaderboards support additional KPI columns, allowing users and admins to compare performance across multiple key metrics alongside the primary leaderboard rankings.

Adding KPIs to a Leaderboard

User’s who are configuring the Leaderboard can select up to five KPIs. These KPIs appear as individual columns on the leaderboard, helping track specific performance parameters that may or may not contribute to the primary KPI selected in Step 1.

For example, if the main rule set measures overall achievement, you can include KPIs such as:

  • Calls Connected
  • Meetings Done
  • Walk-ins
  • Face to Face Meetings

multimetric leaderboard

To publish the Leaderboard program, click Publish.

leaderboard publish

 

7. Create Leaderboards through Goals

If you have a Goal set up for your organization or team, you can also build a Leaderboard for it –

7.1 Program Attributes

  1. In the Attributes section, set up the RulesetsCalculation Type, and Program Duration (refer to section 4 for a detailed walkthrough of the Attributes setup).
  2. Toggle the switch incentives through programs yes for Connect Goals With Leaderboard.
  3. Click +Add Goals.
  4. The Goals matching the program attributes will be shown.
  5. Select the Goals for the Leaderboard.
  6. Click Use Selected Goals.
  7. Click Yes, Use Selected Goals.
Note: You can select multiple Goals in a Leaderboard.

goals leaderboard

7.2 User & Groups

The users are automatically inherited from the Goal. To make any changes to the user list, you will need to edit the list in your Goal configuration.

Note: Refer to section 6 to set up Rewards & Targets.

goals users

 

Next Steps

The View and Manage Leaderboards article will show you how to view the Leaderboards calculations, approve payouts, and manage the progress of the Leaderboard program.

 

Any Questions?

Did you find this article helpful? Please let us know any feedback you may have in the comments section below. We’d love to hear from you and help you out!

View and Manage Leaderboards

1. Feature Overview

This article will show you how to view the Leaderboards calculations, approve payouts, and manage the progress of the Leaderboards.

Note: LeadSquared Leaderboards helps you increase the overall productivity and revenue of your organization through gamification. Before you continue with this article, you must first Create a Leaderboard.

 

2. Prerequisites

  • You must have a published Leaderboard.
  • Only Admins and the assigned Approvers can approve or reject the rewards.

 

3. How it Works

Approvers

Approvers will have access to the ApprovalDashboard, and My Boards tabs on the Leaderboards page. They must approve all the eligible rewards of the users before they can be paid out –

  1. Navigate to Ace>Leaderboards>Approval to approve the rewards.
    1. Once you select a Leaderboard, you can view the reward calculation for all the users in the Leaderboard.
    2. Select a user to either approve or reject the reward.
  2. The Dashboard will give you a complete picture of your team’s eligible rewards, approved rewards, the rewards that are paid out, and pending payouts.

leaderboard approver view

Admins

An Admin will have access to all Leaderboard features.

  1. An Admin can approve rewards on the Approvers’ behalf.
  2. Only Admins can make payouts to the users.
    1. Navigate to Ace>Leaderboards>Payout to get detailed information on the payouts that are pending.
    2. Select a user to make a payout for.
  3. The Dashboard gives Admins a complete picture of their organization’s eligible rewards, approved rewards, the rewards that are paid out, and pending payouts.

leaderboard admin view

Sales User

Sales Users will only have access to the My Boards page. Here, they can keep track of their approval requests, payouts, and showcase the rewards and recognition they have received.

my boards view

Note: Under Leaderboard Settings, admins and super admins can enable or disable the Earnings Breakdown section across all leaderboards. When disabled, payout and earnings data are hidden from all users.

disable earnings summary

 

4. Reward Approval

Navigate to the user approval page –

  1. Navigate to Ace>Leaderboards>Approval.
  2. Select a Leaderboard.
  3. Select a Cycle.
  4. Select a user.

Note:

  • The Approval page can only be accessed by Admins and Approvers.
  • Admins can approve rewards on behalf of the Approvers.

leaderboard approval nav

Click on No. of Criteria Achieved. Here, you can view the Leaderboard Reward Criteria achieved by the user. You can view further information regarding the Achieved Value and the Rewards they are eligible for based on reward calculation.

leaderboard criteria achieved

The Approval Status displays the approval stage for the user. In the following example, we have 2 approvers. Stage 1 needs to be approved first. The Eligible Amount (based on reward calculation) for the user is Rs. 2,160. You can enter the entire amount as the Approved Amount, or choose an appropriate amount. To reject the entire amount, enter 0 (zero). Next, enter a Remark and click Forward to Stage 2.

1st stage approval

In Stage 2, as higher-stage approver, you can override the decisions taken by the lower-stage approver. You can edit the amount that has been approved in the 1st stage – the approval or rejection from the last stage will be final. Once you are satisfied with the approved amount, click Proceed to move to the Payout stage.

2nd stage approval

Note: An approver in a higher stage can also send back the approval to a lower stage.

send back approval

 

5. Leaderboards Payout

Navigate to the payout page –

  1. Navigate to Ace>Leaderboard>Payout.
  2. You can filter the page by User View or Program View.
  3. Select a user.
Note: The Payout page can only be accessed by Admin users.

payout nav

Here, you can view the rewards that have been approved. Once you have paid out the rewards, you can enter the payment details on this page and click Proceed with Payout – the Payout Status will be updated to Paid Out. If you have paid only a part of the approved amount, the Payout Status will still reflect as Pending.

leaderboard approval payout done

Note: You can also request a re-approval of the rewards from the last stage approver. Click Send Back to Approval. This option is not available if a partial amount has been paid out.

payout send back

You can also make payouts to the users through an Excel file. To do this, click Payout Using Excel. You can use the Sample File to add the payouts.

payout using excel

 

6. Leaderboards Dashboard

The Leaderboards Dashboard gives you a breakdown of the progress of the Leaderboards.

Navigate to Ace>Leaderboards>Dashboard.

Note: The Leaderboards Dashboard can only be viewed by Admins and Approvers.

dashboard nav

Select a Time Frequency for the total breakdown in that time frame. If you are an Admin user, you can also select a specific Manager.

dashboard time frequence

You can also drill down further into the Leaderboards under the User View and Program View.

dashboard user prog view

 

7. My Boards

Navigate to Ace>Leaderboards>My Boards. The My Boards page displays all the payout requests, approval requests, rewards received, collectable showcase, and their ranking in the Leaderboards for the respective user. This helps the sales users track all their achievements and keep a check on the rewards that need to be disbursed.

Note: The My Boards page can be accessed by all users that are a part of the Leaderboard.
My boards

 
In the Board Standings view:

  • The leaderboard ranks users based on the main rule set.
  • Two column groups—Rules and KPIs—are displayed:
    • Rules show the individual rules within the selected rule set.
    • KPIs show the additional metrics configured.
  • Users can sort the leaderboard by any KPI column to view performance for that specific metric.

This enables admins and team members to analyze rankings not only by the overall score but also by individual KPIs.

view kpi leaderboard

 

8. LeadSquared Mobile App – Leaderboards

You can also track the progress of your LeadSquared Leaderboards through the LeadSquared Mobile App. The Mobile App will have three different views: Admin user view, Sales Manager view, and Sales User view.

Note: You cannot edit or create Leaderboards through the LeadSquared Mobile App.

Leaderboards Admin View

Navigate to the LeadSquared Ace tab by clicking on the ace icon icon. Next, click on the Ace options icon and select Leaderboards.

Leaderboard mobile nav

On the Dashboard, you can view all the Leaderboards assigned to a Manager. You can select a specific Manager through the dropdown.

Leaderboard mobile managers

You can click on thegoals filter icon to apply a Time Frequency Filter.

Leaderboard mobile filter

As an Admin, you can view the Eligible rewards, Approved rewards, Total Payout Done, and Pending for Payout statistics for all Leaderboards, or a Leaderboard assigned to a specific Manager.

Dashboard stats

You can toggle between the statistics of individual users by selecting User View or individual Leaderboards by selecting Board View.

leaderboard user board view

Select a user or a Leaderboard to drill down into its details and progress.

Leaderboard drilldown

Leaderboard Sales Manager View

If you log in as a Sales Manager, you can view the progress of your Leaderboard through the Dashboard (Leaderboards where you are the Manager) and My Boards (if you are part of a Leaderboard) tabs.

Leaderboard mobile Manager View

Leaderboard Sales User View

If you log in as a Sales User, you view the progression of all the Leaderboards you are a part of through the My Boards tab.

Leaderboards sales user view

Any Questions?

Did you find this article helpful? Please let us know any feedback you may have in the comments section below. We’d love to hear from you and help you out.