Skip to main content

execute

Execute a section or URL as a subroutine and return back to current document.

Parameters

NameTypeDescription
deststringSpecifies what to execute. Required. The value can be one of:
  • "<label>" - section in the current document to execute.
  • "https://<URL>" - URL pointing to the document to execute. Sends HTTP POST.
paramsobjectNamed parameters to send to section or URL. Optional. Default is not set.
metaobjectUser data, ignored by SignalWire. Optional. Default is not set.
on_returnobjectCode to execute after return. Optional. Default is not set.

Variables

None

Examples

Executing a subroutine

version: 1.0.0
sections:
main:
- execute:
dest: subroutine
params:
file: "https://example.com/foo.wav"
subroutine:
- answer

Executing a subroutine and branching on return

version:1.0.0
sections:
main:
- execute:
dest: my_menu
params:
- file: "https://example.com/foo.wav"
- digits: "123"
on_return:
- switch:
- case:
- variable: return_value
- 1:
- transfer: sales
- 2:
- transfer: support
- 3:
- transfer: leave_a_message
- default:
- transfer: invalid_choice
subroutine:
- answer