> Fetch clean Markdown by appending `.md` to any page URL under https://signalwire.com/docs or requesting it with the HTTP header `Accept: text/markdown`. The root index at https://signalwire.com/docs/llms.txt lists the available documentation indexes.

# playBackgroundFile

> Play an audio file in the background during a call.

[functionresult]: /docs/server-sdks/reference/typescript/agents/function-result

Play an audio file in the background while the conversation continues.

## **Parameters**

**`filename`** `string` — required

URL of the audio file to play (e.g., `"https://example.com/hold-music.mp3"`).

---

**`wait`** `boolean` — default: false

When `true`, suppresses the agent's attention-getting behavior during playback.
The agent will not try to re-engage the user while the file is playing.

---

## **Returns**

[`FunctionResult`][functionresult] -- `this`, for chaining.

## **Example**

```typescript {4}
import { FunctionResult } from '@signalwire/sdk';

const result = new FunctionResult()
  .playBackgroundFile('https://example.com/hold-music.mp3');
```

> Play an audio file in the background during a call.