Voice File Name Parameters

Reading Time: 1 minute

You can define voice filenames using various parameters. Read about call recordings in the Downloading and Listening to Call Recordings section.


  • A parameter needs to be inserted between {curly brackets}.
  • Parameters must be separated with an underscore: _.
  • Special characters such as “:*?<>|” are replaced with an underscore: _.
  • Fix components in names must be inserted without curly brackets.


Parameter Meaning Use as
id client identifier {id}
project.name Project name {project.name}
project.id Project identifier in your database {project.id}
starttime Time when call started
  • default format {starttime},
  • shortened date format (yy-mm-dd) {starttime:Dm-%d},
  • shortened date format without hour, minutes, seconds and hyphen {starttime:m%d},
  • full format without hypens (yearmonthdayhourminutesecond) {starttime:DmHS}
  • direction Call direction (outbound or inbound) {direction}
    disposition.name Disposition name belonging to the call {disposition.name}
    disposition.exportname Disposition export name belonging to the call {disposition.exportname}
    field.<fieldname> Any client data belonging to the recorded call (number of fields) eg. {field.name} = customer name
    agent.username Call handler’s username {agent.username}
    source Phone number belonging to the call {source}
    destination Called phone number {destination}
    disposition.description Disposition description {disposition.description}
    disposition.reach Disposition qualification {disposition.reach}
    disposition.id Disposition {disposition.id}
    uuid Call identifier {uuid}
    part Defines voice file part’s folder name and the part’s name {part}
    agent.custom.<fieldname> Custom agent identifier belonging to the voice file, and added to the agent if you have eg. a property field, than: {agent.custom.property}

    There are no comments yet.
    Subscribe to our newsletter
    or Contact us!
    Please note that by subscribing to our newsletter, you agree to receive regular email messages from VCC Live® about service related news and updates. By subscribing to our newsletter, you also agree that VCC Live® will use your data in accordance with the applicable Privacy Policy until you unsubscribe from the newsletter.