website logo
System StatusChange LogLog In / Sign Up
Reference
Tutorials
Navigate through spaces
Reference
Tutorials
⌘K
Overview
Transcription Features
CX AI Features
Getting Started
ElevateAI Dashboards
Submit an Interaction
Declare an Audio Interaction
Declare a Transcript
Declare a Chat Interaction
Check the Status
Check the Processing Status
Retrieve Declared Parameters
Retireve Results
Get Phrase-by-Phrase Transcript
Get Punctuated Transcript
Get CX AI
Delete Data
.Net SDK
Python SDK
Docs powered by archbee 

Overview

// Introduction

About ElevateAI

ElevateAI APIs leverage cutting-edge research in artificial intelligence (AI), automatic speech recognition (ASR), and natural language processing (NLP) to transcribe audio conversations into precise text that can be fed into any data lake or application.

In addition, you can access key data needed to understand conversations at scale. CX AI provides objective insights into audio, transcription, and chat interactions, such as voice activity and out-of-the-box, industry-agnostic behavioral models (including sentiment analysis).



Just Getting Started?

Getting started takes less than 60 seconds, and for each of the API endpoints you will find a tutorial outlining required parameters, code samples, and response examples / schemas.

Not a Developer?

You can transcribe and analyze audio interactions directly from the ElevateAI portal with no code needed.

We're here to help!



If you have any questions, our team of product experts and developers are available and eager to provide additional support!



// Authentication

Your active API tokens authorize requests on behalf of your account and carry many privileges, so be sure to keep them secure. Do not share your API tokens in publicly accessible areas such as GitHub, client-side code, etc.

To ensure authentication, all API requests must be made over HTTPS. Requests made over plain HTTP and/or API requests without an active API token will fail.

For your convenience and security, API tokens can be managed at any time in the Manage Tokens Dashboard.



// Data Retention & Security

Your data is yours!

The ElevateAI API is secured with Transport Layer Security (TLS) 1.2 to secure and encrypt the communication as well as protect the data in transit. The Service also uses TLS mutual authentication to ensure only legitimate users can access the API.

All source data is deleted promptly upon processing. Analysis output is stored in our US-based data warehouse for up to 45 days, encrypted in transit and at rest, so that you may access your results. After 45 days, all associated data is deleted and irretrievable.

If you have retrieved the desired results and would like to permanently delete all analysis data from our database prior to the 45-day standard retention period, you may do so at any time using the DELETE API endpoint.

As a publicly traded company trusted by leading brands worldwide, we make data security a top priority. See additional information in the ElevateAI Privacy Notice.



// Processing Times

Remember: You can retrieve the processing status of your interaction at any time directly from a GET API endpoint or the Interactions Dashboard.

Audio Files

When declaring an audio interaction, you have the flexibility to prioritize for either highSpeed or highAccuracy.

Audio interactions prioritized for highSpeed are generally processed within 25-65% of the total interaction duration, but may vary by system integration and number of concurrent requests.

Audio interactions prioritized for highAccuracy may take up to twice as long to accommodate the latest in transformer technology for highest conversational accuracy.

Requests made where audioTranscriptionMode is set to highAccuracy may incur additional fees. See the the ElevateAI Invoicing Policy for more information.

Transcript and Chat Files

Transcript and chat interactions are generally processed in seconds, but may vary by system integration and number of concurrent requests.



// Accepted File Formats & Sizes

Audio File Formats

ElevateAI supports virtually all unencrypted audio types, whether single or dual channel. If you have any questions or would like to see a full list of supported audio files, reach out to us at support@elevateai.com.

Pro Tip: For highest levels of accuracy, we suggest stereo G.729A audio files.

Supported File Size

ElevateAI supports both uploads and downloads up to 100MB.



// Supported Features by Language

Transcription

Audio





North American English

International English

Latin American Spanish

languageTag

"en-us"

"en"

"es-419"

Mono (single channel)







Stereo (dual channel)







vertical

"default"

"default"

"default"

audioTranscriptionMode

"highSpeed" or

"highAccuracy"

"highSpeed" or

"highAccuracy"

"highSpeed"

PII Redaction

social security numbers,

credit card numbers, and

cvv numbers

credit card numbers and

cvv numbers

social security numbers,

credit card numbers, and

cvv numbers

Speaker Labels

diarization (mono),

channel (stereo)

diarization (mono),

channel (stereo)

diarization (mono),

channel (stereo)

CX AI

Audio
Transcript
Chat



North American English

International English

Latin American Spanish

languageTag

"en-us"

"en"

"es-419"

Voice Activity







Composite Behavioral Scores







Behavioral Scores by Participant







Behaviors for CSAT







Acknowledge Loyalty







Active Listening







Be Empathetic







Build Rapport







Demonstrate Ownership







Effective Questioning







Inappropriate Action







Promote Self Service







Sentiment







Set Expectations







Vulnerable Customer Behaviors







Vulnerable Customer







Capability







Health







Life Event







Mental Health







Resilience







Financial Distress (BETA)







High Risk Transaction (BETA)







Chrun







Complaint







Sales Effectiveness









// Error Handling

ElevateAI uses conventional HTTP response codes for each API request. Codes in the 2xx range indicate the request successfully executed. Codes in the 4xx range indicate a failure based on the information provided (e.g., a required parameter was omitted). While rare, codes in the 5xx range may indicate an error with the ElevateAI service.

If a request is successful but an error occurs when uploading, downloading, or processing your interaction, a descriptive errorMessage will be provided when checking the processing status of the interaction.

We're here to help!



If you have any questions not addressed within this documentation, our team of product experts and developers are available and eager to provide additional support!

HTTP Status Code

Summary

400 - Bad Request

The API request does not contain the expected parameters (either missing a required parameter or providing an unexpected value for a parameter). Prior to re-requesting, review the parameters and code examples within the associated tutorial.

401 - Unauthorized

The API request is missing or passed an invalid X-API-Token in the header. Prior to re-requesting, confirm or request your API token within the Manage Tokens Dashboard.

404 - Not Found

Either the API request was made with an invalid/deleted interactionIdentifer in the path, or analysis results have been requested prior to processing completion. Prior to re-requesting, confirm your API token within the Manage Tokens Dashboard, check the processing status.

409 - Conflict

The API request made can't be complete because you have previously uploaded an audio file or provided a downloadUri when declaring the audio interaction.

413 - Payload Too Large

The ElevateAI service couldn't retrieve the uploaded file or the file is larger than the maximum supported file size. Confirm file size, re-upload, and if you still receive the error, re-declare the interaction.

429 - Too Many Requests

The API request to declare the interaction exceeds the monthly quota associated with your account. To upgrade to a paid account or request your quota be increased, contact us at sales@elevateai.com.



// Monthly Quota

Trial (Free) Accounts

Free accounts have access to declare up to 100 interactions per month for testing purposes! If you are interested in upgrading to a paid account for production use, please contact us at sales@elevateai.com.

Production (Paid) Accounts

By default, paid accounts have access to declare up to 5,000 interactions per month. Requests counts reset on the first day of a calendar month.

If you require a higher limit, pleased reach out to us at support@elevateai.com to request this limit be increased.



// Additional Support

Our team of product experts and developers are on-call and available to answer any questions you may have!

For fastest response times, please direct your question to the following:

Questions about upgrading to a paid account? Contact us at...

 sales@elevateai.com

Questions about the terms of use, privacy policy, or the legal things? Contact us at...

legal@elevateai.com

Questions about our product roadmap or to request a feature? Contact us at...

product@elevateai.com

For ANY OTHER support questions, contact us at...

support@elevateai.com

NICE Support Portal

Paid accounts are further enabled with access Wiser, the NICE Support Portal, which can be accessed by clicking 'Support' in the ElevateAI portal.

If you have not yet activated your credentials, you will first complete the Self Registration Form for account approval (typically complete within 1-2 business days).



Once logged in to the NICE Support Portal, you can easily Create a Case and See Open Cases Across Your Organization. When a case is submitted or updated, an email notification is sent for your awareness.





UP NEXT
Transcription Features
Docs powered by archbee 
TABLE OF CONTENTS
// Introduction
About ElevateAI
Just Getting Started?
Not a Developer?
// Authentication
// Data Retention & Security
// Processing Times
Audio Files
Transcript and Chat Files
// Accepted File Formats & Sizes
Audio File Formats
Supported File Size
// Supported Features by Language
Transcription
CX AI
// Error Handling
// Monthly Quota
Trial (Free) Accounts
Production (Paid) Accounts
// Additional Support
NICE Support Portal