Skip to content

update alexa_devices docs for new 2025.8 actoins #40315

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Aug 10, 2025
Merged

update alexa_devices docs for new 2025.8 actoins #40315

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
9639010
update alexa_devices docs for new 2025.8 actoins
jamesonuk Aug 7, 2025
de89386
tiny tweaks
c0ffeeca7 Aug 8, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
73 changes: 72 additions & 1 deletion source/_integrations/alexa_devices.markdown
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -65,9 +65,42 @@ This means that the specified country may need a special setting.
Open a issue with all details to investigate
{% endnote %}

## Actions

### Available Actions

Available actions: `notify.send_message`, `alexa_devices.send_sound`, `alexa_devices.send_text_command`

#### Action `notify.send_message`

Devices with appropriate functionality will have speak and announce notify entities created. These can be used as the target for the `notify.send_message` action.

{% tip %}
When sending notifications to multiple devices, you may experience delays due to rate limiting by Amazon. You can avoid this by sending notifications to speaker groups created in Alexa.
{% endtip %}

#### Action `alexa_devices.send_text_command`

This action essentially allows you to control Alexa using text commands rather than speech. You should be able to request anything you would via speech using this action.

| Data attribute | Optional | Description |
| -------------- | -------- | ----------------------------------------- |
| `device_id` | no | Device on which you want to run action |
| `text_command` | no | Command to send |

#### Action `alexa_devices.send_sound`

This action allows you to play one of the built-in Alexa sounds. The full list of sounds and their variants is available in [Amazon's documentation](https://developer.amazon.com/en-US/docs/alexa/custom-skills/ask-soundlibrary.html)

| Data attribute | Optional | Description |
| -------------- | -------- | ----------------------------------------- |
| `device_id` | no | Device on which you want to play sound |
| `sound_variant` | no | The variant you want to play (generally 1) |
| `sound` | no | The name of the sound to play |

## Examples

### Automation: Announce welcome when you arrive home
### Send announcement when you arrive home

```yaml
automation:
Expand All @@ -85,6 +118,44 @@ automation:
entity_id: notify.echo_dot_livingroom_announce
```

### Ask the time

```yaml
action: alexa_devices.send_text_command
data:
device_id: 037d79c1af96c67ba57ebcae560fb18e
text_command: whats the time
```

### Play BBC Radio 6

```yaml
action: alexa_devices.send_text_command
data:
device_id: 037d79c1af96c67ba57ebcae560fb18e
text_command: play BBC Radio 6
```

### Play a doorbell sound

```yaml
action: alexa_devices.send_sound
data:
sound_variant: 1
sound: amzn_sfx_doorbell_chime
device_id: 037d79c1af96c67ba57ebcae560fb18e
```

### Play alternative doorbell sound

```yaml
action: alexa_devices.send_sound
data:
sound_variant: 2
sound: amzn_sfx_doorbell_chime
device_id: 037d79c1af96c67ba57ebcae560fb18e
```

## Data updates

This integration {% term polling polls %} data from the device every 30 seconds by default.
Expand Down