By using the Aculab site, you agree with our use of cookies.
right  Talk To Us!

start transcription Action

  Introduced in REST API Version 2.0

Starts transcribing the current call, sending the results to a specified results page. You can specify the language spoken on the call and you can request interim results for each phrase.

A start transcription action uses two speech recognition streams when the transcription mode is separate, and one speech recognition stream for the other modes. The service must be configured so that the application will have a suitable number of streams available when the action runs. The streams will continue to be in use until the transcription ends, such as when a stop transcription action runs.

Note that speech recognition/transcription is a chargeable feature.

language wrappers and examples

The start transcription properties are:

PropertyRequired/OptionalDefaultDescription
results pagerequiredA web page request object that defines the web page that is going to receive the transcription results and any interim results if they are enabled. The request to this page happens asynchronously and its response is not considered part of the application flow.
transcription modeoptionalseparateOne of separate, mixed, inbound, outbound. How the inbound and outbound audio is transcribed. For modes other than mixed the inbound and/or outbound transcription results contain a property indicating direction. For inbound and outbound, only the specified direction of audio is transcribed.
idoptional""A user-defined string that can be used to uniquely identify each particular transcription.
speech recognition optionsoptional-A speech recognition options object that sets the language for the call and other options related to speech recognition.
enable interim resultsoptionalfalseWhether the transcription will send interim results before it has finalised recognition of each phrase.

Remarks

Only one transcription can be running at any one time in an application. If a transcription is running already a start transcription action will stop that transcription and start a new one.

Returns

The start transcription action has no return. The next action in the list will be run when start transcription completes.

Results

Each transcription result is sent to the results page in an action result as it becomes available.

Final transcription results (final = true) are sent to the results page when the speech recognition has finalised each phrase spoken. If interim results are enabled then additional results (final = false) are sent to the same page while the speech recognition is analysing each phrase.

PropertyAvailabilityDescription
transcriptionalwaysAn array of phrase objects representing sequential parts of the recognised speech. If transcription mode is in anything other than mixed then each phrase is labelled as either inbound or outbound. If enable interim results has been enabled then interim results (final = false) will be returned, concluding with a final result (final = true).
completedalwaystrue or false. true indicates that this is the last result of the transcription.
idalwaysThe string identifying the transcription, as specified in the start transcription action.

Note that results are not returned to the application directly, but to the results page. A page that receives a transcription result should respond with a 204 response code indicating no content.



  • Examples:

    • Start transcribing both sides of the call separately in US English using defaults:

      "start_transcription": 
      {
          "results_page":
          {
              "url" : "my_transcription_results_page"
          }
      }
      

      The following is an example of the first three of a series of results that may be sent to the results page:

      Outbound result:

      "action_result" :
      {
      	"action" : "start_transcription",
      	"result" :
      	{   
      		"transcription" : 
      		[
      			{
      				"alternatives" : 
      				[
      					{
      						"text" : "hello which department would you like",
      						"confidence" : 0.91
      					}
      				],
      				"final" : true,
      				"direction" : "outbound"
      			}
      		],
      		"completed" : false,
      		"id" : ""
      	}
      }
      

      Inbound result:

      "action_result" :
      {
      	"action" : "start_transcription",
      	"result" :
      	{   
      		"transcription" : 
      		[
      			{
      				"alternatives" : 
      				[
      					{
      						"text" : "sales please",
      						"confidence" : 0.93
      					}
      				],
      				"final" : true,
      				"direction" : "inbound"
      			}
      		],
      		"completed" : false,
      		"id" : ""
      	}
      }
      

      Outbound result:

      "action_result" :
      {
      	"action" : "start_transcription",
      	"result" :
      	{   
      		"transcription" : 
      		[
      			{
      				"alternatives" : 
      				[
      					{
      						"text" : "I'm putting you through now",
      						"confidence" : 0.94
      					}
      				],
      				"final" : true,
      				"direction" : "outbound"
      			}
      		],
      		"completed" : false,
      		"id" : ""
      	}
      }