SUPPORT.TWILIO.COM END OF LIFE NOTICE: This site, support.twilio.com, is scheduled to go End of Life on February 27, 2024. All Twilio Support content has been migrated to help.twilio.com, where you can continue to find helpful Support articles, API docs, and Twilio blog content, and escalate your issues to our Support team. We encourage you to update your bookmarks and begin using the new site today for all your Twilio Support needs.

How do I fork a media stream from a Studio flow?

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

  1. In the Twilio Console, select Orchestration in the left sidebar.
  2. Select Studio, then Flows.
  3. Select the flow you want to edit to open the Editor tab.
  4. Open the widget library and drag Fork Stream onto the canvas.
  5. Select the new widget to open its configuration panel.
  6. In Stream action, leave the widget set to start a stream, or choose Stop to end one that is already running.
  7. Enter a name for the stream in Stream name. Use the same name on the widget that stops it.
  8. Choose the transport in Stream type:
    1. Websocket: enter the destination in URL.
    2. Siprec: enter the connector's name in Connector name. No URL is needed.
  9. Choose which audio to send in Tracks, for example Both Tracks.
  10. 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.
  11. Select Save.
  12. Open the Transitions tab and choose where the flow goes next for If next.
  13. 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.

Have more questions? Submit a request
Powered by Zendesk