If you chose the JSON metadata format, one JSON file per audio file has to be uploaded.
Naming the JSON file
In order to link the audio to its metadata, it is expected to give them the same name.
JSON file content
The minimum viable JSON file content must be:
In this case, the current date and time of audio+metadata processing will be kept to set the date and time of the audio.
A full example might look like:
Each key of this example is described below.
Date and time of the audio
If you know the date of production of the audio, and you wish to set it, use the key
Valid date and time format are either UTC,
2019-06-09T11:14:56Z or localized on your configuration's timezone,
Caller phone number
If the audio is from a phone call, you can provide the caller phone number using the E.164 standard:
If you wish to pass on additional information, e.g. a reconciliation ID to link your data to ours, you can provide them in
metadata as a key, value dictionary.
The following rules apply:
- You can provide up to 50 pieces of metadata,
- keys must be between 1 to 40 characters among alphamnumerical, underscore and hyphen,
- values are strings of 255 length maximum of any character.
Once digested by our system, the values you've input in
metadata will be made available to you in the payload of each Call in our Activate API.