Declare an Audio Interaction
// Overview
The first step in processing any interaction is to declare the interaction.
When the POST request successfully executes, an HTTP status is returned to indicate the request was successful, along with a JSON response containing the interactionIdentifier.
It is important you store the interactionIdentifier as it will serve as a required parameter for all other ElevateAI endpoints, enabling you to POST, GET, and/or DELETE information associated with this interaction.
If an error occurs when requesting to declare the interaction, a standard HTTP response code is retuned to indicate the request was unsuccessful, along with a JSON response containing additional details to assist in troubleshooting.
All interactions successfully declared will count towards your monthly request quota, irrespective of file upload status or processing outcome.
Only interactions successfully processed are eligible for billing. Once declared, you can confirm the processing status of the interaction as well as track impacts to usage and spend.
// Request Parameters & Code Examples
Details on transcription and CX AI features supported by language can be found on the overview page.
// Submitting an Audio File for Processing
Download URL
Providing access to audio files via the downloadUri parameter is highly recommended for fastest processing times.
We take data security seriously, and know you do to! If required, we are able to provide an IP address to support IP whitelisting or assist in setting up a private, secure SFTP to support transferring via SFTP with URL format. If you have any questions on how to transfer your audio, reach out at any time to support@elevateai.com - we're here to help!
SFTP Transfer
If transferring via SFTP, you will specify a path that represents a directory with the downloadUri formatted like "sftp://[user:password@]host[:port]/~/path/;type=d"
Local File
If the downloadUri parameter is not included when declaring the interaction, the audio should be uploaded to the API directly for processing.