For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Log inSign up
Support
  • Core
    • Overview
    • Variables
    • Versioning
  • Nodes
    • Overview
    • AI Agent
    • Answer Call
    • Conditions
    • Execute SWML
    • Forward to Phone
    • Gather Input
    • Handle Call
    • Hang Up Call
    • Play Audio or TTS
    • Request
    • Send SMS
    • Set Variables
    • Start Call Recording
    • Stop Call Recording
    • Unset Variables
    • Voicemail Recording
LogoLogoSignalWire Docs
Log inSign up
Support
On this page
  • Node Settings
  • Text to Speech Settings
  • Play Audio File Settings
  • Example
Nodes

Play Audio or TTS

|View as Markdown|Open in Claude|
Was this page helpful?
Edit this page
Previous

Request

Next
Built with

This node allows you to play an audio file, play silence, play a ringtone, or play text-to-speech.

Node Settings

Text to Speech
object

Text to Speech node options. See Text to Speech Settings.

Play Audio File
object

Play Audio file node options. See Play Audio File Settings.

Text to Speech Settings

Node options for Text to Speech.

Language
string

The language to use for the text-to-speech.

Gender
string

The gender of the voice to use for the text-to-speech.

Voice
string

The voice to use for the text-to-speech.

Please note that any voices that show (premium) next to the name will be billed at the Premium TTS rate.

Text
string

The text to convert to speech. SSML can be used to customize the speech. The text can also include variables to be replaced with the variable value.

SSML Example: <speak>Here is a <say-as interpret-as="characters">SSML</say-as> example</speak>

Variables Example: Hello, you got a call from %{call.from}

Play Audio File Settings

Node options for Play Audio File.

Audio File
string

A URL of a audio file to play.
Additionally a ringtone or silence can be played over the call.

Ringtone Format: silence:<time in seconds> (ex: silence:5)
Silence Format: ring:<time in seconds><ringtone code> (ex: ring:5:jp)

Example

Text to Speech node example with variable.

Text to Speech node example with variable