Uploaded audio files must be stereo with one speaker on each channel. This is an information we need in order to setup your account, either:
leftchannel is the customer,
rightis the agent
leftchannel is the agent,
rightis the customer
Format can be
wav... Any format supported by ffmpeg should be fine.
Recipes for audio manipulation
Here are a few common audio manipulation recipes to help preparing files for Jupload.
Get audio file information
The following command outputs information about an audio file:
ffprobe -i audio_file.mp3 -v error -show_entries 'stream=codec_type,codec_name,channels,channel_layout,sample_rate,duration'
# Example output:
codec_name=pcm_s16le # 16 bits Little Endian
sample_rate=8000 # 8kHz
channels=1 # One channel
Convert a single mono file to stereo
If you only have a mono file, you can create a stereo file with the audio on one channel and nothing on the second channel. Jupload will then treat the file as if there was only one speaker.
If you want to have the original mono audio on the left channel, and silence on the right one, run this command:
ffmpeg -i input_mono.wav -map_channel '0.0.0' -map_channel '0.0.1?' output_left.mp3
Alternatively, if you want to have the original mono audio on the right channel, and silence on the left one, run this command:
ffmpeg -i input_mono.wav -map_channel '0.0.1?' -map_channel '0.0.0' output_right.mp3
You can now upload the output file on the SFTP.
Convert two separated mono files to stereo
If you have two separated mono files for the agent speaker and the customer, you can create a single stereo file with the agent on one channel and the customer on the second channel.
Run either one of the following commands, depending on where the agent and the customer should be on which channel:
# Customer to left channel, agent to right channel
ffmpeg -i mono-customer.mp3 -i mono-agent.mp3 -filter_complex "apad[a];[a]amerge[aout]" -map "[aout]" stereo-left_customer-right_agent.mp3
# Agent to left channel, customer to right channel
ffmpeg -i mono-agent.mp3 -i mono-customer.mp3 -filter_complex "apad[a];[a]amerge[aout]" -map "[aout]" stereo-left_agent-right_customer.mp3
Naming the audio file
The name of the audio file, without extension, must be found in the metadata file.
my_call.mp3 should be accompanied by either: