Page tree

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Updated for 13

titleThis wiki has been updated for version 13 of your PBX GUI.

Table of Contents


The System Recordings module allows for the management of built-in recordings and provides an easy-to-use interface for adding new recordings for IVRs, Announcements, Queues and so on. 

There are three ways to add System Recordings: uploading a file, recording within the browser, and recording over an extension.

Logging In

  • If you have not already done so, log in to the PBX UI
  • On the top menu click Admin
  • In the drop down click System Recordings

Image Removed

Adding a System Recording

There are two ways to add System Recordings. You can record from your phone or upload a file from your computer.

Recording From Your Phone

Step 1a: Simply enter your extension number in the field and click the Go Click the Add Recording button.

Image Removed

Step 1b: The message at the top will change, and it will instruct you to dial a feature code.

Image Removed

  • From your phone (the extension entered earlier), dial the feature code provided.
  • Simply start speaking at the tone and stop recording by pressing "#".
  • Optional: To listen to your recording, press "1". To erase and re-record, press "*" and press "#" when finished.
  • Hang up when done.

Step 2: If you didn't already verify your recording, or would like to do so again, you can dial the feature codes shown.

Image Removed

Step 3: To save the recording, enter a descriptive name in the field and then click the Save button. There is no Apply Config button.

Image Removed

A message will be displayed below step 3 to let you know the recording was saved successfully.
Image Removed 

Uploading a Sound File

You can upload a recording in any Asterisk-supported file format. Note that if you're using .wav, (i.e. recorded with Microsoft Recorder), the file must be PCM encoded, 16 Bits, at 8000Hz.

Step 1a: Click the Choose File button. Select a file that meets the above criteria.

Image Removed

Step 1b: Click the Upload button. A pop-up window will advise you to wait while the page reloads. Click the OK button right away, and then wait until the page reloads in your browser.

Image Removed

A message will let you know the file has been uploaded successfully.
Image Removed 

Step 2: The Name this Recording field is automatically populated with the file name. You can change the name to something more appropriate if desired. Click the Save button when finished. There is no Apply Config button.
Image Removed

A message will let you know the recording has been saved.
Image Removed 

Editing a System Recording

Choose your recording by clicking its name in the list at the right side of the page.

Image Removed

Once you click on the name, you will get the edit page.
Image Removed

Change Name

In this field, you may change the short name, which is visible on the right side of this module’s page.

Descriptive Name

This is displayed as a hint when selecting this recording in an IVR, Announcement, Queue, etc.

Link to Feature Code

Checking this box creates an optional feature code that can be used to re-record the System Recording. Users would be able to dial this feature code to directly re-record from their phone, eliminating the need for an Admin to create the new recording.

Feature Code Password

Optional password to protect the feature code from unauthorized (or accidental) re-recording.


In the files section you may string multiple audio files together, re-order them (by using the up/down arrow buttons), listen to them (by pressing the blue speaker button), or delete them (using the trash can button).

Re-recording an Existing System Recording

Image Added

Image Added


The name of the system recording on the file system. If it conflicts with another file, then this will overwrite it.


A description of this recording to help you identify it.

File List for (Language)

A sortable File List / play order. Here, you can string multiple files together into one recording. The playback will be done starting from the top to the bottom.

Image Added

  • Click the play icon Image Added to preview a file.
  • Click the X icon Image Added to remove a file.
  • Click on a file name and drag it up or down to a new position to change the playback order.


  • Note: if a file is red, it is missing for the selected language.
    Image Added 


Replacing a File (Re-Recording)

Files can be replaced by clicking them once, which will turn them green and place them into replace mode. (A dialog box will appear asking you to confirm that this is what you want to do.) The next recording you record or upload will then replace this green file upon save.
Image Added

Upload Recording

Allows upload of files from your local system. Supported upload formats are: WAV, aiff, alaw, flac, g719, g722, gsm, mp3, oga, ogg, sln, sln12, sln16, sln192, sln24, sln32, sln44, sln48, sln96, ulaw, wav, wav49. This includes multiple files, and archives that contain multiple files.

Click the Browse button to select a file from your computer. Or, drag and drop files from your desktop onto the Drop Multiple Files or Archives Here box.

Record in Browser

This will initiate a WebRTC request so that you will be able to record from you computer in your browser.

  • Click the red record button Image Added to begin recording. Your browser may alert you that the PBX is requesting access to your microphone. This is normal; click "Allow" or a similar option to permit access.
  • The record button will flash when recording is in progress.
  • Begin speaking, then press the stop button when finished. Image Added
  • Click the play button Image Added to review your recording.
  • Click the Save Recording to save the recording, or the Delete Recording button to delete it.

Image Added

Record Over Extension

The system will call the extension you specify. Upon hangup, you will be able to name the file and it will be placed in the list.

  • Enter the extension number the system should call.
  • Click the Call! button. The system will call the extension.
  • Answer the call and begin speaking after the beep. The GUI will display a message stating that recording is in progress. Hang up when finished.
    Image Added
  • At this point, you can save the recording or delete it. To delete it, click the Cancel button. To save it, enter a name in the Name this file field and then click the Save button.
    Image Added

Add System Recording

This option allows you to add any previously created system recording to the list of files above. To use this option, select a recording from the dropdown menu. It will be added to the file list.

Link to Feature Code

Yes/No: (Options not available on non-existent or compound recordings.) Whether to allow users to re-record the recording by dialing a feature code. Select Yes to create a feature code that will allow this recording to be changed directly by a user. This allows users to make their own changes without needing to contact an administrator.

Feature Code Password

(Optional) If the Link to Feature Code option is set to Yes, this password can prevent unauthorized users from accessing the feature code for the recording. Users will need to enter this password before they can re-record the recording via the feature code. Enter digits only. If the Link to Feature Code option is set to No, this field will be grayed-out.

Convert To

The file formats you would like this system recording to be encoded into. Options include alawg719g722gsm, slnulawwav, and wav49. Select one or more file formats.


When finished, click the Submit button and then click the Apply Config button.

Re-Recording an Existing System Recording

Re-Record via Phone

The easiest way to revise the audio in an existing system recording is to use a feature code and a phone handset.

  • Ensure that the system recording has the "Link to Feature Code" option enabled as described earlier in this wiki. Note the displayed feature code. It will be something like *292.
  • If the re-record password option Feature Code Password option has been enabled and a password is set, note the password as well, as you will need to enter this numeric password before you will be allowed the change the system recording.

Once these one-time steps have been performed, the recording can be re-recorded from any phone without further interaction with the administrative Web UI. Here is the procedure to re-record an existing system greeting using the defined feature code.:

  • Call Dial the feature code from a phone handset (for example, dial *292)on the system.
  • Follow the system prompts to re-record the system recording.
  • After confirming the new recording, just hang up.

Re-Record via GUI

An admin can use the GUI to replace a sound file with a new recording.

  • From the System Recordings home screen, click the edit button Image Added next to the appropriate recording.
  • The current file(s) for the system recording will be shown in the File List near the top of the page.
  • Please see the Replacing a File (Re-Recording) section earlier in this wiki for instructions on how to replace a file.