# Edit Settings

Use this page to edit tenant-wide settings from **Configuration &gt; Settings**. The settings are stored directly for the selected tenant, so review each block before saving.

The screenshots below show the form block by block in the **Canistracci OIL** tenant.

## Form sections

<table id="bkmrk-sectiondescription-s"><thead><tr><th>Section</th><th>Description</th></tr></thead><tbody><tr><td>Settings</td><td>Object-specific settings that change runtime behavior.</td></tr><tr><td>Dialing</td><td>Settings shown in the Dialing block.</td></tr><tr><td>Diversion field for External Agents</td><td>Agent assignment and queue membership behavior.</td></tr><tr><td>Autocreated Custom Destination</td><td>Settings shown in the Autocreated Custom Destination block.</td></tr><tr><td>Recording</td><td>Recording storage and recording-related options.</td></tr><tr><td>Voice Synthesizer</td><td>Voice calling behavior, caller handling, recording, and voice-specific limits.</td></tr><tr><td>Speech to Text</td><td>Settings shown in the Speech to Text block.</td></tr><tr><td>Generative Artificial Intelligent chat models</td><td>Settings shown in the Generative Artificial Intelligent chat models block.</td></tr><tr><td>Dial By Name Directory</td><td>Settings shown in the Dial By Name Directory block.</td></tr><tr><td>CNAM service</td><td>Settings shown in the CNAM service block.</td></tr><tr><td>Faxing</td><td>Fax handling, quality, storage, delivery, and fax-specific transport settings.</td></tr><tr><td>MS Teams integration</td><td>Settings shown in the MS Teams integration block.</td></tr><tr><td>API Interface</td><td>API-related credentials, restrictions, and integration controls.</td></tr><tr><td>Default Music On Hold</td><td>Settings shown in the Default Music On Hold block.</td></tr><tr><td>Unassigned DID destination</td><td>Settings shown in the Unassigned DID destination block.</td></tr><tr><td>General DID destination</td><td>Settings shown in the General DID destination block.</td></tr><tr><td>General Outbound destination</td><td>Settings shown in the General Outbound destination block.</td></tr><tr><td>Emergency numbers notification</td><td>Settings shown in the Emergency numbers notification block.</td></tr><tr><td>Security</td><td>Tenant security, limits, and access controls.</td></tr><tr><td>Call Settings</td><td>Object-specific settings that change runtime behavior.</td></tr><tr><td>Outbound Calls</td><td>Settings shown in the Outbound Calls block.</td></tr><tr><td>CSV Exports</td><td>Settings shown in the CSV Exports block.</td></tr><tr><td>Voicemail Settings</td><td>Voice calling behavior, caller handling, recording, and voice-specific limits.</td></tr><tr><td>Voicemail backup</td><td>Voice calling behavior, caller handling, recording, and voice-specific limits.</td></tr></tbody></table>

### Settings

<figure id="bkmrk-settings-section-on-">![Settings section on the page.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/xXRsettings-page-section-1.png)<figcaption>Settings section on the page.</figcaption></figure>Object-specific settings that change runtime behavior.

### Dialing

<figure id="bkmrk-dialing-section-on-t">![Dialing section on the page.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/zbSsettings-page-section-2.png)<figcaption>Dialing section on the page.</figcaption></figure>Settings shown in the Dialing block.

### Diversion field for External Agents

<figure id="bkmrk-diversion-field-for--1">![Diversion field for External Agents section on the page.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/0cVsettings-page-section-3.png)<figcaption>Diversion field for External Agents section on the page.</figcaption></figure>Agent assignment and queue membership behavior.

### Autocreated Custom Destination

<figure id="bkmrk-autocreated-custom-d-1">![Autocreated Custom Destination section on the page.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/A6msettings-page-section-4.png)<figcaption>Autocreated Custom Destination section on the page.</figcaption></figure>Settings shown in the Autocreated Custom Destination block.

### Recording

<figure id="bkmrk-recording-section-on">![Recording section on the page.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/s1Isettings-page-section-5.png)<figcaption>Recording section on the page.</figcaption></figure>Recording storage and recording-related options.

### Voice Synthesizer

<figure id="bkmrk-voice-synthesizer-se">![Voice Synthesizer section on the page.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/Plusettings-page-section-6.png)<figcaption>Voice Synthesizer section on the page.</figcaption></figure>Voice calling behavior, caller handling, recording, and voice-specific limits.

### Speech to Text

The **Speech to Text** block configures the recognition engine used by the selected tenant. The screenshots use fictional values in the **Canistracci Oil** tenant. Do not save these values on a production system.

Choose **System Default** when the tenant should inherit the global engine and credentials. Choose a specific engine when this tenant needs its own language, endpoint, credentials, model, or provider-specific options.

#### System Default

<figure id="bkmrk-speech-to-text-setti">![Speech to Text settings for System Default with fictional documentation values.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/QRcsettings-speech-to-text-system-default.png)<figcaption>Speech to Text settings for System Default with fictional documentation values.</figcaption></figure><table id="bkmrk-fieldmeaning-engineu"><thead><tr><th>Field</th><th>Meaning</th></tr></thead><tbody><tr><td>Engine</td><td>Use **System Default** to inherit the global Speech to Text engine. This is the normal choice when all tenants share the same transcription provider.</td></tr><tr><td>Language</td><td>Leave as **System Default** to inherit the global language selection. If a tenant override is available, select the language expected for that tenant audio.</td></tr><tr><td>Speech To Text Engine API password</td><td>Leave empty to inherit the global secret. Fill it only when the tenant must override the credential used by the inherited engine.</td></tr><tr><td>Minimum call time for transcript</td><td>Calls shorter than this number of seconds are not sent for transcription. This avoids sending very short recordings to the external service.</td></tr><tr><td>Test speech recognition</td><td>Upload a WAV file and select **Test** to verify the currently selected engine configuration before relying on it for call transcripts.</td></tr></tbody></table>

#### IBM Watson TTS

<figure id="bkmrk-speech-to-text-setti-1">![Speech to Text settings for IBM Watson TTS with fictional documentation values.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/i34settings-speech-to-text-ibm-watson-tts.png)<figcaption>Speech to Text settings for IBM Watson TTS with fictional documentation values.</figcaption></figure><table id="bkmrk-fieldmeaning-engines"><thead><tr><th>Field</th><th>Meaning</th></tr></thead><tbody><tr><td>Engine</td><td>Selects IBM Watson as the tenant Speech to Text provider. The historical engine name includes TTS, but this block is used for speech recognition.</td></tr><tr><td>Full Endpoint URL</td><td>Watson recognition endpoint, including the service instance path. Use the recognize endpoint supplied by IBM for the tenant account or service instance.</td></tr><tr><td>Language</td><td>Recognition model used by Watson, such as an American English broadband model. Choose the model that matches the audio language and expected bandwidth.</td></tr><tr><td>Speech To Text Engine API username</td><td>Watson credential username. Many IBM deployments use `apikey` as the username when authenticating with an API key.</td></tr><tr><td>Speech To Text Engine API password</td><td>Watson API key or password. The screenshot uses a fictional value.</td></tr><tr><td>Minimum call time for transcript</td><td>Minimum recording duration, in seconds, before MiRTA PBX attempts transcription.</td></tr><tr><td>Test speech recognition</td><td>Runs a test upload through the configured Watson settings.</td></tr></tbody></table>

#### Nexiwave

<figure id="bkmrk-speech-to-text-setti-2">![Speech to Text settings for Nexiwave with fictional documentation values.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/tdWsettings-speech-to-text-nexiwave.png)<figcaption>Speech to Text settings for Nexiwave with fictional documentation values.</figcaption></figure><table id="bkmrk-fieldmeaning-engines-1"><thead><tr><th>Field</th><th>Meaning</th></tr></thead><tbody><tr><td>Engine</td><td>Selects Nexiwave as the tenant Speech to Text provider.</td></tr><tr><td>Language</td><td>Language sent to Nexiwave for recognition. The installed option shown in the example is English.</td></tr><tr><td>Speech To Text Engine API username</td><td>Nexiwave account username for the tenant-specific integration.</td></tr><tr><td>Speech To Text Engine API password</td><td>Nexiwave password or API secret. The screenshot uses a fictional value.</td></tr><tr><td>Minimum call time for transcript</td><td>Minimum recording duration before the call is eligible for transcription.</td></tr><tr><td>Test speech recognition</td><td>Uploads a WAV file to test the configured Nexiwave credentials and language.</td></tr></tbody></table>

#### Google Cloud Speech to Text

<figure id="bkmrk-speech-to-text-setti-3">![Speech to Text settings for Google Cloud Speech to Text with fictional documentation values.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/DGrsettings-speech-to-text-google-cloud-speech-to-text.png)<figcaption>Speech to Text settings for Google Cloud Speech to Text with fictional documentation values.</figcaption></figure><table id="bkmrk-fieldmeaning-engines-2"><thead><tr><th>Field</th><th>Meaning</th></tr></thead><tbody><tr><td>Engine</td><td>Selects Google Cloud Speech to Text for tenant transcription.</td></tr><tr><td>Language</td><td>Google recognition language code. Choose the language that best matches the callers; the example uses English (United States).</td></tr><tr><td>Speech To Text Engine API password</td><td>Google API key used when audio is submitted directly without a storage bucket. Leave empty only when the deployment inherits the value elsewhere.</td></tr><tr><td>JSON Service Account key</td><td>Service account JSON used when audio is uploaded to Google Cloud Storage before transcription. The account must have access to the bucket.</td></tr><tr><td>Bucket Name</td><td>Google Cloud Storage bucket used to stage audio for transcription. The bucket must already exist and be accessible by the service account.</td></tr><tr><td>Profanity filter</td><td>Controls whether Google should attempt to mask profanity in returned transcripts. Use **System Default** to inherit the global behavior, or force **Yes** or **No** for this tenant.</td></tr><tr><td>Minimum call time for transcript</td><td>Minimum recording duration before MiRTA PBX sends the call to Google.</td></tr><tr><td>Test speech recognition</td><td>Uploads a WAV file and validates the Google configuration.</td></tr></tbody></table>

#### AssemblyAI

<figure id="bkmrk-speech-to-text-setti-4">![Speech to Text settings for AssemblyAI with fictional documentation values.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/jmXsettings-speech-to-text-assemblyai.png)<figcaption>Speech to Text settings for AssemblyAI with fictional documentation values.</figcaption></figure><table id="bkmrk-fieldmeaning-engines-3"><thead><tr><th>Field</th><th>Meaning</th></tr></thead><tbody><tr><td>Engine</td><td>Selects AssemblyAI as the tenant Speech to Text provider.</td></tr><tr><td>Endpoint server</td><td>AssemblyAI API host. Leave empty for the platform default, or set a host such as `api.assemblyai.com` when documenting or overriding the endpoint.</td></tr><tr><td>Model</td><td>AssemblyAI model used for the transcript request. Use the stronger model when accuracy matters, or a fallback combination when availability is more important.</td></tr><tr><td>Language</td><td>Language sent to AssemblyAI. **Automatic** lets AssemblyAI detect the language, while a specific language restricts recognition to that language.</td></tr><tr><td>Speech To Text Engine API password</td><td>AssemblyAI API token. The screenshot uses a fictional value.</td></tr><tr><td>Minimum call time for transcript</td><td>Minimum recording duration before the call is eligible for transcription.</td></tr><tr><td>Test speech recognition</td><td>Uploads a WAV file to test the AssemblyAI endpoint, model, token, and language choices.</td></tr></tbody></table>

Some installations also render AssemblyAI tuning fields for key terms and custom spelling. When present, use key terms to bias recognition toward tenant names or PBX terminology, and use custom spelling for corrections such as `heard term:correct spelling`.

#### GeminiAI

<figure id="bkmrk-speech-to-text-setti-5">![Speech to Text settings for GeminiAI with fictional documentation values.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/ETysettings-speech-to-text-geminiai.png)<figcaption>Speech to Text settings for GeminiAI with fictional documentation values.</figcaption></figure><table id="bkmrk-fieldmeaning-engines-4"><thead><tr><th>Field</th><th>Meaning</th></tr></thead><tbody><tr><td>Engine</td><td>Selects GeminiAI for speech recognition through a generative AI model.</td></tr><tr><td>Model</td><td>Gemini model used for transcription. Select the model according to the required balance of speed, cost, and accuracy.</td></tr><tr><td>Model command</td><td>Instruction sent to the model for the transcription task. Leave it empty to use the default command, or provide tenant-specific instructions such as speaker separation and terminology handling.</td></tr><tr><td>Language</td><td>Recognition language. The GeminiAI language list can be left at the inherited value or set to an available language option such as any language.</td></tr><tr><td>Speech To Text Engine API password</td><td>Gemini API key. The screenshot uses a fictional value.</td></tr><tr><td>Minimum call time for transcript</td><td>Minimum recording duration before MiRTA PBX asks GeminiAI to transcribe the call.</td></tr><tr><td>Test speech recognition</td><td>Uploads a WAV file and verifies the GeminiAI model, command, key, and language settings.</td></tr></tbody></table>

#### Operational Notes

- Speech recognition is an external-service workflow. Confirm provider cost, privacy, retention, and data-processing requirements before enabling it for a tenant.
- The selected engine, language, credentials, and provider-specific fields are read when a recording is submitted for transcription. Changing these settings affects future transcription attempts.
- Use the test upload after changing credentials, language, endpoint, bucket, or model options. A successful test is the quickest confirmation that the tenant-level override is usable.

### Generative Artificial Intelligent chat models

<figure id="bkmrk-generative-artificia-1">![Generative Artificial Intelligent chat models section on the page.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/m1fsettings-page-section-8.png)<figcaption>Generative Artificial Intelligent chat models section on the page.</figcaption></figure>Settings shown in the Generative Artificial Intelligent chat models block.

### Dial By Name Directory

<figure id="bkmrk-dial-by-name-directo-1">![Dial By Name Directory section on the page.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/4xksettings-page-section-9.png)<figcaption>Dial By Name Directory section on the page.</figcaption></figure>Settings shown in the Dial By Name Directory block.

### CNAM service

<figure id="bkmrk-cnam-service-section">![CNAM service section on the page.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/fy7settings-page-section-10.png)<figcaption>CNAM service section on the page.</figcaption></figure>Settings shown in the CNAM service block.

### Faxing

<figure id="bkmrk-faxing-section-on-th">![Faxing section on the page.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/b1Nsettings-page-section-11.png)<figcaption>Faxing section on the page.</figcaption></figure>Fax handling, quality, storage, delivery, and fax-specific transport settings.

### MS Teams integration

<figure id="bkmrk-ms-teams-integration-1">![MS Teams integration section on the page.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/wK5settings-page-section-12.png)<figcaption>MS Teams integration section on the page.</figcaption></figure>Settings shown in the MS Teams integration block.

### API Interface

<figure id="bkmrk-api-interface-sectio">![API Interface section on the page.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/ej5settings-page-section-13.png)<figcaption>API Interface section on the page.</figcaption></figure>API-related credentials, restrictions, and integration controls.

### Default Music On Hold

<figure id="bkmrk-default-music-on-hol-1">![Default Music On Hold section on the page.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/SRMsettings-page-section-14.png)<figcaption>Default Music On Hold section on the page.</figcaption></figure>Settings shown in the Default Music On Hold block.

### Unassigned DID destination

<figure id="bkmrk-unassigned-did-desti-1">![Unassigned DID destination section on the page.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/Of2settings-page-section-15.png)<figcaption>Unassigned DID destination section on the page.</figcaption></figure>Settings shown in the Unassigned DID destination block.

### General DID destination

<figure id="bkmrk-general-did-destinat-1">![General DID destination section on the page.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/o7Bsettings-page-section-16.png)<figcaption>General DID destination section on the page.</figcaption></figure>Settings shown in the General DID destination block.

### General Outbound destination

<figure id="bkmrk-general-outbound-des-1">![General Outbound destination section on the page.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/tW2settings-page-section-17.png)<figcaption>General Outbound destination section on the page.</figcaption></figure>Settings shown in the General Outbound destination block.

### Emergency numbers notification

<figure id="bkmrk-emergency-numbers-no-1">![Emergency numbers notification section on the page.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/8O9settings-page-section-18.png)<figcaption>Emergency numbers notification section on the page.</figcaption></figure>Settings shown in the Emergency numbers notification block.

### Security

<figure id="bkmrk-security-section-on-">![Security section on the page.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/WWvsettings-page-section-19.png)<figcaption>Security section on the page.</figcaption></figure>Tenant security, limits, and access controls.

### Call Settings

<figure id="bkmrk-call-settings-sectio">![Call Settings section on the page.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/Tkbsettings-page-section-20.png)<figcaption>Call Settings section on the page.</figcaption></figure>Object-specific settings that change runtime behavior.

### Outbound Calls

<figure id="bkmrk-outbound-calls-secti">![Outbound Calls section on the page.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/KSSsettings-page-section-21.png)<figcaption>Outbound Calls section on the page.</figcaption></figure>Settings shown in the Outbound Calls block.

### CSV Exports

<figure id="bkmrk-csv-exports-section-">![CSV Exports section on the page.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/LQKsettings-page-section-22.png)<figcaption>CSV Exports section on the page.</figcaption></figure>Settings shown in the CSV Exports block.

### Voicemail Settings

<figure id="bkmrk-voicemail-settings-s">![Voicemail Settings section on the page.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/SNXsettings-page-section-23.png)<figcaption>Voicemail Settings section on the page.</figcaption></figure>Voice calling behavior, caller handling, recording, and voice-specific limits.

### Voicemail backup

<figure id="bkmrk-voicemail-backup-sec">![Voicemail backup section on the page.](https://manual.mirtapbx.com/uploads/images/gallery/2026-06/PVmsettings-page-section-24.png)<figcaption>Voicemail backup section on the page.</figcaption></figure>Voice calling behavior, caller handling, recording, and voice-specific limits.

## Saving changes

<table id="bkmrk-taskhow-to-do-it-edi"><thead><tr><th>Task</th><th>How to do it</th></tr></thead><tbody><tr><td>Edit</td><td>Change the required tenant settings in the relevant block, then select Save.</td></tr><tr><td>Linked pages</td><td>Use the buttons inside Settings to open related management pages such as CNAM cache, manager users, routing rules, and PIN codes.</td></tr><tr><td>Delete</td><td>Settings itself is not deleted. Delete actions are handled on the linked object pages.</td></tr></tbody></table>