Execute a voice-triggered smartflow
POST/smartflow/voice/:workflowId
Transcribe an audio file and execute the DICTAPHONE-triggered smartflow it targets. The transcription and its metadata are passed to the smartflow as trigger variables.
Variables always available in the smartflow:
transcribedText: the transcribed textdetectedLanguage: detected language of the audioconfidence: transcription confidence score (0-1)audioDuration: duration of the audio in seconds
Custom variables. Send a variables field holding a JSON object to make its
keys available as {{yourVariable}} inside the smartflow. They are returned
untouched in the variables field of the response, so you can correlate the
result with your own context.
If the smartflow's trigger declares variables, the request is validated against
that contract: a missing required variable or a type mismatch returns 400.
The names transcribedText, detectedLanguage, confidence, audioDuration,
lang and executionId are owned by the platform and rejected.
Request
Responses
- 200
- 400
- 404
Smartflow execution result
Invalid request, smartflow configuration, or custom variables
Smartflow not found