Examples

# Submit standalone transcriptions as JSON:
curl -H "Authorization: Basic BASE64_ENCODED_PUBLIC_KEY_AND_PRIVATE_KEY" \
     -H "Content-Type: application/json" \
     -X POST \
     -d '{"caller_id":"+18004506787","file_url":"http://example.com/publicly_accessible_file.mp3","postback_url":"http://example.com/postback_url_without_authentication","data":{"loan_amount":"501","custom_token":"the_value"}}' \
     "https://[your-subdomain].trackdrive.com/api/v1/standalone_transcriptions"

Params

Param name
Description
file_url
Required

Audio File URL location. This must be a publicly accessible URL, and cannot have IP restrictions.

  • Must be a String

postback_url
Required

Postback URL that we will send the following JSON payload to when the transcription is complete: id, highlighted_utterances, keywords, data, body, utterances, file_url

  • Must be a String

caller_id
Optional Blank Value Allowed

Caller ID associated with the audio file, which may be used for addition triggers and actions.

  • Must be a String

dual_channel
Optional Blank Value Allowed

Is the audio file dual channel?

  • Must be a boolean value: 1, true, yes, on, 0, false, no, off

speakers
Optional Blank Value Allowed

Number of people (speakers) in the audio file.

  • Must be a decimal number.

highlight_wrapper_open
Optional Blank Value Allowed

When keywords are highlighted, this is the opening tag, e.g. “This is a {{keyword}}.”

  • Must be a String

highlight_wrapper_close
Optional Blank Value Allowed

When keywords are highlighted, this is the closing tag, e.g. “This is a {{keyword}}.”

  • Must be a String

transcription_flow_group_id
Optional Blank Value Allowed

Transcription Flow Group that will be used to process the transcription. This will be used even if an Offer with a Transcription Flow Group is provided.

offer_id
Optional Blank Value Allowed

Offer that will be used to process the transcription. This will be used if a Transcription Flow Group is not provided, as long as the Offer has a Transcription Flow Group.

data
Optional Blank Value Allowed

A JSON object that is used to store information to filter Transcription Flows and Schedule Action Groups. It is automatically updated with Trackdrive tokens (such as zip code, state, etc.). Extra tokens can be applied to Data when specific keywords are found (Transcription Keyword settings), or when an Action is triggered (Action Group > Action settings).

  • Must be a Hash