Create an Automation Rule
6 min
this guide explains the full automation rules editor for general purpose rules use this editor when the automation sends messages or templates, assigns conversations, hands off to an ai agent, reacts to custom api payloads, or needs a multi step visual flow for pipeline specific behavior, use pipeline automations # instead create a rule go to automation rules select new automation rule enter a clear rule name add a note if it helps teammates understand the rule choose what should happen choose when it should happen choose the business phone numbers the rule applies to, when phone scope is shown save the rule choose the action the action is what peach does after the rule matches the builder supports simple one step actions and an advanced visual flow option common actions include assign conversation hand off to ai agent send template send flow send message set conversation status build a visual flow use the visual flow option when the automation needs more than one step, branches, waits, extra messages, or handoffs choose the trigger the trigger controls when peach should run the rule triggers can come from peach events, connected integrations, or custom developer apis some triggers show extra condition fields for example, a message or template event may show matching options, and a custom api trigger may ask for topic or payload settings choose phone number scope for whatsapp conversation events, peach can scope the rule by business number scope meaning all business phone numbers applies to every connected number, including numbers added later all cloud api numbers applies to all cloud api numbers all coexistence numbers applies to all coexistence numbers only selected phone numbers applies only to the numbers you choose phone number scope may be hidden for account level events and external api events where it does not apply save and activate new rules are saved as active unless the current surface gives you an active toggle and you turn it off after saving active rules listen for matching events draft rules stay saved but do not run rules with visual flows can be opened in the visual editor rules triggered directly by api may show an automation endpoint after the first save when to use the full editor use the full automation rules editor when the rule needs one or more of these ai handoff template or flow sending custom api payload mapping multiple steps advanced triggers visual flow editing for pipeline specific behavior, use pipeline automations #