Lead Stage Automation Rules
Automation rules move a lead to a new lead stage automatically when a guest takes an action in Zenoti β such as booking a service or purchasing a membership. Use automation rules to keep your lead pipeline up to date without manually changing stages after every transaction.
Audience: Admins who configure the AI Lead Manager pipeline and want lead stages to update automatically based on guest activity.
Note: Automation rules are simple if-then rules that change a lead stage in response to a single Zenoti event. For multi-step automation with branching, conditions, and email or SMS actions, use Workflow Automation instead.
On this page
Before you begin
AI Lead Manager must be enabled for your organization, with at least one lead pipeline configured. See Lead Settings & Configuration.
The lead stages, lead types, services, and memberships you want to reference in a rule must already exist.
You need the following permission to view and manage automation rules:
Permission: Lead Settings β Required to view, create, and delete automation rules. Admin path: Organization β Security β Security Roles β [your role] β Lead Settings β View
Webhook credentials are populated automatically when you save a rule β you do not enter any connection details yourself. See How automation rules work.
How automation rules work
An automation rule watches for a specific guest activity in Zenoti and, when that activity happens, moves the matching lead to the lead stage you choose.
- The connection is set up for you. When you save a rule, AI Lead Manager registers the required connection with Zenoti so it can listen for the relevant activity. The account and security credentials for that connection are filled in automatically from your environment β you never enter them manually.
- Rules are scoped before they fire. A rule only acts on a lead when both of these match: the lead's current stage is one of the stages selected in Change lead stage from, and the lead's type is one of the types selected in the Lead type filter.
- Optional event stages can be left unset. Some events (such as a cancelled or closed appointment) have an optional target stage. If you leave one unset, the lead stage is not changed when that event occurs.
- Deleting a rule stops it. When you delete a rule, AI Lead Manager removes the underlying connection so the rule stops acting on leads.
You configure rules at Lead Management > AI Lead Manager > Lead settings > Automation Rules. Services and Memberships rules are created through separate procedures because each item type listens for different guest activity.
Steps
Create a Services automation rule
A Services rule listens for appointment activity and supports four independent trigger events.
- Go to Lead Management > AI Lead Manager > Lead settings > Automation Rules.
- Select the option to add a new rule.
- For item type, select Services.
- In the Lead type filter, select one or more lead types. The rule acts only on leads of the selected types.
- In Change lead stage from, select one or more lead stages. This is a multi-select field β the rule acts only on leads currently in one of the selected stages.
- Select the services the rule applies to:
- Browse by service category and expand a category to select individual services.
- Select as many services across categories as the rule needs.
- Map each appointment event to a lead stage. The booked event is required; the others are optional and can be left unset.
- Save the rule.
The four Services trigger events and their stage mappings are:
| Trigger event | Stage field | Required? |
|---|---|---|
| Appointment booked | To new leads stage | Required |
| Appointment cancelled | Stage to apply when the appointment is cancelled | Optional |
| Appointment no-show | Stage to apply when the guest is a no-show | Optional |
| Appointment closed | Stage to apply when the appointment is closed | Optional |
When you leave the cancelled, no-show, or closed stage unset, the lead stage does not change for that event.
Worked example: A med spa wants new leads to advance automatically when they book a consultation. The admin creates a Services rule with Lead type set to Membership inquiry, Change lead stage from set to New lead and Contacted, and the service set to Botox Consultation. They map To new leads stage (appointment booked) to Consultation booked and the no-show event to Re-engage. They leave the cancelled and closed events unset. Now, when a lead in the New lead or Contacted stage books a Botox consultation, the lead moves to Consultation booked; if they no-show, it moves to Re-engage.
Create a Memberships automation rule
A Memberships rule listens for membership invoice activity and supports two trigger events.
- Go to Lead Management > AI Lead Manager > Lead settings > Automation Rules.
- Select the option to add a new rule.
- For item type, select Memberships.
- In the Lead type filter, select one or more lead types. The rule acts only on leads of the selected types.
- In Change lead stage from, select one or more lead stages. This multi-select field restricts the rule to leads currently in one of the selected stages.
- In If membership invoice is created for, select the memberships the rule applies to:
- Select Any to apply the rule to all available memberships.
- Or select one or more specific memberships.
- Map each membership event to a lead stage. The invoice-created event is required; the invoice-closed event is optional and can be left unset.
- Save the rule.
The two Memberships trigger events and their stage mappings are:
| Trigger event | Stage field | Required? |
|---|---|---|
| Membership invoice created | To new leads stage | Required |
| Membership invoice closed | Stage to apply when the invoice is closed | Optional |
When you leave the invoice-closed stage unset, the lead stage does not change when the invoice is closed.
View and manage automation rules
- Go to Lead Management > AI Lead Manager > Lead settings > Automation Rules.
- Review the list of existing rules. By default, active rules are shown; use the inactive filter to include rules that are no longer active.
- Select a rule to open it and review its full configuration β item type, lead types, origin stages, selected items, and event-to-stage mappings.
Delete an automation rule
Go to Lead Management > AI Lead Manager > Lead settings > Automation Rules.
Locate the rule you want to remove.
Important: Deleting a rule stops it from acting on leads, and it cannot be restored. If you only want to stop a rule temporarily, confirm whether your pipeline can recreate it later β there is no undo. Review the rule before you delete it.
Select the delete option for the rule and confirm.
When you delete a rule, AI Lead Manager removes the underlying connection so the rule no longer moves leads.
Tips
- Keep Change lead stage from narrow. Selecting only the stages where the activity logically occurs prevents a rule from moving leads that are already further down the pipeline.
- Use the Lead type filter to keep rules focused β for example, apply a membership rule only to lead types that represent membership prospects.
- Use the Any option in a Memberships rule when you want any membership purchase to advance a lead, rather than maintaining a long list of specific memberships.
- Leave optional event stages unset when you do not want a particular event to change the lead stage β this is the supported way to ignore the cancelled, no-show, closed, or invoice-closed events.
- Create separate, clearly-purposed rules for services and memberships rather than trying to cover both with one configuration.
Troubleshooting
- A rule isn't moving leads. Confirm the lead's current stage is one of the stages selected in Change lead stage from, and that the lead's type is included in the Lead type filter. A rule acts only when both match.
- Leads advance on booking but not on cancellation or no-show. The cancelled, no-show, and closed events are optional. If you left those stages unset, the lead stage will not change for those events β open the rule and set a target stage for each event you want to handle.
- A membership purchase isn't advancing the lead. Open the rule and verify the purchased membership is included in If membership invoice is created for, or that Any is selected. Also confirm a stage is mapped to To new leads stage.
- A deleted rule stopped working as expected. Deleting a rule removes its connection permanently. If leads stopped advancing after a deletion, recreate the rule.
- Changes don't appear immediately. Lead stages update shortly after the guest activity is processed, not instantly. Allow a few moments before checking the lead.