Sales stage rules and automation
Configure automated pipeline stage transitions for opportunities based on appointment and membership events. When a qualifying event occurs, the system evaluates your configured rules and automatically moves matching opportunities to the target pipeline stage.
Audience: Administrators who configure sales pipeline automation.
On this page
Before you begin
- You need Configure Rules under Opportunity in the Sales section of your security role to create and delete sales stage rules; without it the page shows only Previously Added Rules.
- Your organization must have pipeline stages configured for the opportunity types you want to automate.
- Sales stage rules are optional β opportunities can be managed entirely through manual updates.
Permission: Configure Rules under Opportunity (Sales section) β Required to add and delete sales stage rules. Admin path: Security role > PERMISSIONS tab > Sales section > Opportunity > Configure Rules
How automation works
When an appointment or membership event occurs, the system:
- Identifies open opportunities linked to the guest at that center.
- Evaluates configured rules to find one where all three of the following conditions are simultaneously true:
- The opportunity's current pipeline stage matches the rule's Change sales stage from value.
- The opportunity's type matches the rule's For opportunity type value.
- The triggering appointment or membership matches the rule's If appointment is booked for or Select memberships value.
- If a matching rule is found and the event type aligns with the rule's trigger, transitions the opportunity to the To sales stage.
Important: All three conditions must be satisfied at the same time. An opportunity that matches only two of the three conditions β for example, the correct pipeline stage and type, but a different service β does not trigger a transition.
Rules are evaluated only at the moment a qualifying event occurs. The system does not re-evaluate rules periodically or apply them retroactively. A rule created after an event has already occurred does not trigger off that past event, and a newly added rule does not apply to opportunities that were already transitioned under a prior rule. Conversely, an appointment or membership event that occurs after a rule was added is evaluated against it normally β the rule does not need to predate the opportunity itself, only the triggering event.
Matching conditions
The following table summarizes the three conditions that must all match for a rule to trigger:
| Condition | What it checks |
|---|---|
| Pipeline stage | The opportunity's current pipeline stage must be listed in the rule's Change sales stage from selection. |
| Opportunity type | The opportunity's type must be listed in the rule's For opportunity type selection. |
| Service or membership | The appointment's service (for service rules) or the membership (for membership rules) must match the rule's configured triggering item. |
Appointment event triggers
| Event | Description |
|---|---|
| Appointment created | A new appointment is booked for the guest. |
| Appointment cancelled | An existing appointment is cancelled. |
| Appointment no-show | The guest is marked as a no-show for an appointment. |
| Appointment deleted | An appointment is deleted from the system. |
| Appointment closed | An appointment is completed and the invoice is closed. |
Membership event triggers
| Event | Description |
|---|---|
| Membership purchased | A guest purchases a membership. |
| Membership invoice closed | A membership invoice is closed (payment completed). |
| Membership invoice voided | A membership invoice is voided or cancelled. |
Steps
Configure a rule for services
Tip: Before building a complex rule set, sketch out which pipeline stages map to which appointment events. This prevents conflicting rules.
- Navigate to Configuration > Opportunities > Sales stage rules.
- In the Add a New Rule section, in Select item type, select Services.
- Configure the rule settings:
- For opportunity type * β Select one or more opportunity types this rule applies to.
- If appointment is booked for * β Under Select a service or category below:, open the service picker and select the services that trigger this rule. Your selections appear under Selected Items.
- Change sales stage from * β Select the pipeline stages the opportunity must currently be in.
- To sales stage * β Select the destination pipeline stage.
- If appointment is subsequently cancelled β In change sales stage to, pick the stage to move to when an appointment is cancelled. Optional.
- If appointment is subsequently no-showed β In change sales stage to, pick the stage to move to when a guest is marked as a no-show. Optional.
- If appointment is subsequently closed β In change sales stage to, pick the stage to move to when an appointment is completed. Optional.
- Click Add Rule. The confirmation message Rule added successfully appears and the Previously Added Rules grid refreshes.
Note: The system checks whether an identical rule already exists before saving. If a duplicate is detected, an error is displayed and the rule is not added.
Worked example β Service rule for a facial consultation:
Your organization uses opportunity types Skin Care and pipeline stages Lead, Consultation Booked, Consultation Complete, and Lost. You want bookings for the "Signature Facial" service to move an opportunity from Lead to Consultation Booked, and a no-show to move it back to Lead.
Configure the rule as follows:
- Select item type: Services
- For opportunity type: Skin Care
- If appointment is booked for: Signature Facial
- Change sales stage from: Lead
- To sales stage: Consultation Booked
- If appointment is subsequently no-showed β change sales stage to: Lead
When the appointment is created, any open Skin Care opportunity in the Lead stage for that guest automatically moves to Consultation Booked. If the guest no-shows, the opportunity moves back to Lead.
Configure a rule for memberships
- Navigate to Configuration > Opportunities > Sales stage rules.
- In Select item type, select Memberships.
- Configure the rule settings:
- For opportunity type * β Select one or more opportunity types.
- Select memberships β Select the membership programs that trigger this rule.
- Change sales stage from * β Select the pipeline stages the opportunity must currently be in.
- To sales stage * β Select the destination pipeline stage.
- Membership invoice is subsequently closed β In change sales stage to, pick the stage to move to when the membership invoice is closed. Optional.
- Click Add Rule. The confirmation message Rule added successfully appears and the Previously Added Rules grid refreshes.
Review and delete rules
The Previously Added Rules grid displays all configured rules with the columns FOR OPPORTUNITY TYPE, TRIGGER, FOR, CHANGE STAGE FROM, and CHANGE STAGE TO, plus a delete control on each row.
Important: Sales stage rules cannot be edited in place. To change a rule's matching criteria β its pipeline stages, opportunity type, or triggering service or membership β delete the existing rule and add a new rule with the updated criteria. The Previously Added Rules grid exposes only Add and Delete operations. Because this replacement follows the same event-time-only evaluation as any other rule change, it is not retroactive: appointments or memberships that already triggered a transition under the old criteria are unaffected, and only a qualifying event that occurs after you add the replacement rule is evaluated against the new criteria.
To delete a rule:
- Locate the rule in the Previously Added Rules grid.
- Click the delete control on that row.
- When prompted with This rule will be deleted permanently, are you sure ?, confirm the deletion.
Note: Deleting a rule does not reverse any stage transitions that already occurred. Opportunities that were moved by the rule remain in their current pipeline stage.
Tips
- Test rules with a small scope first before expanding to additional services or membership types. Start with a single opportunity type and one or two services, verify transitions are working as expected, then broaden the rule.
- Consider all event types when creating service rules. Define conditional stages for cancellation, no-show, and closure to handle exceptions so unexpected appointment outcomes move opportunities to meaningful pipeline stages rather than leaving them in a misleading stage.
- The system only applies rules to guests who have open opportunities. If no matching open opportunity exists for the guest, no stage transition occurs.
- Rules apply only at the moment the qualifying event fires. If you create or reconfigure a rule after an appointment was already booked, cancelled, or closed, the rule does not apply retroactively to that past event.
- Monitor the pipeline reports to track how automated stage transitions affect your sales metrics. Compare conversion rates before and after enabling a new rule to evaluate its impact.
Troubleshooting
A rule was added, but the opportunity's pipeline stage did not change when the appointment was created.
All three matching conditions must be satisfied simultaneously: the opportunity's current pipeline stage must match the rule's Change sales stage from selection, the opportunity's type must match For opportunity type, and the service booked must match If appointment is booked for. Verify each condition individually. Also confirm that the guest has an open opportunity β if no open opportunity exists, no transition occurs regardless of the rule.
The same rule appears to work for some guests but not others.
Confirm that the guests for whom the rule did not fire have open opportunities. A guest with no open opportunity, or an opportunity whose current pipeline stage does not match the rule's Change sales stage from value, will not be affected. Check the opportunity's current pipeline stage in the opportunity record before the next triggering event.
A rule was configured after an appointment was already booked, but the stage did not change.
Rules apply only at the moment the qualifying event occurs. A rule created after the event has already fired does not trigger retroactively. To apply the updated rule logic, the qualifying event must occur again β for example, a new appointment must be created or the appointment must be cancelled and rebooked.
The "Add Rule" action returns a duplicate error.
The system detects when a rule with identical criteria already exists. Review the Previously Added Rules grid to confirm whether an existing rule covers the same combination of opportunity type, pipeline stages, and triggering service or membership. If you need different behavior, delete the existing rule and add a new one with the updated criteria.
A deleted rule's past transitions are still reflected in pipeline reports.
Deleting a rule does not reverse transitions that already occurred. Opportunities that were moved by the rule remain in their current pipeline stage. If you need to correct an opportunity's stage, update it manually from the opportunity record.