# IVRs

# Overview

The **IVRs** page builds interactive voice response menus that collect DTMF or speech input and route callers. Open it from **Configuration > IVRs**.

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

<figure id="bkmrk-ivrs-list-page-in-th">![IVRs list page in the Canistracci OIL tenant.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/qxMivrs-list.png)<figcaption>IVRs list page in the Canistracci OIL tenant.</figcaption></figure>## Working with objects

<table id="bkmrk-taskhow-to-do-it-add"><thead><tr><th>Task</th><th>How to do it</th></tr></thead><tbody><tr><td>Add</td><td>Select the New IVR action, complete the form, and select Save.</td></tr><tr><td>Edit</td><td>Open the IVR from the list by selecting its name, number, or row action. Change the form and select Save.</td></tr><tr><td>Delete</td><td>Select the row checkbox and use Delete Selected, or open the IVR and select Delete, then confirm.</td></tr></tbody></table>

## Page functions

<table id="bkmrk-actiondescription-ne"><thead><tr><th>Action</th><th>Description</th></tr></thead><tbody><tr><td>New IVR</td><td>Opens the creation form for a new ivr.</td></tr><tr><td>Delete Selected</td><td>Deletes the selected rows after confirmation.</td></tr></tbody></table>

## List columns

<table id="bkmrk-columndescription-na"><thead><tr><th>Column</th><th>Description</th></tr></thead><tbody><tr><td>Name</td><td>Display name used in lists and references.</td></tr><tr><td>Welcome Message</td><td>Object setting shown by the form.</td></tr><tr><td>Allow Dialing Extensions</td><td>Target or routing selection used when the object sends a call or message onward.</td></tr><tr><td>Allow Dialing Feature Codes</td><td>Dialed value, identifier, or matching value used by the PBX.</td></tr><tr><td>Action</td><td>Object setting shown by the form.</td></tr></tbody></table>

## Demo records

The tenant contains 1 documentation demo record for this page: Docs Demo IVR 1.

## Deleting records

Before deleting a IVR, check references from call flows, destinations, schedules, reports, or provisioning objects. MiRTA PBX asks for confirmation before the delete is submitted.

# Create and Edit IVRs

Use this page when creating a new IVR or editing an existing IVR from **Configuration &gt; IVRs**.

The form screenshots below are separated by block where the application exposes separate sections. Complete the required values, review routing or destination references, and save the record.

## Add and edit form

<figure id="bkmrk-ivrs-add%2Fedit-form.">![IVRs add/edit form.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/FGjivrs-form.png)<figcaption>IVRs add/edit form.</figcaption></figure>## Main fields

<table id="bkmrk-fielddescription-nam"><thead><tr><th>Field</th><th>Description</th></tr></thead><tbody><tr><td>Name:</td><td>Display name used in lists and references.</td></tr><tr><td>Type:</td><td>Mode selector that changes the behavior of the object.</td></tr><tr><td>Speech to Text Language:</td><td>Language or voice selection used for prompts, transcription, or speech synthesis.</td></tr><tr><td>Min silence time (ms):</td><td>Object setting shown by the form.</td></tr><tr><td>Silence threshold:</td><td>Object setting shown by the form.</td></tr><tr><td>Messages playback:</td><td>Object setting shown by the form.</td></tr><tr><td>Menu selection timeout:</td><td>Timing value used by the service.</td></tr><tr><td>Digit timeout:</td><td>Timing value used by the service.</td></tr><tr><td>Max loop counts:</td><td>Object setting shown by the form.</td></tr><tr><td>Loop on timeout</td><td>Timing value used by the service.</td></tr><tr><td>Loop on wrong key press/word</td><td>Object setting shown by the form.</td></tr><tr><td>Allow dialing internal numbers</td><td>Dialed value, identifier, or matching value used by the PBX.</td></tr><tr><td>Allowed numbers:</td><td>Dialed value, identifier, or matching value used by the PBX.</td></tr><tr><td>Allow Custom Codes</td><td>Dialed value, identifier, or matching value used by the PBX.</td></tr><tr><td>Allow Dialing Feature Codes</td><td>Dialed value, identifier, or matching value used by the PBX.</td></tr></tbody></table>

## Voice IVR fields

<figure id="bkmrk-voice-ivr-field-set-">![Voice IVR field set shown after selecting Type: Voice.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/odiivrs-voice-ivr-fields.png)<figcaption>Voice IVR field set shown after selecting Type: Voice.</figcaption></figure>Set **Type** to **Voice** when callers should speak a word or short phrase instead of pressing DTMF digits. MiRTA PBX sends the captured audio to the configured Speech to Text service, compares the recognized text with the entries defined in the IVR, and then routes the call to the matching destination.

<table id="bkmrk-fielddescriptiontype"><thead><tr><th>Field</th><th>Description</th></tr></thead><tbody><tr><td>Type</td><td>Select Voice to hide the fixed DTMF key mappings and use spoken words or phrases as menu choices.</td></tr><tr><td>Speech to Text Language</td><td>Selects the speech-recognition language used to transcribe the caller audio before matching it against the IVR entries.</td></tr><tr><td>Min silence time (ms)</td><td>Amount of silence, in milliseconds, that MiRTA PBX waits before sending the captured speech to the Speech to Text engine. A higher value allows longer pauses inside a phrase; a lower value submits the audio sooner.</td></tr><tr><td>Silence threshold</td><td>Audio level below which the input is considered silence. Increase it in noisy environments; decrease it when quiet speech is being cut too early.</td></tr><tr><td>Welcome Message</td><td>Media played at the beginning of the IVR, normally only on the first pass through the menu.</td></tr><tr><td>Options Message</td><td>Media that explains the available spoken choices to the caller.</td></tr><tr><td>Messages playback</td><td>Controls whether welcome and options media are replayed during loops, only the options media is replayed, or no media is replayed.</td></tr><tr><td>Menu selection timeout</td><td>How long the IVR waits for speech before using the timeout behavior.</td></tr><tr><td>Loop on timeout</td><td>When enabled, the IVR repeats after a timeout instead of immediately following the timeout destination. Max loop counts limits how many retries are allowed.</td></tr><tr><td>Loop on wrong key press/word</td><td>When enabled, the IVR repeats after speech is recognized but does not match any configured word or phrase.</td></tr><tr><td>Entering</td><td>The word or short phrase to match after transcription, such as sales, support, billing, or operator.</td></tr><tr><td>Action to take</td><td>The destination used when the recognized word or phrase matches the Entering value.</td></tr><tr><td>On wrong key press/word</td><td>Fallback destination when the spoken input does not match any configured entry and looping is not used or has reached the maximum loop count.</td></tr><tr><td>On timeout</td><td>Fallback destination when no speech is detected before the menu selection timeout.</td></tr><tr><td>On hangup</td><td>Optional destination or action to run when the caller hangs up while inside the IVR.</td></tr></tbody></table>

Use short, distinct words for Voice IVR entries. Words that sound similar can be transcribed the same way, especially with background noise or low-quality audio.

## Saving and deleting

<table id="bkmrk-taskhow-to-do-it-cre"><thead><tr><th>Task</th><th>How to do it</th></tr></thead><tbody><tr><td>Create</td><td>Select the new action from the IVRs list, fill the required fields, and select Save.</td></tr><tr><td>Edit</td><td>Open the existing IVR, update the needed fields, and select Save.</td></tr><tr><td>Delete</td><td>Before deleting a IVR, check call-flow, destination, schedule, report, provisioning, or integration references. Use the row delete action or the form delete action when available, then confirm.</td></tr></tbody></table>