Usage

Bot usage

How to get a single bot's usage

Bot usage is calculated from the moment the bot triggers the joining_call event until the done event.

Bots operate on dedicated machines and charges are based on the machine's runtime (not time the bot is recording). There are no separate/additional charges for specific features, though some features may require more compute (e.g. Output Media) and you can opt for a more powerful machine to power different use cases.

You can calculate a single bot's usage by calculating the time between the bot's joining_call and done event.

Bot usage per workspace

You can use the Get Usage endpoint to retrieve the number of bot hours used within a specific time period for a given workspace.

How to track bot usage for your own customers

For more detailed insights, you can create a custom billing report for bot usage by:

• Adding data (e.g., customerId) to the metadata field in the Create Bot request to track usage.

• Using the List Bots endpoint to either:

  • Configure the request to return bots with a custom metadata values. For example, you can get all bots where metadata.customerId = 1234.
  • Aggregate usage by iterating over all bots and group/sum usage by multiple metadata fields. For example, you can get all bots where metadata.customerId = 1234 and metadata.level = 'enterprise'.

• Then sum up each bot's usage as described in the previous section.

Transcription Usage

How to get a single recording's transcription usage

There are different ways to get a recording's transcription usage for a given recording depending on what transcription provider you're using

• Recall.ai Transcription - For a given recording, calculate the difference between the started_at and completed_at timestamps.
• Third-Party Transcription - For a given recording, check the transcription provider's data directly by querying the recording.transcript.data.provider_data_download_url field. This contains the raw data received from the transcription provider and indicates the exact audio duration that was transcribed.
• Meeting Caption Transcription - There is no cost associated with meeting caption transcription.

Transcription usage by workspace

You can calculate the transcription usage per workspace by querying the List Recordings endpoint for a given time period and calculating the recording usage for each recording returned.

How to track transcription usage for your own customers

If recordings were made from bots, you can follow a similar approach to tracking bot usage for your own customers, summing the trasnscription usage for each recording on the bot instead.

Recording usage

How to get a single recording's usage

The recording usage is calculated as the time between the started_at and completed_at timestamps on a given recording.

Recording usage by workspace

You can calculate the transcription usage per workspace by querying the List Recordings endpoint for a given time period and calculating the recording usage for each recording returned.