CSV metadata
If you chose the CSV metadata format, one CSV file, referencing several audio files, can be uploaded.
For historic reasons, it is expected that:
- First line of the CSV must be headers,
- First cell of header must be named
Nom
ornom
,- Values in the
nom
cell must reference an audio filename with or without file extension, see example below, - These cells can not be empty, a value is mandatory,
- Values in the
- Fifth row is expected to be the caller phone number,
- Phone number are expected to be using the E.164 standard, for example
+33102030405
. - Leave it empty if caller phone number is unknown
- Phone number are expected to be using the E.164 standard, for example
- Eight row must be the audio date and time,
- See valid date and time formats requirements
- These cells can not be empty, a value is mandatory.
Examples
First example
Considering the following CSV metadata (headers names are for the sake of example):
Nom,Session SVI,Application,NAS,Numero,Cause,Note,Date,Longueur,Competence,SDA de l'agent,Nom agent,Id agent,Dossier
a_first_audio,foobar,foobar,foobar,+33102030405,foobar,foobar,2019-07-01T12:34:56Z,foobar,foobar,foobar,foobar,foobar,foobar
a_second_audio,foobar,foobar,foobar,+33102030406,foobar,foobar,2019-07-01T12:35:56Z,foobar,foobar,foobar,foobar,foobar,foobar
a_third_audio,foobar,foobar,foobar,+33102030407,foobar,foobar,2019-07-01T12:36:56Z,foobar,foobar,foobar,foobar,foobar,foobar
It is therefore expected to upload, aside from this metadata file, three audio files named a_first_audio.EXT
, a_second_audio.EXT
and a_third_audio.EXT
.
Second example
The minimum viable CSV would look something like:
Nom,foo,bar,foobar,Numero,barfoo,foofoo,Date
a_first_audio,,,,,,,2019-07-01T12:34:56Z
a_second_audio,,,,+33102030405,,,2019-07-01T12:34:56Z
- The first line does not have a phone number (it might be unknown)
- the second line has one
Custom metadata
If you wish to keep additional information from other cells, e.g. a reconciliation ID to link your data to ours, an option can be enabled so that all CSV columns will be stored on our side.
Once digested by our system, the values you've input in the CSV will be made available to you in the payload of each Call in our Activate API.
There are some limitations:
- Headers labels will be "slugified" (get rid of space, special chars). For example
My Reconciliation_ID
becomesmy-reconciliation-id
and striped to 40 chars - There must be at most 50 keys
- Cells values are limited to 255 characters
If any of these limitations is not met, an error will occur, and your upload won't be processed.