Overview

The Conditions page defines reusable tests for schedules, caller identity, channel usage, queue state, variables, authentication, and other routing decisions. Open it from Configuration > Conditions.

The page works against the tenant currently selected in the top bar. The screenshots and demo rows were captured in the Canistracci OIL tenant.

Working with conditions

Task	How to do it
Add	Select New Condition, enter a name, choose the condition type, complete the type-specific fields, and select Save.
Edit	Open a condition by selecting its name in the list, change the fields, and select Save.
Duplicate	Use the duplicate action in the Actions column to copy an existing condition before changing it.
Delete	Select one or more rows and use Delete Selected, or open a condition and delete it after checking references.
Show flow	Use the flow action in the Actions column to inspect where the condition routes calls.

Page functions

Action	Description
New Condition	Opens the creation form for a new condition.
Delete Selected	Deletes selected conditions after confirmation.
Search	Filters the visible rows by name, type, condition summary, or action text.
Sort	Sorts the list by the selected column.
Page size	Changes how many conditions are shown per page.

List columns

Column	Description
Select	Selects a condition for bulk deletion.
Name	Condition display name. Select it to edit the condition.
Type	Condition type code used by MiRTA PBX.
Condition	Human-readable summary of the configured match rule.
Actions	Duplicate and flow-inspection actions for the row.

Condition types

Type	Purpose	Example record
Weektime	Matches weekly recurring time slots, such as business hours or after-hours periods.	Docs Condition - Weektime
Calendar	Matches absolute date and time ranges for holidays, maintenance windows, and one-off closures.	Docs Condition - Calendar
Hours	Matches one or more daily time ranges without selecting specific weekdays.	Docs Condition - Hours
Simple Caller ID	Matches the caller number against one or more literal values or regular expressions.	Docs Condition - Simple Caller ID
Simple Caller ID Name	Matches the caller name against one or more literal values or regular expressions.	Docs Condition - Simple Caller ID Name
Weekday	Matches selected days of the week.	Docs Condition - Weekday
Date - exact match	Matches one or more exact dates or date/time values.	Docs Condition - Date - exact match
Date - lesser than date	Matches when the current date/time is earlier than the configured date/time.	Docs Condition - Date - lesser than date
Date - greater than date	Matches when the current date/time is later than the configured date/time.	Docs Condition - Date - greater than date
Date - between dates	Matches when the current date/time is between a configured start and end value.	Docs Condition - Date - between dates
Day of the month	Matches a specific day number in the month.	Docs Condition - Day of the month
Extension status	Matches the state of one selected extension or numbered flow.	Docs Condition - Extension status
Variable value	Matches a tenant user variable value.	Docs Condition - Variable value
Multiple variable values	Matches one variable against multiple possible values, each with its own destination path.	Docs Condition - Multiple variable values
System variable value	Matches an Asterisk or system channel variable value.	Docs Condition - System variable value
Multiple extensions status	Checks the combined state of multiple selected extensions.	Docs Condition - Multiple extensions status
AGI Script	Runs an AGI script and compares the AGIRESULT variable with TRUE.	Docs Condition - AGI Script
Authenticate	Prompts the caller for a PIN and matches when authentication succeeds.	Docs Condition - Authenticate
Tenant - number of I/O channels (external)	Matches when the tenant has more than the configured number of external channels in use.	Docs Condition - Tenant - number of I/O channels (external)
Tenant - number of any channels (internal and external)	Matches when the tenant has more than the configured number of total channels in use.	Docs Condition - Tenant - number of any channels (internal and external)
DID - number of inbound channels	Matches when a selected DID has more than the configured number of inbound channels in use.	Docs Condition - DID - number of inbound channels
Number of custom group channels	Matches when a custom channel group has more than the configured number of active channels.	Docs Condition - Number of custom group channels
Answering Machine Detection	Runs answering machine detection and matches according to the analysis result.	Docs Condition - Answering Machine Detection
SIP Header	Matches a SIP header against a regular expression.	Docs Condition - SIP Header
Agent logged in a queue	Matches when the selected agent is logged in to the selected queue.	Docs Condition - Agent logged in a queue
Agent paused from queue	Matches when the selected agent is paused in the selected queue.	Docs Condition - Agent paused from queue
Caller ID in Phonebook	Matches when caller ID is found in a selected phone book.	Docs Condition - Caller ID in Phonebook
Feature code parameter	Matches parameters collected by a feature code.	Docs Condition - Feature code parameter
All conditions listed satisfied	Matches only when every selected condition is satisfied.	Docs Condition - All conditions listed satisfied
Any conditions listed satisfied	Matches when at least one selected condition is satisfied.	Docs Condition - Any conditions listed satisfied
Negate condition result	Matches when the selected condition does not match.	Docs Condition - Negate condition result
Use a Global Condition	References a global condition from the tenant configuration.	Docs Condition - Use a Global Condition
Check SMS message	Matches SMS message content.	Docs Condition - Check SMS message
Check if a specific channel is running	Checks whether a channel matching the configured attributes is currently running.	Docs Condition - Check if a specific channel is running
Multiple destination over weektime	Routes to different destinations based on a color-coded weekly timetable.	Docs Condition - Multiple destination over weektime
Call Screening using a random PIN	Screens a call by playing a prompt and asking the caller to enter a generated PIN.	Docs Condition - Call Screening using a random PIN
Caller has already called in	Checks recent inbound call history for the current caller.	Docs Condition - Caller has already called in
Caller has been called out	Checks recent outbound call history for the current caller.	Docs Condition - Caller has been called out
Queue Callers, more than	Matches when a selected queue has more than the configured number of callers waiting.	Docs Condition - Queue Callers, more than

Demo records

The Canistracci OIL tenant contains one documentation example for each available condition type: 39 records with names beginning with Docs Condition -. A global example named Docs Global Condition - Weektime is also available for the Use a Global Condition type.

Deleting records

Before deleting a condition, check call flows, destinations, schedules, IVRs, feature codes, and reports that may reference it. MiRTA PBX asks for confirmation before the delete is submitted.