transcribe

Transcribe the entire call in the background. Execution continues to the next instruction while the call proceeds; the transcription covers the whole call and completes when the call ends. To stop it early, use the transcribe_stop method.

For real-time transcription delivered as the call happens, use live_transcribe instead.

Only one transcription can be active on a call at a time. Starting another while one is already running will fail.

Properties

object

An object that accepts the following properties.

transcribe.status_url

string

An HTTP or HTTPS URL that receives the status callback when the transcription finishes. Learn more about status callbacks.

Variables

transcribe_result

success | failed

Whether transcription started successfully.

transcribe_control_id

string

Identifier assigned to this transcription. transcribe_stop uses it to stop the right one.

StatusCallbacks

When you set status_url, SignalWire POSTs a transcript event to it when the call’s transcription finishes: calling.transcript.completed includes the transcribed text when speech was captured, or calling.transcript.failed if the call could not be transcribed.

See the Transcript status callback webhook page for the full field reference.

Example

1 version: 1.0.0
2 sections:
3   main:
4     - transcribe:
5         status_url: https://example.com/transcribe-status