> For the complete documentation index, see [llms.txt](https://docs.xenioo.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.xenioo.com/actions-and-operations/content/xenioo.bots.actions.base.audioaction.md).

# Audio Action

This action will allow sound playback directly in user chat. You can add a sound file as an external URL or upload it to Xenioo storage.

![](/files/-LkUD1qWI76Jro3IMo3M)

### Settings

The action uses the following settings:

| Setting             | Description                                                                                                                                                             | [Parsed](/actions-and-operations/dynamic-parsing.md) |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- |
| From Url            | The audio will be retrieved from the specified URL.                                                                                                                     | :no\_entry:                                          |
| Upload To Storage   | The audio will be retrieved from [your Xenioo Account storage](/basic-concepts/your-account/the-free-plan.md).                                                          | :no\_entry:                                          |
| Audio URL           | The fully qualified URL of the audio source                                                                                                                             | :white\_check\_mark:                                 |
| Audio Title         | The title of the audio                                                                                                                                                  | :white\_check\_mark:                                 |
| Audio Author        | The author of the audio                                                                                                                                                 | :white\_check\_mark:                                 |
| Album Art           | Url or Storage based source for the audio album art                                                                                                                     | :white\_check\_mark:                                 |
| Background Art      | Url or Storage based source for the audio background art                                                                                                                | :white\_check\_mark:                                 |
| Create Content Card | If enabled, Xenioo will automatically try to create a content card using as much information as possible of the above settings. Not all channels support content cards. | :no\_entry:                                          |
| Embed in speech     | If enabled, this flag will force Xenioo to enclose the audio source in a \<audio> SSML tag.                                                                             | :no\_entry:                                          |

### Remarks

When using speech embedding make sure to follow the [Alexa guidelines for audio format](https://developer.amazon.com/docs/custom-skills/speech-synthesis-markup-language-ssml-reference.html#audio).

### Trigger

This action has no triggers.

### Variables

This action produces the following variables after being executed:

| Variable               | Description                                                                                                                                               |
| ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| current\_audio\_action | The unique id of the audio action being executed. This id is consumed by [IoT actions](broken://pages/-LdPE8sDpKDSzqbfN3SF) to stop and resume streaming. |

### Availability

Channel specific availability follows the table below:

| Channel          | Availability                                                                                            |
| ---------------- | ------------------------------------------------------------------------------------------------------- |
| Facebook         | Audio will be by default embedded as attachments. Facebook 25MB limit will apply.                       |
| WhatsApp         | Provider Dependant. Please see [relevant information](/basic-concepts/publishing/channels/whatsapp.md). |
| Telegram         | Fully Available without content card.                                                                   |
| Web              | Fully Available  without content card.                                                                  |
| Alexa            | Fully Available.                                                                                        |
| Google Assistant | Fully Available.                                                                                        |
| Slack            | Fully Available  without content card.                                                                  |
| API              | Fully Available.                                                                                        |

This action can be used only inside interactions and not as child of other actions.&#x20;