Distribution Engine

1. Feature overview

Distribution Engine is a simple, rules-based way to automatically assign Leads and Opportunities to the right users. It replaces complex automation-based assignment with an easy-to-manage setup that helps you distribute records fairly, reduce manual effort, and meet response SLAs.

You can use Distribute Engine to:

• Automatically assign new records as soon as they are created or updated.
• Distribute work evenly across users using predefined methods.
• Reassign records if a user does not act on them within a defined time (SLA).
• Track assignments and SLA breaches from a single dashboard.

When should you use Distribute Engine?

Use this feature if you want to:

• Assign incoming leads from forms, imports, APIs, or integrations automatically.
• Balance workload across sales or support teams.
• Ensure faster follow-ups by reassigning records when SLAs are missed.
• Avoid maintaining multiple automation rules for assignment logic.

How Distribute Engine works (at a glance)

1. A record (Lead or Opportunity) enters the Distribute Engine.
2. The engine checks which assignment rules apply.
3. An eligible user is selected based on your configuration.
4. The record is assigned and tracked for SLA compliance.

2. Prerequisites

• To enable Distribution Engine, contact support@leadsquared.com
• This feature is only available on NextGen.

3. Create a Distribution Rule

This section explains how to create and manage assignment rules.

3.1 Creating a new assignment rule

Navigate to Distribution Engine>Distribution Rules. Click + Create Distribution Rule.

Enter basic information about the rule:

• Rule Name (required, must be unique)
• Description (optional)

You can edit these details later using the pencil icon

Rule creation is a 4-step guided process. You can save progress at any step:

Step 1: Rule Criteria

This step decides when the rule runs and which records qualify.

Select entity and event

1. Choose the entity: Lead or Opportunity
2. Select the entity type (if applicable)
3. Choose when the rule should run, such as:
   • Lead Entity – Lead Created, Lead Updated, Activity Created On Lead, Opportunity Created On Lead, and Task Created On Lead.
   • Opportunity Entity – Opportunity Created, Opportunity Updated, Activity Created On Opportunity, and Task Created On Opportunity.

Only records that match this entry event and conditions will enter the rule.

Define rule conditions (AND / OR logic)

Rule conditions help you narrow down exactly which records should be assigned.

Step 2: Select Users

Choose who can receive leads when this rule runs.

You can select:

• Individual users (Manual selection)
• Teams
• Sales groups

At least one user or one group is required. Also, you can choose to Assign only if the User is available.

Step 3: Distribution Method

Select one assignment method:

Round Robin

• Assigns records one by one in sequence
• Best for equal distribution

Weighted

• Assigns more records to users with higher weight. You can configure the weightage for each user.
• Best when some users have higher capacity

Step 4: Fallback

If no eligible user is available, assign the lead to a default user.

Next, you can:

• Save as Draft – Keeps the rule inactive
• Publish – Makes the rule live and adds it to the priority order

3.2 Managing Distribution Rules

Rule list includes:

• Order (priority)
• Rule name
• Action (entity)
• Status (Draft, Active, Inactive, Error)
• Created on
• Created by

You can:

• Click any rule to open its details
• Search rules by name or creator
• Filter rules by status, creator, or distribution method

Reordering rules

Rule order decides which rule gets applied first when a record enters the Distribute Engine.

When a Lead or Opportunity evaluated:

1. The engine checks the first active rule in the list.
2. If the record matches the rule’s entry criteria, the assignment is made.
3. Once a record is assigned, no further rules are evaluated.
4. If the record does not match, the engine moves to the next rule in the order.

Why rule order matters

If multiple rules can apply to the same record, only the highest‑priority rule will run.

Example:

• Rule 1: Assign All Website Leads to Team A
• Rule 2: Assign High‑Score Website Leads to Team B

If Rule 1 is above Rule 2, all website leads (including high‑score ones) will be assigned to Team A.

To ensure high‑score leads go to Team B, place Rule 2 above Rule 1.

4. Viewing assignments and performance

Navigate to Distribution Engine>Home. The Home page gives you a quick distribution overview. Click the filter icon to filter the data by a date-range.

• Records Created: Total number of records that entered the Distribute Engine during the selected time period.
• Records Assigned: Number of records successfully assigned to users by the Distribute Engine.
• Assignment Success Rate: Percentage of created records that were successfully assigned to a user.
• Records Unassigned: Number of records that could not be assigned due to no matching rule or no eligible user.
• Rule Match Overview: Shows how many records matched each assignment rule.
• Assignment Method Split: Displays how records were distributed across different assignment methods.

5. Logs and reports

The Reports & Logs section helps you understand how records are being assigned and identify issues such as missed assignments.

You can use these reports to:

• View assignment history for each record
• See when and why fallback assignment was used
• Troubleshoot rule execution issues

All reports can be filtered by date range, sales group, assigned user, and entity type to quickly narrow down the data you need.

6. Assignment Settings

The Assignment Settings section defines the global controls used by the Distribute Engine, including who can receive assignments and how many records they can be assigned.

User Assignment Limits

Admins can map user fields to control how many records a user can receive on an hourly, daily, weekly, or monthly basis. If no limit is configured, the user is treated as having unlimited capacity.

User Eligibility for Assignment

Admins can control which users are eligible to receive assignments based on their Check-in / Check-out status. Only users who meet the configured eligibility conditions are considered during assignment.

FAQs

What happens if no user is available?
The record is assigned to the fallback user configured in the rule or settings.

Can I temporarily stop assignments to a user?
Yes. Mark the user unavailable, apply leave, or remove them from the rule.

Can I edit an active rule?
Yes. Changes take effect once you save and activate the rule again.