Usage

Convert waw recordings to mp3

Cloud installation:

  1. Create a new container in Azure to store the converted recordings. You can name it “voicerecordmp3” for example.

    Note

    Having the source and destination of recordings in the same container is not recommended.

  2. In FrontStage administration, create a new repository that you map to a container in Azure

    • Open the device list, PBX and IVR ‣ Devices, create a new entry here

    • Type - choose “StorageAzureBlob”

    • Choose a suitable Name

    • The JSON configuration entry must contain a valid “connection string” to Azure, including the parameters for the conversion. Important parameters:

      • ContainerName - must match the name of the container created in the item #1, e.g. “voicerecordmp3”

      • MediaExtension - output file format, e.g. .mp3

      • CommandLine - in this case it must be ffmpeg

      • CommandParams - setting parameters for the ffmpeg utility. For basic functionality, specify: -i {0} -b:a 16k {1}. For more information, see the official documentation

    ../../../_images/sm-convert-storage.en.png
  3. In FrontStage Administration, create a new conversion rule that connects the source and destination repositories

    • Open the rules list, Configuration ‣ Content rules, create a new entry here. For it, fill in:

    • Action - set to “Convert”

    • Source storage - must match the Key parameter for the source storage

    • Target value - must match the Key parameter for the target repository, see screen above

    • Item type - set to “Voice Record”

    ../../../_images/sm-convert-content_rule.en.png

Local installation

  1. Create a folder on your disk to store the converted recordings.

  2. In FrontStage Administration, create a new repository that maps to the folder you created

    • Open the device list, PBX and IVR ‣ Devices, create a new entry here

    • Type - choose “StorageFileHierarchy”

    • Choose a suitable Name

    • The JSON configuration item contains parameters for conversion and mapping:

      • RootDirectoryPath - the path to the folder to store the converted recordings. For example: E:\\Atlantis\\Records-Mp3

      • MediaExtension - output file format, e.g. .mp3

      • CommandLine - path to the ffmpeg.exe utility. For example: C:\\Atlantis\\Tools\\ffmpeg\\ffmpeg.exe

      • CommandParams - setting parameters for the ffmpeg utility. For basic functionality, specify: -i {0} -b:a 16k {1}. For more information, see the official documentation

    ../../../_images/sm-convert-storage-local.en.png
  3. In FrontStage Administration, create a new conversion rule that connects the source and destination repositories

    • Open the rules list, Configuration ‣ Content rules, create a new entry here. For it, fill in:

    • Action - set to “Convert”

    • Source storage - must match the Key parameter for the source storage

    • Target value - must match the Key parameter for the target repository, see screen above

    • Item type - set to “Voice Record”

    ../../../_images/sm-convert-content_rule.en.png

Functionality check

In service configuration set the DebugIndicators parameter to “Logic,Detail,Onl,ShadowToConsole”.

If you see this conversion progress in the log, everything is working fine:

../../../_images/sm-conversion-log.en.png