Objective
This article shows you how to add and configure the Fork Stream widget so your Studio flow sends a copy of the call's audio to your own service or a recording platform while the call carries on, and how to stop that stream again later.
Product
Studio, Programmable Voice
Environment
Twilio Console
User Account Permission/Role(s) Required
Editing a flow requires the Studio flows create and update permissions on the account.
Procedure
- In the Twilio Console, select Orchestration in the left sidebar.
- Select Studio, then Flows.
- Select the flow you want to edit to open the Editor tab.
- Open the widget library and drag Fork Stream onto the canvas.
- Select the new widget to open its configuration panel.
- In Stream action, leave the widget set to start a stream, or choose Stop to end one that is already running.
- Enter a name for the stream in Stream name. Use the same name on the widget that stops it.
- Choose the transport in Stream type:
- Websocket: enter the destination in URL.
- Siprec: enter the connector's name in Connector name. No URL is needed.
- Choose which audio to send in Tracks, for example Both Tracks.
- To send extra metadata with the stream, select Add stream parameter, enter the parameter's name as the key and its content as the value, then select Save. Repeat for each parameter.
- Select Save.
- Open the Transitions tab and choose where the flow goes next for If next.
- Select Publish to make the change live.
Additional Information
- Choosing Siprec hides URL, because the connector determines the destination instead.
- To stop a stream, add a second Fork Stream widget later in the flow, set Stream action to Stop, and give it the same Stream name.
- Check the recording and consent rules that apply in your customers' jurisdictions before streaming call audio to a third party.
This content was generated by AI and reviewed, edited, and verified by a human.