No results found.
Table of content

Audio

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:

  • left channel is the customer, right is the agent
  • left channel is the agent, right is the customer

Format can be mp3, 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:
[STREAM]
codec_name=pcm_s16le  # 16 bits Little Endian
codec_type=audio
sample_rate=8000  # 8kHz
channels=1  # One channel
channel_layout=mono
duration=612.576000
[/STREAM]

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.

# Copy audio to left channel
ffmpeg -i input_mono.wav -map_channel '0.0.0' -map_channel '0.0.1?' output_left.mp3

# Copy audio to right channel
ffmpeg -i input_mono.wav -map_channel '0.0.1?' -map_channel '0.0.0' output_right.mp3

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 stereo file with the agent on one channel and the customer on the second channel.

# Customer to left channel, agent to right channel
ffmpeg -i mono-customer.mp3 -i mono-agent.mp3 -filter_complex "[0]apad[a];[a][1]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 "[0]apad[a];[a][1]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.

For example my_call.mp3 should be accompanied by either: