# 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.

![](https://2678899722-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LdPD9c4fJbXSAZcPHt9%2F-LkUCZnf66UI6UD0vUQ_%2F-LkUD1qWI76Jro3IMo3M%2Fimage.png?alt=media\&token=6eedc7e3-6832-44f0-9b29-e5de555012b2)

### Settings

The action uses the following settings:

| Setting             | Description                                                                                                                                                             | [Parsed](https://docs10.xenioo.com/actions-and-operations/dynamic-parsing) |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
| 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](https://docs10.xenioo.com/basic-concepts/your-account/the-free-plan).                                    | :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](https://docs10.xenioo.com/actions-and-operations/content/broken-reference) 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](https://docs10.xenioo.com/basic-concepts/publishing/channels/whatsapp). |
| 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. Any account can use this action regardless of [subscription level](https://docs10.xenioo.com/basic-concepts/your-account/the-free-plan).