Table of Contents

API : PBX : Recording Transcribe Auto (M2M)

Request

This request is invoked by the PBX servers when a recording has completed. It runs automatic transcription (and AI summarization) of the recording according to the setting of the recording owner: recording.transcribe on the employee for personal recordings, or recording.transcribe on the PBX settings for common recordings.

The language, transcription and summary are stored on the recording.

The automatic path respects the customer's AI allowance but never fails on it: a step whose allowance is used up - or a customer with no AI product at all - is skipped silently with a syslog line, and whatever is still allowed is done, so a recording can end up transcribed without a summary, or with neither. The on-demand Transcribe request fails with 402 quota_exceeded instead. See AI quota status.

URL https://api.telecomx.dk/pbx/recording/RECORDING_ID/transcribe/auto
Method GET
Access level None - may only be invoked from PBX server IP addresses.
Param RECORDING_ID Id of the recording (24 hex-char string)

Query example

https://api.telecomx.dk/pbx/recording/12345678901234567890AAAA/transcribe/auto

Response

JSON object
success Boolean True on success
transcribe String The setting that was applied: DISABLED, TRANSCRIBE or TRANSCRIBE_AND_SUMMARIZE

Example

{
  "success": true,
  "transcribe": "TRANSCRIBE_AND_SUMMARIZE"
}

Errors

Error code Message Description
403 access_denied Not invoked from a PBX server
404 not_found Recording not found
500 internal_error <Unspecified>