Actions and Conditions

Actions and Conditions work together to control how calls flow through an IVR.

Actions define what the system should do next, while Conditions evaluate caller input or call state to determine which path a call should follow. Together, they combine into logical, step-by-step IVR workflows — a Condition evaluates the call state, and the corresponding Action determines the next step. This logic allows administrators to build dynamic, intelligent call paths that adapt in real time.


Actions

Actions define the behavior that occurs once a Condition is met. They control what happens to the call, such as playing an announcement, routing the call to a queue or destination, or ending the interaction. Actions are executed sequentially and form the building blocks of the IVR call experience.

📘

Terminating Action

A terminating action is an action in the IVR that will result in the caller leaving the current IVR.

Drop Call

A terminating action that immediately disconnects the call.

FieldDescription
Action NameName of the action displayed in reporting and call flows.
Play AnnouncementOptional announcement played before the call is dropped.

Typically used after playing a final message, handling invalid input, or ending an IVR flow intentionally.

Forced Announcement

Plays an audio message that the caller cannot skip.

FieldDescription
Action NameName of the action displayed in reporting and call flows.
Play AnnouncementThe announcement played to the caller.

Commonly used for compliance messages, legal disclosures, emergency notices, or mandatory information before proceeding.

Transfer

A terminating action that transfers the call to a specified destination such as another IVR call flow, skill, agent, or dialable number.

FieldDescription
Action NameName of the action displayed in reporting and call flows.
Destination TypeThe transfer target: Transfer to IVR, Transfer to Skill, Transfer to Agent, or Transfer to Dialable Number.

This action is usually the final step before agent interaction.

Collect Digits

Prompts the caller to enter digits using their keypad (DTMF). The digit entry is finalized by the # key.

FieldDescription
Query NameName of the action displayed in reporting and call flows.
Session Parameter IDName of the key for the collected value; available as a parameter for other conditions and actions.
Play AnnouncementAnnouncement played when the call flow reaches this action.
Max Digits AllowedThe maximum number of digits accepted; defaults to Unlimited.
Digit Entry Confirmation LanguageThe language used for the announcements played during digit entry.
Timeout DurationThe maximum time given for the caller to input digits. If this time elapses, the digits entered up to that point are used.
Display Digits in Historical LoggingWhen enabled, the digits entered are displayed in reporting details alongside the session parameter ID.
Display to AgentWhen enabled, the digits entered are visible to the agent for the call alongside the session parameter ID.
Censor all but last four digitsWhen enabled, only the last four digits entered are displayed in reporting details and to the agent.

Used for collecting a string of digits such as menu selections, account numbers, PINs, or routing decisions based on caller input.

Examples could include:

  • Account Number
  • Extension
  • Date of Birth
  • Callback Number

Collect Confirmation

Prompts the caller to enter digits using their keypad (DTMF).

FieldDescription
Action NameName of the action displayed in reporting and call flows.
Session Parameter IDName of the key for the collected value; available as a parameter for other conditions and actions.
Consent AnnouncementThe announcement presented to the caller requesting confirmation.
Display Digits in Historical LoggingWhen enabled, the confirmation digit entered is displayed in reporting details alongside the session parameter ID.
Display to AgentWhen enabled, the confirmation digit entered is visible to the agent for the call alongside the session parameter ID.

Used for collecting binary responses from the caller such as consent to send SMS messages, gather permissions, and/or acknowledgement to compliances.

Examples could include:

  • "Do you agree?"
  • "Do you want to continue?"
  • "Do you approve this action?"
  • "May we text you?"

Confirm Caller Number

Prompts the caller to confirm their phone number using their keypad (DTMF).

FieldDescription
Action NameName of the action displayed in reporting and call flows.
Session Parameter IDName of the key for the collected value; available as a parameter for other conditions and actions.
Max Digits AllowedThe maximum number of digits accepted; defaults to Unlimited.
Timeout DurationThe maximum time given for the caller to input digits. If this time elapses, the digits entered up to that point are used.
Display Digits in Historical LoggingWhen enabled, the confirmation digit entered is displayed in reporting details alongside the session parameter ID.
Display to AgentWhen enabled, the confirmation digit entered is visible to the agent for the call alongside the session parameter ID.

Announcement Settings:

FieldDescription
Number Verification IntroThe first announcement played to the caller, reading back the digits entered for verification.
Number Confirmation PromptThe second announcement, asking the caller to confirm the digits are correct — 1 to confirm, 2 to reject.
Request Number PromptPlayed if the caller rejects the Number Confirmation Prompt, prompting them to re-enter the digits.
Confirmation Success AnnouncementPlayed once the caller confirms the digits are correct.
Digit Playback Language PackThe language used for the announcements played during confirmation.
Invalid Entry AnnouncementPlayed if the caller enters an invalid entry.

Used for confirming a call back number, a phone number to text and/or receive calls.

Set Parameter

An action that changes the behavior of the call flow and/or displays data to agents or in reporting.

FieldDescription
Action NameName of the action displayed in reporting and call flows.
Session Parameter IDName of the key for the value; available as a parameter for other conditions and actions.

Select one value source:

FieldDescription
Set as Static ValueAssigns a fixed string of text as the value whenever this action is triggered.
Set with Standard ParameterAssigns the value from a dropdown of existing standard parameters.
Set with Session ParameterAssigns the value from an existing Session Parameter ID.

Used to carry state forward through the rest of the call flow. Examples include:

  • Marking that a call recording disclosure has already been announced, so it is not repeated later in the flow
  • Flagging that the caller is a specific type of member
  • Recording that the caller passed identity verification, so downstream skills or groups do not repeat the check

Data Dip

An action used to request data from a database in a call flow.

FieldDescription
Query NameName of the action displayed in reporting and call flows.
Data Dip ProfileThe Data Dip Profile executed as this action.

Used for changing the call behavior based on data requested from a database about the calling party, displaying data from a database to agents during a live call, and/or displaying data from a database in reporting.

Digit Menu

A terminating action to transfer the caller out of the IVR and into a Digit Menu.

FieldDescription
Digit Menu ProfileThe Digit Menu Profile the caller is transferred into.

Used for completing an IVR for the caller to navigate into a "phone-tree."

Send SMS

An action that sends an SMS message to the caller or a verified number and can receive a reply.

🛑

Consent Required for SMS Messages

A documented consent must be obtained from the caller for SMS messaging. Consent should include clear information about SMS purposes, the applicable privacy policy, and instructions for HELP and STOP (opt-out). SMS-enabled numbers must be registered with The Campaign Registry and comply with the applicable 10DLC requirements.

FieldDescription
Action NameName of the action displayed in reporting and call flows.
Outbound SMS DIDDropdown to select the outbound SMS number used to send the message.
Consent ParameterThe Session Parameter ID used to check for SMS consent.
Target Number SourceCaller ID Number uses the caller's caller ID number as the SMS destination. Verified Number uses a Session Parameter ID obtained from caller input by another action, set via Target Number Session Parameter.

SMS Settings:

FieldDescription
SMS MessageThe text sent to the target SMS number.
Successfully Sent AnnouncementPlayed when the SMS was consented to and sent successfully.
Not Sent AnnouncementPlayed when the SMS was not consented to and therefore not sent.
Failed to Send AnnouncementPlayed when the SMS message failed to send.

Conditions

Conditions act as decision points within an IVR flow. They evaluate specific criteria - such as caller keypress input (DTMF), time of day, or menu selection - and determine which path the call should follow. Conditions enable IVRs to respond differently based on how or when a caller interacts with the system before being determined by an action.

Parameter

A condition used to check for a value that is conditionally met given a filter operator.

FieldDescription
Condition NameName of the condition displayed in reporting and call flows.
Parameter TypeSelect one: Standard Parameter, SIP Header, or Session Parameter.

Each parameter type has unique inputs that use named parameters (by type) to check a value given a conditional filter operator.

Example:

  • If the Parameter Condition is a Standard Parameter, the lookup key is set to DNIS and the lookup value is 1234, where the filter operator is set to CONTAINS, this parameter is conditionally met and will advance the call in the IVR to the next condition/action.

Standard Parameter

Using basic call information.

FieldDescription
ParameterOne of Caller ID, DNIS, External Number, or Tag.
OperatorThe comparison operator applied to the value.
ValueThe value being compared against.

SIP Header

Using common call header information.

FieldDescription
HeaderOne of FROM, FROM (Caller ID Only), CONTACT, TO, P-ASSERTED-IDENTITY, USER-AGENT, or REFERRED-BY.
OperatorThe comparison operator applied to the value.
ValueThe value being compared against.

Session Parameter

Using an expected named session parameter.

FieldDescription
Session ParameterThe name of an existing Session Parameter.
OperatorThe comparison operator applied to the value.
ValueThe value being compared against.

Holiday

A condition used to check for holidays in the IVR.

FieldDescription
Condition NameName of the condition displayed in reporting and call flows.
Holiday ProfileThe Holiday Profile evaluated by this condition.

Time of Day

A condition used to check for a schedule in the IVR.

FieldDescription
Condition NameName of the condition displayed in reporting and call flows.
Time of Day ProfileThe Time of Day Profile evaluated by this condition.
Condition is MetOutside of Profile Hours (False) or Inside of Profile Hours (True).