Howto13r1:Record an announcement by phone: Difference between revisions

From innovaphone wiki
Jump to navigation Jump to search
Line 106: Line 106:


==Use other languages==
==Use other languages==
Each language-directory contains the necessary prompts, needed by the script. The script needs the following files from the voicemail-scripts provided by innovaphone:
Each language-directory contains the necessary prompts needed by the script.  
The script needs the following files from the voicemail-scripts provided by innovaphone:


:* beep.g711a
:* beep.g711a
Line 119: Line 120:
:* silence_g711a
:* silence_g711a


These files can be found in the older download-site from innovaphone (https://download.innovaphone.com/) under ‘Version 6 Releases’ - > apps.
These files can be found in the (older) download-site from innovaphone (https://download.innovaphone.com/) under ‘Version 6 Releases’ - > apps. Different languange can be found there.
 
Please note that the Files-app from innovaphone is case-sensitive and the folder (‘xx’), must be the same as the file-prefix above.


Please note that the Files-app from innovaphone is case-sensitive and the folder (‘xx’), must have the same name as the file-prefix above.


Example if we would like to add the Spanish prompts too:


==Download==
==Download==

Revision as of 16:16, 8 June 2021


Applies To

This information applies to

  • All PBX’s running version 13 with an Application Platform (AP)


More Information

Sometimes customers want to record dynamic announcements using a phone for announcing public holidays of special on-the-fly messages. This can be achieved easily by adding some scripts and objects. Voicemail licenses are mandatory as the script uses audio files of the innovaphone voicemail packages. When the announcements are replaced by own recordings, no voicemail licenses are needed.

Configuration

Download the files

The script and the announcements can be downloaded in the download-section and include English, Dutch, German, French and Norwegian prompt. If other languages are required, please follow the instructions in the ‘Use other languages’-section.

Copy the files

Upload the content of the downloaded zip-file with the Files-app to the Application Platform. In the example below we fist created the ‘/Scripts/Record’-directory.

The directory of the script will contain the following content:

  • The ‘Record.xml’-file containing the logic.
  • A directory where the announcements will be stored: ‘RecordedMessages’. Please do not delete this directory, or change the name.
  • Multiple language-directories, for each language one (eg: ‘en’). Languages which are not needed can be deleted safely.


001 copy files.png

Share the Record-directory

As the script must be available for the PBX, we need to share the ‘Record’-directory with a username and a password (strong password advised)

003 share record dir.png

After sharing the folder, we need to know the path of the directory. So we open this directory and click on the upper-right ‘i’-icon and copy the URL (we will need it later on).

004 link record dir.png

URL: https://apps.voipserver.online/voipserver.online/files/root/Scripts/Record

Share the RecordMessages-directory

The ‘RecordMessages’-directory must be shared too, but now with a filekey:

005 share recordedmessage dir 2.png

After sharing the folder we can also copy the path of the URL, but this is only needed if you want to configure the waiting queue (see further) via the Advanced UI instead of the 'PBX Manager -> Waiting Queue'-app.

005 link recordedmessage dir.png

Create ‘Voicemail’-object to reach the script

Open the Advanced UI of the PBX and navigate to the objects of the PBX: ‘PBX -> Objects’.

Create a new ‘Voicemail’-object:

  • General -> Long Name: ‘Record Holiday’
  • General -> Name: ‘record.holiday’
  • General -> Number: ##1
  • Voicemail -> URL: ‘https://apps.voipserver.online/voipserver.online/files/root/Scripts/Record/Record.xml‘
  • Voicemail -> User: ‘record_script’
  • Voicemail -> Password: (the_strong_password_set_earlier)

006 create vm 2.png

006 create vm 3.png

Options to the URL:

  • $_lang: specifies the folder and the prefix of the prompts being used by the script (if omitted: ‘en’ is supposed).
  • $_fileName: specifies the name of the file of the recorded message (if omitted: 'RecordedMessage' is supposed).

By creating multiple Voicemail-objects pointing to the same script, but with a different filename, you can record multiple dynamic announcements.

Example: if we want to record an announcement named ‘Holiday’ with Dutch prompts, we can change the URL above to:

https://apps.voipserver.online/voipserver.online/files/root/Scripts/Record/Record.xml?$_lang=nl&$_filename=Holiday

Record an announcement

Call the number of the voicemail-script pointing to the Record-script just created and follow the instructions:

  • “To record a new personal announcement, press 1. To listen to the current personal announcement: press 2. To delete the current personal announcement: press 3. To return to the main menu: press star”: press 1.
  • “Please speak after the signal. To finish press any key + “: Record your announcement + press a key.
  • “The message is being played “ + “To save: press 2. To cancel: press *”: Press 2.
  • “The message have been saved.’.

Result in the Files-app:

007 record file.png

Create ‘Waiting Queue’ to use the announcement

  • Open the ‘PBX Manager’-app and click on the ‘Waiting Queues’-app.

008 add wq 1.png

  • Add a new waiting queue:

008 add wq 2.png

  • Configure an announcement (we adjusted the announcement to be played continuesly):

008 add wq 3.png

008 add wq 4.png

008 add wq 5.png

  • Configure the ‘Time to announcement(s)’:

008 add wq 6.png

Now the Waiting Queue can be tested by dialling the number...

Use other languages

Each language-directory contains the necessary prompts needed by the script. The script needs the following files from the voicemail-scripts provided by innovaphone:

  • beep.g711a
  • xx_cancel.g711a
  • xx_menu_voicebox_greetings_personal.g711a
  • xx_message_deleted.g711a
  • xx_message_saved.g711a
  • xx_not_available.g711a
  • xx_please_speak_after_the_signal.g711a
  • xx_press_key_to_end.g711a
  • xx_save_2_cancel_star.g711a
  • silence_g711a

These files can be found in the (older) download-site from innovaphone (https://download.innovaphone.com/) under ‘Version 6 Releases’ - > apps. Different languange can be found there.

Please note that the Files-app from innovaphone is case-sensitive and the folder (‘xx’), must have the same name as the file-prefix above.

Example if we would like to add the Spanish prompts too:

Download