V-Spark Online Help

Preparing Metadata Files

Once you have configured your metadata fields, you can upload your audio along with one metadata file per call. Currently V‑Spark accepts JSON or XML files that have the same filename as the audio file, but with an .xml or .json extension in place of the original extension.

For example, an audio file named "ABC.wav" could be uploaded with a metadata file named "ABC.json" or "ABC.xml". If you are uploading JSON metadata files along with previously processed transcripts, your metadata files must use the .jsonmeta extension. Your JSON or XML file must be 100% valid; V‑Spark does not do any error correction on metadata files.


Metadata timestamps without timezone information are interpreted with the organization's timezone and not the system timezone.

The following is an example of the XML format:

<?xml version="1.0" encoding="UTF-8" standalone="no" ?>
        <agentid> 10005 </agentid>
        <datetime> 2015-06-02 13:29:20 </datetime>
        <agentname> John Smith </agentname>
        <client-phone> 123-456-7890 </client-phone>

The following is an example of the JSON format:

            "agentid": "10005",
            "datetime": "2015-06-02 13:29:20",
            "agentname": "John Smith",
            "client-phone": "123-456-7890"


A leading "-" in custom metadata is reserved for exclude phrases. As a result, any leading "-" at the beginning of your custom metadata values will be replaced with "#". For example, if you have a fieldname for Call Direction with a metadata value of "-inbound", the metadata value will be changed to "#inbound".