Conditions

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.

Conditions list page filtered to documentation examples in the Canistracci OIL tenant.
Conditions list page filtered to documentation examples in the Canistracci OIL tenant.

Working with conditions

TaskHow to do it
AddSelect New Condition, enter a name, choose the condition type, complete the type-specific fields, and select Save.
EditOpen a condition by selecting its name in the list, change the fields, and select Save.
DuplicateUse the duplicate action in the Actions column to copy an existing condition before changing it.
DeleteSelect one or more rows and use Delete Selected, or open a condition and delete it after checking references.
Show flowUse the flow action in the Actions column to inspect where the condition routes calls.

Page functions

ActionDescription
New ConditionOpens the creation form for a new condition.
Delete SelectedDeletes selected conditions after confirmation.
SearchFilters the visible rows by name, type, condition summary, or action text.
SortSorts the list by the selected column.
Page sizeChanges how many conditions are shown per page.

List columns

ColumnDescription
SelectSelects a condition for bulk deletion.
NameCondition display name. Select it to edit the condition.
TypeCondition type code used by MiRTA PBX.
ConditionHuman-readable summary of the configured match rule.
ActionsDuplicate and flow-inspection actions for the row.

Condition types

TypePurposeExample record
WeektimeMatches weekly recurring time slots, such as business hours or after-hours periods.Docs Condition - Weektime
CalendarMatches absolute date and time ranges for holidays, maintenance windows, and one-off closures.Docs Condition - Calendar
HoursMatches one or more daily time ranges without selecting specific weekdays.Docs Condition - Hours
Simple Caller IDMatches the caller number against one or more literal values or regular expressions.Docs Condition - Simple Caller ID
Simple Caller ID NameMatches the caller name against one or more literal values or regular expressions.Docs Condition - Simple Caller ID Name
WeekdayMatches selected days of the week.Docs Condition - Weekday
Date - exact matchMatches one or more exact dates or date/time values.Docs Condition - Date - exact match
Date - lesser than dateMatches when the current date/time is earlier than the configured date/time.Docs Condition - Date - lesser than date
Date - greater than dateMatches when the current date/time is later than the configured date/time.Docs Condition - Date - greater than date
Date - between datesMatches when the current date/time is between a configured start and end value.Docs Condition - Date - between dates
Day of the monthMatches a specific day number in the month.Docs Condition - Day of the month
Extension statusMatches the state of one selected extension or numbered flow.Docs Condition - Extension status
Variable valueMatches a tenant user variable value.Docs Condition - Variable value
Multiple variable valuesMatches one variable against multiple possible values, each with its own destination path.Docs Condition - Multiple variable values
System variable valueMatches an Asterisk or system channel variable value.Docs Condition - System variable value
Multiple extensions statusChecks the combined state of multiple selected extensions.Docs Condition - Multiple extensions status
AGI ScriptRuns an AGI script and compares the AGIRESULT variable with TRUE.Docs Condition - AGI Script
AuthenticatePrompts 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 channelsMatches 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 channelsMatches when a custom channel group has more than the configured number of active channels.Docs Condition - Number of custom group channels
Answering Machine DetectionRuns answering machine detection and matches according to the analysis result.Docs Condition - Answering Machine Detection
SIP HeaderMatches a SIP header against a regular expression.Docs Condition - SIP Header
Agent logged in a queueMatches when the selected agent is logged in to the selected queue.Docs Condition - Agent logged in a queue
Agent paused from queueMatches when the selected agent is paused in the selected queue.Docs Condition - Agent paused from queue
Caller ID in PhonebookMatches when caller ID is found in a selected phone book.Docs Condition - Caller ID in Phonebook
Feature code parameterMatches parameters collected by a feature code.Docs Condition - Feature code parameter
All conditions listed satisfiedMatches only when every selected condition is satisfied.Docs Condition - All conditions listed satisfied
Any conditions listed satisfiedMatches when at least one selected condition is satisfied.Docs Condition - Any conditions listed satisfied
Negate condition resultMatches when the selected condition does not match.Docs Condition - Negate condition result
Use a Global ConditionReferences a global condition from the tenant configuration.Docs Condition - Use a Global Condition
Check SMS messageMatches SMS message content.Docs Condition - Check SMS message
Check if a specific channel is runningChecks whether a channel matching the configured attributes is currently running.Docs Condition - Check if a specific channel is running
Multiple destination over weektimeRoutes to different destinations based on a color-coded weekly timetable.Docs Condition - Multiple destination over weektime
Call Screening using a random PINScreens 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 inChecks recent inbound call history for the current caller.Docs Condition - Caller has already called in
Caller has been called outChecks recent outbound call history for the current caller.Docs Condition - Caller has been called out
Queue Callers, more thanMatches 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.

Weektime

The Weektime type matches weekly recurring time slots, such as business hours or after-hours periods.

Open Configuration > Conditions, select New Condition, enter a name, choose Weektime in the Type field, complete the type-specific fields, and select Save.

Weektime condition edit form in the Canistracci OIL tenant.
Weektime condition edit form in the Canistracci OIL tenant.

Fields

Field or optionDescription
NameDisplay name used in condition lists and selectors.
TypeSelect Weektime.
TimezoneTimezone used to evaluate the weekly schedule. Leave it empty to use the tenant default.
Select timeslotsWeekly calendar where matching time blocks are drawn.

Example

FieldExample value
NameDocs Condition - Weektime
TimeslotMonday 09:00-17:00

Destinations

For tenant conditions, select the destinations that should run when the condition matches and when it does not match. Global conditions are referenced by tenant-level Use a Global Condition records.

Editing and deleting

To edit this condition, open Docs Condition - Weektime from the Conditions list, adjust the fields, and select Save. Before deleting it, check IVRs, schedules, routes, feature codes, and other call-flow objects that may reference it.

Calendar

The Calendar type matches absolute date and time ranges for holidays, maintenance windows, and one-off closures.

Open Configuration > Conditions, select New Condition, enter a name, choose Calendar in the Type field, complete the type-specific fields, and select Save.

Calendar condition edit form in the Canistracci OIL tenant.
Calendar condition edit form in the Canistracci OIL tenant.

Fields

Field or optionDescription
NameDisplay name used in condition lists and selectors.
TypeSelect Calendar.
TimezoneTimezone used to evaluate the calendar entries.
Select timeslotsCalendar where date and time blocks are entered.

Example

FieldExample value
NameDocs Condition - Calendar
Calendar slot2026-12-24 09:00 to 2026-12-24 17:00

Destinations

For tenant conditions, select the destinations that should run when the condition matches and when it does not match. Global conditions are referenced by tenant-level Use a Global Condition records.

Editing and deleting

To edit this condition, open Docs Condition - Calendar from the Conditions list, adjust the fields, and select Save. Before deleting it, check IVRs, schedules, routes, feature codes, and other call-flow objects that may reference it.

Hours

The Hours type matches one or more daily time ranges without selecting specific weekdays.

Open Configuration > Conditions, select New Condition, enter a name, choose Hours in the Type field, complete the type-specific fields, and select Save.

Hours condition edit form in the Canistracci OIL tenant.
Hours condition edit form in the Canistracci OIL tenant.

Fields

Field or optionDescription
NameDisplay name used in condition lists and selectors.
TypeSelect Hours.
TimezoneTimezone used to evaluate the time ranges.
From - ToUp to three daily start and end ranges.

Example

FieldExample value
NameDocs Condition - Hours
From - To09:00 to 17:00

Destinations

For tenant conditions, select the destinations that should run when the condition matches and when it does not match. Global conditions are referenced by tenant-level Use a Global Condition records.

Editing and deleting

To edit this condition, open Docs Condition - Hours from the Conditions list, adjust the fields, and select Save. Before deleting it, check IVRs, schedules, routes, feature codes, and other call-flow objects that may reference it.

Simple Caller ID

The Simple Caller ID type matches the caller number against one or more literal values or regular expressions.

Open Configuration > Conditions, select New Condition, enter a name, choose Simple Caller ID in the Type field, complete the type-specific fields, and select Save.

Simple Caller ID condition edit form in the Canistracci OIL tenant.
Simple Caller ID condition edit form in the Canistracci OIL tenant.

Fields

Field or optionDescription
NameDisplay name used in condition lists and selectors.
TypeSelect Simple Caller ID.
Caller IDCaller number value or regular expression to match. Multiple rows can be used.

Example

FieldExample value
NameDocs Condition - Simple Caller ID
Caller ID^1555

Destinations

For tenant conditions, select the destinations that should run when the condition matches and when it does not match. Global conditions are referenced by tenant-level Use a Global Condition records.

Editing and deleting

To edit this condition, open Docs Condition - Simple Caller ID from the Conditions list, adjust the fields, and select Save. Before deleting it, check IVRs, schedules, routes, feature codes, and other call-flow objects that may reference it.

Simple Caller ID Name

The Simple Caller ID Name type matches the caller name against one or more literal values or regular expressions.

Open Configuration > Conditions, select New Condition, enter a name, choose Simple Caller ID Name in the Type field, complete the type-specific fields, and select Save.

Simple Caller ID Name condition edit form in the Canistracci OIL tenant.
Simple Caller ID Name condition edit form in the Canistracci OIL tenant.

Fields

Field or optionDescription
NameDisplay name used in condition lists and selectors.
TypeSelect Simple Caller ID Name.
Caller ID NameCaller name value or regular expression to match. Multiple rows can be used.

Example

FieldExample value
NameDocs Condition - Simple Caller ID Name
Caller ID NameCanistracci

Destinations

For tenant conditions, select the destinations that should run when the condition matches and when it does not match. Global conditions are referenced by tenant-level Use a Global Condition records.

Editing and deleting

To edit this condition, open Docs Condition - Simple Caller ID Name from the Conditions list, adjust the fields, and select Save. Before deleting it, check IVRs, schedules, routes, feature codes, and other call-flow objects that may reference it.

Weekday

The Weekday type matches selected days of the week.

Open Configuration > Conditions, select New Condition, enter a name, choose Weekday in the Type field, complete the type-specific fields, and select Save.

Weekday condition edit form in the Canistracci OIL tenant.
Weekday condition edit form in the Canistracci OIL tenant.

Fields

Field or optionDescription
NameDisplay name used in condition lists and selectors.
TypeSelect Weekday.
TimezoneTimezone used to determine the current weekday.
Sunday through SaturdayCheckboxes for the days that should match.

Example

FieldExample value
NameDocs Condition - Weekday
DaysMonday through Friday

Destinations

For tenant conditions, select the destinations that should run when the condition matches and when it does not match. Global conditions are referenced by tenant-level Use a Global Condition records.

Editing and deleting

To edit this condition, open Docs Condition - Weekday from the Conditions list, adjust the fields, and select Save. Before deleting it, check IVRs, schedules, routes, feature codes, and other call-flow objects that may reference it.

Date - exact match

The Date - exact match type matches one or more exact dates or date/time values.

Open Configuration > Conditions, select New Condition, enter a name, choose Date - exact match in the Type field, complete the type-specific fields, and select Save.

Date - exact match condition edit form in the Canistracci OIL tenant.
Date - exact match condition edit form in the Canistracci OIL tenant.

Fields

Field or optionDescription
NameDisplay name used in condition lists and selectors.
TypeSelect Date - exact match.
TimezoneTimezone used to evaluate the date.
DateExact date or date/time value to match.
RecurringTreats the date as recurring instead of a one-time date.

Example

FieldExample value
NameDocs Condition - Date - Exact Match
Date2026-12-25 00:00:00

Destinations

For tenant conditions, select the destinations that should run when the condition matches and when it does not match. Global conditions are referenced by tenant-level Use a Global Condition records.

Editing and deleting

To edit this condition, open Docs Condition - Date - exact match from the Conditions list, adjust the fields, and select Save. Before deleting it, check IVRs, schedules, routes, feature codes, and other call-flow objects that may reference it.

Date - lesser than date

The Date - lesser than date type matches when the current date/time is earlier than the configured date/time.

Open Configuration > Conditions, select New Condition, enter a name, choose Date - lesser than date in the Type field, complete the type-specific fields, and select Save.

Date - lesser than date condition edit form in the Canistracci OIL tenant.
Date - lesser than date condition edit form in the Canistracci OIL tenant.

Fields

Field or optionDescription
NameDisplay name used in condition lists and selectors.
TypeSelect Date - lesser than date.
Lesser than DateDate or date/time threshold used by the comparison.
RecurringTreats the threshold as a recurring date value.
CustomUses a custom date expression instead of the date picker value.

Example

FieldExample value
NameDocs Condition - Date - Lesser Than Date
Lesser than Date2026-12-31 23:59:59

Destinations

For tenant conditions, select the destinations that should run when the condition matches and when it does not match. Global conditions are referenced by tenant-level Use a Global Condition records.

Editing and deleting

To edit this condition, open Docs Condition - Date - lesser than date from the Conditions list, adjust the fields, and select Save. Before deleting it, check IVRs, schedules, routes, feature codes, and other call-flow objects that may reference it.

Date - greater than date

The Date - greater than date type matches when the current date/time is later than the configured date/time.

Open Configuration > Conditions, select New Condition, enter a name, choose Date - greater than date in the Type field, complete the type-specific fields, and select Save.

Date - greater than date condition edit form in the Canistracci OIL tenant.
Date - greater than date condition edit form in the Canistracci OIL tenant.

Fields

Field or optionDescription
NameDisplay name used in condition lists and selectors.
TypeSelect Date - greater than date.
Greater than DateDate or date/time threshold used by the comparison.
RecurringTreats the threshold as a recurring date value.
CustomUses a custom date expression instead of the date picker value.

Example

FieldExample value
NameDocs Condition - Date - Greater Than Date
Greater than Date2026-01-01 00:00:00

Destinations

For tenant conditions, select the destinations that should run when the condition matches and when it does not match. Global conditions are referenced by tenant-level Use a Global Condition records.

Editing and deleting

To edit this condition, open Docs Condition - Date - greater than date from the Conditions list, adjust the fields, and select Save. Before deleting it, check IVRs, schedules, routes, feature codes, and other call-flow objects that may reference it.

Date - between dates

The Date - between dates type matches when the current date/time is between a configured start and end value.

Open Configuration > Conditions, select New Condition, enter a name, choose Date - between dates in the Type field, complete the type-specific fields, and select Save.

Date - between dates condition edit form in the Canistracci OIL tenant.
Date - between dates condition edit form in the Canistracci OIL tenant.

Fields

Field or optionDescription
NameDisplay name used in condition lists and selectors.
TypeSelect Date - between dates.
Between Date/TimeStart and end values for a matching window. Multiple windows can be configured.
RecurringTreats the date window as recurring.

Example

FieldExample value
NameDocs Condition - Date - Between Dates
Between Date/Time2026-12-24 09:00:00 and 2026-12-24 17:00:00

Destinations

For tenant conditions, select the destinations that should run when the condition matches and when it does not match. Global conditions are referenced by tenant-level Use a Global Condition records.

Editing and deleting

To edit this condition, open Docs Condition - Date - between dates from the Conditions list, adjust the fields, and select Save. Before deleting it, check IVRs, schedules, routes, feature codes, and other call-flow objects that may reference it.

Day of the month

The Day of the month type matches a specific day number in the month.

Open Configuration > Conditions, select New Condition, enter a name, choose Day of the month in the Type field, complete the type-specific fields, and select Save.

Day of the month condition edit form in the Canistracci OIL tenant.
Day of the month condition edit form in the Canistracci OIL tenant.

Fields

Field or optionDescription
NameDisplay name used in condition lists and selectors.
TypeSelect Day of the month.
TimezoneTimezone used to evaluate the month day.
Day of the monthDay number from 1 to 31.

Example

FieldExample value
NameDocs Condition - Day of the Month
Day of the month15

Destinations

For tenant conditions, select the destinations that should run when the condition matches and when it does not match. Global conditions are referenced by tenant-level Use a Global Condition records.

Editing and deleting

To edit this condition, open Docs Condition - Day of the month from the Conditions list, adjust the fields, and select Save. Before deleting it, check IVRs, schedules, routes, feature codes, and other call-flow objects that may reference it.

Extension status

The Extension status type matches the state of one selected extension or numbered flow.

Open Configuration > Conditions, select New Condition, enter a name, choose Extension status in the Type field, complete the type-specific fields, and select Save.

Extension status condition edit form in the Canistracci OIL tenant.
Extension status condition edit form in the Canistracci OIL tenant.

Fields

Field or optionDescription
NameDisplay name used in condition lists and selectors.
TypeSelect Extension status.
ExtensionExtension or flow whose state is checked.
StateState to match: in use, not in use, or DND active.

Example

FieldExample value
NameDocs Condition - Extension Status
Extension100 - Alex Reed
StateNot in use

Destinations

For tenant conditions, select the destinations that should run when the condition matches and when it does not match. Global conditions are referenced by tenant-level Use a Global Condition records.

Editing and deleting

To edit this condition, open Docs Condition - Extension status from the Conditions list, adjust the fields, and select Save. Before deleting it, check IVRs, schedules, routes, feature codes, and other call-flow objects that may reference it.

Variable value

The Variable value type matches a tenant user variable value.

Open Configuration > Conditions, select New Condition, enter a name, choose Variable value in the Type field, complete the type-specific fields, and select Save.

Variable value condition edit form in the Canistracci OIL tenant.
Variable value condition edit form in the Canistracci OIL tenant.

Fields

Field or optionDescription
NameDisplay name used in condition lists and selectors.
TypeSelect Variable value.
VariableUser variable name. The form prefixes the value with USR-.
ValueValue to compare against.
Use as RegexTreats the value as a regular expression.

Example

FieldExample value
NameDocs Condition - Variable Value
VariableDEPARTMENT
ValueAccounting

Destinations

For tenant conditions, select the destinations that should run when the condition matches and when it does not match. Global conditions are referenced by tenant-level Use a Global Condition records.

Editing and deleting

To edit this condition, open Docs Condition - Variable value from the Conditions list, adjust the fields, and select Save. Before deleting it, check IVRs, schedules, routes, feature codes, and other call-flow objects that may reference it.

Multiple variable values

The Multiple variable values type matches one variable against multiple possible values, each with its own destination path.

Open Configuration > Conditions, select New Condition, enter a name, choose Multiple variable values in the Type field, complete the type-specific fields, and select Save.

Multiple variable values condition edit form in the Canistracci OIL tenant.
Multiple variable values condition edit form in the Canistracci OIL tenant.

Fields

Field or optionDescription
NameDisplay name used in condition lists and selectors.
TypeSelect Multiple variable values.
VariableUser variable name. The form prefixes the value with USR-.
Value rowsValues to compare against.
Destination rowsDestination selected for each matching value.

Example

FieldExample value
NameDocs Condition - Multiple Variable Values
VariableSERVICE
Valuesbilling, support

Destinations

This type hides the standard single match destination and shows destination rows for each configured variable value.

Editing and deleting

To edit this condition, open Docs Condition - Multiple variable values from the Conditions list, adjust the fields, and select Save. Before deleting it, check IVRs, schedules, routes, feature codes, and other call-flow objects that may reference it.

System variable value

The System variable value type matches an Asterisk or system channel variable value.

Open Configuration > Conditions, select New Condition, enter a name, choose System variable value in the Type field, complete the type-specific fields, and select Save.

System variable value condition edit form in the Canistracci OIL tenant.
System variable value condition edit form in the Canistracci OIL tenant.

Fields

Field or optionDescription
NameDisplay name used in condition lists and selectors.
TypeSelect System variable value.
System variableVariable name available in the call, such as CALLERID(num).
ValueValue to compare against.
Use as RegexTreats the value as a regular expression.

Example

FieldExample value
NameDocs Condition - System Variable Value
System variableCALLERID(num)
Value^1555

Destinations

For tenant conditions, select the destinations that should run when the condition matches and when it does not match. Global conditions are referenced by tenant-level Use a Global Condition records.

Editing and deleting

To edit this condition, open Docs Condition - System variable value from the Conditions list, adjust the fields, and select Save. Before deleting it, check IVRs, schedules, routes, feature codes, and other call-flow objects that may reference it.

Multiple extensions status

The Multiple extensions status type checks the combined state of multiple selected extensions.

Open Configuration > Conditions, select New Condition, enter a name, choose Multiple extensions status in the Type field, complete the type-specific fields, and select Save.

Multiple extensions status condition edit form in the Canistracci OIL tenant.
Multiple extensions status condition edit form in the Canistracci OIL tenant.

Fields

Field or optionDescription
NameDisplay name used in condition lists and selectors.
TypeSelect Multiple extensions status.
ExtensionsExtensions or numbered flows included in the check.
StateCombined state rule that must match.

Example

FieldExample value
NameDocs Condition - Multiple Extensions Status
Extensions100 and 101
StateAll users are online

Destinations

For tenant conditions, select the destinations that should run when the condition matches and when it does not match. Global conditions are referenced by tenant-level Use a Global Condition records.

Editing and deleting

To edit this condition, open Docs Condition - Multiple extensions status from the Conditions list, adjust the fields, and select Save. Before deleting it, check IVRs, schedules, routes, feature codes, and other call-flow objects that may reference it.

AGI Script

The AGI Script type runs an AGI script and compares the AGIRESULT variable with TRUE.

Open Configuration > Conditions, select New Condition, enter a name, choose AGI Script in the Type field, complete the type-specific fields, and select Save.

AGI Script condition edit form in the Canistracci OIL tenant.
AGI Script condition edit form in the Canistracci OIL tenant.

Fields

Field or optionDescription
NameDisplay name used in condition lists and selectors.
TypeSelect AGI Script.
AGI ScriptScript to execute.
Parameter 1-5Optional script parameters, depending on the selected script definition.
AGIRESULTThe script result variable must evaluate to TRUE for the condition to match.

Example

FieldExample value
NameDocs Condition - AGI Script
AGI ScriptDocs Demo AGI 1

Destinations

For tenant conditions, select the destinations that should run when the condition matches and when it does not match. Global conditions are referenced by tenant-level Use a Global Condition records.

Editing and deleting

To edit this condition, open Docs Condition - AGI Script from the Conditions list, adjust the fields, and select Save. Before deleting it, check IVRs, schedules, routes, feature codes, and other call-flow objects that may reference it.

Authenticate

The Authenticate type prompts the caller for a PIN and matches when authentication succeeds.

Open Configuration > Conditions, select New Condition, enter a name, choose Authenticate in the Type field, complete the type-specific fields, and select Save.

Authenticate condition edit form in the Canistracci OIL tenant.
Authenticate condition edit form in the Canistracci OIL tenant.

Fields

Field or optionDescription
NameDisplay name used in condition lists and selectors.
TypeSelect Authenticate.
Welcome MessagePrompt played before PIN entry.
PINValid PIN value. Additional PIN fields can define more accepted values.
Maximum digitsMaximum number of digits the caller can enter.
Wrong PIN MessagePrompt played after an invalid PIN.
Max attemptsHow many failed attempts are allowed.
TimeoutHow long to wait for digits.

Example

FieldExample value
NameDocs Condition - Authenticate
PIN1234
Max attempts3

Destinations

For tenant conditions, select the destinations that should run when the condition matches and when it does not match. Global conditions are referenced by tenant-level Use a Global Condition records.

Editing and deleting

To edit this condition, open Docs Condition - Authenticate from the Conditions list, adjust the fields, and select Save. Before deleting it, check IVRs, schedules, routes, feature codes, and other call-flow objects that may reference it.

Tenant - number of I/O channels (external)

The Tenant - number of I/O channels (external) type matches when the tenant has more than the configured number of external channels in use.

Open Configuration > Conditions, select New Condition, enter a name, choose Tenant - number of I/O channels (external) in the Type field, complete the type-specific fields, and select Save.

Tenant - number of I/O channels (external) condition edit form in the Canistracci OIL tenant.
Tenant - number of I/O channels (external) condition edit form in the Canistracci OIL tenant.

Fields

Field or optionDescription
NameDisplay name used in condition lists and selectors.
TypeSelect Tenant - number of I/O channels (external).
More than # of I/O channels usedExternal channel threshold.

Example

FieldExample value
NameDocs Condition - Tenant Channels
More than5

Destinations

For tenant conditions, select the destinations that should run when the condition matches and when it does not match. Global conditions are referenced by tenant-level Use a Global Condition records.

Editing and deleting

To edit this condition, open Docs Condition - Tenant - number of I/O channels (external) from the Conditions list, adjust the fields, and select Save. Before deleting it, check IVRs, schedules, routes, feature codes, and other call-flow objects that may reference it.

Tenant - number of any channels (internal and external)

The Tenant - number of any channels (internal and external) type matches when the tenant has more than the configured number of total channels in use.

Open Configuration > Conditions, select New Condition, enter a name, choose Tenant - number of any channels (internal and external) in the Type field, complete the type-specific fields, and select Save.

Tenant - number of any channels (internal and external) condition edit form in the Canistracci OIL tenant.
Tenant - number of any channels (internal and external) condition edit form in the Canistracci OIL tenant.

Fields

Field or optionDescription
NameDisplay name used in condition lists and selectors.
TypeSelect Tenant - number of any channels (internal and external).
More than # of any type of channels usedTotal channel threshold, including internal and external channels.

Example

FieldExample value
NameDocs Condition - Tenant Any Channels
More than10

Destinations

For tenant conditions, select the destinations that should run when the condition matches and when it does not match. Global conditions are referenced by tenant-level Use a Global Condition records.

Editing and deleting

To edit this condition, open Docs Condition - Tenant - number of any channels (internal and external) from the Conditions list, adjust the fields, and select Save. Before deleting it, check IVRs, schedules, routes, feature codes, and other call-flow objects that may reference it.

DID - number of inbound channels

The DID - number of inbound channels type matches when a selected DID has more than the configured number of inbound channels in use.

Open Configuration > Conditions, select New Condition, enter a name, choose DID - number of inbound channels in the Type field, complete the type-specific fields, and select Save.

DID - number of inbound channels condition edit form in the Canistracci OIL tenant.
DID - number of inbound channels condition edit form in the Canistracci OIL tenant.

Fields

Field or optionDescription
NameDisplay name used in condition lists and selectors.
TypeSelect DID - number of inbound channels.
DID to monitorDID whose inbound channel usage is checked.
More than # of channels usedInbound channel threshold.

Example

FieldExample value
NameDocs Condition - DID Channels
DIDDocs Demo DID 1
More than1

Destinations

For tenant conditions, select the destinations that should run when the condition matches and when it does not match. Global conditions are referenced by tenant-level Use a Global Condition records.

Editing and deleting

To edit this condition, open Docs Condition - DID - number of inbound channels from the Conditions list, adjust the fields, and select Save. Before deleting it, check IVRs, schedules, routes, feature codes, and other call-flow objects that may reference it.

Number of custom group channels

The Number of custom group channels type matches when a custom channel group has more than the configured number of active channels.

Open Configuration > Conditions, select New Condition, enter a name, choose Number of custom group channels in the Type field, complete the type-specific fields, and select Save.

Number of custom group channels condition edit form in the Canistracci OIL tenant.
Number of custom group channels condition edit form in the Canistracci OIL tenant.

Fields

Field or optionDescription
NameDisplay name used in condition lists and selectors.
TypeSelect Number of custom group channels.
Group nameCustom group name to count.
More than # of channels usedChannel count threshold.

Example

FieldExample value
NameDocs Condition - Channel Group Count
Group namesupport
More than2

Destinations

For tenant conditions, select the destinations that should run when the condition matches and when it does not match. Global conditions are referenced by tenant-level Use a Global Condition records.

Editing and deleting

To edit this condition, open Docs Condition - Number of custom group channels from the Conditions list, adjust the fields, and select Save. Before deleting it, check IVRs, schedules, routes, feature codes, and other call-flow objects that may reference it.

Answering Machine Detection

The Answering Machine Detection type runs answering machine detection and matches according to the analysis result.

Open Configuration > Conditions, select New Condition, enter a name, choose Answering Machine Detection in the Type field, complete the type-specific fields, and select Save.

Answering Machine Detection condition edit form in the Canistracci OIL tenant.
Answering Machine Detection condition edit form in the Canistracci OIL tenant.

Fields

Field or optionDescription
NameDisplay name used in condition lists and selectors.
TypeSelect Answering Machine Detection.
Initial silenceMaximum initial silence before greeting detection.
GreetingMaximum greeting duration.
After greeting, silenceSilence duration after greeting.
Total analysis timeMaximum analysis window.
Word settingsMinimum and maximum word lengths, silence between words, and maximum word count.
Silence thresholdAudio threshold used for silence detection.

Example

FieldExample value
NameDocs Condition - Answering Machine Detection
Total analysis time5000

Destinations

For tenant conditions, select the destinations that should run when the condition matches and when it does not match. Global conditions are referenced by tenant-level Use a Global Condition records.

Editing and deleting

To edit this condition, open Docs Condition - Answering Machine Detection from the Conditions list, adjust the fields, and select Save. Before deleting it, check IVRs, schedules, routes, feature codes, and other call-flow objects that may reference it.

SIP Header

The SIP Header type matches a SIP header against a regular expression.

Open Configuration > Conditions, select New Condition, enter a name, choose SIP Header in the Type field, complete the type-specific fields, and select Save.

SIP Header condition edit form in the Canistracci OIL tenant.
SIP Header condition edit form in the Canistracci OIL tenant.

Fields

Field or optionDescription
NameDisplay name used in condition lists and selectors.
TypeSelect SIP Header.
SIP HeaderHeader name to inspect.
Regular ExpressionExpression used to match the header value.

Example

FieldExample value
NameDocs Condition - SIP Header
SIP HeaderX-Account
Regular ExpressionAccounting

Destinations

For tenant conditions, select the destinations that should run when the condition matches and when it does not match. Global conditions are referenced by tenant-level Use a Global Condition records.

Editing and deleting

To edit this condition, open Docs Condition - SIP Header from the Conditions list, adjust the fields, and select Save. Before deleting it, check IVRs, schedules, routes, feature codes, and other call-flow objects that may reference it.

Agent logged in a queue

The Agent logged in a queue type matches when the selected agent is logged in to the selected queue.

Open Configuration > Conditions, select New Condition, enter a name, choose Agent logged in a queue in the Type field, complete the type-specific fields, and select Save.

Agent logged in a queue condition edit form in the Canistracci OIL tenant.
Agent logged in a queue condition edit form in the Canistracci OIL tenant.

Fields

Field or optionDescription
NameDisplay name used in condition lists and selectors.
TypeSelect Agent logged in a queue.
AgentAgent extension or external agent to check.
QueueQueue where login state is checked.

Example

FieldExample value
NameDocs Condition - Agent Logged In
Agent100 - Alex Reed
QueueAccounting

Destinations

For tenant conditions, select the destinations that should run when the condition matches and when it does not match. Global conditions are referenced by tenant-level Use a Global Condition records.

Editing and deleting

To edit this condition, open Docs Condition - Agent logged in a queue from the Conditions list, adjust the fields, and select Save. Before deleting it, check IVRs, schedules, routes, feature codes, and other call-flow objects that may reference it.

Agent paused from queue

The Agent paused from queue type matches when the selected agent is paused in the selected queue.

Open Configuration > Conditions, select New Condition, enter a name, choose Agent paused from queue in the Type field, complete the type-specific fields, and select Save.

Agent paused from queue condition edit form in the Canistracci OIL tenant.
Agent paused from queue condition edit form in the Canistracci OIL tenant.

Fields

Field or optionDescription
NameDisplay name used in condition lists and selectors.
TypeSelect Agent paused from queue.
AgentAgent extension or external agent to check.
QueueQueue where pause state is checked.

Example

FieldExample value
NameDocs Condition - Agent Paused
Agent100 - Alex Reed
QueueAccounting

Destinations

For tenant conditions, select the destinations that should run when the condition matches and when it does not match. Global conditions are referenced by tenant-level Use a Global Condition records.

Editing and deleting

To edit this condition, open Docs Condition - Agent paused from queue from the Conditions list, adjust the fields, and select Save. Before deleting it, check IVRs, schedules, routes, feature codes, and other call-flow objects that may reference it.

Caller ID in Phonebook

The Caller ID in Phonebook type matches when caller ID is found in a selected phone book.

Open Configuration > Conditions, select New Condition, enter a name, choose Caller ID in Phonebook in the Type field, complete the type-specific fields, and select Save.

Caller ID in Phonebook condition edit form in the Canistracci OIL tenant.
Caller ID in Phonebook condition edit form in the Canistracci OIL tenant.

Fields

Field or optionDescription
NameDisplay name used in condition lists and selectors.
TypeSelect Caller ID in Phonebook.
Caller IDCaller number to look up, usually provided dynamically during a call.
PhonebookPhone book used for the lookup.

Example

FieldExample value
NameDocs Condition - Caller ID in Phonebook
Caller ID${CALLERID(num)}
PhonebookDefault

Destinations

For tenant conditions, select the destinations that should run when the condition matches and when it does not match. Global conditions are referenced by tenant-level Use a Global Condition records.

Editing and deleting

To edit this condition, open Docs Condition - Caller ID in Phonebook from the Conditions list, adjust the fields, and select Save. Before deleting it, check IVRs, schedules, routes, feature codes, and other call-flow objects that may reference it.

Feature code parameter

The Feature code parameter type matches parameters collected by a feature code.

Open Configuration > Conditions, select New Condition, enter a name, choose Feature code parameter in the Type field, complete the type-specific fields, and select Save.

Feature code parameter condition edit form in the Canistracci OIL tenant.
Feature code parameter condition edit form in the Canistracci OIL tenant.

Fields

Field or optionDescription
NameDisplay name used in condition lists and selectors.
TypeSelect Feature code parameter.
ParameterParameter value to compare. Multiple parameter rows can be used.

Example

FieldExample value
NameDocs Condition - Feature Code Parameter
Parameter 142

Destinations

For tenant conditions, select the destinations that should run when the condition matches and when it does not match. Global conditions are referenced by tenant-level Use a Global Condition records.

Editing and deleting

To edit this condition, open Docs Condition - Feature code parameter from the Conditions list, adjust the fields, and select Save. Before deleting it, check IVRs, schedules, routes, feature codes, and other call-flow objects that may reference it.

All conditions listed satisfied

The All conditions listed satisfied type matches only when every selected condition is satisfied.

Open Configuration > Conditions, select New Condition, enter a name, choose All conditions listed satisfied in the Type field, complete the type-specific fields, and select Save.

All conditions listed satisfied condition edit form in the Canistracci OIL tenant.
All conditions listed satisfied condition edit form in the Canistracci OIL tenant.

Fields

Field or optionDescription
NameDisplay name used in condition lists and selectors.
TypeSelect All conditions listed satisfied.
ConditionsConditions that must all match.

Example

FieldExample value
NameDocs Condition - All Conditions
ConditionsWeektime and Weekday

Destinations

For tenant conditions, select the destinations that should run when the condition matches and when it does not match. Global conditions are referenced by tenant-level Use a Global Condition records.

Editing and deleting

To edit this condition, open Docs Condition - All conditions listed satisfied from the Conditions list, adjust the fields, and select Save. Before deleting it, check IVRs, schedules, routes, feature codes, and other call-flow objects that may reference it.

Any conditions listed satisfied

The Any conditions listed satisfied type matches when at least one selected condition is satisfied.

Open Configuration > Conditions, select New Condition, enter a name, choose Any conditions listed satisfied in the Type field, complete the type-specific fields, and select Save.

Any conditions listed satisfied condition edit form in the Canistracci OIL tenant.
Any conditions listed satisfied condition edit form in the Canistracci OIL tenant.

Fields

Field or optionDescription
NameDisplay name used in condition lists and selectors.
TypeSelect Any conditions listed satisfied.
ConditionsConditions where any one match is enough.

Example

FieldExample value
NameDocs Condition - Any Conditions
ConditionsWeektime or Caller ID

Destinations

For tenant conditions, select the destinations that should run when the condition matches and when it does not match. Global conditions are referenced by tenant-level Use a Global Condition records.

Editing and deleting

To edit this condition, open Docs Condition - Any conditions listed satisfied from the Conditions list, adjust the fields, and select Save. Before deleting it, check IVRs, schedules, routes, feature codes, and other call-flow objects that may reference it.

Negate condition result

The Negate condition result type matches when the selected condition does not match.

Open Configuration > Conditions, select New Condition, enter a name, choose Negate condition result in the Type field, complete the type-specific fields, and select Save.

Negate condition result condition edit form in the Canistracci OIL tenant.
Negate condition result condition edit form in the Canistracci OIL tenant.

Fields

Field or optionDescription
NameDisplay name used in condition lists and selectors.
TypeSelect Negate condition result.
ConditionCondition whose result is inverted.

Example

FieldExample value
NameDocs Condition - Negate Condition
ConditionDocs Condition - Weektime

Destinations

For tenant conditions, select the destinations that should run when the condition matches and when it does not match. Global conditions are referenced by tenant-level Use a Global Condition records.

Editing and deleting

To edit this condition, open Docs Condition - Negate condition result from the Conditions list, adjust the fields, and select Save. Before deleting it, check IVRs, schedules, routes, feature codes, and other call-flow objects that may reference it.

Use a Global Condition

The Use a Global Condition type references a global condition from the tenant configuration.

Open Configuration > Conditions, select New Condition, enter a name, choose Use a Global Condition in the Type field, complete the type-specific fields, and select Save.

Use a Global Condition condition edit form in the Canistracci OIL tenant.
Use a Global Condition condition edit form in the Canistracci OIL tenant.

Fields

Field or optionDescription
NameDisplay name used in condition lists and selectors.
TypeSelect Use a Global Condition.
ConditionGlobal condition to evaluate from this tenant.

Example

FieldExample value
NameDocs Condition - Use Global Condition
Global conditionDocs Global Condition - Weektime

Destinations

The global condition supplies the test. The tenant condition still defines the destinations that should run when the global test matches or does not match.

Editing and deleting

To edit this condition, open Docs Condition - Use a Global Condition from the Conditions list, adjust the fields, and select Save. Before deleting it, check IVRs, schedules, routes, feature codes, and other call-flow objects that may reference it.

Check SMS message

The Check SMS message type matches SMS message content.

Open Configuration > Conditions, select New Condition, enter a name, choose Check SMS message in the Type field, complete the type-specific fields, and select Save.

Check SMS message condition edit form in the Canistracci OIL tenant.
Check SMS message condition edit form in the Canistracci OIL tenant.

Fields

Field or optionDescription
NameDisplay name used in condition lists and selectors.
TypeSelect Check SMS message.
Message contentText or expression used to match the SMS body.
Case sensitiveRequires exact case matching.
Exact MatchCompares exact content without filtering characters.
Use regexTreats message content as a regular expression.

Example

FieldExample value
NameDocs Condition - Check SMS Message
Message contentSTOP

Destinations

For tenant conditions, select the destinations that should run when the condition matches and when it does not match. Global conditions are referenced by tenant-level Use a Global Condition records.

Editing and deleting

To edit this condition, open Docs Condition - Check SMS message from the Conditions list, adjust the fields, and select Save. Before deleting it, check IVRs, schedules, routes, feature codes, and other call-flow objects that may reference it.

Check if a specific channel is running

The Check if a specific channel is running type checks whether a channel matching the configured attributes is currently running.

Open Configuration > Conditions, select New Condition, enter a name, choose Check if a specific channel is running in the Type field, complete the type-specific fields, and select Save.

Check if a specific channel is running condition edit form in the Canistracci OIL tenant.
Check if a specific channel is running condition edit form in the Canistracci OIL tenant.

Fields

Field or optionDescription
NameDisplay name used in condition lists and selectors.
TypeSelect Check if a specific channel is running.
ChannelChannel name or pattern.
ContextDialplan context to match.
ExtensionDialplan extension to match.
StateChannel state to match.
CallerIDCaller ID value to match.

Example

FieldExample value
NameDocs Condition - Check Channel
ChannelPJSIP/100

Destinations

For tenant conditions, select the destinations that should run when the condition matches and when it does not match. Global conditions are referenced by tenant-level Use a Global Condition records.

Editing and deleting

To edit this condition, open Docs Condition - Check if a specific channel is running from the Conditions list, adjust the fields, and select Save. Before deleting it, check IVRs, schedules, routes, feature codes, and other call-flow objects that may reference it.

Multiple destination over weektime

The Multiple destination over weektime type routes to different destinations based on a color-coded weekly timetable.

Open Configuration > Conditions, select New Condition, enter a name, choose Multiple destination over weektime in the Type field, complete the type-specific fields, and select Save.

Multiple destination over weektime condition edit form in the Canistracci OIL tenant.
Multiple destination over weektime condition edit form in the Canistracci OIL tenant.

Fields

Field or optionDescription
NameDisplay name used in condition lists and selectors.
TypeSelect Multiple destination over weektime.
Color namesLabels for each timetable color.
TimetableWeekly grid where time blocks are assigned to colors.
DestinationsDestination selected for each color.

Example

FieldExample value
NameDocs Condition - Multiple Destination over Weektime
Color 1Open hours
Color 2After hours

Destinations

This type uses one destination group for each color in the weekly timetable.

Editing and deleting

To edit this condition, open Docs Condition - Multiple destination over weektime from the Conditions list, adjust the fields, and select Save. Before deleting it, check IVRs, schedules, routes, feature codes, and other call-flow objects that may reference it.

Call Screening using a random PIN

The Call Screening using a random PIN type screens a call by playing a prompt and asking the caller to enter a generated PIN.

Open Configuration > Conditions, select New Condition, enter a name, choose Call Screening using a random PIN in the Type field, complete the type-specific fields, and select Save.

Call Screening using a random PIN condition edit form in the Canistracci OIL tenant.
Call Screening using a random PIN condition edit form in the Canistracci OIL tenant.

Fields

Field or optionDescription
NameDisplay name used in condition lists and selectors.
TypeSelect Call Screening using a random PIN.
Welcome MessagePrompt played before PIN entry.
Wrong PIN MessagePrompt played after an invalid PIN.
Max attemptsHow many failed attempts are allowed.
TimeoutHow long to wait for digits.
PIN lengthLength of the generated PIN.

Example

FieldExample value
NameDocs Condition - Call Screening Random PIN
PIN length4

Destinations

For tenant conditions, select the destinations that should run when the condition matches and when it does not match. Global conditions are referenced by tenant-level Use a Global Condition records.

Editing and deleting

To edit this condition, open Docs Condition - Call Screening using a random PIN from the Conditions list, adjust the fields, and select Save. Before deleting it, check IVRs, schedules, routes, feature codes, and other call-flow objects that may reference it.

Caller has already called in

The Caller has already called in type checks recent inbound call history for the current caller.

Open Configuration > Conditions, select New Condition, enter a name, choose Caller has already called in in the Type field, complete the type-specific fields, and select Save.

Caller has already called in condition edit form in the Canistracci OIL tenant.
Caller has already called in condition edit form in the Canistracci OIL tenant.

Fields

Field or optionDescription
NameDisplay name used in condition lists and selectors.
TypeSelect Caller has already called in.
Lookup daysHow many days back to search.
Lookup hoursHow many hours back to search.
Match number of digitsHow many rightmost caller ID digits to compare.
DispositionCall result filter.
At leastMinimum call count and optional duration rule.

Example

FieldExample value
NameDocs Condition - Caller Already Called In
Lookup hours24
At least1 time

Destinations

For tenant conditions, select the destinations that should run when the condition matches and when it does not match. Global conditions are referenced by tenant-level Use a Global Condition records.

Editing and deleting

To edit this condition, open Docs Condition - Caller has already called in from the Conditions list, adjust the fields, and select Save. Before deleting it, check IVRs, schedules, routes, feature codes, and other call-flow objects that may reference it.

Caller has been called out

The Caller has been called out type checks recent outbound call history for the current caller.

Open Configuration > Conditions, select New Condition, enter a name, choose Caller has been called out in the Type field, complete the type-specific fields, and select Save.

Caller has been called out condition edit form in the Canistracci OIL tenant.
Caller has been called out condition edit form in the Canistracci OIL tenant.

Fields

Field or optionDescription
NameDisplay name used in condition lists and selectors.
TypeSelect Caller has been called out.
Lookup daysHow many days back to search.
Lookup hoursHow many hours back to search.
Match number of digitsHow many rightmost caller ID digits to compare.
DispositionCall result filter.

Example

FieldExample value
NameDocs Condition - Caller Already Called Out
Lookup hours24
DispositionAnswered

Destinations

For tenant conditions, select the destinations that should run when the condition matches and when it does not match. Global conditions are referenced by tenant-level Use a Global Condition records.

Editing and deleting

To edit this condition, open Docs Condition - Caller has been called out from the Conditions list, adjust the fields, and select Save. Before deleting it, check IVRs, schedules, routes, feature codes, and other call-flow objects that may reference it.

Queue Callers, more than

The Queue Callers, more than type matches when a selected queue has more than the configured number of callers waiting.

Open Configuration > Conditions, select New Condition, enter a name, choose Queue Callers, more than in the Type field, complete the type-specific fields, and select Save.

Queue Callers, more than condition edit form in the Canistracci OIL tenant.
Queue Callers, more than condition edit form in the Canistracci OIL tenant.

Fields

Field or optionDescription
NameDisplay name used in condition lists and selectors.
TypeSelect Queue Callers, more than.
QueueQueue to monitor.
More than # callersWaiting caller threshold.

Example

FieldExample value
NameDocs Condition - Queue Callers More Than
QueueAccounting
More than # callers3

Destinations

For tenant conditions, select the destinations that should run when the condition matches and when it does not match. Global conditions are referenced by tenant-level Use a Global Condition records.

Editing and deleting

To edit this condition, open Docs Condition - Queue Callers, more than from the Conditions list, adjust the fields, and select Save. Before deleting it, check IVRs, schedules, routes, feature codes, and other call-flow objects that may reference it.