transcribe

Request Parameter	Type	Description
requestType	string	The context or reason why this request is being made. Will be transcribe - The `TranscribeUtterance` command has completed and its `actionUrl` is being invoked.
callId	string	Unique identifier for this Call, generated by FreeClimb.
accountId	string	Account ID associated with your account
from	string	Phone number of the party that initiated the Call (in E.164 format)
to	string	Phone number provisioned to the customer and to which this Call is directed (in E.164 format)
recordingId	string	The ID of the recording. If no recording was made due to errors or the "saveRecording" flag being disabled this field will be set to null.
recordingUrl	string (url)	The URL of the recorded audio file. This URL can be used as is in a `Play` command to play the recording (no authentication needed). It can also be used to download the recording file via the REST API. If no recording was made due to errors or the "saveRecording" flag being disabled this field will be set to null.
recordingSize	integer	The size of the recording in bytes. If no recording was made due to errors or the "saveRecording" flag being disabled this field will be set to 0.
recordingFormat	string	The media type of the recording. If no recording was made due to errors or the "saveRecording" flag being disabled this field will be set to null.
recordingDurationMs	integer	The duration of the recorded audio in milliseconds. If no recording was made due to errors or the "saveRecording" flag being disabled this field will be set to 0.
termReason	string	The action url was invoked. Indicates if the command did complete or there was an error that prevented the command from running `error` - Top level command error, such as a parsing problem or parameter problem. `completed` - Command as a whole completed, look at record/transcribe term reasons for more detail including any possible errors that may have occurred for a specific record.
recordTermReason	string	The action url was invoked after the command completed and a record had been requested. Can be any of the following: `error` - An error occurred during the processing of the recording `hangup`- The call ended before the recording could be created. Note - if any termination reason in this callback is `hangup`, any PerCL returned will be ignored. `maxLength` - The audio reached the maximum duration `digit` - dtmf was pressed during recording which terminated the recording. `noInput` - The recording timed out while waiting for speech to start `recordTerminationSilenceTime` - The recording completed as no additional speech was detected for duration of `rcrdTerminationSilenceTimeMs`
digit	string	If recordTermReason is digit, this will be the digit that was pressed. Otherwise it will be null. Digit will be set to "xxxxx" in the logs if privacyForLogging is enabled.
privacyForLogging	boolean	Echo back of the privacyForLogging flag as specified in the transcribe utterance command – confirmation of logging protection has been applied. Can be used by application to know it should also apply protection when handling this request.
privacyForRecording	boolean	Echo back of the privacyForRecording flag as specified in the transcribe utterance command – confirmation of logging protection has been applied. Can be used by application to know it should also apply protection when handling this request.
bargeInReason	string	noBargeIn, bargeInByDTMF, bargeInByEnergy. When this is populated with DTMF or Energy, then more information will be present in additional bargeInXxx fields
bargedInPromptNo	integer	-1 : no barge-in 0 : buffered DTMF or DTMF detected or Energy detected at start of command execution and before first prompt could play 1 or higher : 1-based index of prompt number from list of prompts provided indicating which prompt was barged-in. If a prompt was barged-in, then additional information will be present in bargedInPromptMs
bargedInPromptMs	integer	duration in ms bargedInPromptNo prompt was executing until barge-in occurred.
bargedInPromptLoopNo	integer	1-based count of number of times prompt had played when barge-in occurred. If loopCount was not specified for the prompt then it would show 1 to indicate first (and only) time it was played. If the prompt does not support looping, it will also show 1. If no barge in, it will be 0.
bargeInTimeMs	integer	epoch time in ms e.g. 1677170569123
transcript	string	Transcribed text of the recording. Can be empty or null. null means there was a failure in transcribing the audio, refer to transcribeReason for detailed failure reason. Transcript will be set to "xxxxx" in the logs if privacyForLogging is enabled.
transcribeReason	string	Results of transcription, will be success when audio is transcribed successfully, else a reason of the failure will be provided. Can be any of the following: `internalError` - An error occurred during the processing of the transcription, if defined a detailed error message will be included. `hangup` - The call ended before the transcription could be created. Note - if any termination reason in this callback is 'hangup', any PerCL returned will be ignored. `maxLength` - The audio reached the maximum duration `digit` - dtmf was pressed which terminated the transcription. `noInput` - no input received by the time the command terminated.
transcriptionDurationMs	integer	The duration of the audio being transcribed in milliseconds